Definir claves alternativas para hacer referencia a filas

  • Artículo

Las claves alternativas ofrecen una forma eficaz y precisa de integrar datos con sistemas externos. Es esencial en los casos en que un sistema externo no almacena los Id. de identificador único global (GUID) que identifican de forma única filas en Microsoft Dataverse.

Un sistema de integración de datos usa claves alternativas para identificar de forma exclusiva filas mediante uno o más valores de columna de tabla que representen una única combinación. Cada clave alternativa tiene un nombre único.

Por ejemplo, para identificar una fila de cuenta con una clave alternativa, puede usar el número de cuenta o la columna de número de cuenta conjuntamente con otras columnas que tienen valores que no deben cambiar.

Nota

Aunque puede definir claves alternativas con Power Apps, solo se pueden usar mediante programación en código. Para obtener más información sobre cómo usar claves alternativas mediante programación, consulte:

Algunas de las ventajas de la característica de claves alternativas:

  • Consulta más rápida de las filas.
  • Operaciones de datos en masa más robustas.
  • Programación simplificada con datos importados desde sistemas externos sin identificadores de fila.

Crear una clave alternativa

Hay dos diseñadores que puede usar para crear claves alternativas:

Diseñador Descripción
Portal Power Apps Proporciona una experiencia fácil y ágil, pero algunas opciones no están disponibles.
Más información: Definir claves alternativas con el portal de Power Apps
Explorador de soluciones No es tan fácil, pero proporciona más flexibilidad para requisitos menos comunes.
Más información: Definir claves alternativas con el explorador de soluciones

Nota

También puede crear una clave alternativa en su entorno mediante lo siguiente:

La información de este artículo le ayuda a elegir el diseñador que puede usar.

Debería usar el portal de Power Apps para crear claves alternativas, a menos que necesite satisfacer cualquiera de los siguientes requisitos:

  • Crear una clave alternativa en una solución distinta de la solución predeterminada de Common Data Service.
  • Desea realizar fácilmente un seguimiento del trabajo del sistema que realiza el seguimiento del progreso de creación de los índices de soporte.

Límites al crear claves alternativas

Hay restricciones a la hora de crear una clave alternativa.

Campos que se pueden usar para las claves alternativas

Solo estos tipos de columnas se pueden usar para crear claves alternativas:

  • Decimal
  • Número entero (entero)
  • Una sola línea de texto (cadena)
  • Fecha y hora
  • Lookup
  • Opción

Nota

  • Las columnas que tienen habilitada la propiedad Habilitar seguridad de columna no se pueden usar como clave alternativa. Más información: Tablas de seguridad de campo
  • Cuando se utilizan valores NULL en las columnas clave alternativa, no se aplicará la unicidad. Para evitar registros duplicados, no utilice valores nulos en las columnas definidas en la restricción única de clave alternativa.

Número de claves

Puede definir hasta 10 claves diferentes para una tabla.

Tamaño de clave válido

Cuando se crea una clave, el sistema valida que la plataforma puede admitir la clave, incluido que el tamaño total de la clave no infringe restricciones de índice basadas en SQL como 900 bytes por clave y 16 columnas por clave. Si el tamaño de la clave no cumple las restricciones, un mensaje de error se muestra.

Caracteres Unicode en valor de clave

Si los datos en una columna que se usa en una clave alternativa contiene uno de los caracteres siguientes <,>,*,%,&,:,/,\\,# las acciones de actualización o upsert (PATCH) no funcionarán.

Si solo necesita unicidad, este método funciona, pero si necesita usar estas claves como parte de la integración de datos, entonces es mejor crear la clave en las columnas que no tienen datos con dichos caracteres.

Seguir el estado de creación de la clave alternativa

Cuando se crea una clave alternativa, se inicia un trabajo del sistema para crear índices en las tablas de base de datos para aplicar restricciones exclusivas en las columnas que se usan en la clave alternativa. La clave alternativa no surtirá efecto hasta que se creen estos índices. La creación de estos índices puede tardar más tiempo en función de la cantidad de datos del sistema.

El estado del trabajo del sistema determina el estado de la clave alternativa. La clave alternativa puede tener los siguientes estados:

  • Pendiente
  • En curso
  • Active
  • Con error

Cuando se completa el trabajo del sistema, el estado de la clave alternativa es Activo y está disponible para su uso.

Si se produce un error en el trabajo del sistema, busque el trabajo del sistema para ver los errores. El trabajo del sistema tendrá un nombre que sigue este patrón: Create index for {0} for table {1} donde 0 es el Nombre para mostrar de la clave alternativa y 1 es el nombre de la tabla.

Nota

Si desea supervisar el estado del trabajo del sistema debe usar el explorador de soluciones para crear el índice. Incluirá un vínculo al trabajo del sistema para poder supervisarlo. Más información: (Opcional) Ver el seguimiento del trabajo del sistema de creación de índices

Vea también

Definir las claves alternativas con el portal Power Apps
Definir las claves alternativas con el explorador de soluciones
Documentación para desarrolladores: Definir claves alternativas para una tabla
Documentación para desarrolladores: Usar una clave alternativa para crear una fila

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).