Informazioni sul processo di distribuzioneUnderstand the deployment process

Il processo di distribuzione consente di clonare contenuto da una fase della pipeline a un'altra, in genere dallo sviluppo al test e dal test alla produzione.The deployment process lets you clone content from one stage in the pipeline to another, typically from development to test, and from test to production.

Durante la distribuzione, Power BI copia il contenuto dalla fase corrente a quella di destinazione.During deployment, Power BI copies the content from the current stage, into the target one. Durante il processo di copia le connessioni tra gli elementi copiati vengono mantenute.The connections between the copied items are kept during the copy process. Power BI, poi, applica al contenuto aggiornato nella fase di destinazione le regole dei set di dati configurati.Power BI also applies the configured dataset rules to the updated content in the target stage. La distribuzione del contenuto può richiedere tempo, a seconda del numero di elementi da distribuire.Deploying content may take a while, depending on the number of items being deployed. Durante questo periodo, è possibile passare ad altre pagine del portale di Power BI, ma non è possibile usare il contenuto nella fase di destinazione.During this time, you can navigate to other pages in the Power BI portal, but you cannot use the content in the target stage.

Distribuzione di contenuto in una fase vuotaDeploying content to an empty stage

Quando si distribuisce contenuto in una fase vuota, i metadati dei report, dei dashboard e dei set di dati nell'area di lavoro di origine della distribuzione vengono copiati nella fase di destinazione.When you deploy content to an empty stage, the metadata of the reports, dashboards, and datasets in the workspace you're deploying from, is copied to the stage you're deploying to. In una capacità Premium viene creata una nuova area di lavoro per la fase di distribuzione di destinazione.A new workspace for the stage you deployed to, is created on a Premium capacity.

Esistono due modi per distribuire contenuto da una fase alla successiva.There are two ways to deploy content from one stage to the next one. È possibile distribuire tutto il contenuto oppure selezionare gli elementi di contenuto da distribuire.You can deploy all the content, or you can select which content items to deploy.

È anche possibile distribuire contenuto in senso inverso, da una fase successiva nella pipeline di distribuzione a una precedente.You can also deploy content backwards, from a later stage in the deployment pipeline, to an earlier one.

Al termine della distribuzione, aggiornare i set di dati in modo che sia possibile usare il contenuto appena copiato.After the deployment is complete, refresh the datasets so that you can use the newly copied content. L'aggiornamento dei set di dati è necessario perché i dati non vengono copiati da una fase all'altra.The dataset refresh is required because data isn't copied from one stage to another. Per comprendere quali proprietà degli elementi vengono copiate durante il processo di distribuzione e quali non vengono copiate, vedere la sezione Proprietà degli elementi copiate durante la distribuzione.To understand which item properties are copied during the deployment process, and which item properties are not copied, review the item properties copied during deployment section.

Creazione un'area di lavoro di una capacità PremiumCreating a Premium capacity workspace

Durante la prima distribuzione, le pipeline di distribuzione controllano se si hanno autorizzazioni di capacità Premium.During first-time deployment, deployment pipelines checks if you have Premium capacity permissions.

Se si hanno autorizzazioni di capacità, il contenuto dell'area di lavoro viene copiato nella fase di destinazione e viene creata una nuova area di lavoro per tale fase nella capacità Premium.If you have capacity permissions, the content of the workspace is copied to the stage you're deploying to, and a new workspace for that stage is created on the Premium capacity.

Se non si hanno autorizzazioni di capacità, l'area di lavoro viene creata, ma il contenuto non viene copiato.If you don't have capacity permissions, the workspace is created but the content isn’t copied. È possibile chiedere a un amministratore della capacità di aggiungere l'area di lavoro a una capacità o richiedere autorizzazioni di assegnazione per la capacità.You can ask a capacity admin to add your workspace to a capacity, or ask for assignment permissions for the capacity. In seguito, quando l'area di lavoro viene assegnata a una capacità, è possibile distribuire contenuto in questa area di lavoro.Later, when the workspace is assigned to a capacity, you can deploy content to this workspace.

