Definir claves alternativas a facer referencia a filas

  • Artigo

As claves alternativas, fornecen unha maneira eficiente e correcta de integrar datos con sistemas externos. É esencial en casos nos que un sistema externo non almacena identificadores do Identificador Único Global (GUID) que identifican exclusivamente filas en Microsoft Dataverse.

Un sistema de integración de datos utiliza teclas alternativas para identificar de forma única filas usando un ou máis valores da columna de táboas que representan unha combinación única. Cada clave alternativa ten un nome único.

Por exemplo, para identificar unha fila de conta cun clave alternativa, podes usar o número de conta ou a columna de número de conta en combinación con algunhas outras columnas, que teñen valores que non deberían cambiar.

Nota

Aínda que pode definir claves alternativas con Power Apps, só se poden utilizar mediante programación en código. Para obter máis información sobre como usar as claves alternativas mediante programación consulte:

Os beneficios da funcionalidade de claves alternativas son, entre outros:

  • Busca máis rápida de filas.
  • Operacións de datos en masa máis sólidas.
  • Programación simplificada con datos importados de sistemas externos sen identificadores de filas.

Creación dunha clave alternativa

Hai dous deseñadores que pode utilizar para crear claves alternativas:

Deseñador Descrición
Portal de Power Apps Ofrece unha experiencia simplificada fácil, pero algunhas opcións non están dispoñibles.
Máis información: Definir claves alternativas mediante o portal de Power Apps
Explorador de solucións Non é tan fácil, mais fornece máis flexibilidade para requirimentos menos comúns.
Máis información: Definir claves alternativas mediante o explorador de solucións

Nota

Tamén pode crear unha clave alternativa no seu ambiente facendo o seguinte:

A información deste artigo axúdache a escoller que deseñador podes usar.

Debería usar o Portal de Power Apps para crear claves alternativas a menos que teña que cumprir calquera dos requisitos seguintes:

  • Crea un clave alternativa dentro dunha solución distinta da Common Data Service solución por defecto.
  • Quere rastrexar facilmente o traballo do sistema creado que rastrexa o progreso da creación dos índices de apoio.

Límites ao crear claves alternativa

Non hai restricións na creación de claves alternativas.

Campos que se poden usar para claves alternativas

Só estes tipos de columnas se poden utilizar para crear claves alternativas:

  • Decimal
  • Número enteiro
  • Liña única de texto (cadea)
  • Data e hora
  • Busca
  • Opción

Nota

  • As columnas que teñen habilitada a propiedade de seguridade da columna Enable non poden ser usadas como clave alternativa. Máis información: Táboas de seguridade de campo
  • Cando se utilicen valores NULL en columnas clave alternativa, non se aplicará a singularidade. Para evitar rexistros duplicados, non utilice valores nulos nas columnas definidas na restrición única do clave alternativa.

Número de claves

Podes definir ata 10 claves diferentes para unha táboa.

Tamaño de clave válido

Cando se crea unha clave, o sistema valida que a clave pode ser soportada pola plataforma, incluíndo que o tamaño total da clave non viola restricións de índice baseadas en SQL como 900 bytes por clave e 16 columnas por tecla. Se o tamaño da clave non cumpre coas restricións, móstrase unha mensaxe de erro.

Caracteres Unicode en valor de clave

Se os datos dunha columna que se usan nun clave alternativa contén un dos seguintes caracteres <,>``*``%``&``:``/``\\``# as accións de actualización ou upsert (PATCH) non funcionarán.

Se só precisa de singularidade, este enfoque funciona, pero se precisa usar estas claves como parte da integración de datos, o mellor é crear a clave en columnas que non teñen datos con estes caracteres.

Rastrexar o estado da creación da clave alternativa

Cando se crea un clave alternativa, inicia un traballo do sistema para crear índices nas táboas da base de datos para aplicar restricións únicas nas columnas utilizadas polo clave alternativa. O clave alternativa non estará vixente ata que se creen estes índices. A creación destes índices pode levar un tempo dependendo da cantidade de datos do sistema.

O estado do traballo do sistema determina o estado da clave alternativa. A clave alternativa pode ter os seguintes estados:

  • Pendente
  • En curso
  • Activa
  • Erro

Cando se completa o traballo do sistema, o estado clave alternativa é Activo e está dispoñible para o seu uso.

Se hai erros no traballo do sistema, localice o traballo do sistema para ver os erros. O traballo do sistema ten un nome que segue este padrón: Create index for {0} for table {1} onde 0 é o Nome para Mostrar da clave alternativa e 1 é o nome da táboa.

Nota

Se desexa monitorar o estado do traballo do sistema debe utilizar o explorador de solucións para crear o índice. Incluirá unha ligazón ao traballo do sistema para que o poida monitorar. Máis información: (Opcional) Visualice a creación de índices de seguimento do traballo do sistema

Consulte tamén

Definir claves alternativas mediante o portal de Power Apps
Definir claves alternativas mediante o explorador de solucións
Documentación de programador: Definir claves alternativas para unha táboa
Documentación para programadores: Utilizar unha clave alternativa para crear unha fila

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).