Compartir a través de


Integración de la biblioteca de variables con canalizaciones

La Biblioteca de Variables es un nuevo tipo de elemento en Microsoft Fabric que permite a los usuarios definir y administrar variables al nivel del área de trabajo, para que pronto puedan utilizarse en varios elementos del área de trabajo, como canalizaciones, cuadernos, acceso directo a lakehouse y mucho más. 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, lo que facilita la administración de 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. Elija un nombre y presione 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. Una vez creada la biblioteca de variables, se le lleva a la página principal. Haga clic en + 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. Una vez que agregue una nueva variable, puede configurarla y establecer el Nombre, el Tipo y el valor Predeterminado. 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 hacer clic en Crear, puede editar los valores de variable y elegir el valor establecido 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 una vez que 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 utilizar una variable de la biblioteca de variables en tu canalización, crea una nueva canalización o accede a una canalización 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 flujo de trabajo, debes crear una referencia a la 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. Después de hacer clic en + Nuevo, se abrirá un elemento emergente que muestra todas las bibliotecas de variables. Puede usar este selector para seleccionar la variable de biblioteca de variables y hacer clic en 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. Una vez que haya agregado las referencias de variables de la biblioteca, agregue las actividades de la canalización. En la configuración de la actividad, haga clic en 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, haga clic en los 3 puntos situados 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. Haga clic en la referencia de variable library para agregar una nueva expresión al generador de expresiones. A continuación, haga clic en 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. Ahora 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, haga clic en Vista previa de los datos. Se abrirá un nuevo panel que muestra el valor de la variable de biblioteca. Haga clic en 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 String, Guid como tipo String, Integer como tipo Int, y String como tipo String. Los tipos de números no se admiten en canalizaciones.
  • La parametrización de conexiones externas se admite con la biblioteca de variables integrada con las canalizaciones. Sin embargo, debe buscar el GUID de la conexión en Configuración | Administrar conexiones y puertas de enlace. Allí encontrará el GUID de la conexión seleccionando Configuración junto al nombre de la conexión.