Tipos de variables en bibliotecas de variables

Una biblioteca de variables en Microsoft Fabric es un elemento especializado que centraliza la definición y administración de variables, lo que permite la configuración escalable y automatizada en áreas de trabajo y elementos.

Las variables dentro de una biblioteca de variables pueden ser tipos básicos o avanzados, y cada variable se identifica de forma única por su nombre dentro del elemento de biblioteca.

• Los tipos de variables básicos de la biblioteca de variables incluyen tipos de datos simples, como Boolean, DateTime (en formato UTC ISO 8601), Guid, Integer, Number y String. Estos son valores sencillos que se pueden asignar y usar directamente en diferentes fases y entornos.
• Los tipos de variables avanzadas están diseñados para casos de uso más sofisticados, como hacer referencia a elementos internos de Fabric o conexiones externas. Estos incluyen tipos de "referencia de elementos" que almacenan identificadores de área de trabajo y de elementos que apuntan a elementos específicos de Fabric.

Tipos admitidos en bibliotecas de variables

Las variables dentro de una biblioteca de variables tienen los siguientes tipos de variables admitidos

TypeType	Categoría	Description
Boolean	Básico	Representa valores verdadero/falso.
Integer	Básico	Números enteros sin decimales.
Number	Básico	Valores numéricos, incluidos los decimales.
String	Básico	Valores de texto o secuencias de caracteres.
DateTime	Básico	Fecha y hora representadas como la norma 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, 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).
GUID	Básico	Identificador único global que se usa para la identificación de objetos distintos.
Referencia de elemento	Advanced	Se usa dentro de la biblioteca de variables de Fabric para contener una referencia a un elemento de Fabric existente, como un lakehouse, cuaderno o canalización de datos, almacenando su ID de área de trabajo e ID de elemento.

Propiedades de variables

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

Propiedad	Description
Nombre	Identificador único de la variable. Se usa para hacer referencia a la variable en scripts o flujos de trabajo.
Nota (opcional)	Comentario descriptivo o anotación sobre la variable. Puede incluir contexto, notas de uso o instrucciones especiales. Longitud máxima: 2048 caracteres.
Tipo	Define el tipo de datos de la variable (por ejemplo, cadena, entero, booleano, matriz). Determina cómo se interpreta y valida el valor.
Conjunto de valores predeterminado	Valor inicial asignado a la variable cuando no se proporciona ningún otro valor. Garantiza un comportamiento coherente en los flujos de trabajo. No se puede cambiar el nombre del conjunto de valores predeterminado.
Conjuntos de valores alternativos (opcional)	Conjuntos predefinidos adicionales de valores que se pueden aplicar en condiciones o escenarios específicos. Resulta útil para configuraciones específicas del entorno o alternativas de reserva.

Convenciones de nomenclatura

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.

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.

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.