Distribuire contenuto usando le pipeline di distribuzione

Qualsiasi utente con licenza membro o amministratore nell'area di lavoro di origine può distribuire il contenuto in una fase vuota (una fase che non contiene contenuto). L'area di lavoro deve risiedere in una capacità per il completamento della distribuzione.

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

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 il 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 modello semantico e i cloni sono associati in modo analogo 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 Distribuzione del contenuto in una fase vuota.

Opzioni di distribuzione

Le pipeline di distribuzione offrono tre opzioni per la distribuzione del contenuto di Fabric:

Dopo aver scelto come distribuire il contenuto, è possibile esaminare la distribuzione e lasciare una nota.

Distribuire tutto il contenuto

Selezionare la fase da cui eseguire la distribuzione e quindi selezionare il pulsante di distribuzione. Il processo di distribuzione crea un'area di lavoro duplicata nella fase di destinazione. Questa area di lavoro include tutto il contenuto esistente nella fase corrente.

Screenshot che mostra il pulsante Distribuisci per le fasi di sviluppo e test in una pipeline di distribuzione.

Distribuzione selettiva

Se non si vuole distribuire tutti gli elementi da tale fase, è possibile selezionare elementi specifici per la distribuzione. Selezionare il collegamento Mostra altro e quindi selezionare gli elementi da distribuire. Quando si seleziona il pulsante Distribuisci , nella fase successiva vengono distribuiti solo gli elementi selezionati.

Poiché i dashboard, i report, i modelli semantici e i flussi di dati sono correlati e hanno dipendenze, è possibile usare il pulsante di selezione correlato per visualizzare tutti gli elementi da cui dipendono tali elementi. Ad esempio, se si vuole distribuire un report nella fase successiva, selezionare il pulsante Seleziona correlato per contrassegnare il modello semantico a cui è connesso il report, in modo che entrambi vengano distribuiti insieme e che il report non venga interrotto.

Screenshot che mostra l'opzione di distribuzione selettiva nelle pipeline di distribuzione, disponibile dopo aver selezionato l'opzione Mostra altro.

Nota

  • Non è possibile distribuire un elemento fabric nella 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 è cambiato e non è più identico a quello nella 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ù elementi, non è possibile distribuire una cartella vuota.
  • Non è possibile distribuire manualmente le singole cartelle nella distribuzione. La distribuzione viene attivata automaticamente quando viene distribuito uno o più elementi.
  • La distribuzione di 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.

Esaminare la distribuzione e lasciare una nota

Dopo aver selezionato il contenuto da distribuire, una finestra popup elenca tutti gli elementi da distribuire. È possibile esaminare l'elenco e aggiungere una nota o un commento alla distribuzione. L'aggiunta di una nota è facoltativa, ma è altamente consigliata perché le note vengono aggiunte alla cronologia di distribuzione. Con una nota per ogni distribuzione, esaminare la cronologia delle pipeline diventa più significativo.

Per lasciare una nota, espandere l'opzione Aggiungi una nota e scrivere la 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 a un'altra

Dopo avere contenuto in una fase della pipeline, è possibile distribuirlo alla fase successiva. La distribuzione del contenuto in un'altra fase viene in genere eseguita dopo aver eseguito alcune azioni nella pipeline. Ad esempio, apportare modifiche di sviluppo al contenuto nella fase di sviluppo o testare il contenuto 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 Distribuire il contenuto in un'area di lavoro esistente.

Quando si distribuisce il contenuto in una fase che contiene già altri contenuti, selezionare gli elementi da distribuire. Se è già presente un elemento con lo stesso nome, tale elemento viene sovrascritto. Le relazioni tra gli elementi non vengono mantenute. Pertanto, se si distribuisce un report associato a un modello semantico nella fase di origine, viene distribuito solo il report. Per distribuire tutti gli elementi connessi al report, usare il pulsante Seleziona elementi correlati .

Per distribuire il contenuto alla fase successiva nella pipeline di distribuzione, selezionare il pulsante Distribuisci nella parte inferiore della fase.

Quando si esaminano le schede di fase di test e produzione, è possibile visualizzare l'ora dell'ultima distribuzione. Questa volta indica l'ultima volta che il contenuto è stato distribuito nella fase.

Il tempo di distribuzione è utile per stabilire quando una fase è stata aggiornata per l'ultimo aggiornamento. Può essere utile anche se si vuole tenere traccia del tempo tra le distribuzioni di test e di produzione.