Iniziare a usare le pipeline di distribuzione

SI APPLICA A: Power BI Desktop servizio Power BI

Questo articolo illustra le impostazioni di base necessarie per l'uso delle pipeline di distribuzione in servizio Power BI. Prima di procedere, è consigliabile leggere l'introduzione delle pipeline di distribuzione.

È anche possibile completare il modulo Learn creare e gestire una pipeline di distribuzione di Power BI , che illustra come creare una pipeline di distribuzione.

Nota

In una pipeline di distribuzione, a ogni fase viene assegnata un'area di lavoro. Prima di iniziare a usare la pipeline nell'ambiente di produzione, esaminare i requisiti di capacità per le aree di lavoro della pipeline.

Accesso alle pipeline di distribuzione

È possibile accedere alla funzionalità delle pipeline di distribuzione se vengono soddisfatte le condizioni seguenti:

Nota

Sarà anche possibile visualizzare il pulsante delle pipeline di distribuzione, se in precedenza è stata creata una pipeline o se una pipeline è stata condivisa con l'utente.

Screenshot della pagina di destinazione delle pipeline di distribuzione.

Passaggio 1: creare una pipeline di distribuzione

È possibile creare una pipeline dalla scheda Pipeline di distribuzione o da un'area di lavoro.

Dopo la creazione della pipeline, è possibile condividerla con altri utenti o eliminarla. Quando si condivide una pipeline con altri utenti, gli utenti con cui si condivide la pipeline avranno accesso alla pipeline e diventeranno amministratori della pipeline. L'accesso alla pipeline consente agli utenti di visualizzare, condividere, modificare ed eliminare la pipeline.

Creare una pipeline dalla scheda Pipeline di distribuzione

Per creare una pipeline dalla scheda Pipeline di distribuzione, seguire questa procedura:

  1. Nel servizio Power BI, nel riquadro di spostamento selezionare Pipeline di distribuzione e quindi selezionare Crea la pipeline.

  2. Nella finestra di dialogo Crea una pipeline di distribuzione immettere un nome e una descrizione per la pipeline e selezionare Crea.

Creare una pipeline da un'area di lavoro

È possibile creare una pipeline da un'area di lavoro esistente, fornendo l'amministratore di un'area di lavoro.

  1. Nell'area di lavoro selezionare Crea una pipeline.

    Screenshot del pulsante Crea una pipeline in un'area di lavoro.

  2. Nella finestra di dialogo Crea una pipeline di distribuzione immettere un nome e una descrizione per la pipeline e selezionare Crea.

Nota

Se l'area di lavoro non è assegnata alla capacità Premium dell'organizzazione o alla capacità PPU dell'utente, si riceverà una notifica che richiede di assegnarla a una capacità.

Passaggio 2: Assegnare un'area di lavoro

Dopo aver creato una pipeline, è necessario aggiungere il contenuto che si vuole gestire alla pipeline. L'aggiunta di contenuto alla pipeline viene eseguita assegnando un'area di lavoro alla fase della pipeline. È possibile assegnare un'area di lavoro a qualsiasi fase.

Seguire le istruzioni nel collegamento per assegnare un'area di lavoro a una pipeline.

Nota

Se si sta creando una pipeline da un'area di lavoro è possibile ignorare questa fase, perché l'area di lavoro è già selezionata.

Passaggio 3: eseguire la distribuzione in una fase vuota

Qualsiasi utente di Power BI Pro che sia membro o amministratore 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 codice. Per altre informazioni, vedere Automatizzare la pipeline di distribuzione usando le API e DevOps.

Se si dispone già di un'area di lavoro che si vuole usare con una fase specifica, anziché distribuirla è 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 set di dati nella fase di origine viene clonato insieme con il set di dati e i cloni mantengono la stessa associazione nell'area di lavoro di destinazione.

Al termine della distribuzione, aggiornare il set di dati. 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 del contenuto di Power BI:

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

Distribuzione di tutto il contenuto

Selezionare la fase da cui eseguire la distribuzione e 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 visualizza il pulsante di distribuzione per le fasi di sviluppo e test in una pipeline di distribuzione.

Distribuzione selettiva

Per distribuire solo elementi specifici, selezionare il collegamento Mostra altro e quindi selezionare gli elementi che si vuole distribuire. Quando si fa clic sul pulsante per la distribuzione, nella fase successiva vengono distribuiti solo gli elementi selezionati.

