Creación y administración de bibliotecas de variables

Las bibliotecas de variables de Microsoft Fabric permiten a los desarrolladores personalizar y compartir configuraciones de elementos dentro de un área de trabajo, con el objetivo de simplificar la administración del ciclo de vida del contenido. En este artículo se explica cómo crear, administrar y consumir bibliotecas de variables.

Para obtener un tutorial más detallado del proceso, consulte el tutorial para usar bibliotecas de variables.

Prerequisites

Para crear elementos de biblioteca de variables en Fabric, necesita:

• Una cuenta de arrendatario de Fabric con una suscripción activa. Cree una cuenta gratuita.

• Un área de trabajo con una capacidad habilitada para Microsoft Fabric.

• Los siguientes modificadores de inquilino habilitados desde el portal de administración:

  • Los usuarios pueden crear elementos de Fabric

  El administrador de inquilinos, el administrador de capacidad o el administrador del área de trabajo pueden habilitar estos modificadores, en función de la configuración de la organización.

Consideraciones de seguridad y administración de permisos para bibliotecas de variables de Fabric

Las bibliotecas de variables de Fabric son construcciones eficaces que permiten la administración centralizada de variables en varios elementos de Fabric. Sin embargo, esta flexibilidad presenta consideraciones de seguridad críticas.

Dado que las bibliotecas de variables son elementos de Fabric, se rigen por sus propios conjuntos de permisos . Estos conjuntos de permisos pueden diferir de los elementos que consumen sus variables. Esta discrepancia puede provocar escenarios en los que un usuario tiene acceso de escritura a una biblioteca de variables, pero carece de acceso al elemento que consume.

En tales casos, los usuarios no autorizados pueden modificar valores de variable de maneras que modifican intencionada o involuntariamente el comportamiento de los elementos dependientes de Fabric. Esta capacidad crea un vector de ataque potencial en el que las actualizaciones malintencionadas de variables compartidas podrían poner en peligro la integridad, la seguridad o la funcionalidad de esos elementos.

Para mitigar estos riesgos, siga estos procedimientos clave:

• Adoptar controles de permisos estrictos: los administradores deben administrar cuidadosamente los permisos de escritura en bibliotecas de variables para que solo los usuarios o servicios de confianza puedan modificarlos. Esta práctica incluye evitar el acceso excesivamente permisivo y auditar periódicamente las asignaciones de permisos.
• Usar referencias de biblioteca de confianza: los elementos solo deben hacer referencia a variables de bibliotecas que se designan explícitamente como de confianza. Este modelo de confianza debe aplicarse a través de directivas de gobernanza que validen el origen de las referencias de variables durante el desarrollo y la implementación.

Para obtener más información, consulte Permisos de biblioteca de variables.

Creación de un elemento de biblioteca de variables

Puede crear un elemento de biblioteca de variables desde la página principal de Fabric o desde dentro del área de trabajo:

Página principal

1. En la barra lateral, seleccione Crear. (Si no está ahí, seleccione los tres puntos y, a continuación, seleccione Crear).

2. En la sección Data Factory , seleccione Biblioteca de variables.

   

3. Asigne un nombre a la nueva biblioteca de variables y seleccione Crear. Asegúrese de que el nombre se ajusta a las convenciones de nomenclatura necesarias.

Workspace

1. Seleccione + Nuevo elemento.

2. Desplácese hacia abajo hasta la sección Desarrollar datos y seleccione Biblioteca de variables.

   

3. Asigne un nombre a la nueva biblioteca de variables y seleccione Crear. Asegúrese de que el nombre se ajusta a las convenciones de nomenclatura necesarias.

Aparece una biblioteca de variables vacía. Ahora puede agregar variables a ella.

Administrar bibliotecas de variables y sus variables

Puede administrar las variables de la biblioteca de variables desde la barra de menús superior.

Adición de una variable

Para agregar una nueva variable a la biblioteca:

1. Seleccione + Nueva variable.
2. Escriba un nombre. Asegúrese de que sigue las convenciones de nomenclatura.
3. En la lista desplegable, seleccione un tipo. Consulte una lista de tipos de variables admitidos.
4. Escriba un valor predeterminado.
5. Agregue una nota en la que se explica qué es la variable o cómo usarla (opcional).
6. Haga clic en Guardar.

Eliminar o editar una variable

• Para eliminar una variable, seleccione una o varias variables y, a continuación, seleccione Eliminar variable>Guardar.
• Para editar el nombre, el tipo o el conjunto de valores de una variable, cambie el valor y, a continuación, seleccione Guardar.
• Para agregar otro conjunto de valores alternativos, seleccione Agregar conjunto de valores.

Note

Al seleccionar Guardar después de editar cualquier variable de la biblioteca de variables, se desencadena una comprobación de validación de errores para asegurarse de que todos los nombres y valores de las variables sean válidos. Debe corregir los errores antes de guardar los cambios.

Agregar un conjunto de valores

Para agregar otro conjunto de valores que puede usar en una fase diferente:

1. Seleccione Agregar conjunto de valores.

2. Asigne un nombre al conjunto de valores. Asegúrese de que sigue las convenciones de nomenclatura. Asígnele una descripción (opcional) de hasta 2048 caracteres.

3. Si desea usar este valor para que sea el valor activo actualmente establecido en esta área de trabajo, seleccione Establecer como activo.

4. Escriba los valores de todas las variables de la biblioteca de variables.

5. Haga clic en Guardar.

Edición de un conjunto de valores

Para editar un conjunto de valores:

1. Seleccione los tres puntos junto al nombre del conjunto de valores.

2. Seleccione Establecer como activo (para este área de trabajo), Cambiar nombre o eliminar.

   

3. Haga clic en Guardar. Los cambios surten efecto solo después de guardarlos.

Para restablecer el valor de cada variable al valor predeterminado, seleccione el botón restablecer.

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.