Condividi tramite

Esercitazione: Usare librerie di variabili per personalizzare e condividere le configurazioni degli elementi

Questa esercitazione illustra come usare il contenuto dinamico nelle pipeline di Microsoft Fabric. Quando si crea un elemento della libreria di variabili e si aggiungono variabili, è possibile automatizzare i valori per varie fasi della pipeline di distribuzione. In questa esercitazione si copiano dati da una lakehouse a un'altra. Usare quindi la libreria di variabili per impostare i valori di origine e di destinazione per l'attività di copia.

In questa esercitazione, farai:

  • Creare una libreria di variabili.
  • Aggiungere variabili alla libreria.
  • Definire set di valori aggiuntivi per le variabili.
  • Utilizzare le variabili in un altro elemento nell'ambiente di lavoro (una pipeline).
  • Modificare le variabili in un repository Git.
  • Creare una pipeline di distribuzione e distribuire la libreria di variabili.
  • Modificare il valore attivo impostato nella fase di destinazione della pipeline di distribuzione.
  • Mostra che il valore della variabile è conforme al valore attivo impostato in ogni fase.

Il diagramma seguente illustra il layout dell'area di lavoro per questa esercitazione.

Diagramma di un layout dell'area di lavoro.

Prerequisiti

Creare l'area di lavoro Stage LHs, SourceLH_Stage lakehouse con dati di esempio e Pipeline_Stage pipeline

Creare prima di tutto un'area di lavoro e una lakehouse da usare come dati di staging iniziale:

  1. Passare a Power BI.

  2. Sulla barra laterale selezionare Area di lavoro.

  3. Creare un'area di lavoro. Chiamalo Stage LHs.

    Screenshot del pulsante per la creazione di una nuova area di lavoro.

  4. Creare una lakehouse:

    1. Nella parte superiore dell'area di lavoro selezionare Nuovo elemento.

    2. In Archivia dati selezionare Lakehouse.

      Screenshot del riquadro per la selezione di una lakehouse come nuovo elemento.

    3. Immettere il nome SourceLH_Stage e quindi selezionare Crea.

  5. Creare una pipeline:

    1. Nel lakehouse, selezionare Nuova pipeline.

      Screenshot del riquadro per la creazione di una nuova pipeline.

    2. Immettere il nome Pipeline_Stage e quindi selezionare Crea.

    3. Nella procedura guidata Copia dati in Lakehouse selezionare Dati di esempio nella pagina Scegli origine dati.

      Screenshot della pagina per la scelta di un'origine dati per la copia dei dati in un lakehouse.

    4. Selezionare Festività pubbliche.

      Screenshot della selezione dei dati di esempio festività pubbliche.

    5. Al termine del caricamento dei dati di esempio, selezionare Avanti.

    6. Nella pagina Connetti alla destinazione dati selezionare Avanti.

      Screenshot dei dettagli per una destinazione della pipeline.

    7. Nella pagina Rivedi e salva selezionare Salva + Esegui.

      Screenshot della pagina per il salvataggio e l'esecuzione di una pipeline.

Creare gli LH di origine con l'area di lavoro Variabili

A questo punto, creare l'area di lavoro da usare e usare con la libreria di variabili:

  1. Passare a Power BI.

  2. Sulla barra laterale selezionare Area di lavoro.

  3. Creare un'area di lavoro. Chiamalo Source LHs con Variables.

Creare SourceLH_Dev, SourceLH_Test e SourceLH_Prod lakehouse

Creare quindi i tre lakehouse da usare con la libreria di variabili:

  1. Creare la prima lakehouse:

    1. Sulla barra laterale selezionare LH di origine con l'area di lavoro Variabili.

    2. Selezionare Nuovo elemento.

    3. In Archivia dati selezionare Lakehouse.

    4. Immettere il nome SourceLH_Dev e quindi selezionare Crea.

  2. Creare il secondo lakehouse seguendo i passaggi precedenti. Denominarlo SourceLH_Test.

  3. Creare la terza lakehouse seguendo i passaggi precedenti. Denominarlo SourceLH_Prod.

  4. Sulla barra laterale selezionare l'area di lavoro Source LHs with Variables (LH di origine con variabili ) e assicurarsi che contenga tutti i lakehouse appena creati.

Ottenere gli ID e gli ID oggetto dell'area di lavoro per i lakehouse

In questi passaggi si ottengono gli identificatori univoci da usare nella libreria di variabili:

  1. Nella barra laterale di Power BI selezionare l'area di lavoro Stage LHs .

  2. Nell'area di lavoro selezionare il SourceLH_Stage lakehouse.

  3. Copiare l'ID dell'area di lavoro e l'ID oggetto lakehouse nell'URL.

    Screenshot che mostra come ottenere l'identificatore dell'area di lavoro e l'identificatore dell'oggetto lakehouse.

  4. Ripetere i passaggi precedenti per le SourceLH_Dev e le SourceLH_Test lakehouse nell'area di lavoro LH di origine con variabili .

Creare una libreria di variabili con variabili

Creare ora la libreria di variabili:

  1. Nell'area di lavoro LH di origine con variabili selezionare Nuovo elemento.

  2. In Sviluppare dati selezionare **Libreria di variabili **.

    Screenshot che mostra il riquadro per la creazione di una libreria di variabili.

  3. Denominare le variabili WS della libreria e quindi selezionare Crea.

  4. Selezionare Nuova variabile.

    Screenshot che mostra il pulsante per la selezione di una nuova variabile.

  5. Creare le variabili seguenti:

    Nome TIPO Set di valori predefinito
    Source_LH Stringa <GUID di SourceLH_Stage lakehouse>
    Source_WSID Stringa <GUID dell'area di lavoro di SourceLH_Stage>
    Destination_LH Stringa <GUID di SourceLH_Dev lakehouse>
    Destination_WSID Stringa <GUID dell'area di lavoro di SourceLH_Dev>
    SourceTable_Name Stringa Processed
    DestinationTable_Name Stringa DevCopiedData

    Screenshot del set predefinito completato per la libreria di variabili.

  6. Seleziona Salva.

Creare set di valori alternativi

In questi passaggi si aggiungono i set di valori alternativi alla libreria di variabili:

  1. Creare il primo set di valori:

    1. Nella libreria di variabili Variabili WS selezionare Aggiungi set di valori.

    2. Immettere Test VS come nome e quindi selezionare Crea.

    3. Creare le variabili seguenti:

      Nome TIPO Set di valori predefinito
      Source_LH Stringa <GUID di SourceLH_Dev lakehouse>
      Source_WSID Stringa <GUID dell'area di lavoro di SourceLH_Dev>
      Destination_LH Stringa <GUID di SourceLH_Test lakehouse>
      Destination_WSID Stringa <GUID dell'area di lavoro di SourceLH_Test>
      SourceTable_Name Stringa DevCopiedData
      DestinationTable_Name Stringa TestCopiedData

    4. Selezionare Salva>accetto.

  2. Creare il secondo set di valori:

    1. Selezionare Aggiungi set di valori.

    2. Immettere Prod VS come nome e quindi selezionare Crea.

    3. Creare le variabili seguenti:

      Nome TIPO Set di valori predefinito
      Source_LH Stringa <GUID di SourceLH_Test lakehouse>
      Source_WSID Stringa <GUID dell'area di lavoro di SourceLH_Test>
      Destination_LH Stringa <GUID di SourceLH_Prod lakehouse>
      Destination_WSID Stringa <GUID dell'area di lavoro di SourceLH_Prod>
      SourceTable_Name Stringa TestCopiedData
      DestinationTable_Name Stringa ProdCopiedData

      Screenshot dei valori alternativi completati in una libreria di variabili.

    4. Selezionare Salva>accetto.

Creare la pipeline di Pipeline_Deploy e dichiarare le variabili

In questi passaggi si crea la pipeline e si dichiarano le variabili:

  1. Nell'area di lavoro LH di origine con variabili selezionare Nuovo elemento.

  2. In Recupera dati selezionare Pipeline.

    Screenshot del riquadro di una pipeline.

  3. Immettere il nome Pipeline_Deploy e quindi selezionare Crea.

  4. Selezionare Copia dati>Aggiungi all'area di disegno.

    Screenshot delle selezioni di menu per l'aggiunta di dati di copia a un'area di disegno.

  5. Selezionare l'area di disegno in modo che lo stato attivo sia disattivato Copia dati.

  6. Selezionare **Variabili di libreria **.

    Screenshot della scheda per le variabili della libreria.

  7. Selezionare Nuovo e quindi aggiungere le variabili seguenti:

    Nome Libreria Nome variabile TIPO
    SourceLH Variabili WS Source_LH Stringa
    SourceWSID Variabili WS Source_WSID Stringa
    DestinationLH Variabili WS Destination_LH Stringa
    DestinationWSID Variabili WS Destination_WSID Stringa
    SourceTableName Variabili WS SourceTable_Name Stringa
    DestinationTableName Variabili WS DestinationTable_Name Stringa

    Screenshot dell'aggiunta di variabili a una pipeline.

  8. Seleziona Salva.

Configurare la connessione di origine per la pipeline di Pipeline_Deploy

In questi passaggi viene configurata la connessione di origine per la pipeline:

  1. Nell'area di lavoro LH di origine con variabili passare a Pipeline_Deploy.

  2. Nell'area di disegno selezionare Copia dati in modo che lo stato attivo sia Copia dati.

  3. Selezionare Origine.

  4. Configurare SourceLH:

    1. In Connessione origine> selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare SourceLH. Popola la casella con @pipeline().libraryVariables.SourceLH. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per un'origine di connessione.

  5. Configurare SourceWSID:

    1. In ID>area di lavoro di origine selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare SourceWSID. Popola la casella con @pipeline().libraryVariables.SourceWSID. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per un'origine dell'area di lavoro.

  6. Configurare SourceTableName:

    1. InTabella> origine selezionare Invio manualmente, selezionare Nome tabella e quindi selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare SourceTableName. Popola la casella con @pipeline().libraryVariables.SourceTableName. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per un nome di tabella.

  7. Ora che la connessione di origine è configurata, è possibile testarla. Selezionare Anteprima dati e quindi fare clic su OK nel riquadro a comparsa. Dopo aver popolato i dati, è possibile chiudere l'anteprima dei dati.

    Screenshot dell'anteprima dei dati per una connessione di origine.

Configurare la connessione di destinazione per la pipeline di Pipeline_Deploy

In questi passaggi viene configurata la connessione di destinazione per la pipeline:

  1. Nell'area di lavoro LH di origine con variabili passare a Pipeline_Deploy.

  2. Nell'area di disegno selezionare Copia dati in modo che lo stato attivo sia Copia dati.

  3. Selezionare Destinazione.

  4. Configurare SourceLH:

    1. In Connessione di destinazione> selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare SourceLH. Popola la casella con @pipeline().libraryVariables.DestinationLH. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per una destinazione di connessione.

  5. Configurare DestinationWSID:

    1. InID area di lavoro di> selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare DestinationWSID. Popola la casella con @pipeline().libraryVariables.DestinationWSID. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per una destinazione dell'area di lavoro.

  6. Configurare DestinationTableName:

    1. In Tabella di destinazione> selezionare Immettere manualmente, selezionare Nome tabella e quindi selezionare Aggiungi contenuto dinamico.

    2. Seleziona i puntini di sospensione (...), quindi seleziona **Variabili della libreria**.

    3. Selezionare DestinationTableName. Popola la casella con @pipeline().libraryVariables.DestinationTableName. Seleziona OK.

      Screenshot del riquadro per l'aggiunta di contenuto dinamico per un nome di tabella di destinazione.

  7. Dopo aver configurato la connessione di destinazione, salvare la pipeline e selezionare Esegui. Verificare che venga eseguito correttamente.

    Screenshot di un'esecuzione della pipeline.

Creare la pipeline di distribuzione

Creare ora la pipeline di distribuzione:

  1. Nell'area di lavoro LH di origine con variabili selezionare Crea pipeline di distribuzione.

  2. Assegnare alla pipeline il nome Deployment_Pipeline_Var e quindi selezionare Avanti.

    Screenshot del riquadro per la denominazione di una nuova pipeline di distribuzione.

  3. Nella pipeline di distribuzione selezionare Crea e continua.

    Screenshot che mostra il pulsante per la creazione di una pipeline di distribuzione.

  4. Per la fase di sviluppo :

    1. Nell'elenco a discesa selezionare LH di origine con variabili per l'area di lavoro. Selezionare quindi il segno di spunta Assegna .

      Screenshot della selezione dell'area di lavoro per una nuova pipeline di distribuzione.

    2. Seleziona Continua. La fase dovrebbe ora essere popolata con gli elementi dell'area di lavoro.

      Screenshot della parte di sviluppo di una pipeline di distribuzione.

  5. Per la fase test :

    1. Selezionare la casella di controllo nella parte superiore per selezionare tutti gli elementi. Deselezionare quindi la casella di controllo per la SourceLH_Dev lakehouse.

    2. Selezionare il pulsante Distribuisci . Selezionare di nuovo Distribuisci . La fase test dovrebbe ora essere popolata.

      Screenshot della parte di test di una nuova pipeline di distribuzione.

  6. Per la fase Produzione :

    1. Selezionare la casella di controllo nella parte superiore per selezionare tutti gli elementi. Deselezionare quindi la casella di controllo per il SourceLH_Test lakehouse.

    2. Selezionare il pulsante Distribuisci . Selezionare di nuovo Distribuisci . La fase Produzione dovrebbe ora essere popolata.

      Screenshot della parte di produzione di una nuova pipeline di distribuzione.

Impostare il set attivo della libreria di variabili per ogni fase

In questi passaggi viene configurato il set attivo per ogni fase della pipeline di distribuzione:

  1. Configurare il set attivo per la fase test :

    1. Sulla barra laterale selezionare la pipeline Deployment_Pipeline_Var .

    2. Selezionare la fase Test .

      Screenshot della fase di test.

    3. Selezionare Variabili WS.

    4. Selezionare i puntini di sospensione (...) e quindi selezionare Imposta come attivo. Selezionare il pulsante Imposta come attivo .

      Screenshot di una libreria di variabili, con le selezioni per impostare la fase di test come attiva.

      Il set attivo è ora configurato.

      Screenshot di un set attivo configurato in una pipeline di distribuzione.

    5. Selezionare Salva>accetto.

  2. Configurare il set attivo per la fase Prod :

    1. Sulla barra laterale selezionare la pipeline Deployment_Pipeline_Var .

    2. Selezionare la fase Prod .

    3. Selezionare Variabili WS.

    4. Selezionare i puntini di sospensione (...) e quindi selezionare Imposta come attivo. Selezionare il pulsante Imposta come attivo .

    5. Selezionare Salva>accetto.

Verificare e testare la libreria di variabili

Dopo aver configurato la libreria di variabili e configurato tutti i set attivi per ogni fase della pipeline di distribuzione, è possibile verificarli:

  1. Controllare la SourceLHs_Dev lakehouse:

    1. Nell'area di lavoro Source LHs with Variables (LH di origine con variabili ) selezionare il SourceLHs_Dev lakehouse.

    2. Modificare la connessione da Lakehouseall'endpoint di analisi SQL.

    3. In Esplora risorse espandere Schemi>tabelle>.

    4. Verificare che venga visualizzata la tabella DevCopiedData .

      Screenshot dell'area per le tabelle in Esplora risorse.

  2. Passare alla SourceLHs_Test lakehouse e ripetere i passaggi precedenti.

    La tabella TestCopiedData non dovrebbe essere visualizzata perché non è ancora stata eseguita la pipeline con il set attivo test di Visual Studio .

  3. Passare alla SourceLHs_Prod lakehouse e ripetere i passaggi precedenti.

    La tabella ProdCopiedData non dovrebbe essere visualizzata perché non è ancora stata eseguita la pipeline con il set attivo prod VS .

  4. Controllare la fase test della pipeline di Deployment_Pipeline_Var :

    1. Passare alla pipeline Deployment_Pipeline_Var e selezionare la fase Test .

    2. Selezionare la pipeline Pipeline_Deploy .

    3. Selezionare Esegui. Questo processo dovrebbe essere completato correttamente.

  5. Controllare di nuovo la SourceLHs_Test lakehouse:

    1. Passare alla SourceLHs_Test lakehouse.

    2. Modificare la connessione da Lakehouseall'endpoint di analisi SQL.

    3. In Esplora risorse espandere Schemi>tabelle>.

    4. Verificare che venga visualizzata la tabella TestCopiedData .

      Screenshot dell'area per le tabelle e un'anteprima dei dati in Esplora risorse.

  6. Controllare la fase di produzione della pipeline di Deployment_Pipeline_Var :

    1. Passare alla pipeline di Deployment_Pipeline_Var e selezionare la fase Produzione .

    2. Selezionare la pipeline Pipeline_Deploy .

    3. Selezionare Esegui. Questo processo dovrebbe essere completato correttamente.

  7. Controllare di nuovo il SourceLHs_Prod lakehouse:

    1. Passare alla SourceLHs_Prod lakehouse.

    2. Modificare la connessione da Lakehouseall'endpoint di analisi SQL.

    3. In Esplora risorse espandere Schemi>tabelle>.

    4. Verificare che venga visualizzata la tabella ProdCopiedData .

Personalizzare i valori delle variabili in Git (facoltativo)

Per vedere come la libreria di variabili è rappresentata in Git o per modificare le variabili da un repository Git:

  1. Nell'area di lavoro selezionare Controllo del codice sorgente e connettere l'area di lavoro a un repository Git.

  2. Nel riquadro Controllo del codice sorgente selezionare Commit per eseguire il push del contenuto dell'area di lavoro nel repository Git.

    Il repository Git ha una cartella per ogni elemento nell'area di lavoro. Cartella denominata variabili WS. VariableLibrary rappresenta l'elemento della libreria di variabili. Per altre informazioni sul contenuto di questa cartella, vedere CI/CD della libreria di variabili.

  3. Confrontare i fileProdVS.json e TestVS.json nella cartella valueSets . Verificare che la overrides variabile sia impostata sui diversi valori. È possibile modificare questi valori direttamente nell'interfaccia utente o modificando questo file in Git e aggiornandolo nell'area di lavoro.

    {
 "$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"
  }
 ]
}

Contenuto correlato

  • Last updated on