Funzioni di controllo della versione e distribuzione dei dati utente

Questo articolo illustra il funzionamento delle pipeline di integrazione e distribuzione Git per le funzioni dati utente in Microsoft Fabric. Le funzioni dati utente di Fabric offrono l'integrazione Git per il controllo del codice sorgente con i repository Di Azure DevOps. Con l'integrazione con Git, è possibile controllare la versione dell'elemento delle funzioni dati utente, collaborare usando i rami Git e gestire interamente il ciclo di vita del contenuto delle funzioni dati utente all'interno di Fabric.

Scopri di più sul processo di integrazione di Git con l'area di lavoro di Microsoft Fabric in Concetti di base nell'integrazionedi Git.

Configurare una connessione

Dalle impostazioni dell'area di lavoro è possibile configurare facilmente una connessione al repository per eseguire il commit e la sincronizzazione delle modifiche. Per configurare la connessione, vedere Introduzione all'integrazione di Git. Dopo la connessione, gli elementi, incluse le funzioni dati utente, vengono visualizzati nel riquadro Controllo del codice sorgente.

Dopo aver eseguito correttamente il commit degli elementi delle funzioni dati utente nel repository Git, nel repository vengono visualizzate le cartelle delle funzioni dati utente. A questo punto, è possibile eseguire operazioni future, ad esempio creare una richiesta pull.

Rappresentazione delle funzioni dati utente in Git

L'immagine seguente mostra un esempio della struttura di file di ogni elemento di funzioni dati utente nel repository:

La struttura di cartelle include gli elementi seguenti:

• .platform: Il file .platform contiene i seguenti attributi:

  

  • version: numero di versione dei file di sistema. Questo numero è usato per consentire la compatibilità con le versioni precedenti. Il numero di versione dell'elemento potrebbe essere diverso.
  • logicalId: Identificatore incrociato tra aree di lavoro generato automaticamente, che rappresenta un elemento e la sua rappresentazione nel controllo del codice sorgente.
  • type: UserDataFunction è il tipo per definire un elemento di funzioni dati utente.
  • displayName: rappresenta il nome dell'elemento. Quando l'elemento delle funzioni dati utente viene rinominato, questo displayName viene aggiornato.

• definitions.json: questo file condivide tutte le definizioni di elementi delle funzioni dati utente, ad esempio connessioni, librerie e così via, come rappresentazione delle proprietà degli elementi delle funzioni dati utente.

  

• function-app.py: questo file è il codice delle funzioni. Tutte le modifiche apportate al codice apportato all'elemento delle funzioni dati utente vengono sincronizzate nel repository con questo file. È possibile eseguire varie operazioni Git per gestire il ciclo di sviluppo del codice.

  

• resources: la cartella contiene un file functions.json con tutti i metadati, ad esempio connessioni, librerie e funzioni all'interno di questo elemento. NON AGGIORNARE MANUALMENTE QUESTO FILE. functions.json consente a Fabric di creare o ricreare l'elemento delle funzioni relative ai dati utente in un'area di lavoro.

  

Funzioni dati utente nelle pipeline di distribuzione

Inoltre è possibile usare le pipeline di distribuzione per implementare il codice di funzioni dati utente in ambienti diversi, ad esempio sviluppo, test e produzione. Questa funzionalità consente di semplificare il processo di sviluppo, garantire qualità e coerenza, e ridurre gli errori manuali con operazioni leggere con poco codice.

Nota

Tutte le connessioni e le librerie vengono aggiunte ai nuovi elementi delle funzioni dati utente creati in altri ambienti.

Per completare la distribuzione del tuo notebook utilizzando la pipeline di distribuzione, segui la procedura seguente.

1. Creare una nuova pipeline di distribuzione o aprire una pipeline di distribuzione esistente. Per maggiori informazioni, vedi Inizia con le pipeline di distribuzione.

2. Assegnare le aree di lavoro a fasi diverse in base agli obiettivi di distribuzione.

3. Seleziona, visualizza e confronta elementi, inclusi gli elementi delle funzioni dati utente tra fasi diverse.

4. Seleziona Distribuisci per distribuire l'elemento delle funzioni dati utente nell'ambiente di test. Puoi aggiungere una nota per fornire dettagli sulle modifiche per questa distribuzione. Analogamente, è possibile eseguire il push delle modifiche nelle fasi sviluppo, test e produzione.

5. Monitorare lo stato della distribuzione dalla cronologia di distribuzione .

Contenuto correlato

• Introduzione all'integrazione di Git di Microsoft Fabric
• Introduzione alle pipeline di distribuzione