Poiché i dashboard, i report, i set di dati e i flussi di dati sono correlati e hanno dipendenze, è possibile usare il pulsante seleziona correlato per controllare tutti gli elementi da cui dipendono tali elementi. Se, ad esempio, si vuole distribuire un report nella fase successiva, facendo clic sul pulsante di selezione degli elementi correlati verrà contrassegnato il set di dati a cui è connesso il report, in modo che entrambi vengano distribuiti contemporaneamente e che il report non venga interrotto.

Screenshot che visualizza l'opzione di distribuzione selettiva nelle pipeline di distribuzione, disponibile dopo la selezione dell'opzione Mostra altro.

Nota

  • Non è possibile distribuire un elemento di Power BI 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 set di dati avrà esito negativo, a meno che il set di dati non esista già nella fase di destinazione.
  • Se si sceglie di distribuire un elemento di Power BI senza l'elemento da cui dipende, è possibile ottenere risultati imprevisti. Ciò può verificarsi quando un set di dati o un flusso di dati nella fase di destinazione è stato modificato e non è più identico a quello nella fase da cui si esegue la distribuzione.

Distribuzione nella fase precedente

È possibile scegliere di eseguire la distribuzione in una fase precedente, ad esempio in uno scenario in cui si assegna un'area di lavoro esistente a una fase di produzione e quindi 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. Quando si esegue la distribuzione in una fase precedente, non è possibile selezionare elementi specifici, viene distribuito tutto il contenuto della fase.

Screenshot che visualizza il pulsante Distribuisci nella fase precedente, disponibile nei menu della fase di test o di produzione.

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 alla distribuzione. L'aggiunta di una nota è facoltativa, ma è consigliabile aggiungere le note alla cronologia di distribuzione. Con 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 la nota nella casella di testo. Quando si è pronti per la distribuzione, selezionare Distribuisci.

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

Passaggio 4: Creare regole di distribuzione

Quando si lavora in una pipeline di distribuzione, le diverse fasi possono avere configurazioni diverse. Ogni fase, ad esempio, può avere database diversi o parametri di query diversi. La fase di sviluppo può eseguire query sui dati di esempio del database, mentre le fasi di test e produzione eseguono query sull'intero database.

Quando si distribuisce il contenuto tra le fasi della pipeline, la configurazione delle regole di distribuzione consente di consentire modifiche al contenuto, mantenendo intatte alcune impostazioni. Se, ad esempio, si vuole che un set di dati in una fase di produzione punti a un database di produzione, è possibile definire una regola. La regola viene definita nella fase di produzione, sotto il set di dati appropriato. Dopo aver definito la regola, il contenuto distribuito dal test all'ambiente di produzione erediterà il valore definito nella regola di distribuzione e verrà sempre applicato finché la regola rimane invariata e valida.

È possibile configurare le regole e le regole dei parametri dell'origine dati. La tabella seguente elenca il tipo di elementi di Power BI per cui è possibile configurare le regole e il tipo di regola che è possibile configurare per ognuno di essi.

Regola origine dati Regola dei parametri Dettagli
Flusso Si applica a. Si applica a. Usare per determinare i valori delle origini dati o dei parametri per un flusso di dati specifico.
Set di dati Si applica a. Si applica a. Usare per determinare i valori delle origini dati o dei parametri per un set di dati specifico.
Datamart Si applica a. Si applica a. Usare per determinare i valori delle origini dati o dei parametri per un datamart specifico.
Report impaginato Si applica a. Non si applica a. Definito per le origini dati di ogni report impaginato. È possibile usare queste regole per determinare le origini dati del report impaginato.

Nota

Le regole di origine dati funzionano solo quando si modificano le origini dati dallo stesso tipo.

Creare una regola di distribuzione

