Definir claves alternativas a facer referencia a filas

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 utilizará claves alternativas para identificar exclusivamente filas usando un ou máis valores de columna de táboas que representan unha combinación exclusiva. Cada clave alternativa ten un nome único.

Por exemplo, para identificar unha fila de conta cunha clave alternativa, pode utilizar a columna de número de conta ou ou o número de conta en combinación con algunhas outras columnas que teñen valores que non se deben modificar.

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 Fornece unha experiencia dinamizada 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 tema axuda a escoller que deseñador pode utilizar.

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

  • Crear unha clave alternativa nunha solución distinta á solución predefinida de Common Data Service
  • Quererá rastrexar facilmente o traballo do sistema creado que rastrexa o progreso da creación de índices de soporte

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

Número de claves

Pode definir ata 10 claves diferente para unha táboa.

Tamaño de clave válido

Cando se crea unha clave, o sistema valida que a clave sexa compatible coa plataforma; incluíndo a que o tamaño total da clave non infrinxa as restricións de índice baseadas en SQL como 900 bytes por clave e 16 columnas por clave. Se o tamaño da clave non cumpre as restricións, mostrarase unha mensaxe de erro.

Caracteres Unicode en valor de clave

Se os datos dunha columna que se usa nunha clave alternativa conteñen un dos seguintes caracteres <,>,*,%,&,:,/,\\, as accións update ou upsert (PATCH) non funcionarán.

Se só necesita exclusividade, este enfoque funcionará, pero se necesita utilizar estas claves como parte da integración de datos, é mellor crear a clave en columnas que non teñan datos con estes caracteres.

Rastrexar o estado da creación da clave alternativa

Ao crear unha clave alternativa, iniciarase un traballo do sistema para crear índices nas táboas da base de datos para impoñer límites exclusivos nas columnas utilizadas pola clave alternativa. A clave alternativa non terá efecto até que se creen estes índices. Crear estes índices pode demorar un pouco dependendo da cantidade de datos no 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

Ao concluír o traballo do sistema, o estado da 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).