Ler em inglês

Compartilhar via


Metadados

Os metadados são informações sobre um valor que está associado a um valor. Os metadados são representados como um valor de registro, chamado de registro de metadados. Os campos de um registro de metadados podem ser usados para armazenar os metadados de um valor. Cada valor tem um registro de metadados. Se o valor do registro de metadados não for especificado, o registro de metadados estará vazio (não tem campos). Associar um registro de metadados a um valor não altera o comportamento do valor nas avaliações, exceto para aquelas que inspecionam explicitamente os registros de metadados.

Registros de metadados

Um valor de registro de metadados é associado a um valor x usando o valor de sintaxe meta [record]. Por exemplo, o seguinte associa um registro de metadados aos campos de classificação e marcações com o valor de texto "Mozart":

"Mozart" meta [ Rating = 5,
Tags = {"Classical"} ]

Um registro de metadados pode ser acessado para um valor usando a função Value.Metadata . No exemplo a seguir, a expressão no campo ComposerRating acessa o registro de metadados do valor no campo do compositor e, em seguida, acessa o campo de classificação do registro de metadados.

[  
    Composer = "Mozart" meta [ Rating = 5, Tags = {"Classical"} ],
    ComposerRating = Value.Metadata(Composer)[Rating]   // 5
]  

Os registros de metadados não são preservados quando um valor é usado com um operador ou função que constrói um novo valor. Por exemplo, se dois valores de texto forem concatenados com o operador &, os metadados do valor de texto resultante serão um registro vazio [].

As funções de biblioteca padrão Value.RemoveMetadata e Value.ReplaceMetadata podem ser usadas para remover todos os metadados de um valor e substituir os metadados de um valor.

Limitações

Alguns hosts que usam Power Query para transformar ou mover dados não dão suporte ao armazenamento de metadados personalizados no armazenamento. Os seguintes hosts não dão suporte ao armazenamento de metadados personalizados:

  • Fluxos de dados do Power BI
  • Fluxo de dados Gen2 do Fabric
  • Fluxo de dados do Power Platform