Tutorial: Uso de bibliotecas de variables para personalizar y compartir configuraciones de elementos

Este tutorial te muestra cómo usar contenido dinámico en pipelines de Fabric. Al crear un elemento de la biblioteca de variables y añadir variables a él, puedes automatizar la asignación de valores para distintas etapas de tu canalización de despliegue. En este tutorial, copiarás datos de un lakehouse a otro. A continuación, use la biblioteca de variables para establecer los valores de origen y destino de la actividad de copia.

En este tutorial, harás lo siguiente:

  • Cree una biblioteca de variables.
  • Agregue variables a la biblioteca.
  • Defina conjuntos de valores adicionales para las variables.
  • Consumir las variables en otro elemento del espacio de trabajo (una canalización).
  • Edite las variables en un repositorio de Git.
  • Cree una canalización de implementación e implemente la biblioteca de variables.
  • Cambie el conjunto de valores activo definido en la etapa de destino de la canalización de despliegue.
  • Mostrar que el valor de la variable cumple con el valor activo establecido en cada fase.

En el diagrama siguiente se muestra el diseño del área de trabajo de este tutorial.

Diagrama de un diseño de área de trabajo.

Prerrequisitos

Cree el área de trabajo Stage LHs, el almacén de lago SourceLH_Stage con datos de ejemplo y la canalización Pipeline_Stage

Primero, crear un área de trabajo y un lakehouse para usarlos como almacenamiento provisional inicial para los datos:

  1. Vaya a Power BI.

  2. En la barra lateral, seleccione Área de trabajo.

  3. Crear un área de trabajo. Llámalo Stage LHs.

    Captura de pantalla del botón para crear una nueva área de trabajo.

  4. Crear un lakehouse:

    1. En la parte superior del área de trabajo, seleccione Nuevo elemento.

    2. En Almacenar datos, seleccione Lakehouse.

      Captura de pantalla del mosaico para seleccionar un lakehouse como elemento nuevo.

    3. Escriba el nombre SourceLH_Stage y seleccione Crear.

  5. Cree una canalización:

    1. En lakehouse, seleccione Nueva canalización.

      Captura de pantalla del icono para crear una nueva canalización.

    2. Escriba el nombre Pipeline_Stage y seleccione Crear.

    3. En el asistente Copiar datos en Lakehouse, en la página Elegir origen de datos, seleccione Datos de ejemplo.

      Captura de pantalla de la página para elegir un origen de datos para copiar datos en un lago.

    4. Seleccione Días festivos públicos.

      Captura de pantalla que muestra la selección de datos de ejemplo de días festivos.

    5. Una vez que los datos de ejemplo terminen de cargarse, seleccione Siguiente.

    6. En la página Conectar al destino de datos , seleccione Siguiente.

      Captura de pantalla de los detalles de un destino de canalización.

    7. En la página Revisar y guardar , seleccione Guardar y ejecutar.

      Captura de pantalla de la página para guardar y ejecutar una canalización.

Cree los LH de origen en el espacio de trabajo Variables

Ahora, crea el área de trabajo en la que trabajarás y que usarás con tu biblioteca de variables:

  1. Vaya a Power BI.

  2. En la barra lateral, seleccione Área de trabajo.

  3. Crear un área de trabajo. Llámalo LHs de origen con variables.

Creación de los SourceLH_Dev, SourceLH_Test y SourceLH_Prod lakehouses

A continuación, cree los tres lakehouses para usar con la biblioteca de variables:

  1. Cree el primer lago:

    1. En la barra lateral, seleccione el área de trabajo Source LHs with Variables (LHs de origen con variables ).

    2. Seleccione Nuevo elemento.

    3. En Almacenar datos, seleccione Lakehouse.

    4. Escriba el nombre SourceLH_Dev y seleccione Crear.

  2. Cree el segundo lago siguiendo los pasos anteriores. Asígnele el nombre SourceLH_Test.

  3. Cree el tercer lago siguiendo los pasos anteriores. Asígnele el nombre de SourceLH_Prod.

  4. En la barra lateral, seleccione el espacio de trabajo Source LHs with Variables y asegúrese de que contiene todos los lakehouses recién creados.

Obtención de los identificadores de área de trabajo y los identificadores de objeto para lakehouses

En estos pasos, obtendrá los identificadores únicos que se usarán en la biblioteca de variables:

  1. En Power BI, en la barra lateral, seleccione el área de trabajo Stage LHs.

  2. En el área de trabajo, seleccione el SourceLH_Stage lakehouse.

  3. Copie el identificador del área de trabajo y el identificador del objeto lakehouse en la dirección URL.

    Captura de pantalla que muestra cómo obtener el identificador del área de trabajo y el identificador del objeto lakehouse.

  4. Repita los pasos anteriores para el SourceLH_Dev y SourceLH_Test lakehouses en el área de trabajo LHs de origen con variables .

