Azure Data Factory ve Synapse Analytics'te Bir Başarısız Etkinlik Yürütme
Bazen kasıtlı olarak bir işlem hattında hata oluşturmak isteyebilirsiniz. Arama etkinliği eşleşen veri döndürmeyebilir veya Özel etkinlik bir iç hatayla bitebilir. Nedeni ne olursa olsun, artık işlem hattında Bir Başarısız etkinliği kullanabilir ve hem hata iletisini hem de hata kodunu özelleştirebilirsiniz.
UYGULANANLAR: 
Azure Data Factory Azure Synapse Analytics
İpucu
Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!
Kullanıcı arabirimiyle Bir Başarısız etkinlik oluşturma
İşlem hattında Bir Başarısız etkinliği kullanmak için aşağıdaki adımları tamamlayın:
İşlem hattı Etkinlikleri bölmesinde Başarısız'ı arayın ve bir Başarısız etkinliği işlem hattı tuvaline sürükleyin.
Tuvalde henüz seçili değilse yeni Başarısız etkinliği ve ayrıntılarını düzenlemek için Ayarlar sekmesini seçin.
Bir hata iletisi ve hata kodu girin. Bu değerler değişmez dize ifadeleri veya dinamik ifadelerin, işlevlerin, sistem değişkenlerinin veya diğer etkinliklerden gelen çıkışların herhangi bir bileşimi olabilir.
Sözdizimi
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Tür özellikleri
| Özellik | Açıklama | İzin verilen değerler | Zorunlu |
|---|---|---|---|
| Adı | Başarısız etkinliğinin adı. | String | Yes |
| Tür | Başarısız olarak ayarlanmalıdır. | String | Yes |
| ileti | Başarısız etkinliğinde ortaya çıkarılan hata iletisi. Çalışma zamanında değerlendirilecek dinamik içerik olabilir. | String | Yes |
| errorCode | Başarısız etkinliğinin hata türünü kategorilere ayıran hata kodu. Çalışma zamanında değerlendirilecek dinamik içerik olabilir. | String | Yes |
Başarısız etkinlik hata kodunu anlama
İşlem hattı yazarları normalde Hata etkinliğinin hata iletisini ve hata kodunu ayarlar. Hata kodlarının belirli anlamlarını anlamak için işlem hattı geliştiricisine başvurun. Ancak aşağıdaki uç durumlarda Azure Data Factory hata iletisini ve/veya hata kodunu ayarlar.
| Durum açıklaması | Hata İletisi | Hata kodu |
|---|---|---|
içindeki message errorCode (dinamik) içerik doğru yorumlanır. |
Kullanıcı tarafından ayarlanan hata iletisi | Kullanıcı tarafından ayarlanan hata kodu |
hem içindeki hem de message errorCode içindeki dinamik içerik yorumlanamaz. |
"Başarısız activity_name> iletisi veya hata kodu yorumlanamadı<" | ErrorCodeNotString |
içindeki message dinamik içerik dize olarak yorumlanamaz. |
"<activity_name> başarısız ileti parametresi dize olarak yorumlanamadı" | Kullanıcı tarafından ayarlanan hata kodu |
içindeki message dinamik içerik null, boş dize veya boşluklara çözümür. |
"Başarısız activity_name> iletisi veya hata kodu yorumlanamadı<" | Kullanıcı tarafından ayarlanan hata kodu |
içindeki errorCode dinamik içerik dize olarak yorumlanamaz. |
Kullanıcı tarafından ayarlanan hata iletisi | ErrorCodeNotString |
içindeki errorCode dinamik içerik null, boş dize veya boşluklara çözümür. |
Kullanıcı tarafından ayarlanan hata iletisi | ErrorCodeNotString |
kullanıcı tarafından sağlanan veya errorCode değeri message dizeye uygun değil.* |
İşlem hattı şu hatayla başarısız oluyor: "Özellik><errorCode/message için geçersiz değer" |
|
Alan message eksik.* |
"Başarısız ileti sağlanmadı" | Kullanıcı tarafından ayarlanan hata kodu |
Alan errorCode eksik.* |
Kullanıcı tarafından ayarlanan hata iletisi | ErrorCodeNotString |
* İşlem hattı Data Factory'nin web kullanıcı arabirimi (UI) ile geliştirilmişse bu durum oluşmamalıdır.
İlgili içerik
Desteklenen diğer denetim akışı etkinliklerine bakın, örneğin: