Compartir vía

¿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.

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.
  • 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.

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

La biblioteca de variables de Fabric es un sistema estructurado diseñado para administrar parámetros de configuración entre áreas de trabajo y fases de implementación. En su núcleo se encuentran variables definidas por el usuario, que pueden ser tipos básicos (como string, entero, booleano) o tipos complejos, como referencias de elementos. Estas variables se agrupan dentro de un elemento de biblioteca de variables y se pueden hacer referencia a ellas por elementos de consumo dentro del mismo área de trabajo.

Para admitir la configuración dinámica, cada variable puede tener varios conjuntos de valores o conjuntos alternativos de valores adaptados para entornos diferentes (por ejemplo, desarrollo, pruebas, prod). Un conjunto de valores se designa como "activo" por área de trabajo, lo que determina qué valores se usan durante el tiempo de ejecución.

Los usuarios pueden crear, editar y administrar variables y conjuntos de valores mediante la interfaz de usuario o las API de Fabric, con comprobaciones de permisos y validación integradas. El sistema admite flujos de trabajo de CI/CD, lo que permite administrar variables como código, integrarse con Git e implementarlas a través de canalizaciones. Esta estructura garantiza la administración escalable, automatizada y controlada de la configuración en sistemas de datos complejos.

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

Elementos admitidos

Los siguientes elementos admiten la biblioteca de variables:

Convenciones de nomenclatura

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.

Consideraciones y limitaciones

Limitaciones de las variables

  • 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