Compartir a través de

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

En este tutorial se muestra cómo usar contenido dinámico en canalizaciones de Microsoft Fabric. Al crear un elemento de biblioteca de variables y agregar variables a él, puede automatizar los valores de varias fases de la canalización de implementación. En este tutorial, copiará datos de una instancia de Lakehouse a otra. 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 valor activo establecido en la fase de destino de la canalización de implementación.
  • 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

Creación del área de trabajo stage LHs, SourceLH_Stage lakehouse con datos de ejemplo y canalización de Pipeline_Stage

En primer lugar, cree un área de trabajo y lakehouse para usarla como datos de ensayo iniciales:

  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. Cree una instancia de LakeHouse:

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

    2. En Almacenar datos, seleccione Lakehouse.

      Captura de pantalla del icono para seleccionar una instancia de Lakehouse como un nuevo elemento.

    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 para 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 de la selección de datos de ejemplo días festivos públicos.

    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.

Creación de los LH de origen con el área de trabajo Variables

Ahora, cree el área de trabajo de la que trabajará y usará con la 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 almacenes de lago que se usarán 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ígnelo el nombre SourceLH_Test.

  3. Cree el tercer lago siguiendo los pasos anteriores. Asígne un nombre SourceLH_Prod.

  4. En la barra lateral, seleccione el área de trabajo Source LHs with Variables (LHs de origen con variables ) y asegúrese de que contiene todas las instancias de Lakehouse recién creadas.

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 (Fase de 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 (Probar VS ) 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_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>acuerdo.

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

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.

Configuración de la conexión de origen para la canalización de 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 Id>. del área de trabajo de origen, 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. EnTabla de> origen, 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 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 control 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. EnDestination Workspace ID (Id. del área de trabajo de >), seleccione Add dynamic content (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.

Creación de la canalización de implementación

Ahora, cree la canalización de implementación:

  1. En el área 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 LHs de origen con variables para el área 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 parte de desarrollo de una canalización de implementación.

  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 implementación.

  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. Ahora se debe rellenar la fase de producción .

      Captura de pantalla de la parte de producción de una nueva canalización de implementación.

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

En estos pasos, configurará el conjunto activo para cada fase de la canalización de implementación:

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

    1. En la barra lateral, seleccione la canalización de 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>acuerdo.

  2. Configure el conjunto activo para la fase Prod :

    1. En la barra lateral, seleccione la canalización de 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>acuerdo.

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 (LHs de origen con 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 de prueba de la canalización de Deployment_Pipeline_Var :

    1. Cambie a la canalización de Deployment_Pipeline_Var y seleccione la fase De prueba .

    2. Seleccione la canalización de 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 de producción de la canalización de Deployment_Pipeline_Var :

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

    2. Seleccione la canalización de Pipeline_Deploy .

    3. Seleccione Ejecutar. Este proceso debe finalizar correctamente.

  7. Vuelva a comprobar 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, vea Ci/CD de la biblioteca de variables.

  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