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:
Avere una delle licenze Premium seguenti:
Utente Pro di Power BI appartenente a un'organizzazione con capacità Premium.
Si è un amministratore di un'area di lavoro.
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.
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:
Nel servizio Power BI, nel riquadro di spostamento selezionare Pipeline di distribuzione e quindi selezionare Crea la pipeline.
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.
Nell'area di lavoro selezionare Crea una pipeline.
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:
Distribuzione di tutto il contenuto : distribuire tutto il contenuto di Power BI nella fase di destinazione.
Distribuzione selettiva : selezionare il contenuto di Power BI da distribuire nella fase di destinazione.
Distribuzione con le versioni precedenti : distribuire il contenuto in una fase precedente nella pipeline.
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.
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.
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.
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.
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 |  |
|
Usare per determinare i valori delle origini dati o dei parametri per un flusso di dati specifico. |
| Set di dati | |
|
Usare per determinare i valori delle origini dati o dei parametri per un set di dati specifico. |
| Datamart | |
|
Usare per determinare i valori delle origini dati o dei parametri per un datamart specifico. |
| Report impaginato | |
 |
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.
Nella fase della pipeline per cui si vuole creare una regola di distribuzione selezionare Regole di distribuzione.
È 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.
Selezionare il flusso di dati, il set di dati, il datamart o il report impaginato per cui si vuole creare una regola.
Selezionare il tipo di regola che si vuole creare, espandere l'elenco e quindi selezionare Aggiungi regola. È possibile creare due tipi di regole:
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 |
|
|
|
| Azure Synapse |
|
|
|
| SQL Server Analysis Services (SSAS) |
|
|
|
| Azure SQL Server |
|
|
|
| SQL Server |
|
|
|
| Feed OData |
|
|
|
| Oracle |
|
|
|
| SapHana (supportata solo per la modalità di importazione, non per la modalità DirectQuery) | |||
| SharePoint |
|
|
|
| Teradata |
|
|
|
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.
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.
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.
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.
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.
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.
È possibile ottenere altre informazioni su quali elementi vengono copiati nella fase successiva e quali elementi non vengono copiati, in Informazioni sul processo di distribuzione.