Exécuter une activité Fail dans Azure Data Factory et Synapse Analytics
Il se peut que vous souhaitiez parfois générer une erreur dans un pipeline de manière intentionnelle. Une activité Lookup peut ne renvoyer aucunes données correspondantes, ou une activité Custom peut se terminer par une erreur interne. Quelle que soit la raison, vous pouvez désormais utiliser une activité Fail dans un pipeline et personnaliser son message et son code d’erreur.
S’APPLIQUE À : 
Azure Data Factory Azure Synapse Analytics
Conseil
Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !
Créer une activité Fail avec l’interface utilisateur
Pour utiliser une activité Fail dans un pipeline, procédez comme suit :
Recherchez Fail dans le volet Activités du pipeline, puis faites glisser une activité Fail vers le canevas du pipeline.
Sélectionnez la nouvelle activité Fail sur le canevas si elle ne l’est pas déjà, et son onglet Paramètres, pour en modifier les détails.
Entrez un message d’échec et un code d’erreur. Ces valeurs peuvent être des expressions de chaîne littérales, ou toute combinaison d’expressions ou de fonctions dynamiques, de variables système ou de sorties d’autres activités.
Syntaxe
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Propriétés type
| Propriété | Description | Valeurs autorisées | Obligatoire |
|---|---|---|---|
| name | Nom de l’activité Fail. | String | Oui |
| type | Doit être défini sur Échec. | String | Oui |
| message | Message d’erreur qui est apparu dans l’activité Fail. Il peut s’agir de contenu dynamique à évaluer au moment de l’exécution. | Chaîne | Oui |
| errorCode | Code d’erreur qui catégorise le type d’erreur de l’activité Fail. Il peut s’agir de contenu dynamique à évaluer au moment de l’exécution. | Chaîne | Oui |
Comprendre le code d’erreur de l’activité Fail
Les auteurs de pipeline définissent généralement le message d’erreur et le code d’erreur de l’activité Fail. Pour comprendre les significations spécifiques des codes d’erreur, contactez le développeur du pipeline. Toutefois, dans les cas limites suivants, Azure Data Factory définit le message d’erreur et/ou le code d’erreur.
| Description de la situation | Message d’erreur | Code d'erreur |
|---|---|---|
Le contenu (dynamique) dans message et errorCode est interprété correctement. |
Message d’erreur défini par l’utilisateur | Code d’erreur défini par l’utilisateur |
Le contenu dynamique dans message et errorCode ne peut pas être interprété. |
« N’a pas pu interpréter le message d’échec < |
ErrorCodeNotString |
Le contenu dynamique dans message ne peut pas être interprété en tant que chaîne. |
« Le paramètre de message d’échec <nom_activité> n’a pas pu être interprété en tant que chaîne » | Code d’erreur défini par l’utilisateur |
Le contenu dynamique dans message se résout en Null, une chaîne vide ou des espaces blancs. |
« N’a pas pu interpréter le message d’échec < |
Code d’erreur défini par l’utilisateur |
Le contenu dynamique dans errorCode ne peut pas être interprété en tant que chaîne. |
Message d’erreur défini par l’utilisateur | ErrorCodeNotString |
Le contenu dynamique dans errorCode se résout en Null, une chaîne vide ou des espaces blancs. |
Message d’erreur défini par l’utilisateur | ErrorCodeNotString |
La valeur pour message ou errorCode fournie par l’utilisateur n’est pas convertible en chaîne.* |
Le pipeline échoue avec l’erreur « Valeur non valide de la propriété <errorCode/message>» |
|
Le champ message est manquant.* |
« Le message d’échec n’a pas été fourni » | Code d’erreur défini par l’utilisateur |
Le champ errorCode est manquant.* |
Message d’erreur défini par l’utilisateur | ErrorCodeNotString |
* Cette situation ne devrait pas se produire si le pipeline est développé avec l’interface utilisateur web de Data Factory.
Contenu connexe
Consultez d’autres activités de flux de contrôle prises en charge, à savoir :