Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Un'azione è un'esecuzione di un elemento dell'area di lavoro che una distribuzione esegue prima o dopo la distribuzione di un altro elemento. Le azioni consentono a un piano di distribuzione di eseguire operazioni che la sola distribuzione dei metadati degli elementi non può eseguire, ad esempio popolare una tabella del lakehouse prima della distribuzione di una vista del warehouse che la legge.
Un'azione appartiene a un gruppo di distribuzione, e un gruppo distribuisce esattamente un elemento. Le azioni del gruppo ruotano attorno al dispiegamento di quell'elemento.
Important
Questa funzionalità si trova in Anteprima.
Azioni pre-distribuzione e post-distribuzione
Ogni gruppo di distribuzione comporta due serie di azioni:
- Le azioni pre-deploy si svolgono prima che l'elemento del gruppo venga dispiegato.
- Le azioni post-deploy vengono eseguite dopo che l'elemento del gruppo è stato dispiegato.
Un'azione pre-deploy non può eseguire lo stesso elemento che il suo gruppo distribuisce, perché quell'elemento non è ancora stato distribuito quando l'azione viene eseguita.
Tipi di oggetti che puoi usare come azione
I seguenti tipi di elementi possono essere eseguiti come azioni del piano di deployment:
| Tipo di elemento | Tipo di job |
|---|---|
| Notebook | Execute |
| Pipeline di dati | Execute |
| Flusso di dati Gen2 | Execute |
| Attività di copia | Execute |
| Funzione dati utente | Execute |
Per la struttura della definizione e le proprietà del lavoro, vedi Definizione del piano di deployment.
Ogni azione fa girare l'oggetto. L'elemento definisce cosa fa l'azione e quali parametri accetta, non il piano.
Nessun altro tipo di oggetto può essere eseguito come azione. Per i tipi di oggetti che sono in considerazione ma non supportati, vedi Considerazioni e limitazioni.
Ordina azioni all'interno di un gruppo di dispiegamento
Azioni a catena per controllare l'ordine in cui si svolgono. Quando concateni un'azione all'altra, il deployment le esegue in quella sequenza, così puoi ordinare un'azione che carica i dati prima di quella che li valida.
Nell'immagine precedente, la catena nel gruppo lakehouse viene eseguita Refresh_Sales prima di Validate_Sales. Il seguente gruppo di magazzini esegue Notify prima di distribuire il magazzino.
Si applicano le seguenti regole:
- Puoi concatenare un'azione ad altre azioni nello stesso gruppo di distribuzione. Nel file di piano, una catena è una dipendenza dal nome di un'altra azione.
- I nomi delle azioni devono essere univoci all'interno del rispettivo gruppo di distribuzione, perché una catena fa riferimento a un'azione tramite il nome.
- Una catena non può ripiegarsi su se stessa. Il sistema rifiuta un ciclo di dipendenza quando salvi il piano.
- Le azioni si svolgono una alla volta. Le azioni che non concateni tra loro comunque non si svolgono in parallelo.
Un'operazione di distribuzione si interrompe al primo guasto e il sistema non annulla alcuna modifica. Per maggiori informazioni, vedi Se un'operazione fallisce.
Passa i parametri a un'azione
Un'azione può includere parametri, che il piano passa all'elemento su cui viene eseguita l'azione. Ogni parametro ha un nome e un valore, e i nomi dei parametri devono essere unici all'interno di un'azione.
Un valore di parametro è o un valore letterale o un riferimento a una variabile in una libreria di variabili. Un riferimento variabile permette a un singolo piano di fornire valori diversi per ambiente, invece di codificare rigidamente un valore corretto in un solo spazio di lavoro.
Un riferimento a una variabile che non si risolve in un tipo di variabile noto viene rifiutato quando il piano viene salvato.
Poiché il piano trasmette i valori all'elemento, fornisci i parametri che l'articolo si aspetta. Per quali parametri un elemento accetta, consulta la documentazione di quel tipo di elemento.
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-cicdlibreria 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 |