Creación de una biblioteca de variables con variables

Ahora, cree la biblioteca de variables:

  1. En el área de trabajo LHs de origen con variables , seleccione Nuevo elemento.

  2. En Desarrollar datos, seleccione **Biblioteca de variables **.

    Captura de pantalla que muestra el icono para crear una biblioteca de variables.

  3. Asigne un nombre a las variables WS de la biblioteca y, a continuación, seleccione Crear.

  4. Seleccione Nueva variable.

    Captura de pantalla que muestra el botón para seleccionar una nueva variable.

  5. Cree las siguientes variables:

    Nombre Tipo Conjunto de valores predeterminado
    Source_LH Cuerda <GUID de SourceLH_Stage lakehouse>
    Source_WSID Cuerda <GUID del área de trabajo de SourceLH_Stage>
    Destination_LH Cuerda <GUID de SourceLH_Dev lakehouse>
    Destination_WSID Cuerda <GUID del área de trabajo de SourceLH_Dev>
    SourceTable_Name Cuerda Processed
    DestinationTable_Name Cuerda DevCopiedData

    Captura de pantalla del conjunto predeterminado terminado para la biblioteca de variables.

  6. Haga clic en Guardar.

Creación de conjuntos de valores alternativos

En estos pasos, agregará los conjuntos de valores alternativos a la biblioteca de variables:

  1. Cree el primer conjunto de valores:

    1. En la biblioteca de variables de WS Variables , seleccione Agregar valor establecido.

    2. Escriba Test VS en el campo Nombre y, a continuación, seleccione Crear.

    3. Cree las siguientes variables:

      Nombre Tipo Conjunto de valores predeterminado
      Source_LH Cuerda <GUID de SourceLH_Dev lakehouse>
      Source_WSID Cuerda <GUID del área de trabajo de SourceLH_Dev>
      Destination_LH Cuerda <GUID de SourceLH_Test lakehouse>
      Destination_WSID Cuerda <GUID del área de trabajo de SourceLH_Test>
      SourceTable_Name Cuerda DevCopiedData
      DestinationTable_Name Cuerda TestCopiedData

    4. Seleccione Guardar>Aceptar.

  2. Cree el segundo conjunto de valores:

    1. Seleccione Agregar conjunto de valores.

    2. Escriba Vs prod como nombre y, a continuación, seleccione Crear.

    3. Cree las siguientes variables:

      Nombre Tipo Conjunto de valores predeterminado
      Source_LH Cuerda <GUID de SourceLH_Test lakehouse>
      Source_WSID Cuerda <GUID del área de trabajo de SourceLH_Test>
      Destination_LH Cuerda <GUID de SourceLH_Prod lakehouse>
      Destination_WSID Cuerda <GUID del área de trabajo de SourceLH_Prod>
      SourceTable_Name Cuerda TestCopiedData
      DestinationTable_Name Cuerda ProdCopiedData

      Captura de pantalla de los valores alternativos terminados en una biblioteca de variables.

    4. Seleccione Guardar>Aceptar.

Creación de la canalización de Pipeline_Deploy y declaración de variables

En estos pasos, creará la canalización y declarará las variables:

  1. En el área de trabajo LHs de origen con variables , seleccione Nuevo elemento.

  2. En Obtener datos, seleccione Canalización.

    Captura de pantalla del icono de una canalización.

  3. Escriba el nombre Pipeline_Deploy y seleccione Crear.

  4. Seleccione Copiar datos>Agregar al lienzo.

    Captura de pantalla de las selecciones de menú para agregar datos de copia a un lienzo.

  5. Seleccione el lienzo para que el foco esté desactivado Copiar datos.

  6. Seleccione **Variables de biblioteca **.

    Captura de pantalla de la pestaña para las variables de biblioteca.

  7. Seleccione Nuevo y agregue las siguientes variables:

    Nombre Biblioteca Nombre de la variable Tipo
    SourceLH Variables de WS Source_LH Cuerda
    SourceWSID Variables de WS Source_WSID Cuerda
    DestinationLH Variables de WS Destination_LH Cuerda
    DestinationWSID Variables de WS Destination_WSID Cuerda
    SourceTableName Variables de WS SourceTable_Name Cuerda
    DestinationTableName Variables de WS DestinationTable_Name Cuerda

    Captura de pantalla de la adición de variables a una canalización.

  8. Haga clic en Guardar.

Configurar la conexión de origen de la canalización Pipeline_Deploy