Se si usa Premium per utente (PPU) l'area di lavoro viene creata automaticamente nella capacità associata alla licenza PPU.If you're using Premium Per User (PPU), your workspace is automatically created in the capacity associated with your PPU. In questi casi non sono richieste autorizzazioni per la capacità.In such cases capacity permissions are not required. Tuttavia, le aree di lavoro create da un utente PPU sono accessibili solo da altri utenti PPU.However, workspaces created by a PPU user, can only be accessed by other PPU users. Anche il contenuto creato in tali aree di lavoro può essere utilizzato solo da utenti PPU.In addition, content created in such workspaces can only be consumed by PPU users.

Area di lavoro e proprietà del contenutoWorkspace and content ownership

L'utente che esegue la distribuzione diventa automaticamente il proprietario dei set di dati clonati e l'unico amministratore della nuova area di lavoro.The deploying user automatically becomes the dataset owner of the cloned datasets, and the only admin of the new workspace.

Distribuire contenuto in un'area di lavoro esistenteDeploy content to an existing workspace

La distribuzione di contenuto di una pipeline di produzione di lavoro in una fase con un'area di lavoro esistente prevede quanto segue:Deploying content in a working production pipeline, to a stage that has an existing workspace, includes the following:

  • Distribuzione di nuovo contenuto come aggiunta, in una fase che contiene già contenuto.Deploying new content as an addition, to a stage that already contains content.

  • Distribuzione di nuovo contenuto per sostituire contenuto precedente, in una fase di lavoro corrente.New content deployed to replace old content, in a current working stage.

Processo di distribuzioneDeployment process

Il contenuto della fase corrente viene copiato nella fase di destinazione.Content from the current stage is copied over to the target stage. Power BI identifica il contenuto esistente nella fase di destinazione e lo sovrascrive.Power BI identifies existing content in the target stage and overwrites it. Per identificare gli elementi di contenuto da sovrascrivere, le pipeline di distribuzione usano la connessione tra l'elemento padre e i relativi cloni.To identify which content item needs to be overwritten, deployment pipelines uses the connection between the parent item and its clones. Questa connessione viene mantenuta quando viene creato nuovo contenuto.This connection is kept when new content is created. L'operazione di sovrascrittura sovrascrive solo il contenuto dell'elemento.The overwrite operation only overwrites the content of the item. L'ID, l'URL e le autorizzazioni dell'elemento rimangono invariati.The item's ID, URL, and permissions remain unchanged.

Nella fase di destinazione, le proprietà dell'elemento che non vengono copiate rimangono com'erano prima della distribuzione.In the target stage, item properties that are not copied, remain as they were before deployment. Nuovo contenuto e nuovi elementi vengono copiati dalla fase corrente alla fase di destinazione.New content and new items are copied from the current stage to the target stage.

Aggiornamento del set di datiRefreshing the dataset

Quando possibile, i dati nel set di dati di destinazione vengono mantenuti.Data in the target dataset is kept when possible. Se un set di dati non è stato modificato, i dati vengono mantenuti com'erano prima della distribuzione.If there are no changes to a dataset, the data is kept as it was before the deployment.

Nel caso di piccole modifiche, ad esempio l'aggiunta di una tabella o di misure, Power BI mantiene i dati originali e l'aggiornamento viene ottimizzato in modo che vengano aggiornati solo gli elementi che lo richiedono.With small changes, such as adding a table or measures, Power BI keeps the original data, and the refresh is optimized to refresh only what's needed. Per modifiche sostanziali dello schema o per le modifiche apportate alla connessione all'origine dati, è necessario un aggiornamento completo.For breaking schema changes, or changes in the data source connection, a full refresh is required.

Requisiti per la distribuzione in una fase con un'area di lavoro esistenteRequirements for deploying to a stage with an existing workspace

A condizione che il contenuto da distribuire risieda in una capacità Premium, un utente che soddisfi le condizioni seguenti può distribuire tale contenuto in una fase con un'area di lavoro esistente:As long as the deployed content resides on a premium capacity, a user that meets the following conditions, can deploy it to a stage with an existing workspace:

  • Essere un utente con licenza Pro o un utente PPU membro di entrambe le aree di lavoro nelle fasi di distribuzione di origine e di destinazione.A user with a Pro license or a PPU user, who's a member of both workspaces in the source and target deployment stages.

  • Essere proprietario di tutti i set di dati dell'area di lavoro di destinazione che stanno per essere distribuiti.An owner of all the datasets in the target workspace that are about to be deployed.

