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à Lookup potrebbe non restituire dati corrispondenti oppure un'Attività personalizzata potrebbe terminare con un errore interno. Indipendentemente dal motivo, è ora possibile usare un'attività non riuscita 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 all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!
Creare un'attività Fail con l'interfaccia utente
Per usare un'attività non riuscita in una pipeline, completare la procedura seguente:
Cercare Fail nel riquadro Attività della 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. Questi valori possono essere espressioni stringa letterali o qualsiasi combinazione di espressioni, funzioni dinamiche, 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 | Obbligatoria |
|---|---|---|---|
| name | Nome dell'attività Fail. | String | Sì |
| type | Deve essere impostato su Fail. | String | Sì |
| messaggio | Messaggio di errore visualizzato nell'attività Fail. Può essere contenuto dinamico da valutare in fase di esecuzione. | String | Sì |
| errorCode | Codice di errore che classifica il tipo di errore dell'attività Fail. Può essere contenuto dinamico da valutare in fase di esecuzione. | String | Sì |
Informazioni sul codice di errore dell'attività Fail
Gli autori della pipeline impostano in genere il messaggio di errore e il codice di errore dell'attività Fail. Per comprendere i significati specifici dei codici di errore, contattare lo sviluppatore della pipeline. Tuttavia, nei casi limite seguenti, Azure Data Factory imposta il messaggio di errore e/o il codice di errore.
| Descrizione della situazione | Messaggio d'errore | Codice 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 sia in message che in errorCode non può essere interpretato. |
"Non è possibile interpretare il messaggio di errore o codice di errore di <activity_name>" | ErrorCodeNotString |
Il contenuto dinamico in message non può essere interpretato come stringa. |
"Non è stato possibile interpretare il parametro del messaggio di errore di <activity_name> come stringa" | Codice di errore impostato dall'utente |
Il contenuto dinamico in message viene risolto in valori Null, in una stringa vuota o in spazi vuoti. |
"Non è possibile interpretare il messaggio di errore o codice di errore di <activity_name>" | 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 errorCode viene risolto in valori 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 può essere convertito in stringhe.* |
La pipeline riscontra un errore con: "Tipo di valore non valido per la proprietà <errorCode/message>" |
|
Il campo message è mancante.* |
"Messaggio di errore non specificato" | Codice di errore impostato dall'utente |
Il campo errorCode è 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à del flusso di controllo supportate, tra cui: