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

Questo tutorial ti mostra come utilizzare contenuti dinamici nelle pipeline 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).
  • Modifica le variabili in un repository Git.
  • Creare una pipeline di distribuzione e distribuire la libreria di variabili.
  • Modifica 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.

      Schermata del riquadro per selezionare una lakehouse come nuovo elemento.

    3. Immettere il nome SourceLH_Stage e quindi selezionare Crea.

  5. Crea 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, nella pagina Scegli origine dati, selezionare Dati di esempio.

      Schermata della pagina per scegliere un'origine dati per copiare i dati in un lakehouse.

    4. Selezionare Festività pubbliche.

      Schermata della selezione dei dati di esempio delle festività pubbliche.

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

    6. Nella pagina Connetti alla destinazione dati selezionare Avanti.

      Schermata con i dettagli di una destinazione della pipeline.

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

      Schermata della pagina di salvataggio ed esecuzione di una pipeline.

Crea l'area di lavoro Source LHs con Variabili

Ora, crea l'area di lavoro da cui lavorerai e che utilizzerai 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 i lakehouse SourceLH_Dev, SourceLH_Test e SourceLH_Prod

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

  1. Crea il primo lakehouse:

    1. Nella barra laterale, seleziona l'area di lavoro LH di origine con 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. Assegnagli il nome SourceLH_Prod.

  4. Nella barra laterale, seleziona lo spazio di lavoro Source LHs with Variables e assicurati che contenga tutti i lakehouse appena creati.

Recuperare gli ID dell'area di lavoro e gli ID oggetto 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. Copia l'ID dell'area di lavoro e l'ID dell'oggetto lakehouse nell'URL.

    Schermata che mostra come ottenere l'identificatore dell'area di lavoro e l'identificatore dell'oggetto Lakehouse.

  4. Ripetere i passaggi precedenti per i lakehouse SourceLH_Dev e SourceLH_Test nell'area di lavoro Source LHs with Variables.

Creare una libreria di variabili con le 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

    Schermata del set predefinito finale per la libreria delle 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

      Schermata dei valori alternativi finali 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.

    Schermata delle opzioni di menu selezionate per aggiungere dati copiati 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 **.

    Schermata della scheda delle variabili di libreria.

  7. Selezionare Nuovo e quindi aggiungere le variabili seguenti:

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

    Schermata 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, vai a Pipeline_Deploy.

  2. Nell'area di disegno, seleziona Copia dati in modo che lo stato attivo sia su 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 Origine>ID area di lavoro, 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. In Origine>tabella, seleziona Immetti manualmente, seleziona Nome tabella e quindi seleziona 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.

    Schermata dell'anteprima dei dati per una connessione sorgente.

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, vai a Pipeline_Deploy.

  2. Nell'area di disegno, seleziona Copia dati in modo che lo stato attivo sia su 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. In Destinazione>ID area di lavoro, seleziona 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.

      Schermata del riquadro per aggiungere contenuto dinamico per il nome di una tabella di destinazione.

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

    Schermata di un'esecuzione della pipeline.

Creare la pipeline di distribuzione

Ora, crea la tua pipeline di distribuzione:

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

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

    Schermata del riquadro in cui assegnare il nome a 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 .

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

      Schermata della fase 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.

      Schermata della fase 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.

      Schermata della sezione 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. Nella 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 (...), 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.

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

    5. Selezionare Salva>accetto.

  2. Configurare il set attivo per la fase Prod :

    1. Nella barra laterale, seleziona la pipeline Deployment_Pipeline_Var.

    2. Selezionare la fase Prod .

    3. Selezionare Variabili WS.

    4. Selezionare i puntini di sospensione (...), 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. Controlla il SourceLHs_Dev lakehouse:

    1. Nell'area di lavoro LH di origine con variabili, selezionare il lakehouse SourceLHs_Dev.

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

    3. In Esplora oggetti espandere gli schemi>dbo>Tabelle.

    4. Verificare che venga visualizzata la tabella DevCopiedData .

      Schermata dell'area delle tabelle in Esplora.

  2. Passa al lakehouse SourceLHs_Test e ripeti 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. Passate al lakehouse SourceLHs_Prod e ripetete 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 al SourceLHs_Test lakehouse.

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

    3. In Esplora oggetti, espandere Schemi>dbo>Tabelle.

    4. Verificare che venga visualizzata la tabella TestCopiedData .

      Schermata dell'area delle tabelle e di un'anteprima dei dati nell'esplora.

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

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

    2. Selezionare la pipeline Pipeline_Deploy.

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

  7. Controllare di nuovo il SourceLHs_Prod lakehouse:

    1. Passa al SourceLHs_Prod lakehouse.

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

    3. In Esplora oggetti, espandere Schemas>dbo>Tables.

    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. Una cartella denominata WS variables.VariableLibrary rappresenta l'elemento della libreria di variabili. Per altre informazioni sul contenuto di questa cartella, vedere CI/CD della libreria di variabili.

  3. Confronta i file ProdVS.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