Per altre informazioni, vedere la sezione delle autorizzazioni.For more information, review the permissions section.

Elementi distribuitiDeployed items

Quando si distribuisce contenuto da una fase della pipeline a un'altra, il contenuto copiato contiene gli elementi Power BI seguenti:When you deploy content from one pipeline stage to another, the copied content contains the following Power BI items:

  • Set di datiDatasets

  • ReportReports

  • DashboardDashboards

Elementi non supportatiUnsupported items

Le pipeline di distribuzione non supportano gli elementi seguenti:Deployment pipelines doesn't support the following items:

  • Set di dati che non hanno origine da un file PBIXDatasets that do not originate from a PBIX

  • Report basati su set di dati non supportatiReports based on unsupported datasets

  • Aree di lavoro app modelloTemplate app workspaces

  • Report impaginatiPaginated reports

  • Flussi di datiDataflows

  • Set di dati di pushPUSH datasets

  • Cartelle di lavoroWorkbooks

Proprietà degli elementi copiate durante la distribuzioneItem properties copied during deployment

Durante la distribuzione, le proprietà degli elementi seguenti vengono copiate e sovrascrivono le proprietà degli elementi nella fase di destinazione:During deployment, the following item properties are copied and overwrite the item properties at the target stage:

  • Origini dati (le regole dei set di dati sono supportate)Data sources (dataset rules are supported)

  • Parametri (le regole dei set di dati sono supportate)Parameters (dataset rules are supported)

  • Oggetti visivi del reportReport visuals

  • Pagine del reportReport pages

  • I riquadri del dashboardDashboard tiles

  • Metadati modelloModel metadata

  • Relazioni tra elementiItem relationships

Proprietà degli elementi che non vengono copiateItem properties that are not copied

Durante la distribuzione non vengono copiate le proprietà degli elementi seguenti:The following item properties are not copied during deployment:

  • Dati: i dati non vengono copiati. Vengono copiati solo i metadatiData - Data isn't being copied, only metadata is copied

  • URLURL

  • IDID

  • Autorizzazioni: per un'area di lavoro o un elemento specificoPermissions - For a workspace or a specific item

  • Impostazioni dell'area di lavoro: ogni fase ha una propria area di lavoroWorkspace settings - Each stage has its own workspace

  • Contenuto e impostazioni delle app: per distribuire le app, vedere Distribuzione di app Power BIApp content and settings - To deploy your apps, see deploying Power BI apps

Durante la distribuzione non vengono copiate neanche le proprietà dei set di dati seguenti:The following dataset properties are also not copied during deployment:

  • Assegnazione di ruoloRole assignment

  • Pianificare gli aggiornamentiRefresh schedule

  • Credenziali origine datiData source credentials

  • Impostazioni di memorizzazione nella cache delle query (possono essere ereditate dalla capacità)Query caching settings (can be inherited from the capacity)

  • Impostazioni di approvazioneEndorsement settings

Funzionalità del set di dati supportateSupported dataset features

Le pipeline di distribuzione supportano molte funzionalità del set di dati di Power BI.Deployment pipelines supports many Power BI dataset features. In questa sezione vengono presentate due funzionalità del set di dati di Power BI che consentono di migliorare l'esperienza delle pipeline di distribuzione:This section lists two Power BI dataset features that can enhance your deployment pipelines experience:

Aggiornamento incrementaleIncremental refresh

Le pipeline di distribuzione supportano l'aggiornamento incrementale, una funzionalità che consente di aggiornare in modo più rapido e affidabile set di dati di grandi dimensioni con un consumo ridotto.Deployment pipelines supports incremental refresh, a feature that allows large datasets faster and more reliable refreshes, with lower consumption.

Le pipeline di distribuzione consentono di applicare aggiornamenti a un set di dati con l'aggiornamento incrementale, mantenendo nel contempo sia i dati sia le partizioni.With deployment pipelines, you can make updates to a dataset with incremental refresh while retaining both data and partitions. Quando si distribuisce il set di dati vengono distribuiti anche i criteri.When you deploy the dataset, the policy is copied along.

Attivazione dell'aggiornamento incrementale in una pipelineActivating incremental refresh in a pipeline

