Nombres y tipos de variables (versión preliminar)

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

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

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

Convenciones de nomenclatura

Nombre del elemento de Biblioteca de variables

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

• No estar 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 estar 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:

• Cadena: cualquier carácter puede ser nulo o estar vacío.
• Boolean: True o False.
• DateTime: la fecha y hora se representan con el estándar ISO 8601, aaaa-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, seguida por el 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) Por ejemplo, 2025-01-14T16:15:20.123Z.
• Número: cualquier número.
• GUID: use este tipo para representar GUID.
• Entero: número entero que puede ser positivo, negativo o cero.

Una vez que una variable tiene un valor definido, si intenta cambiar su tipo, aparece un cuadro de diálogo de consentimiento que alerta al usuario 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 value-sets. Puede cambiar el orden en que se muestran los conjuntos de valores o cambiar el valor de una variable en el conjunto de valores alternativos establecido 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 el número total de celdas de los conjuntos de valores alternativos sea inferior a 10 000 celdas y el tamaño del elemento no sea mayor que 1 MB. Esto se valida cuando el usuario guarda 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 del conjunto de valores alternativos

• Los conjuntos de valores alternativos de la Biblioteca de variables aparecen en el orden en que se agregaron. 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 la 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 uno y solo un conjunto de valores activo en una Biblioteca de variables a la vez. No se puede eliminar el conjunto de valores activo. Para eliminarlo, establezca primero otro conjunto de valores que sea activo. Puede configurar un conjunto de valores activado diferente para cada fase de un proceso de implementación.