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.

In una pipeline di distribuzione viene assegnata un'area di lavoro a ogni fase. Prima di iniziare a usare la pipeline in 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.

A screenshot of the deployment pipelines landing page.

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, agli utenti con cui viene condivisa verrà concesso l'accesso alla 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, a condizione che l'utente sia l'amministratore di una nuova esperienza delle aree di lavoro.

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

    A screenshot of the create a pipeline button in a workspace.

  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 API e DevOps.

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

Nota

Per distribuire un report impaginato, sarà necessaria una capacità che supporti i report impaginati.

Quando si distribuisce 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.

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.

A screenshot showing the deploy button for the development and test stages in a deployment pipeline.

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 select correlato per controllare tutti gli elementi dipendenti da 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.

A screenshot showing the selective deploy option in deployment pipelines, available after selecting the show more option.

Nota

  • Non è possibile distribuire un elemento Power BI nella fase successiva, se gli elementi dipendenti da non esistono nella fase in cui si sta distribuendo. 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.
  • È possibile ottenere risultati imprevisti se si sceglie di distribuire un elemento Power BI senza che l'elemento dipende. 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 della 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.

A screenshot showing the deploy to previous stage button, available from the test or production stage menus.

Passaggio 4 - Creare regole di distribuzione

Quando si lavora in una pipeline di distribuzione, le varie 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 invariate 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 a condizione che la regola sia invariata e valida.

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

Regola origine dati Regola dei parametri Dettagli
Flusso di dati Applies to. Applies to. Usare per determinare i valori delle origini dati o dei parametri per un flusso di dati specifico.
Set di dati Applies to. Applies to. Usare per determinare i valori delle origini dati o dei parametri per un set di dati specifico.
Report impaginato Applies to. Does not apply to. Definito per le origini dati di ogni report impaginato. È possibile usare queste regole per determinare le origini dati del report impaginato.

Nota

Le regole dell'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 fino a quando 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 Impostazioni di distribuzione.

    A screenshot of the deployment settings button, located in the deployment settings.

  2. È possibile impostare regole su flussi di dati, set di dati e report impaginati. Nel riquadro Impostazioni di distribuzione selezionare il tipo di regola da impostare.

    A screenshot of the deployment rules pane, showing that you can set rules for dataflows, datasets and paginated reports.

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

    A screenshot of the deployment rules pane, showing two datasets in the datasets tab. To configure a rule select an item from one of the tabs.

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

    A screenshot of the deployment rules pane, showing a selected dataset and the two rule types, data source and parameter, you can configure for it.

    • Regole delle origini dati

      Nell'elenco origine dati selezionare un nome di 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 dell'origine dati verranno disattivate se non si è il proprietario dell'elemento di Power BI per cui si sta creando una regola o se l'elemento di Power BI non contiene origini dati.
      • Per i flussi di dati, i set di dati e ireport impaginati, l'elenco delle origini dati viene tratto dalla fase della pipeline di origine.
    • Regole dei parametri : 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.

  • Non è possibile creare regole di distribuzione nella fase di sviluppo.

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

  • Quando si annulla l'assegnazione e la riassegnazione di un'area di lavoro per ristabilire le connessioni, le regole per tale area di lavoro non vengono mantenute. Per usare queste regole, è necessario riconfigurarle.

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

  • Le regole dell'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, l'apertura del report tramite Generatore report di Power BI non è supportata.

Nota

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

Origini dati supportate per il flusso di dati e le regole del set di dati

È possibile definire le regole delle origini dati solo per le origini dati seguenti:

  • 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

Per altre origini dati, è consigliabile usare i parametri per configurare l'origine dati.

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.

A screenshot showing a deployment pipeline with its comparison indicators.

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.

    Anche i set di dati con regole di distribuzione configurate che non sono state distribuite vengono contrassegnati come diversi. Ciò è dovuto al fatto che 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.

A screenshot showing the compare option which expands the compare view and allows comparing items between deployment pipeline stages.

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.

A screenshot of the replaced content warning which is displayed when a deployment is about to cause changes to items in the stage you're deploying to.

È 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