Automatizza la pipeline di distribuzione con le API di Fabric
Lo strumento Pipeline di distribuzione di Microsoft Fabric consente ai team di creare un processo di rilascio efficiente e riutilizzabile per il contenuto di Fabric.
Importante
Questa funzionalità è in anteprima.
Usare le API REST di Fabric per le pipeline di distribuzione per integrare Fabric nel processo di automazione dell'organizzazione. Ecco alcuni esempi di operazioni che possono essere eseguite usando le API:
Integrare Fabric in strumenti DevOps familiari, ad esempio Azure DevOps o GitHub Actions.
Pianificare le distribuzioni della pipeline in modo che vengano eseguite automaticamente in un momento specifico.
Distribuire più pipeline contemporaneamente.
A catena a seconda delle distribuzioni della pipeline. Se si dispone di contenuto connesso tra pipeline, è possibile assicurarsi che alcune pipeline vengano distribuite prima di altre.
Prerequisiti
Per lavorare con le API della pipeline di distribuzione, sono necessari i prerequisiti seguenti:
- Gli stessi prerequisiti necessari per usare le pipeline di distribuzione.
- Un token Microsoft Entra per il servizio Fabric. Usare tale token nell'intestazione dell'autorizzazione della chiamata API. Per informazioni su come ottenere un token, vedere Avvio rapido dell'API di Fabric.
È possibile usare le API REST senza PowerShell, ma gli script in questo articolo usano PowerShell. Per eseguire gli script, occorre installare i seguenti programmi:
Funzioni API delle pipeline di distribuzione
Le API REST di Fabric per le pipeline di distribuzione consentono di eseguire le funzioni seguenti:
Ottieni pipeline di distribuzione: restituisce informazioni sulla pipeline di distribuzione specificata.
Elenca le pipeline di distribuzione: restituisce un elenco di pipeline di distribuzione a cui l'utente ha accesso.
Elenca le fasi della pipeline di distribuzione: restituisce le fasi della distribuzione specificata, inclusi l'ID, il nome visualizzato, la descrizione e se la fase è pubblica o meno.
Elenca gli elementi della fase della pipeline di distribuzione: restituisce gli elementi supportati dall'area di lavoro assegnata alla fase specificata della pipeline di distribuzione specificata.
Distribuisci contenuto della fase: distribuisce gli elementi dalla fase specificata della pipeline di distribuzione specificata.
Usare questa API per distribuire tutti gli elementi o per selezionare elementi specifici da distribuire. Se non sono selezionati elementi specifici, vengono distribuiti tutti gli elementi.
Per trovare l'ID di fase pertinente da distribuire, usare l'API List Deployment Pipeline Stages (Fasi della pipeline di distribuzione elenco).
Questa API è integrata con le API Operazioni a esecuzione prolungata per monitorare lo stato della distribuzione.
- Ottenere lo stato dell'operazione per verificare se l'operazione è completa con l'API Ottieni esecuzione prolungata – Ottieni stato dell'operazione.
- Per 24 ore dopo il completamento della distribuzione, le informazioni sulla distribuzione estesa sono disponibili nell'API Ottieni risultato dell'operazione.
È anche possibile usare altre chiamate dell'API REST di Fabric per completare le operazioni correlate.
Esempi di PowerShell
È possibile usare gli script di PowerShell seguenti per comprendere come eseguire diversi processi di automazione. Per visualizzare o copiare il testo in un esempio di PowerShell, usare i collegamenti in questa sezione.
-
Specificare le informazioni seguenti:
- Nome della pipeline
- Nome della fase di origine
- Nome della fase di destinazione
- Note sulla distribuzione (facoltativo)
-
Specificare le informazioni seguenti:
- Nome della pipeline
- Nome della fase di origine
- Nome della fase di destinazione
- Elementi da distribuire (nome visualizzato degli elementi e tipo di elemento)
- Note sulla distribuzione (facoltativo)
Considerazioni e limitazioni
Quando si usano le API delle pipeline di distribuzione, considerare le limitazioni seguenti:
Tutte le limitazioni che si applicano per la pipeline di distribuzione sono valide quando si usano le API. Per altre informazioni, vedere Procedure consigliate per le pipeline di distribuzione.
I flussi di dati non sono attualmente supportati. I clienti che usano flussi di dati possono usare le API Power BI.
Le entità servizio sono supportate solo per gli elementi di Power BI.
Non tutte le opzioni di distribuzione disponibili nelle API Power BI sono disponibili in Fabric. Le seguenti API non sono disponibili nell'API Distribuisci contenuto della fase di Fabric:
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Se è necessaria una di queste API, usare l'API Power BI per la distribuzione. Queste API, tuttavia, funzionano solo per gli elementi di Power BI.