Bagikan melalui

Menjalankan aktivitas Gagal di Azure Data Factory dan Synapse Analytics

  • Artikel

Anda mungkin kadang-kadang ingin membuang kesalahan dalam alur dengan sengaja. Aktivitas Pencarian mungkin tidak menampilkan data yang cocok, atau Aktivitas Kustom mungkin selesai dengan kesalahan internal. Apa pun alasannya, sekarang Anda dapat menggunakan aktivitas Gagal dalam alur dan menyesuaikan pesan kesalahan dan kode galatnya.

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Membuat aktivitas Gagal dengan antarmuka pengguna

Untuk menggunakan aktivitas Gagal dalam alur, selesaikan langkah-langkah berikut:

  1. Cari Gagal di panel Aktivitas alur, dan seret aktivitas Gagal ke kanvas alur.

  2. Pilih aktivitas Gagal baru di kanvas jika belum dipilih, dan tab Pengaturannya, untuk mengedit detailnya.

    Menampilkan UI untuk aktivitas Gagal.

  3. Masukkan pesan kegagalan dan kode kesalahan. Nilai-nilai ini dapat berupa ekspresi string harfiah, atau kombinasi ekspresi dinamis , fungsi, variabel sistem, atau output dari aktivitas lain.

Sintaks

{
    "name": "MyFailActivity",
    "type": "Fail",
    "typeProperties": {
        "errorCode": "500",
        "message": "My Custom Error Message"
    }
}

Properti jenis

Properti Deskripsi Nilai yang diizinkan Wajib
nama Nama aktivitas Gagal. String Ya
jenis Harus ditetapkan ke Gagal. String Ya
pesan Pesan kesalahan yang muncul dalam aktivitas Gagal. Ini dapat berupa konten dinamis yang akan dievaluasi saat runtime. String Ya
errorCode Kode galat yang mengategorikan jenis kesalahan aktivitas Gagal. Ini dapat berupa konten dinamis yang akan dievaluasi saat runtime. String Ya

Memahami kode galat aktivitas Gagal

Penulis alur biasanya mengatur pesan kesalahan dan kode kesalahan aktivitas Gagal. Hubungi pengembang alur untuk memahami arti spesifik dari kode galat. Namun, dalam kasus tepi berikut, Azure Data Factory menetapkan pesan kesalahan dan/atau kode galat.

Deskripsi situasi Pesan kesalahan Kode kesalahan
Konten (dinamis) di message dan errorCode ditafsirkan dengan benar. Pesan kesalahan yang ditetapkan oleh pengguna Kode kesalahan yang ditetapkan oleh pengguna
Konten dinamis di message dan errorCode tidak dapat ditafsirkan. "Gagal menafsirkan <activity_name> pesan gagal atau kode galat" ErrorCodeNotString
Konten dinamis di message tidak dapat ditafsirkan sebagai untai. "<activity_name> parameter pesan gagal tidak dapat ditafsirkan sebagai string" Kode kesalahan yang ditetapkan oleh pengguna
Konten dinamis di message diselesaikan ke null, untai kosong, atau spasi kosong. "Gagal menafsirkan <activity_name> pesan gagal atau kode galat" Kode kesalahan yang ditetapkan oleh pengguna
Konten dinamis di errorCode tidak dapat ditafsirkan sebagai untai. Pesan kesalahan yang ditetapkan oleh pengguna ErrorCodeNotString
Konten dinamis di errorCode diselesaikan ke null, untai kosong, atau spasi kosong. Pesan kesalahan yang ditetapkan oleh pengguna ErrorCodeNotString
Nilai untuk message atau errorCode yang disediakan oleh pengguna tidak dapat diuntai.* Alur gagal dengan: "Nilait tidak valid untuk properti <errorCode/message>"
Bidang message tidak ada.* "Pesan gagal tidak disediakan" Kode kesalahan yang ditetapkan oleh pengguna
Bidang errorCode tidak ada.* Pesan kesalahan yang ditetapkan oleh pengguna ErrorCodeNotString

* Situasi ini tidak akan terjadi jika alur dikembangkan dengan antarmuka pengguna (UI) web Data Factory.

Konten terkait

Lihat aktivitas alur kontrol yang didukung lainnya, seperti: