Acessar rótulos de opções diretamente do Azure Synapse Link for Dataverse

O Microsoft Dataverse fornece metadados ricos que podem ser usados diretamente no Power Apps. Uma opção (lista de seleção) é um dos tipos de colunas mais usados que podem ser incluídos em uma tabela. Ela define um conjunto de opções. Quando uma opção é exibida em um formulário, ela usa um controle de lista suspensa. Você pode configurar uma opção para usar um conjunto de opções definidas dentro dela mesma (localmente) ou usar um conjunto de opções definidas em outro lugar (globalmente), que podem ser utilizadas por outras colunas de opções.

Para obter mais informações sobre colunas de opções, vá para Visão geral de criação e edição de opções globais.

Depois de criar um Azure Synapse Link, as cinco tabelas a seguir são criadas em uma pasta chamada OptionsetMetadata no Azure Data Lake Storage Gen2:

• OptionsetMetadata
• GlobalOptionsetMetadata
• StateMetadata
• StatusMetadata
• TargetMetadata

StateMetadata e StatusMetadata armazenam o valor das opções Estado e Status a ser recuperado. TargetMetadata armazena metadados de relacionamentos de tabelas a serem recuperados.

Nome da coluna	Tipo de dados	Valor de exemplo	Descrição
EntityName	Cadeia de caracteres	conta	Nome da tabela atual do Dataverse.
AttributeName	Cadeia de caracteres	transactioncurrencyid	Nome da coluna atual
ReferencedEntity	Cadeia de caracteres	transactioncurrency	Nome da tabela relacionada do Dataverse
ReferencedAttribute	Cadeia de caracteres	transactioncurrencyid	Nome da coluna relacionada

Mais informações: Visão geral dos relacionamentos de tabelas.

OptionsetMetadata armazena os metadados do rótulo de opções locais nas tabelas importadas do Dataverse. GlobalOptionsetMetadata armazena os metadados do rótulo de opções globais e segue o mesmo esquema de tabela mais uma coluna extra, GlobalOptionSetName, uma combinação de tabela e nome de opção.

Nome da coluna	Tipo de dados	Valor de exemplo	Descrição
EntityName	Cadeia de caracteres	conta	Nome da tabela do Dataverse.
OptionSetName	Cadeia de caracteres	ownershipcode	Nome da coluna.
Opção	Bigint	1	Rótulo numérico especificado pelo usuário quando o item de opção é criado.
IsUserLocalizedLabel	Booliano	False	Retorne False por padrão.
LocalizedLabelLanguageCode	Bigint	1033	O código de idioma do rótulo de opções, como 1033 para Inglês (Estados Unidos) ou 1034 para Espanhol (Espanha).
LocalizedLabel	Cadeia de caracteres	Pública	Rótulo de texto especificado pelo usuário quando o item de opção é criado.
GlobalOptionSetName (somente GlobalOptionsetMetadata)	Cadeia de caracteres	socialprofile_community	uma combinação de tabela e nome de opção

Nas tabelas do Dataverse, a coluna de opções contém um valor numérico especificado pelo usuário, que é igual ao valor Opção na tabela OptionsetMetadata descrita acima.

Pré-requisito

Azure Synapse Link for Dataverse. Este artigo pressupõe que você já exportou dados do Dataverse usando o Azure Synapse Link for Dataverse. 

Acessar metadados de opções

1. Selecione o Azure Synapse Link desejado e, em seguida, selecione Ir para o espaço de trabalho do Azure Synapse Analytics na barra de comandos.  
2. Expanda Bancos de dados do Lake no painel esquerdo, selecione dataverse-environmentName-organizationUniqueName e, em seguida, expanda Tabelas.  Todos os metadados de opções listados estão disponíveis para análise.

Para consumir colunas de opções do Dataverse com pool de SQL sem servidor.

1. Clique com o botão direito do mouse no ícone do banco de dados e selecione Novo script SQL > Script vazio.
2. Aplique um script SQL de junção para unir os metadados de opções à sua tabela do Dataverse e armazenar a exibição em um novo banco de dados.

Script SQL de exemplo para unir metadados de opções

Substituir <DATABASE_NAME>,<COLUMN_NAME> e <TABLE_NAME> pelo nome do banco de dados, da coluna e da tabela para substituir um valor de opção numérico por um rótulo de texto significativo

SELECT [LocalizedLabel] as [<COLUMN_NAME>] 
FROM [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned] 
LEFT JOIN [<DATABASE_NAME>].[dbo].[OptionsetMetadata] 
ON ([<DATABASE_NAME>].[dbo].[OptionsetMetadata].[Option] = [<DATABASE_NAME>].[dbo].[<TABLE_NAME>_partitioned].[<COLUMN_NAME>] AND [<DATABASE_NAME>].[dbo].[OptionsetMetadata].[OptionSetName] = <COLUMN_NAME>)

Para obter mais informações sobre como consumir vários valores de conjuntos de opções, consulte Usar Expressões de Tabela Comuns.