Compartir a través de

¿Qué es una biblioteca de variables?

Una biblioteca de variables de Microsoft Fabric es un cubo de variables que otros elementos del área de trabajo pueden consumir como parte de la administración del ciclo de vida de la aplicación (ALM). Funciona como un elemento dentro del área de trabajo que contiene una lista de variables, junto con sus respectivos valores para cada fase de la canalización de versión. Presenta un enfoque unificado para la administración eficaz de las configuraciones de elementos dentro de un área de trabajo, para ayudar a garantizar la escalabilidad y la coherencia en las fases del ciclo de vida.

Por ejemplo, una biblioteca de variables puede contener variables que contienen valores para:

  • Entero que se va a usar en una actividad de espera en una canalización.
  • Referencia de lakehouse para ser el origen en una actividad de datos de copia . Cada valor se usa en una canalización diferente, en función de la fase de versión de la canalización.
  • Referencia de lakehouse que se va a configurar como una instancia predeterminada de lakehouse de cuadernos. Cada valor se usa en una canalización diferente, en función de la fase de lanzamiento del cuaderno.

La resolución de valores en el elemento de consumidor no está necesariamente vinculada a su implementación. En su lugar, cada elemento de consumidor resuelve el valor en función de su propio contexto.

La experiencia de una biblioteca de variables difiere en función del tipo de variable, pero todas las bibliotecas de variables permiten definir y administrar variables que otros elementos pueden usar.

Una biblioteca de variables de Fabric:

  • Es compatible con los procesos de integración continua y entrega continua (CI/CD). Esta compatibilidad permite la integración con Git y la implementación a través de canalizaciones de implementación.
  • Admite la automatización a través de las API públicas de Fabric.

Ventajas

Las bibliotecas de variables permiten a los clientes personalizar y compartir configuraciones.

Personalización de configuraciones

Puede configurar un valor de variable en función de la fase de canalización de versión. Puede configurar la biblioteca de variables con conjuntos de valores: un valor para cada fase de la canalización de versión. A continuación, después de la configuración única del valor activo establecido para cada fase, el valor correcto se usa automáticamente en la fase de canalización. Algunos ejemplos son:

  • Cambiar la conexión de un elemento en función de la fase.
  • Cambiar a otro origen de datos en la nube en función de la fase.
  • Ajustar la cantidad de datos en una consulta en función de la fase.

Compartir configuraciones

Las Bibliotecas de variables proporcionan una manera centralizada de administrar configuraciones entre los elementos del área de trabajo. Por ejemplo, si tiene varias casas de lago en el área de trabajo y cada una tiene un acceso directo que usa el mismo origen de datos, puede crear una biblioteca de variables con ese origen de datos como una de las variables. De este modo, si desea cambiar el origen de datos, solo tiene que cambiarlo una vez en la biblioteca de variables. No es necesario cambiarlo en cada lakehouse por separado.

Estructura de la Biblioteca de variables

Las Bibliotecas de variables contienen una o varias variables. Cada variable tiene un nombre, un tipo y un valor predeterminado. También puede agregar una nota a cada variable para describir su propósito o cómo usarla.

Captura de pantalla de una biblioteca de variables con varias variables y sus componentes principales.

Valor predeterminado

El valor predeterminado es el valor que se usa a menos que defina específicamente un valor diferente.

Todas las variables deben tener un valor predeterminado. Si el tipo de variable es string, el valor predeterminado puede ser null.

Conjuntos de valores alternativos

Los conjuntos de valores definen los valores de cada variable de la biblioteca de variables. Normalmente, una biblioteca de variables contiene varios conjuntos de valores. El conjunto de valores activo (o efectivo) contiene el valor que recibe el elemento de consumidor para esa área de trabajo.

En cada área de trabajo, seleccione un conjunto de valores para que esté activo. El conjunto de valores activos de un área de trabajo no cambia durante una implementación o actualización de Git.

Captura de pantalla de una biblioteca de variables con varios conjuntos de valores alternativos.

Al crear un conjunto de valores alternativos, el nuevo conjunto de valores se crea con punteros al valor predeterminado de cada variable. A continuación, puede cambiar el valor de cada variable del nuevo conjunto de valores.

Elementos admitidos

Los siguientes elementos admiten la biblioteca de variables:

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.

Contenido relacionado

  • Last updated on