Distribuire contenuto tramite le pipeline di distribuzione

Qualsiasi utente con licenza che sia almeno un contributore dell'area di lavoro di origine, può distribuire il contenuto in una fase vuota, ovvero una fase che non include contenuto. Perché la distribuzione sia completata, l'area di lavoro deve risiedere in una capacità.

È anche possibile usare le API REST delle pipeline di distribuzione per eseguire distribuzioni a livello di prorammazione. Per ulteriori informazioni, vedere Automatizzare la pipeline di distribuzione tramite le API e DevOps.

Importante

La nuova interfaccia utente per le pipeline di distribuzione di Microsoft Fabric è temporaneamente disabilitata. Microsoft sta lavorando per risolvere il problema e aggiornerà questa pagina quando la nuova interfaccia utente è nuovamente disponibile. Nel frattempo, è possibile continuare a usare l'interfaccia utente originale.

Eseguire la distribuzione in una fase vuota

Se si ha già un'area di lavoro che si vuole usare con una fase specifica, anziché distribuire è possibile assegnare tale area di lavoro alla fase appropriata.

Quando si distribuisce contenuto in una fase vuota, le relazioni tra gli elementi vengono mantenute. Ad esempio, un report associato a un modello semantico nella fase di origine viene clonato insieme al relativo modello semantico e i cloni mantengono la stessa associazione nell'area di lavoro di destinazione. Viene mantenuta anche la struttura di cartelle. Se nella fase di origine sono presenti elementi in una cartella, viene creata una cartella nella fase di destinazione. Poiché una cartella viene distribuita solo se viene distribuito uno dei relativi elementi, non è possibile distribuire una cartella vuota.

Al termine della distribuzione, aggiornare il modello semantico. Per altre informazioni, vedere la distribuzione di contenuto in una fase vuota.

Opzioni di distribuzione

Le pipeline di distribuzione offrono tre opzioni per la distribuzione dei contenuti di Fabric:

Dopo aver scelto come distribuire i contenuti, è possibile Esaminare la distribuzione e lasciare una nota.

Distribuire tutto il contenuto

  1. Selezionare la fase di destinazione.
  2. Dal menu a discesa scegliere una fase adiacente da cui eseguire la distribuzione.
  3. Selezionare gli elementi da distribuire.
  4. Selezionare il pulsante Distribuisci.

Screenshot che mostra come distribuire il contenuto dalla fase di sviluppo alla fase di test nella nuova interfaccia della pipeline di distribuzione.

Il processo di distribuzione crea un'area di lavoro duplicata nella fase di destinazione. Questa area di lavoro include tutto il contenuto selezionato dalla fase di origine.

Distribuzione selettiva

Se non si vogliono distribuire tutti gli elementi di tale fase, è possibile selezionare elementi specifici da destinare alla distribuzione. Selezionare il collegamento Mostra altro e poi selezionare gli elementi da distribuire. Quando si fa clic sul pulsante Distribuzione, nella fase successiva vengono distribuiti solo gli elementi selezionati.

Gli elementi di Fabric sono spesso correlati o dipendenti da altri elementi. Dashboard, report, modelli semantici, flussi di dati, lakehouse e warehouse sono tutti esempi di elementi che possono essere correlati o dipendenti da altri elementi. Per includere tutti gli elementi correlati all'elemento da distribuire, usare il pulsante di selezione correlato. Se, ad esempio, si vuole distribuire un report nella fase successiva, selezionare il pulsante Seleziona correlati per contrassegnare il modello semantico a cui il report è collegato, in modo che vengano distribuiti insieme e il report non si interrompa.

Se non si vogliono distribuire tutti gli elementi di tale fase, è possibile selezionare solo elementi specifici da destinare alla distribuzione. Poiché i dashboard, i report, i modelli semantici e i flussi di dati presentano dipendenze, è possibile usare il pulsante destinato alla selezione per controllare tutti gli elementi da cui dipende l'elemento selezionato. Se, ad esempio, si vuole distribuire un report nella fase successiva, selezionare il pulsante Seleziona correlati per contrassegnare il modello semantico a cui il report è collegato, in modo che vengano distribuiti insieme e il report non si interrompa.

Il pulsante distribuisci mostra il numero di elementi selezionati per la distribuzione.

Gli elementi non supportati vengono visualizzati anche in questo elenco. Gli elementi non supportati non possono essere distribuiti, ma possono essere filtrati.

Screenshot che mostra l'opzione di distribuzione selettiva nelle pipeline di distribuzione.