En estos pasos, configurará la conexión de origen para la canalización:

  1. En el área de trabajo LHs de origen con variables , vaya a Pipeline_Deploy.

  2. En el lienzo, seleccione Copiar datos para que el foco esté en Copiar datos.

  3. Seleccione Origen.

  4. Configurar SourceLH:

    1. En Conexión>de origen, seleccione Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione SourceLH. Rellena el cuadro con @pipeline().libraryVariables.SourceLH. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un origen de conexión.

  5. Configurar SourceWSID:

    1. En Origen>Id. del área de trabajo, seleccione Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione SourceWSID. Rellena el cuadro con @pipeline().libraryVariables.SourceWSID. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un origen del área de trabajo.

  6. Configurar SourceTableName:

    1. En Origen>Tabla, seleccione Especificar manualmente, seleccione Nombre de tabla y después seleccione Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione SourceTableName. Rellena el cuadro con @pipeline().libraryVariables.SourceTableName. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un nombre de tabla.

  7. Ahora que la conexión de origen está configurada, puede probarla. Seleccione Vista previa de los datos y, a continuación, seleccione Aceptar en el panel flotante. Una vez rellenados los datos, puede cerrar la vista previa de los datos.

    Captura de pantalla de la vista previa de datos para una conexión de origen.

Configuración de la conexión de destino para la canalización de Pipeline_Deploy

En estos pasos, configurará la conexión de destino para la canalización:

  1. En el área de trabajo LHs de origen con variables , vaya a Pipeline_Deploy.

  2. En el lienzo, seleccione Copiar datos para que el foco esté en Copiar datos.

  3. Seleccione Destino.

  4. Configurar SourceLH:

    1. En Conexión de destino>, seleccione Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione SourceLH. Rellena el cuadro con @pipeline().libraryVariables.DestinationLH. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un destino de conexión.

  5. Configurar DestinationWSID:

    1. En Destino>Id. del área de trabajo, seleccione Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione DestinationWSID. Rellena el cuadro con @pipeline().libraryVariables.DestinationWSID. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un destino del área de trabajo.

  6. Configurar DestinationTableName:

    1. En Tabla de destino>, seleccione Entrar manualmente, seleccione Nombre de tabla y, después, Agregar contenido dinámico.

    2. Seleccione los puntos suspensivos (...) y, a continuación, seleccione **Variables de biblioteca **.

    3. Seleccione DestinationTableName. Rellena el cuadro con @pipeline().libraryVariables.DestinationTableName. Selecciona Aceptar.

      Captura de pantalla del panel para agregar contenido dinámico para un nombre de tabla de destino.

  7. Ahora que la conexión de destino está configurada, guarde la canalización y seleccione Ejecutar. Confirme que se ejecuta correctamente.

    Captura de pantalla de una ejecución de canalización.

Crear la canalización de despliegue

Ahora, cree la canalización de despliegue:

  1. En el espacio de trabajo LHs de origen con variables, seleccione Crear canalización de implementación.

  2. Asigne un nombre al Deployment_Pipeline_Var de canalización y, a continuación, seleccione Siguiente.

    Captura de pantalla del panel para asignar un nombre a una nueva canalización de implementación.

  3. En la canalización de implementación, seleccione Crear y continuar.

    Captura de pantalla que muestra el botón para crear una canalización de implementación.

  4. Para la fase de desarrollo :

    1. En la lista desplegable, seleccione LH de origen con variables como espacio de trabajo. A continuación, seleccione la marca de verificación Asignar.

      Captura de pantalla de la selección del área de trabajo para una nueva canalización de implementación.

    2. Seleccione Continuar. La fase debe rellenarse ahora con los elementos del área de trabajo.

      Captura de pantalla de la fase de desarrollo de una canalización de despliegue.

  5. Para la fase de prueba :

    1. Active la casilla de la parte superior para seleccionar todos los elementos. A continuación, desactive la casilla del SourceLH_Dev lakehouse.

    2. Seleccione el botón Implementar . Seleccione Implementar de nuevo. La fase de prueba ahora debe rellenarse.

      Captura de pantalla de la parte de prueba de una nueva canalización de despliegue.

  6. Para la fase de producción :

    1. Active la casilla de la parte superior para seleccionar todos los elementos. A continuación, desactive la casilla del SourceLH_Test lakehouse.

    2. Seleccione el botón Implementar . Seleccione Implementar de nuevo. La etapa Producción debería estar ahora rellenada.

      Captura de pantalla de la fase de producción de una nueva canalización de despliegue.

Establecer el conjunto activo de la biblioteca de variables para cada fase

