Azure Data Factory ve Synapse Analytics'te Bir Başarısız Etkinliği 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.

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'te Data Factory'deki eşdeğer etkinlik için bkz. Başarısız aktivite.

Kullanıcı arabirimiyle bir Hata Etkinliği oluşturma

İşlem hattında Başarısız Etkinliği kullanmak için aşağıdaki adımları tamamlayın:

  1. İş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.

  2. Henüz seçili değilse, tuvaldeki yeni Fail etkinliğini ve Ayarlar sekmesini seçerek ayrıntılarını düzenleyin.

    Bir başarısızlık aktivitesi için kullanıcı arayüzünü gösterir.

  3. 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ı. Dize Yes
Tür Başarısız olarak ayarlanmalıdır. Dize Yes
ileti Başarısız Etkinlik'te ortaya çıkan hata iletisi. Çalışma zamanında değerlendirilecek dinamik içerik olabilir. Dize Yes
hataKodu 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. Dize Yes

Başarısız etkinlik hata kodunu anlama

İşlem hattı yazarları normalde Fail etkinliğinin hata mesajını 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 messageerrorCode (dinamik) içerik doğru yorumlanır. Kullanıcı tarafından ayarlanan hata iletisi Kullanıcı tarafından ayarlanan hata kodu
Hem message hem de errorCode içindeki dinamik içerik yorumlanamaz. "<activity_name> hata mesajı veya hata kodu çözülemedi" 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
message içindeki dinamik içerik null, boş bir dize veya boşluklar olarak çözülür. "<activity_name> hata mesajı veya hata kodu çözülemedi" Kullanıcı tarafından ayarlanan hata kodu
içindeki errorCode dinamik içerik dize olarak yorumlanamaz. Kullanıcı tarafından ayarlanan hata iletisi ErrorCodeNotString
errorCode içindeki dinamik içerik null, boş bir dize veya boşluklar olarak çözülür. Kullanıcı tarafından ayarlanan hata iletisi ErrorCodeNotString
Kullanıcı tarafından sağlanan message veya errorCode değeri, dizeye dönüştürülebilir 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ızlık mesajı verilmedi 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:

  • Last updated on