Comparteix via


Integración de la biblioteca de variables con canalizaciones

La biblioteca de variables es un nuevo tipo de elemento en Microsoft Fabric. Mediante la biblioteca de variables, puede definir y administrar variables en el nivel de área de trabajo. Puede usar estas variables en varios elementos del área de trabajo, como canalizaciones, cuadernos, acceso directo para lakehouse, etc. Proporciona una manera unificada y centralizada de administrar configuraciones, lo que reduce la necesidad de valores codificados de forma rígida y simplifica los procesos de CI/CD. Es más fácil administrar configuraciones en distintos entornos.

Cómo usar la biblioteca de variables con canalizaciones

  1. Vaya al área de trabajo y cree un nuevo elemento.

    Captura de pantalla en la que se muestra dónde agregar un nuevo elemento en el área de trabajo de Fabric resaltada.

  2. Use el filtro para buscar la biblioteca de variables o desplácese hacia abajo hasta la sección Desarrollo de datos.

    Captura de pantalla que muestra el filtro de un nuevo elemento de biblioteca de variables.

  3. Seleccione Biblioteca de variables para crear una nueva biblioteca de variables. Escriba un nombre y seleccione Crear.

    Captura de pantalla que muestra un nuevo elemento de biblioteca de variables con un conjunto de nombres y el botón Crear resaltado.

  4. Después de crear la biblioteca de variables, se le lleva a la página principal. Seleccione + Nuevo para agregar una nueva variable.

    Captura de pantalla que muestra la página de inicio de un nuevo elemento de biblioteca de variables.

  5. Al agregar una nueva variable, puede configurar la variable y establecer el valor Name, Type y Default. También puede agregar Notas.

    Captura de pantalla que muestra las configuraciones que se van a establecer para una nueva variable.

  6. Agregue conjuntos de valores alternativos según sea necesario (por ejemplo, valores diferentes para distintos entornos de canalización de implementación). Después de establecer un nombre y seleccionar Crear, puede editar los valores de variable y elegir qué valor se establece para activar.

    Captura de pantalla en la que se resalta dónde agregar nuevos conjuntos de valores para una variable.

    Captura de pantalla que muestra cómo agregar un nombre para un nuevo conjunto de valores.

  7. Guarde los cambios cuando haya terminado.

    Captura de pantalla que muestra el botón Guardar resaltado en la esquina superior izquierda.

Uso las variables de la biblioteca Variable en la canalización

  1. Para usar una variable de biblioteca de variables en su canalización, cree una nueva canalización o acceda a una existente.

    Captura de pantalla que resalta el botón Crear nuevo elemento en la esquina superior izquierda y el elemento de canalización resaltado.

  2. En tu pipeline, crea una referencia a tu variable de la biblioteca de variables en el panel inferior.

    Captura de pantalla que resalta la pestaña Variables de biblioteca y el botón +Nuevo en el panel inferior del lienzo de la canalización.

  3. Seleccione + Nuevo. Se abre un elemento emergente que muestra todas las bibliotecas de variables. Use este selector para seleccionar la variable de biblioteca de variables y seleccione Aceptar.

    Captura de pantalla que muestra el botón +Nuevo en la pestaña Variable biblioteca resaltada.

    Captura de pantalla que muestra una variable biblioteca seleccionada en el selector de variables.

    Captura de pantalla que muestra la configuración establecida para una nueva referencia de variable de biblioteca.

  4. Después de agregar las referencias de variables de biblioteca, agregue las actividades de canalización. En la configuración de la actividad, seleccione Agregar contenido dinámico para la configuración que desea parametrizar.

    Recorte de pantalla en el que se muestra Agregar contenido dinámico resaltado en la configuración de una actividad de búsqueda.

  5. Se abre el generador de expresiones. Si no ve variables de biblioteca, seleccione los tres puntos junto a Funciones y seleccione Variables de biblioteca.

    Captura de pantalla que muestra los 3 puntos junto a Funciones en el generador de expresiones y la pestaña Variables de biblioteca resaltadas.

  6. Seleccione la referencia de variable library para agregar una nueva expresión al generador de expresiones. A continuación, seleccione Aceptar para agregar la expresión.

    Captura de pantalla que muestra una referencia de variable de biblioteca resaltada para agregarla al generador de expresiones.

    Captura de pantalla que muestra el conjunto de expresiones en el generador de expresiones.

  7. Verá que el contenido dinámico se agrega a la configuración de actividad.

    Captura de pantalla que muestra el conjunto de expresiones como contenido dinámico en la configuración de la actividad búsqueda.

  8. Para obtener una vista previa de los datos, seleccione Vista previa de los datos. Esta acción abre un nuevo panel que muestra el valor de la variable de biblioteca. Seleccione Aceptar para obtener una vista previa de los datos.

    Captura de pantalla que muestra la opción de vista previa de datos.

    Captura de pantalla que muestra el panel de datos de vista previa.

  9. Guarde y ejecute la canalización como de costumbre. Verá que el valor pasado es cualquier valor establecido como Activo en la biblioteca de variables.

    Recorte de pantalla en el que se muestra la configuración de Guardar y Ejecutar resaltada en el lienzo de la canalización.

Limitaciones conocidas

Las siguientes limitaciones conocidas se aplican a la integración de la biblioteca variable en canalizaciones en Data Factory en Microsoft Fabric:

  • La biblioteca variable admite tipos de datos Boolean, Datetime, Guid, Integer, Number y String. En la canalización, verá Boolean como tipo Bool, Datetime como Tipo de cadena, Guid como Tipo de cadena, Entero como Tipo int y String como Tipo de cadena. Los tipos numéricos no son compatibles en canalizaciones.
  • La parametrización de conexión externa se admite mediante la biblioteca de variables integrada en las canalizaciones. Sin embargo, debe buscar el GUID de la conexión desde Configuración | Administrar conexiones y puertas de enlace. Para encontrar el GUID de la conexión, seleccione Configuración junto al nombre de la conexión.