En estos pasos, configura el conjunto activo para cada fase del canal de implementación:

  1. Configure el conjunto activo para la fase de prueba :

    1. En la barra lateral, seleccione el pipeline Deployment_Pipeline_Var.

    2. Seleccione la fase Prueba .

      Captura de pantalla de la fase de prueba.

    3. Seleccione Variables de WS.

    4. Seleccione los puntos suspensivos (...) y, a continuación, seleccione Establecer como activo. Seleccione el botón Establecer como activo .

      Captura de pantalla de una biblioteca de variables, con selecciones para establecer la fase de prueba como activa.

      El conjunto activo ahora está configurado.

      Captura de pantalla de un conjunto activo configurado en una canalización de implementación.

    5. Seleccione Guardar>Aceptar.

  2. Configure el conjunto activo para la fase Prod :

    1. En la barra lateral, seleccione el pipeline Deployment_Pipeline_Var.

    2. Seleccione la fase Prod .

    3. Seleccione Variables de WS.

    4. Seleccione los puntos suspensivos (...) y, a continuación, seleccione Establecer como activo. Seleccione el botón Establecer como activo .

    5. Seleccione Guardar>Aceptar.

Comprobación y prueba de la biblioteca de variables

Ahora que configuró la biblioteca de variables y configuró todos los conjuntos activos para cada fase de la canalización de implementación, puede comprobarlos:

  1. Compruebe la SourceLHs_Dev lakehouse:

    1. En el área de trabajo Source LHs with Variables, seleccione el SourceLHs_Dev lakehouse.

    2. Cambie la conexión de Lakehouse al punto de conexión de SQL Analytics.

    3. En el explorador, expanda Esquemas>dbo>Tablas.

    4. Confirme que aparece la tabla DevCopiedData .

      Captura de pantalla del área de las tablas en el explorador.

  2. Cambie al SourceLHs_Test lakehouse y repita los pasos anteriores.

    La tabla TestCopiedData no debería aparecer porque aún no ha ejecutado la canalización con el conjunto activo Test VS .

  3. Cambie al SourceLHs_Prod lakehouse y repita los pasos anteriores.

    La tabla ProdCopiedData no debería aparecer porque aún no ha ejecutado la canalización con el conjunto activo de VS prod .

  4. Compruebe la fase Test de la canalización Deployment_Pipeline_Var:

    1. Cambie a la canalización Deployment_Pipeline_Var y seleccione la fase Test.

    2. Seleccione el flujo Pipeline_Deploy.

    3. Seleccione Ejecutar. Este proceso debe finalizar correctamente.

  5. Vuelva a comprobar el SourceLHs_Test lakehouse:

    1. Cambie al SourceLHs_Test lakehouse.

    2. Cambie la conexión de Lakehouse al punto de conexión de SQL Analytics.

    3. En el explorador, expanda Esquemas>dbo>Tablas.

    4. Confirme que aparece la tabla TestCopiedData .

      Captura de pantalla del área para tablas y una vista previa de datos en el explorador.

  6. Compruebe la fase Producción del pipeline Deployment_Pipeline_Var:

    1. Cambie a la canalización Deployment_Pipeline_Var y seleccione la fase Producción.

    2. Seleccione el flujo Pipeline_Deploy.

    3. Seleccione Ejecutar. Este proceso debe finalizar correctamente.

  7. Vuelva a revisar el SourceLHs_Prod lakehouse:

    1. Cambie al SourceLHs_Prod lakehouse.

    2. Cambie la conexión de Lakehouse al punto de conexión de SQL Analytics.

    3. En el explorador, expanda Esquemas>dbo>Tablas.

    4. Confirme que aparece la tabla ProdCopiedData .

Personalización de los valores de variable en Git (opcional)

Para ver cómo se representa la biblioteca de variables en Git o para editar las variables desde un repositorio de Git:

  1. En el área de trabajo, seleccione Control de código fuente y conecte el área de trabajo a un repositorio de Git.

  2. En el panel Control de código fuente , seleccione Confirmar para insertar el contenido del área de trabajo en el repositorio de Git.

    El repositorio de Git tiene una carpeta para cada elemento del área de trabajo. Carpeta denominada variables WS. VariableLibrary representa el elemento de biblioteca de variables. Para obtener más información sobre el contenido de esta carpeta, consulte Biblioteca de variables de CI/CD.

  3. Compare los archivos ProdVS.json y TestVS.json de la carpeta valueSets . Confirme que la overrides variable está establecida en los distintos valores. Puede editar estos valores directamente en la interfaz de usuario o editando este archivo en Git y actualizándolo al área de trabajo.

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Test VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "4fe228d3-a363-4b7f-a5d4-fae9d2abca43"
  },
  {
   "name": "DestinationTableName",
   "value": "TestCopiedData"
  }
 ]
}

    {
 "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/VariablesLibrary/definition/valueSets/1.0.0/schema.json",
 "valueSetName": "Prod VS",
 "overrides": [
  {
   "name": "Source_LH",
   "value": "c0f13027-9bf4-4e8c-8f57-ec5c18c8656b"
  },
  {
   "name": "DestinationTableName",
   "value": "ProdCopiedData"
  }
 ]
}

Contenido relacionado

  • Last updated on