Valores de Registro - Valor Estruturado no Power Query

Este tutorial discutirá sobre valores de registro dentro do Editor do Power Query . Você aprenderá como criar e usar registros com diferentes expressões para gerar os resultados que deseja alcançar.

Índice

• Criando valores de registro
  • Registros com valores de campo
  • Outras maneiras de criar registros
• Referindo outros valores de campos
• Combinando e igualando valores de registro
• Conclusão

Criando valores de registro

Um valor de registro é uma sequência ordenada de campos. É composto por um conjunto de campos que consiste em um nome de campo e um valor de campo associado. O nome do campo é um valor de texto que identifica exclusivamente o campo dentro de um registro e pode ser de qualquer tipo primitivo ou estruturado. No entanto, a ordem dos campos não é considerada na comparação de registros.

O inicializador de registro é um conjunto de colchetes. Se você inserir colchetes ( [ ] ) na barra de fórmulas e pressionar Enter, criará um registro vazio sem campos e valores.

Se você observar o painel Consulta, verá o ícone associado aos valores de registro.

Para criar um registro com campos, primeiro crie uma nova consulta. Clique com o botão direito do mouse no painel Consulta, clique em Nova consulta e selecione Consulta em branco .

Registros com valores de campo

Na barra de fórmulas, insira um nome de campo e atribua um valor. Para adicionar mais campos ao registro, coloque uma vírgula entre cada nome e valor. Você verá os nomes e valores no painel de visualização. Ambos os valores de campo no registro são primitivos.

Os registros também podem conter tipos de estrutura. Crie um novo registro e atribua um valor de registro. Você terá um valor de registro aninhado no painel de visualização.

Se você clicar no espaço ao lado do valor do registro aninhado, verá uma visualização do conteúdo desse registro abaixo do painel de visualização.

Agora, você pode detalhar o valor do registro. Clique em Gravar e você verá o valor no painel.

Você também pode fazer isso clicando com o botão direito do mouse no espaço ao lado de Registro e selecionando Drill Down .

Outras maneiras de criar registros

Existem outras maneiras de criar registros. Você pode usar funções M que retornam registros ou usar o sublinhado em uma coluna personalizada para retornar um registro com todos os nomes de campo e valores de campo para a linha atual de uma tabela. Você também pode usar o operador de acesso de item para retornar um registro específico de uma tabela.

Se você abrir a janela do editor avançado, verá que o Power Query adicionou a expressão let .

A expressão não é realmente necessária, então você pode remover tudo, exceto o valor do registro. Quando você clica em Concluído , nada muda e o resultado continua o mesmo.

Se você transformar o registro em uma tabela e for para a janela do editor avançado, verá que o Power Query traz automaticamente a expressão let de volta.

Além disso, existem fatos sobre registros que você deve conhecer. Primeiro, cada nome de campo em um registro precisa ser exclusivo e os nomes de campo são comparados usando uma comparação ordinal. Se você inserir o mesmo nome de campo, receberá uma mensagem de erro.

Em segundo lugar, o nome do campo em um registro e o operador de pesquisa , que é o nome do campo entre colchetes, são escritos sem a notação entre aspas .

Você pode ver que não há notações entre aspas usadas nos nomes dos campos.

No entanto, há um caso específico em que as notações entre aspas são necessárias. Os sinais de aspas duplas são necessários quando você inclui um espaço inicial ou final no nome do campo. Isso ocorre porque M assume que um espaço amplo ocorrendo no início ou no final de um nome de campo sem aspas pode ser ignorado.

Você pode ver que as notações são adicionadas por causa de um espaço após o nome do campo de primeiro valor .

Referindo outros valores de campos

A expressão para um valor de campo também pode se referir a outros campos no registro. Aqui está um exemplo:

Se você procurar um valor de campo que não existe, receberá um erro.

Adicionar um ponto de interrogação a um acesso de campo ou operador de pesquisa altera o erro para null . Isso é chamado de execução de uma seleção de campo opcional .

Combinando e igualando valores de registro

Há um conjunto de operadores que você pode usar com registros: a combinação e os operadores de equação .

Os registros podem ser mesclados com um operador de combinação usando o e comercial ( & ).

Se você combinar registros e os nomes dos campos não forem exclusivos, os valores dos campos do operando direito substituirão os valores dos campos da esquerda.

Além de combinar, você também pode comparar registros.

Lembre-se que a ordem dos campos não é considerada na comparação de registros. Portanto, mesmo que você altere a posição dos nomes dos campos, o resultado ainda será o mesmo.

Extrair valores de registros e listas em
dados delimitados do Power Query – Extraindo registros usando o LuckyTemplates
Power Query/M Masterclass #1 – Novo curso sobre LuckyTemplates

Conclusão

Os valores de registro são um dos valores estruturados no Power Query. Eles ajudam a moldar seu relatório de dados e mostram informações com base nas expressões e na sintaxe que você usa no Editor do Power Query. Se você deseja tornar seu relatório de dados mais eficiente na geração de dados , pode usar valores de registro.

melissa