Qual è un piano di distribuzione in Microsoft Fabric? (anteprima)

Un piano di distribuzione Microsoft Fabric è un elemento di spazio di lavoro che aggiunge un ordine esplicito degli elementi e azioni automatizzate a un'operazione di deployment. Usa un piano per distribuire gli oggetti in una sequenza specifica. Puoi anche usarlo per eseguire un notebook, una pipeline di dati o un altro elemento supportato prima o dopo il deployment di un elemento.

Un piano di distribuzione funziona con questi strumenti di implementazione:

Integrazione con Git
Pipeline di distribuzione
API REST supportate

In questo articolo, strumento di distribuzione si riferisce a uno qualsiasi di questi strumenti supportati. Non gestisci un piano da solo. Lo colleghi quando inizi un'operazione con uno strumento di deployment.

Important

Questa funzionalità si trova in Anteprima.

Quando utilizzare un piano di distribuzione

Utilizzare un piano di dispiegamento quando:

Scenario	Come un piano aiuta
Gli oggetti devono essere distribuiti in un ordine che la linea Fabric non rappresenta.	Il piano definisce dipendenze esplicite tra i gruppi di deployment.
Il lavoro deve essere eseguito prima o dopo il dispiegamento di un elemento.	Il piano gestisce gli elementi supportati come azioni pre-deploy o post-deploy.
L'operazione richiede sia un ordinamento esplicito sia le dipendenze degli elementi di Fabric.	Fabric combina il piano con la discendenza quando determina l'ordine degli oggetti.

Non serve un piano di dispiegamento quando l'ordine standard dello strumento di distribuzione è sufficiente e non sono necessarie azioni.

Componenti del piano di dispiegamento

Un piano di distribuzione contiene i seguenti componenti:

Componente	Purpose
Gruppo di distribuzione del software	Un elemento da distribuire e le relative azioni pre-distribuzione o post-distribuzione.
Passo	Distribuisce l'elemento in un gruppo di distribuzione.
Action	Un'esecuzione di un elemento supportato prima o dopo la distribuzione dell'elemento del gruppo.

Per tipi di azioni supportate e comportamenti d'azione, vedi Azioni del piano di distribuzione.

Come funziona un piano di dispiegamento

Ogni operazione di dispiegamento combina tre input:

Elementi selezionati: Gli elementi selezionati per l'operazione.
Piano di dispiegamento: l'ordine esplicito e le azioni associate a tali elementi.
Linea di Fabric: Le dipendenze che Fabric rileva tra gli oggetti.

Determinare l'ambito di distribuzione

Lo strumento di distribuzione determina l'origine, la destinazione e gli elementi dell'operazione. Allegare un piano non sostituisce quella scelta. Gli elementi selezionati che non fanno parte di un gruppo di distribuzione continuano a distribuire utilizzando il comportamento standard dello strumento.

Allegare un piano non seleziona automaticamente gli elementi a cui fa riferimento. Su una superficie di distribuzione selettiva, seleziona gli elementi che vuoi distribuire e assicurati che gli elementi richiesti dalle azioni del piano siano disponibili nello spazio di lavoro target quando tali azioni vengono eseguite.

Un piano di distribuzione controlla la distribuzione degli elementi e le azioni. Non distribuisce le configurazioni a livello di area di lavoro, come le identità dell'area di lavoro, le connessioni, le associazioni del gateway o le impostazioni di Spark. Configurare lo spazio di lavoro di destinazione prima di un'azione dipende da queste impostazioni.

Risolvere l'ordine di distribuzione

Fabric combina dipendenze esplicite tra gruppi di distribuzione con dipendenze rilevate dalla lineage. Un piano può aggiungere un ordine che la linea non rappresenta, ma non elimina le dipendenze che Fabric rileva.

Per uno scenario dettagliato che mostra come gli elementi selezionati, le dipendenze del piano, la discendenza e le azioni runtime lavorano insieme, vedi Esempi di piano di deployment.

Esegui gruppi di distribuzione e azioni

Per ogni gruppo di distribuzione, Fabric esegue le azioni preliminari alla distribuzione, distribuisce l'elemento del gruppo stesso e quindi esegue le azioni successive alla distribuzione. Le dipendenze tra gruppi e azioni determinano il loro ordine. La posizione di un elemento nel fascicolo del piano non ne definisce l'ordine.