Per abilitare l'aggiornamento incrementale, attivarlo in Power BI Desktop e quindi pubblicare il set di dati.To enable incremental refresh, turn it on in Power BI Desktop, and then publish your dataset. Dopo la pubblicazione, i criteri di aggiornamento incrementale sono simili nell'intera pipeline e possono essere creati solo in Power BI Desktop.After you publish, the incremental refresh policy is similar across the pipeline, and can be authored only in Power BI Desktop.

Dopo aver configurato la pipeline con l'aggiornamento incrementale, è consigliabile usare il flusso seguente:Once your pipeline is configured with incremental refresh, we recommend that you use the following flow:

  1. Apportare modifiche al file PBIX in Power BI Desktop.Make changes to your PBIX file in Power BI Desktop. Per evitare tempi di attesa prolungati, è possibile apportare modifiche usando un campione dei dati.To avoid long waiting times, you can make changes using a sample of your data.

  2. Caricare il file PBIX nella fase di sviluppo.Upload your PBIX file to the development stage.

  3. Distribuire il contenuto nella fase di test.Deploy your content to the test stage. Dopo la distribuzione, le modifiche apportate verranno applicate all'intero set di dati in uso.After deployment, the changes you made will apply to the entire dataset you're using.

  4. Esaminare le modifiche apportate nella fase di test e dopo averle verificate, eseguire la distribuzione nella fase di produzione.Review the changes you made in the test stage, and after you verify them, deploy to the production stage.

Esempi di utilizzoUsage examples

Di seguito sono riportati esempi di come integrare l'aggiornamento incrementale con le pipeline di distribuzione.Below are a few examples of how you may integrate incremental refresh with deployment pipelines.

  • Creare una nuova pipeline e connetterla a un'area di lavoro con un set di dati in cui è abilitato l'aggiornamento incrementale.Create a new pipeline and connect to it a workspace with a dataset that has incremental refresh enabled.

  • Abilitare l'aggiornamento incrementale in un set di dati già presente in un'area di lavoro di sviluppo.Enable incremental refresh in a dataset that's already in a development workspace.

  • Creare una pipeline da un'area di lavoro di produzione con un set di dati che usa l'aggiornamento incrementale.Create a pipeline from a production workspace that has a dataset that uses incremental refresh. Questa operazione viene eseguita assegnando l'area di lavoro alla fase di produzione di una nuova pipeline e usando la distribuzione nella fase precedente per eseguire la distribuzione nella fase di test e quindi nella fase di sviluppo.This is done by assigning the workspace to a new pipeline's production stage, and using backwards deployment to deploy to the test stage, and then to the development stage.

  • Pubblicare un set di dati che usa l'aggiornamento incrementale in un'area di lavoro che fa parte di una pipeline esistente.Publish a dataset that uses incremental refresh to a workspace that's part of an existing pipeline.

Limitazioni e considerazioniLimitations and considerations

Per l'aggiornamento incrementale, le pipeline di distribuzione supportano solo i set di dati che usano i metadati del set di dati avanzati.For incremental refresh, deployment pipelines only supports datasets that use enhanced dataset metadata. A partire dalla versione di settembre 2020 di Power BI Desktop, tutti i set di dati creati o modificati con Power BI Desktop implementano automaticamente i metadati del set di dati avanzati.Beginning with the September 2020 release of Power BI Desktop, all datasets created or modified with Power BI Desktop automatically implement enhanced dataset metadata.

Quando si ripubblica un set di dati in una pipeline attiva con l'aggiornamento incrementale abilitato, le seguenti modifiche provocano un errore di distribuzione causato dalla possibile perdita di dati:When republishing a dataset to an active pipeline with incremental refresh enabled, the following changes will result in deployment failure due to data loss potential:

  • Ripubblicazione di un set di dati che non usa l'aggiornamento incrementale per sostituire un set di dati in cui è abilitato l'aggiornamento incrementale.Republishing a dataset that doesn't use incremental refresh, to replace a dataset that has incremental refresh enabled.

  • Ridenominazione di una tabella in cui è abilitato l'aggiornamento incrementale.Renaming a table that has incremental refresh enabled.

  • Ridenominazione di colonne non calcolate in una tabella in cui è abilitato l'aggiornamento incrementale.Renaming non-calculated columns in a table with incremental refresh enabled.

