Eseguire un'attività fail in Azure Data Factory e Synapse Analytics
In alcuni casi potrebbe essere necessario generare un errore in una pipeline intenzionalmente. Un'attività di ricerca potrebbe non restituire dati corrispondenti oppure un'attività personalizzata potrebbe terminare con un errore interno. Indipendentemente dal motivo, è ora possibile usare un'attività Fail in una pipeline e personalizzarne il messaggio di errore e il codice di errore.
SI APPLICA A:
Azure Data Factory Azure Synapse Analytics
Suggerimento
Provare Data Factory in Microsoft Fabric, una soluzione di analisi completa per le aziende. Microsoft Fabric copre tutti gli elementi, dallo spostamento dei dati all'analisi scientifica dei dati, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Scopri come avviare gratuitamente una nuova versione di valutazione .
Creare un'attività di errore con l'interfaccia utente
Per usare un'attività Fail in una pipeline, completare la procedura seguente:
Cercare Fail nel riquadro Attività pipeline e trascinare un'attività Fail nell'area di disegno della pipeline.
Selezionare la nuova attività Fail nell'area di disegno se non è già selezionata e la relativa scheda Impostazioni per modificarne i dettagli.
Immettere un messaggio di errore e un codice di errore. Possono essere espressioni stringa letterali o qualsiasi combinazione di espressioni dinamiche , funzioni, variabili di sistema o output di altre attività.
Sintassi
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Proprietà del tipo
| Proprietà | Descrizione | Valori consentiti | Obbligatorio |
|---|---|---|---|
| name | Nome dell'attività Fail. | Stringa | Sì |
| Tipo | Deve essere impostato su Fail. | Stringa | Sì |
| messaggio | Messaggio di errore visualizzato nell'attività Fail. Può trattarsi di contenuto dinamico valutato in fase di esecuzione. | Stringa | Sì |
| errorCode | Codice di errore che classifica il tipo di errore dell'attività Fail. Può trattarsi di contenuto dinamico valutato in fase di esecuzione. | Stringa | Sì |
Informazioni sul codice di errore dell'attività Fail
Il messaggio di errore e il codice di errore di un'attività Fail vengono in genere impostati dagli utenti. Per comprendere i significati specifici dei codici di errore, contattare lo sviluppatore della pipeline. Tuttavia, nei casi perimetrali seguenti, Azure Data Factory imposta il messaggio di errore e/o il codice di errore.
| Descrizione della situazione | Error message | Codice di errore |
|---|---|---|
Il contenuto (dinamico) in message e errorCode viene interpretato correttamente. |
Messaggio di errore impostato dall'utente | Codice di errore impostato dall'utente |
Il contenuto dinamico in e message errorCode non può essere interpretato. |
"Impossibile interpretare <activity_name> messaggio di errore o codice di errore" | ErrorCodeNotString |
Il contenuto dinamico in message non può essere interpretato come stringa. |
"<impossibile interpretare> activity_name parametro del messaggio di errore come stringa" | Codice di errore impostato dall'utente |
Il contenuto dinamico in viene risolto in message null, in una stringa vuota o in spazi vuoti. |
"Impossibile interpretare <activity_name> messaggio di errore o codice di errore" | Codice di errore impostato dall'utente |
Il contenuto dinamico in errorCode non può essere interpretato come stringa. |
Messaggio di errore impostato dall'utente | ErrorCodeNotString |
Il contenuto dinamico in viene risolto in errorCode null, in una stringa vuota o in spazi vuoti. |
Messaggio di errore impostato dall'utente | ErrorCodeNotString |
Il valore per message o errorCode fornito dall'utente non è in grado di eseguire stringhe.* |
La pipeline ha esito negativo con: "Valore non valido per la proprietàmessage</errorCode> " |
|
Il message campo è mancante.* |
"Messaggio di errore non specificato" | Codice di errore impostato dall'utente |
Il errorCode campo è mancante.* |
Messaggio di errore impostato dall'utente | ErrorCodeNotString |
* Questa situazione non dovrebbe verificarsi se la pipeline viene sviluppata con l'interfaccia utente Web di Data Factory.
Contenuto correlato
Vedere altre attività di flusso di controllo supportate, tra cui: