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
- 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.
- 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.
- Clique com o botão direito do mouse no ícone do banco de dados e selecione Novo script SQL > Script vazio.
- 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.