Nota

  • Non è possibile distribuire un elemento di Fabric alla fase successiva se gli elementi da cui dipende non esistono nella fase in cui si esegue la distribuzione. Ad esempio, la distribuzione di un report senza un modello semantico avrà esito negativo, a meno che il modello semantico non esista già nella fase di destinazione.
  • Se si sceglie di distribuire un elemento senza l'elemento da cui dipende, è possibile ottenere risultati imprevisti. Ciò può verificarsi quando un modello semantico o un flusso di dati nella fase di destinazione è stato modificato e non è più identico a quello della fase da cui si esegue la distribuzione.

Quando si distribuiscono aree di lavoro che contengono cartelle, si applicano le regole seguenti:

  • Gli elementi con lo stesso nome e tipo sono associati. Se sono presenti due elementi con lo stesso nome e tipo in un'area di lavoro, gli elementi vengono associati agli elementi nella fase di destinazione solo se il percorso è lo stesso (si trovano nella stessa cartella).
  • Poiché una cartella viene distribuita solo se viene distribuito uno o più dei suoi elementi, non è possibile distribuire una cartella vuota.
  • Non è possibile distribuire manualmente le singole cartelle nella distribuzione. La loro distribuzione viene attivata automaticamente quando viene distribuito almeno uno dei loro elementi.
  • Distribuire solo alcuni elementi in una cartella aggiorna la struttura di tutti gli elementi nella cartella nella fase in cui viene distribuita, anche se gli elementi stessi non vengono distribuiti.
  • La gerarchia di cartelle degli elementi associati viene aggiornata solo durante la distribuzione. Durante l'assegnazione, dopo il processo di associazione, la gerarchia degli elementi associati non viene ancora aggiornata.

Distribuzione nella fase precedente

A volte potrebbe essere necessario distribuire il contenuto in una fase precedente. Ad esempio, in uno scenario in cui si assegna un'area di lavoro esistente a una fase di produzione e la si distribuisce prima alla fase di test e poi a quella di sviluppo. La distribuzione in una fase precedente funziona solo se la fase precedente è vuota.

Screenshot che mostra come modificare la fase in cui si esegue la distribuzione.

Esaminare la distribuzione e lasciare una nota

Dopo aver selezionato il contenuto da distribuire, una finestra popup elencherà tutti gli elementi da distribuire. È possibile verificare l'elenco e aggiungere una nota, o un commento, alla distribuzione. Aggiungere una nota è facoltativo ma è consigliato poiché le note vengono aggiunte alla cronologia di distribuzione. Se è presente una nota per ogni distribuzione, la revisione della cronologia delle pipeline diventa più significativa.

Per lasciare una nota, espandere l'opzione Aggiungi una nota e scrivere tale nota nella casella di testo. Quando si è pronti per la distribuzione, selezionare Distribuisci.

Screenshot che mostra la finestra popup di distribuzione con l'opzione Aggiungi una nota espansa.

Distribuire il contenuto da una fase all'altra

Quando è presente contenuto in una fase della pipeline, è possibile distribuirlo alla fase successiva. La distribuzione del contenuto in un'altra fase avviene in genere dopo che sono state eseguite azioni nella pipeline. Ad esempio, la modifica allo sviluppo del contenuto in fase di sviluppo oppure l'esecuzione di test nella fase di test. Sebbene sia possibile avere fino a 10 fasi diverse nella pipeline, un flusso di lavoro tipico per lo spostamento del contenuto è lo sviluppo per la fase di test e quindi il test nell'ambiente di produzione. Per altre informazioni su questo processo, vedere la sezione sulla distribuzione di contenuto in un'area di lavoro esistente.

Quando il contenuto viene distribuito in una fase che contiene già altri contenuti, selezionare gli elementi da distribuire. Un elemento associato a un altro elemento nella fase di origine (il nome dell'elemento associato viene visualizzato nell'ultima colonna) viene sovrascritto da esso.

Le relazioni tra gli elementi non vengono conservate. Pertanto, se un report associato a un modello semantico nella fase di origine viene distribuito, verrà distribuito soltanto il report. Per distribuire tutti gli elementi connessi al report, usare il pulsante Seleziona elementi correlati.

Per distribuire il contenuto nella fase successiva della pipeline di distribuzione, selezionare gli elementi e, quindi, il pulsante di distribuzione.

Quando si esaminano le schede della fase di produzione e di test, è possibile visualizzare data e ora dell'ultima distribuzione. Questo valore indica l'ultima volta in cui il contenuto è stato distribuito nella fase.

L'orario della distribuzione è utile per stabilire quando è stato eseguito l'ultimo aggiornamento di una fase. Possono anche essere utili se si vuole tenere traccia del tempo tra le distribuzioni di test e di produzione.