Allegare un piano è opzionale. Senza un piano, lo strumento di distribuzione selezionato utilizza il suo comportamento standard.

Allega un piano di dispiegamento

Puoi allegare un piano quando usi un'operazione di integrazione Git supportata, distribuisci contenuti tramite una pipeline di distribuzione o chiami un'API REST supportata. L'allegato vale solo per quell'operazione. Per le interfacce supportate e il comportamento di selezione del piano, consulta Allega un piano di distribuzione.

Creare e versionare un piano di distribuzione

Crea un piano nel canvas del piano di distribuzione, in cui aggiungi gruppi di distribuzione, ne definisci l'ordine e configuri le azioni. Per le istruzioni, vedi Crea un piano di deployment.

Un piano di distribuzione è un elemento dell'area di lavoro. Quando lo spazio di lavoro è collegato a Git, esegui il commit del piano insieme agli elementi a cui fa riferimento, in modo che il piano possa avanzare nel processo CI/CD.

Se un'operazione fallisce

L'operazione si interrompe quando un elemento o un'azione fallisce e non annulla il lavoro completato. Per il comportamento dei guasti e i passaggi di risoluzione, vedi Troubleshoot deployment plans.

Considerazioni e limitazioni

Limitazioni del piano generale di dispiegamento

Non puoi usare un piano per distribuire in più di un workspace in un'unica esecuzione.
Puoi collegare un solo piano di dispiegamento a un'operazione di dispiegamento.

Limitazioni per l'allegazione di un piano

Un allegato del piano è valido solo per l'operazione corrente. Non puoi configurare un piano come predefinito per le future implementazioni o programmare il piano stesso. Se uno strumento di deployment programma un'operazione, l'operazione deve allegare il piano ogni volta che viene eseguita.
Non puoi allegare un piano a un'operazione di importazione con un singolo oggetto.
La fabric-cicd libreria non supporta i piani di implementazione.

Limitazioni durante una distribuzione

Non puoi distribuire gruppi di distribuzione indipendenti in parallelo.
Una distribuzione non riuscita non viene ripristinata. Gli elementi già distribuiti rimangono nello spazio di lavoro di destinazione, e gli oggetti successivi non vengono distribuiti.

Limitazioni per le azioni del piano

Solo le combinazioni supportate di oggetti e tipi di lavoro possono essere eseguite come azioni pre-deploy o post-deploy. Vedi Tipi di oggetti che puoi eseguire come azione.
Non puoi usare lo stesso elemento Dataflow Gen2 in più di un'azione in un piano. Il processo di aggiornamento non può essere eseguito in più istanze contemporaneamente, quindi l'area di disegno ti avvisa quando ne aggiungi una seconda e quest'ultima viene bloccata durante la distribuzione.
Non puoi restituire più di 512 KB da un'azione della funzione dati utente. La produzione maggiore viene troncata. L'azione ha comunque successo.
Non puoi fare in modo che un'azione aspetti che i servizi che alimenta si aggiornino. Un'azione si completa quando l'azione stessa termina, così che l'azione successiva possa iniziare prima che i dati prodotti siano interrogabili.
Non puoi usare un piano di distribuzione per cambiare il set di valori attivi di una libreria variabile durante il deployment. I riferimenti alle variabili vengono risolti in base all'insieme di valori già attivo nell'area di lavoro di destinazione. In uno spazio di lavoro di destinazione appena creato, Default è attivo finché non selezioni e salvi un altro set di valori. Per maggiori informazioni, vedi Libreria variabile CI/CD.

Limitazioni per la redazione dei piani

Non puoi aggiungere più di un elemento a un gruppo di distribuzione.
La tela supporta solo il layout automatico.

Limiti di dimensione del piano di dispiegamento

Un piano che supera anche uno solo di questi limiti viene rifiutato al momento del salvataggio. I limiti vengono applicati ogni volta che un piano viene salvato, quindi si applicano sia al canvas, all'API REST, a un pull da Git e a strumenti esterni.

Elemento	Limit
Dimensione del piano tariffario	1 MB
Lunghezza del nome di un gruppo o di una fase	60 caratteri
Gruppi del piano	1,000
Dipendenze da un gruppo	1,000
Azioni prima della distribuzione in un gruppo	20
Azioni post-dispiegamento in un gruppo	20
Dipendenze da un'azione	20
Parametri di un'azione	20

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-09-29