Per creare una regola di distribuzione, seguire la procedura descritta in questa sezione. Dopo aver creato tutte le regole di distribuzione necessarie, distribuire i set di dati con le regole appena create dalla fase di origine alla fase di destinazione in cui sono state create le regole. Le regole non verranno applicate finché non si distribuiscono i set di dati dall'origine alla fase di destinazione.

  1. Nella fase della pipeline per cui si vuole creare una regola di distribuzione selezionare Regole di distribuzione.

    Screenshot del pulsante Regole di distribuzione, disponibile nelle regole di distribuzione.

  2. È possibile impostare regole su flussi di dati, set di dati, datamarts e report impaginati. Per trovare l'elemento di Power BI per cui si vuole impostare una regola, usare le funzionalità di ricerca o filtro.

    Screenshot del riquadro regole di distribuzione, che mostra che è possibile impostare regole per flussi di dati, set di dati, datamarts e report impaginati.

  3. Selezionare il flusso di dati, il set di dati, il datamart o il report impaginato per cui si vuole creare una regola.

    Screenshot del riquadro regole di distribuzione che mostra due set di dati nella scheda Set di dati. Per configurare una regola, selezionare un elemento da una delle schede.

  4. Selezionare il tipo di regola che si vuole creare, espandere l'elenco e quindi selezionare Aggiungi regola. È possibile creare due tipi di regole:

    Screenshot del riquadro regole di distribuzione, che mostra un set di dati selezionato e i due tipi di regola, l'origine dati e il parametro, è possibile configurarlo.

    • Regole delle origini dati

      Nell'elenco origine dati selezionare un nome origine dati da aggiornare. Usare uno dei metodi seguenti per selezionare un valore per sostituire quello della fase di origine:

      • Eseguire la selezione da un elenco.

      • Selezionare Altro e aggiungere manualmente la nuova origine dati. È possibile passare solo a un'origine dati dello stesso tipo.

      Nota

      • Le regole di origine dati verranno disattivate se non si è il proprietario dell'elemento di Power BI per cui si sta creando una regola oppure se l'elemento di Power BI non contiene origini dati.
      • Per i flussi di dati, i set di dati e ireport impaginati, l'elenco di origini dati viene tratto dalla fase della pipeline di origine.
      • Non è possibile usare la stessa origine dati in più di una regola.
    • Regole di parametro : selezionare un parametro dall'elenco dei parametri; viene visualizzato il valore corrente. Modificare il valore nel valore che si vuole rendere effettivo dopo ogni distribuzione.

Limitazioni delle regole di distribuzione

Questa sezione elenca le limitazioni per le regole di distribuzione.

  • Per creare una regola di distribuzione, è necessario essere il proprietario del flusso di dati, del set di dati o del report impaginato per cui si sta creando una regola.

  • Le regole di distribuzione non possono essere create nella fase di sviluppo.

  • Quando un elemento viene rimosso o eliminato, vengono eliminate anche le relative regole che non potranno essere ripristinate.

  • Quando non si assegna e si riassegna un'area di lavoro per ripristinare le connessioni, le regole per tale area di lavoro non vengono mantenute. Per usare queste regole, sarà necessario riconfigurarle.

  • Le regole per i flussi di dati con altri flussi di dati come origini non sono supportate.

  • Le regole di origine dati per le cartelle CDM (Common Data Model) in un flusso di dati non sono supportate.

  • Le regole per i set di dati che usano flussi di dati come origine, non sono supportate.

  • Se l'origine dati definita in una regola viene modificata o rimossa dall'elemento a cui punta nella fase di origine, la regola non sarà valida e la distribuzione avrà esito negativo.

  • Se il parametro definito in una regola viene modificato o rimosso dall'elemento a cui punta nella fase di origine, la regola non sarà valida e la distribuzione avrà esito negativo.

  • Dopo aver distribuito un report impaginato con una regola di origine dati, aprire il report usando il Power BI Report Builder non è supportato.

Nota

Le regole dei parametri non sono supportate per i report impaginati.

Origini dati supportate per le regole

La tabella seguente elenca le origini dati per cui è possibile definire le regole. Per altre origini dati, è consigliabile usare i parametri per configurare l'origine dati.

Origine dati Set di dati Flusso di dati Report impaginato
Azure Analysis Services Sì. Sì. Sì.
Azure Synapse Sì. Sì. Sì.
SQL Server Analysis Services (SSAS) Sì. Sì. Sì.
Azure SQL Server Sì. Sì. Sì.
SQL Server Sì. Sì. Sì.
Feed OData Sì. Sì. No.
Oracle Sì. Sì. Sì.
SapHana (supportata solo per la modalità di importazione, non per la modalità DirectQuery)
SharePoint Sì. Sì. No.
Teradata Sì. Sì. Sì.

Passaggio 5: 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. Un flusso di lavoro tipico per lo spostamento di contenuto da fase a fase, è da sviluppo a test e quindi da test a produzione. Per altre informazioni su questo processo, vedere la sezione sulla distribuzione di contenuto in un'area di lavoro esistente.

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

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.

La data e l'ora della distribuzione sono utili 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.

Confronto delle fasi

Quando due fasi sequenziali includono contenuto, questo viene confrontato in base ai metadati degli elementi di contenuto. Questa operazione non include il confronto tra i dati o il tempo di aggiornamento tra le fasi.

Screenshot che visualizza una pipeline di distribuzione con i relativi indicatori di confronto.

Per consentire una rapida visualizzazione di dati analitici sulle differenze tra due fasi sequenziali, viene visualizzato un indicatore di icona di confronto tra le due fasi. L'indicatore di confronto ha due stati:

  • Indicatore verde: i metadati per ogni elemento di contenuto sono gli stessi in entrambe le fasi.

  • Indicatore arancione: viene visualizzato se viene soddisfatta una delle condizioni seguenti.

    • Alcuni degli elementi di contenuto in ogni fase sono stati modificati o aggiornati, ovvero hanno metadati diversi.
    • Esiste una differenza nel numero di elementi tra le fasi.

Quando due fasi sequenziali non sono uguali, viene visualizzato un collegamento Confronta sotto l'icona di confronto arancione. Se si fa clic sul collegamento si apre l'elenco di elementi di contenuto in entrambe le fasi della visualizzazione di confronto. La visualizzazione di confronto consente di rilevare le modifiche o le differenze tra gli elementi in ogni fase della pipeline. Gli elementi modificati ottengono una delle etichette seguenti:

  • Nuovo: nuovo elemento nella fase di origine. Si tratta di un elemento che non esiste nella fase di destinazione. Dopo la distribuzione questo elemento viene clonato nella fase di destinazione.

  • Diverso: un elemento che esiste sia nella fase di origine che in quella di destinazione, laddove una delle versioni è stata modificata dopo l'ultima distribuzione. Dopo la distribuzione l'elemento nella fase di origine sovrascriverà l'elemento nella fase di destinazione, indipendentemente da dove è stata apportata la modifica.

    I set di dati con regole di distribuzione configurate che non sono state distribuite, vengono contrassegnati anche come diversi. Ciò avviee perché le regole di distribuzione non vengono applicate finché i set di dati non vengono distribuiti dalla fase di origine alla fase di destinazione, che include le regole configurate.

  • Mancante da: questa etichetta indica che un elemento viene visualizzato nella fase di destinazione ma non nella fase di origine.

    Nota

    La distribuzione non avrà alcun effetto sugli elementi mancanti.

Il confronto è progettato per comprendere la differenza tra le fasi. Nella visualizzazione di confronto gli elementi vengono disposti in base alla logica elencata di seguito.

  1. Gli elementi dell'area di lavoro di origine sono ordinati in ordine alfabetico con i gruppi, in base al loro tipo. I gruppi vengono ordinati in base al flusso di dati. Ad esempio, i primi set di dati, quindi i report e infine i dashboard.

  2. L'area di lavoro di destinazione viene ordinata in base all'area di lavoro di origine. Ogni elemento si trova nella stessa riga dell'elemento equivalente nella fase di origine.

  3. Gli elementi presenti nell'area di lavoro di destinazione, ma non nell'area di lavoro di origine, vengono visualizzati nella parte inferiore del gruppo di tipi, in ordine alfabetico.

Screenshot con l'opzione Confronta, che espande la visualizzazione di confronto e consente di confrontare gli elementi tra fasi diverse della pipeline di distribuzione.

Esecuzione dell'override del contenuto

Quando si esegue la distribuzione dopo avere apportato modifiche al contenuto della fase di origine, il contenuto modificato nella fase di destinazione viene sovrascritto. Dopo aver fatto clic sul pulsante di distribuzione verrà visualizzato un avviso che indica il numero di elementi che verranno sovrascritti.

Screenshot dell'avviso di contenuto sostituito, visualizzato quando una distribuzione sta per causare modifiche a elementi nella fase in cui si esegue la distribuzione.

È possibile ottenere altre informazioni su quali elementi vengono copiati nella fase successiva e quali elementi non vengono copiati, in Informazioni sul processo di distribuzione.

Passaggi successivi