Nombres y tipos de variables

Un elemento de biblioteca de variables de Microsoft Fabric contiene una lista de variables y sus valores predeterminados. También puede contener otros conjuntos de valores que contienen valores alternativos.

Cada variable de la biblioteca de variables tiene las siguientes propiedades:

• Nombre
• Nota (opcional), hasta 2048 caracteres
• Tipo
• Conjunto de valores predeterminado
• Conjuntos de valores alternativos (opcional)

Convenciones de nomenclatura

Nombre de la biblioteca de variables

El nombre del elemento de biblioteca de variables debe seguir estas convenciones:

• No está vacío
• No tiene espacios iniciales ni finales
• Comienza con una letra
• Puede incluir letras, números, caracteres de subrayado, guiones y espacios
• No supera los 256 caracteres de longitud

El nombre de la biblioteca de variables no distingue mayúsculas de minúsculas.

Nombre de la variable

El nombre de una variable dentro de la biblioteca de variables debe seguir estas convenciones:

• No está vacío
• No tiene espacios iniciales ni finales
• Comienza con una letra o un carácter de subrayado
• Puede incluir letras, números, caracteres de subrayado y guiones
• No supera los 256 caracteres de longitud

El nombre de la variable no distingue mayúsculas de minúsculas.

Nombre del conjunto de valores

Los nombres de conjunto de valores tienen las mismas restricciones que los nombres de variable.

Tipos de variables

Antes de que pueda agregar un valor a una variable, debe definir el tipo de variable. Las variables de la biblioteca de variables pueden ser cualquiera de los siguientes tipos:

• String: cualquier carácter. Puede ser null o estar vacío.

• Boolean: True o False.

• DateTime: fecha y hora representadas como estándar ISO 8601 yyyy-MM-ddTHH:mm:ss.xxxZ, donde:

  • aaaa-MM-dd es el año de cuatro dígitos, seguido del mes de dos dígitos y el día de dos dígitos.
  • T separa la fecha y la hora.
  • HH:mm:ss.xxx es la hora de dos dígitos en formato de 24 horas, seguido del minuto de dos dígitos, el segundo de dos dígitos y el milisegundo de tres dígitos.
  • Z indica que la hora está en hora universal coordinada (UTC).

  Un ejemplo es 2025-01-14T16:15:20.123Z.

• Número: cualquier número.

• GUID: identificador único global.

• Entero: número entero que puede ser positivo, negativo o cero.

Después de que una variable tenga un valor definido, si intenta cambiar su tipo, aparecerá un cuadro de diálogo de consentimiento. El cuadro de diálogo le avisa de que se restablecerán todos los valores de variable y que este cambio podría ser un cambio importante en el elemento de consumidor.

Conjuntos de valores alternativos

Al crear un nuevo conjunto de valores en una biblioteca de variables, los nuevos valores se establecen como punteros a los valores predeterminados. Puede cambiarlos para que sean un valor fijo.

Si cambia el valor de una variable en el conjunto de valores alternativos, el valor alternativo se guarda en el archivo JSON para los conjuntos de valores. Puede cambiar el orden en el que aparecen los conjuntos de valores o cambiar el valor de una variable en el conjunto de valores alternativos, en este archivo JSON en Git.

Consideraciones y limitaciones

Limitaciones de tamaño

• Puede haber hasta 1000 variables y hasta 1000 conjuntos de valores, siempre y cuando cumpla ambos requisitos:

  • El número total de celdas de los conjuntos de valores alternativos es inferior a 10 000.
  • El tamaño del elemento no supera los 1 MB.

  Estos requisitos se validan al guardar los cambios.

• El campo de nota puede tener hasta 2048 caracteres.

• El campo de descripción de value-set puede tener hasta 2048 caracteres.

Limitaciones para conjuntos de valores alternativos

• Los conjuntos de valores alternativos de una biblioteca de variables aparecen en el orden en que los agregó. Actualmente, no se pueden reordenar en la interfaz de usuario. Para cambiar el orden, edite el archivo JSON directamente.
• El nombre de cada conjunto de valores debe ser único dentro de una biblioteca de variables.
• Los nombres de variable deben ser únicos dentro de una biblioteca de variables. Puede tener dos variables con el mismo nombre en un área de trabajo si están en elementos diferentes.
• Siempre hay un valor activo (y solo uno) establecido en una biblioteca de variables a la vez. No se puede eliminar un conjunto de valores mientras está activo. Para eliminarlo, configure primero otro valor establecido para que esté activo. Puede tener un valor activo diferente establecido para cada fase de una canalización de implementación.