Altre modifiche sono consentite, ad esempio l'aggiunta di una colonna, la rimozione di una colonna e la ridenominazione di una colonna calcolata.Other changes such as adding a column, removing a column, and renaming a calculated column, are permitted. Se tuttavia le modifiche hanno effetto sulla visualizzazione, è necessario aggiornare per rendere visibile la modifica.However, if the changes affect the display, you'll need to refresh before the change is visible.

Modelli compositiComposite models

I modelli compositi consentono di impostare un report con più connessioni dati.Using composite models you can set up a report with multiple data connections.

È possibile usare la funzionalità dei modelli compositi per connettere un set di dati di Power BI a un set di dati esterno, ad esempio Azure Analysis Services.You can use the composite models functionality to connect a Power BI dataset to an external dataset such as Azure Analysis Services. Per altre informazioni, vedere Uso di DirectQuery per set di dati di Power BI e Azure Analysis Services.For more information, see Using DirectQuery for Power BI datasets and Azure Analysis Services.

In una pipeline di distribuzione è possibile usare i modelli compositi per connettere un set di dati a un altro set di dati di Power BI esterno alla pipeline.In a deployment pipeline, you can use composite models to connect a dataset to another Power BI dataset external to the pipeline.

LimitazioniLimitations

Le connessioni ai modelli compositi seguenti non sono supportate:The following composite models connections are not supported:

  • Connessione di set di dati che risiedono nella stessa area di lavoro.Connecting datasets that reside in the same workspace.

  • Connessione di set di dati che risiedono in pipeline separate.Connecting datasets that reside in distinct pipelines.

  • Connessione di set di dati che risiedono nella stessa pipeline.Connecting datasets that reside in the same pipeline.

Distribuzione di app Power BIDeploying Power BI apps

Le app Power BI rappresentano la modalità consigliata per la distribuzione di contenuto agli utenti che usano Power BI gratuitamente.Power BI apps are the recommended way of distributing content to free Power BI consumers. L'uso delle pipeline di distribuzione consente di gestire il ciclo di vita delle app Power BI all'interno di una pipeline con un controllo maggiore e una flessibilità più ampia.Using deployment pipelines you can manage Power BI apps in a deployment pipeline, so that you have more control and flexibility when it comes to your app's lifecycle.

Creare un'app per ogni fase della pipeline di distribuzione, in modo da poter testare ogni aggiornamento dell'app dal punto di vista dell'utente finale.Create an app for each deployment pipeline stage, so that you can test each app update from an end user's point of view. Con una pipeline di distribuzione questo processo può essere gestito con facilità.A deployment pipeline allows you to manage this process easily. Usare il pulsante di pubblicazione o visualizzazione nella scheda dell'area di lavoro per pubblicare o visualizzare l'app in una fase specifica della pipeline.Use the publish or view button in the workspace card, to publish or view the app in a specific pipeline stage.

Screenshot con il pulsante Pubblica app evidenziato nell'angolo inferiore destro della finestra della fase di produzione.A screenshot highlighting the publish app button, at the bottom right of the production stage.

Nella fase di produzione, il pulsante dell'azione principale nell'angolo inferiore destro apre la pagina di aggiornamento dell'app in Power BI, in modo che tutti gli aggiornamenti del contenuto diventino disponibili per gli utenti dell'app.In the production stage, the main action button on the bottom-right corner opens the update app page in Power BI, so that any content updates become available to app users.

Screenshot con il pulsante Aggiorna app evidenziato nell'angolo inferiore destro della finestra della fase di produzione.A screenshot highlighting the update app button, at the bottom right of the production stage.

Importante

Il processo di distribuzione non include l'aggiornamento del contenuto o delle impostazioni dell'app.The deployment process does not include updating the app content or settings. Per applicare le modifiche al contenuto o alle impostazioni, è necessario aggiornare manualmente l'app nella fase della pipeline richiesta.To apply changes to content or settings, you need to manually update the app in the required pipeline stage.

AutorizzazioniPermissions

