Definir chaves alternativas para referenciar linhas

  • Artigo

As Chaves alternativas fornecem uma forma eficiente e exata de integrar dados com sistemas externos. É essencial em casos quando um sistema externo não armazena os ID de identificador exclusivo global (GUID) que identificam linhas no Microsoft Dataverse.

Um sistema de integração de dados utiliza chaves alternativas para identificar exclusivamente linhas utilizando um ou mais valores de coluna de tabela que representam uma combinação exclusiva. Cada chave alternativa tem um nome exclusivo.

Por exemplo, para identificar uma linha de conta com uma chave alternativa, pode utilizar o número da conta ou a coluna de número de conta em combinação com algumas outras colunas que têm valores que não devem ser alterados.

Nota

Embora possa definir as chaves alternativas com o Power Apps, estas só podem ser utilizadas através de programação em código. Para mais informações sobre a utilização da programação de chaves alternativas, consulte:

Alguns dos benefícios da funcionalidade de chaves alternativas incluem:

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

Criar uma chave alternativa

Existem dois estruturadores que pode utilizar para criar chaves alternativas:

Estruturador Descrição
Portal Power Apps Fornece uma experiência simplificada e fácil, mas algumas opções não estão disponíveis.
Mais informações: Definir chaves alternativas através do portal Power Apps
Explorador de soluções Não é tão fácil, mas fornece mais flexibilidade para requisitos menos comuns.
Mais informações: Definir chaves alternativas através do explorador de soluções

Nota

Também pode criar uma chave alternativa no seu ambiente utilizando o seguinte:

As informações neste artigo ajudam-no a escolher que estruturador pode utilizar.

Deve utilizar o portal Power Apps PowerApps para criar chaves alternativas, a menos que necessite de tratar de qualquer um dos seguintes requisitos:

  • Crie uma chave alternativa dentro de uma solução que não a Solução Predefinida do Common Data Service.
  • Pretende monitorizar facilmente a tarefa de sistema criada que monitoriza o progresso de criar os índices de suporte.

Limites na criação de chaves alternativas

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

Campos que podem ser utilizados para chaves alternativas

Apenas estes tipos de colunas podem ser utilizados para criar chaves alternativas:

  • Decimal
  • Número Completo (Número Inteiro)
  • Uma linha de Texto (Cadeia)
  • Data e Hora
  • Procura
  • Opção

Nota

  • As colunas que têm a propriedade Ativar segurança da coluna ativada não podem ser usadas como uma chave alternativa. Mais informações: Tabelas de segurança de campo
  • Quando valores NULL são usados em colunas de chave alternativa, a exclusividade não será imposta. Para evitar registos duplicados, não utilize valores nulos nas colunas definidas na restrição exclusiva de chave alternativa.

Número de chaves

Pode definir até 10 chaves diferentes para uma tabela.

Tamanho da chave válido

Quando é criada uma chave, o sistema valida que a chave pode ser suportada pela plataforma, incluindo que o tamanho total da chave não viola restrições de índice baseadas em SQL, como 900 bytes por chave e 16 colunas por chave. Se o tamanho da chave não corresponder às restrições, uma mensagem de erro é apresentada.

Caracteres Unicode no valor da chave

Se os dados de uma coluna que é utilizada numa chave alternativa contiverem um destes carateres <,>,*,%,&,:,/,\\,# então as ações de atualizar ou upsert (PATCH) não funcionam.

Se precisar apenas de exclusividade, esta abordagem funciona, mas se for necessário utilizar estas chaves como parte da integração de dados, então, é melhor criar a chave em colunas que não tenham dados com esses carateres.

Monitorizar o estado da criação da chave alternativa

Quando é criada uma chave alternativa, esta inicia uma tarefa de sistema para criar índices nas tabelas da base de dados para impor restrições exclusivas às colunas utilizadas pela chave alternativa. A chave alternativa não entrará em vigor até que estes índices sejam criados. Criar estes índices poderá demorar algum tempo, consoante a quantidade de dados no sistema.

O estado da tarefa de sistema determina o estado da chave alternativa. A chave alternativa pode ter os seguintes estados:

  • Pendente
  • Em Curso
  • Activo
  • Falhado

Quando a tarefa de sistema tiver sido concluída, o estado da chave alternativa é Ativa e está disponível para utilização.

Se a tarefa de sistema falhar, localize a tarefa de sistema para ver os erros. A tarefa de sistema terá um nome que segue este padrão: Create index for {0} for table {1} onde 0 é o Nome a Apresentar da chave alternativa e 1 é o nome da tabela.

Nota

Se pretender monitorizar o estado da tarefa de sistema deve utilizar o explorador de soluções para criar o índice. Irá incluir uma ligação para a tarefa de sistema para que possa monitorizá-la. Mais informações: (Opcional) Ver a criação de monitorização da tarefa de sistema de índices

Consulte também

Definir chaves alternativas através do portal Power Apps
Definir chaves alternativas com o explorador de soluções
Documentação do Programador: Definir chaves alternativas para uma tabela
Documentação do Programador: Utilizar uma chave alternativa para criar uma linha

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).