Comentários

Definir chaves alternativas referenciar linhas

  • Artigo
  • 4 minutos para o fim da leitura

As chaves alternativas proporcionam um modo eficiente e preciso de integrar dados com sistemas externos. É essencial, nos casos em que um sistema externo não armazena IDs de identificador global exclusivo (GUID), que identifiquem exclusivamente as linhas no Microsoft Dataverse.

Um sistema de integração de dados usará chaves alternativas para identificar exclusivamente linhas, usando um ou mais valores de coluna de tabela que representem uma combinação exclusiva. Cada chave alternativa tem um nome exclusivo.

Por exemplo, para identificar uma linha de conta com uma chave alternativa, você pode usar o número da conta ou a coluna de número de conta em combinação com algumas outras colunas que tenham valores que não devam mudar.

Observação

Embora você possa definir chaves alternativas com o Power Apps, elas só podem ser usadas de forma programada no código. Para saber mais sobre o uso de chaves alternativas programaticamente, consulte:

Alguns dos benefícios do recurso de chaves alternativas incluem:

  • Pesquisa de linhas mais rápida.
  • Operações de dados em massa mais robustas.
  • Programação simplificada com dados importados de sistemas externos sem IDs de linha.

Criando uma chave alternativa

Existem dois designers que você pode usar para criar chaves alternativas:

Designer Descrição
Portal do Power Apps Fornece um uso fácil, mas algumas opções não estão disponíveis.
Mais informações: Definir chaves alternativas usando o portal do Power Apps
Gerenciador de soluções Não é tão fácil de usar, mas fornece mais flexibilidade para requisitos menos comuns.
Mais informações: Defina chaves alternativas, usando o gerenciador de soluções

Observação

Você também pode criar uma chave alternativa em seu ambiente, usando os seguintes procedimentos:

As informações deste tópico ajudarão você a decidir qual designer utilizar.

Você deve usar o portal do Power Apps para criar chaves alternativas, a menos que precise atender a qualquer um dos seguintes requisitos:

  • Criar uma chave alternativa em uma solução diferente da solução padrão do Common Data Service
  • Você deseja rastrear facilmente o trabalho do sistema criado que rastreia o progresso de criação dos índices de suporte

Limites na criação de chaves alternativas

Há restrições na criação de chaves alternativas.

Campos que podem ser usados para chaves alternativas

Somente estes tipos de colunas podem ser usados para criar chaves alternativas:

  • Decimal
  • Número inteiro (inteiro)
  • Linha única de texto (cadeia de caracteres)
  • Data e Hora
  • Pesquisar
  • Opção

Número de chaves

Você pode definir até dez chaves diferentes para uma tabela.

Tamanho de chave válido

Quando uma chave é criada, o sistema valida que essa chave pode ter suporte da plataforma, incluindo que o tamanho total da chave não viola as restrições de índice com base em SQL como 900 bytes por chave e 16 colunas por chave. Se o tamanho da chave não atender as restrições, uma mensagem de erro será exibida.

Caracteres Unicode no valor da chave

Se os dados em uma coluna que será usada em uma chave alternativa contiverem um dos seguintes caracteres: <,>,*,%,&,:,/,\\, as ações de update ou upsert (PATCH) não funcionarão.

Se você precisar apenas da exclusividade, essa abordagem funcionará. Porém, se precisar usar essas chaves como parte da integração de dados, o melhor será criá-las em colunas que não tenham dados com esses caracteres.

Rastrear o status da criação da chave alternativa

Quando uma chave alternativa é criada, o processo iniciará um trabalho do sistema para criar índices nas tabelas de banco de dados para impor restrições exclusivas às colunas usadas pela chave alternativa. A chave alternativa não será aplicada até que os índices sejam criados. A criação desses índices pode levar algum tempo, dependendo da quantidade de dados no sistema.

O status do trabalho do sistema determina o estado da chave alternativa. A chave alternativa pode ter os seguintes estados:

  • Pendente
  • Em Andamento
  • Ativa
  • Falha

Quando o trabalho do sistema for concluído, o status da chave alternativa será Ativo, e o uso estará disponível.

Se o trabalho do sistema falhar, localize o trabalho do sistema para visualizar os erros. O trabalho do sistema terá um nome com o seguinte padrão: Create index for {0} for table {1} onde 0 é o Nome de exibição da chave alternativa e 1 é o nome da tabela.

Observação

Para monitorar o status do trabalho do sistema, você deverá usar o gerenciador de soluções para criar o índice. Isso incluirá um link para o trabalho do sistema, de modo que você poderá monitorá-lo. Mais informações: (Opcional) Exibir o trabalho do sistema para rastrear a criação de índices

Consulte também

Definir chaves alternativas usando o portal do Power Apps
Definir chaves alternativas usando o Gerenciador de soluções
Documentação do Desenvolvedor: Definição de chaves alternativas para uma tabela
Documentação do Desenvolvedor: usar uma chave alternativa para criar uma linha

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).