Le autorizzazioni della pipeline e quelle dell'area di lavoro vengono concesse e gestite separatamente.Pipeline permissions and workspace permissions are granted and managed separately. Un utente con accesso alla pipeline che non ha autorizzazioni per l'area di lavoro, ad esempio, è in grado di visualizzare la pipeline e condividerla con altri utenti.For example, a user with pipeline access that doesn't have workspace permissions, will be able to view the pipeline and share it with others. Questo utente, tuttavia, non è in grado di visualizzare il contenuto dell'area di lavoro nella pipeline o nella pagina dell'area di lavoro e non è in grado di eseguire distribuzioni.However, this user will not be able to view the content of the workspace in the pipeline, or in the workspace page, and will not be able to perform deployments.

Utente con accesso alla pipelineUser with pipeline access

Gli utenti con accesso alla pipeline hanno le autorizzazioni seguenti:Users with pipeline access have the following permissions:

  • Visualizzazione della pipelineView the pipeline

  • Condivisione della pipeline con altri utentiShare the pipeline with others

  • Modifica ed eliminazione della pipelineEdit and delete the pipeline

Nota

L'accesso alla pipeline non implica la concessione delle autorizzazioni per la visualizzazione o l'esecuzione di azioni sul contenuto dell'area di lavoro.Pipeline access doesn't grant permissions to view or take actions on the workspace content.

Visualizzatore dell'area di lavoroWorkspace viewer

I visualizzatori dell'area di lavoro con accesso alla pipeline possono anche eseguire le operazioni seguenti:Workspace viewers that have pipeline access, can also do the following:

  • Utilizzare contenutoConsume content

Nota

I visualizzatori dell'area di lavoro non possono accedere al set di dati o modificare il contenuto dell'area di lavoro.Workspace viewers cannot access the dataset or edit workspace content.

Collaboratore dell'area di lavoroWorkspace contributor

I collaboratori dell'area di lavoro con accesso alla pipeline possono anche eseguire le operazioni seguenti:Workspace contributors that have pipeline access, can also do the following:

  • Utilizzare contenutoConsume content

  • Confrontare fasiCompare stages

  • Visualizzare set di datiView datasets

Membro dell'area di lavoroWorkspace member

I membri dell'area di lavoro con accesso alla pipeline possono anche eseguire le operazioni seguenti:Workspace members that have pipeline access, can also do the following:

  • Visualizzare il contenuto dell'area di lavoroView workspace content

  • Confrontare fasiCompare stages

  • Distribuire report e dashboardDeploy reports and dashboards

  • Rimuovere aree di lavoroRemove workspaces

Area di lavoro amministratoreWorkspace admin

Gli amministratori dell'area di lavoro con accesso alla pipeline possono eseguire le azioni dei membri dell'area di lavoro, oltre alle operazioni seguenti:Workspace administrators that have pipeline access, can perform workspace member actions, and also do the following:

  • Assegna aree di lavoroAssign workspaces

  • Rimuovere aree di lavoroRemove workspaces

Proprietario del set di datiDataset owner

I proprietari di set di dati che sono membri o amministratori dell'area di lavoro possono anche eseguire le operazioni seguenti:Dataset owners that are either workspace members or admins, can also do the following:

  • Aggiornare i set di datiUpdate datasets

  • Configurare le regoleConfigure rules

Nota

Questa sezione descrive le autorizzazioni utente nelle pipeline di distribuzione.This section describes user permissions in deployment pipelines. Le autorizzazioni elencate in questa sezione possono avere applicazioni diverse in altre funzionalità di Power BI.The permissions listed in this section may have different applications in other Power BI features.

LimitazioniLimitations

Questa sezione elenca la maggior parte delle limitazioni delle pipeline di distribuzione.This section lists most of the limitations in deployment pipelines.

Limitazioni del set di datiDataset limitations

  • Non è possibile distribuire i set di dati che usano la connettività dei dati in tempo reale.Datasets that use real-time data connectivity cannot be deployed.

  • Durante la distribuzione, se il set di dati di destinazione usa una connessione dinamica, anche il set di dati di origine deve usare questa modalità di connessione.During deployment, if the target dataset is using a live connection, the source dataset must use this connection mode too.

  • Dopo la distribuzione, il download di un set di dati (dalla fase in cui è stato distribuito) non è supportato.After deployment, downloading a dataset (from the stage it's been deployed to) is not supported.

  • Per l'elenco delle limitazioni delle regole del set di dati, vedere Limitazioni delle regole del set di dati.For a list of dataset rule limitations, see dataset rule limitations.

Passaggi successiviNext steps