Bagikan melalui


Membuat dependensi pemicu jendela jatuh

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!

Artikel ini menyediakan langkah-langkah untuk membuat dependensi pemicu jendela jatuh. Untuk informasi umum tentang pemicu Jendela Jatuh, lihat Cara membuat pemicu jendela jatuh.

Untuk membangun rantai dependensi dan memastikan bahwa pemicu dijalankan hanya setelah keberhasilan eksekusi pemicu lain dalam layanan, gunakan fitur tingkat lanjut ini untuk membuat dependensi jendela jatuh.

Untuk demonstrasi tentang cara membuat alur dependen menggunakan pemicu jendela jatuh, tonton video berikut:

Membuat dependensi di UI

Untuk membuat ketergantungan pada pemicu, pilih Pemicu > Lanjutan > Baru, lalu pilih pemicu untuk bergantung dengan offset dan ukuran yang sesuai. Pilih Selesai dan terbitkan perubahan agar dependensi diterapkan.

Screenshot of the dependency creation window.

Properti dependensi jendela jatuh

Pemicu jendela jatuh dengan dependensi yang memiliki properti berikut:

{
    "name": "MyTriggerName",
    "properties": {
        "type": "TumblingWindowTrigger",
        "runtimeState": <<Started/Stopped/Disabled - readonly>>,
        "typeProperties": {
            "frequency": <<Minute/Hour>>,
            "interval": <<int>>,
            "startTime": <<datetime>>,
            "endTime": <<datetime - optional>>,
            "delay": <<timespan - optional>>,
            "maxConcurrency": <<int>> (required, max allowed: 50),
            "retryPolicy": {
                "count": <<int - optional, default: 0>>,
                "intervalInSeconds": <<int>>,
            },
            "dependsOn": [
                {
                    "type": "TumblingWindowTriggerDependencyReference",
                    "size": <<timespan - optional>>,
                    "offset": <<timespan - optional>>,
                    "referenceTrigger": {
                        "referenceName": "MyTumblingWindowDependency1",
                        "type": "TriggerReference"
                    }
                },
                {
                    "type": "SelfDependencyTumblingWindowTriggerReference",
                    "size": <<timespan - optional>>,
                    "offset": <<timespan>>
                }
            ]
        }
    }
}

Tabel berikut ini menyediakan daftar atribut yang diperlukan untuk menentukan dependensi Jendela Jatuh.

Nama Properti Keterangan Jenis Diperlukan
jenis Semua pemicu jendela jatuh yang ada ditampilkan dalam daftar menurun ini. Memilih pemicu untuk mengaktifkan dependensi. TumblingWindowTriggerDependencyReference atau SelfDependencyTumblingWindowTriggerReference Ya
offset Offset pemicu dependensi. Berikan nilai dalam format rentang waktu serta offset negatif dan positif diizinkan. Properti ini wajib jika pemicunya tergantung pada pemicunya sendiri dan dalam semua kasus lain hal ini adalah opsional. Dependensi mandiri selalu menjadi offset negatif. Jika tidak ada nilai yang ditentukan, jendela sama dengan pemicu itu sendiri. Rentang waktu
(hh:mm:ss)
Dependensi Mandiri: Ya
Lainnya: Tidak
size Ukuran jendela jatuh dependensi. Memberikan nilai rentang waktu yang positif. Properti ini bersifat opsional. Rentang waktu
(hh:mm:ss)
Tidak

Catatan

Pemicu jendela jatuh dapat bergantung pada maksimal lima pemicu lainnya.

Properti dependensi mandiri jendela jatuh

Dalam skenario di mana pemicu tidak boleh melanjutkan ke jendela berikutnya hingga jendela sebelumnya berhasil diselesaikan, bangun dependensi mandiri. Pemicu ketergantungan mandiri yang tergantung pada keberhasilan eksekusi pemicu sebelumnya dalam jam sebelumnya akan memiliki properti yang ditunjukkan dengan kode berikut.

Catatan

Jika alur yang dipicu mengandalkan output alur di jendela yang dipicu sebelumnya, sebaiknya gunakan hanya dependensi mandiri pemicu jendela jatuh. Untuk membatasi pemicu eksekusi paralel, atur konkurensi pemicu maksimal.

{
    "name": "DemoSelfDependency",
    "properties": {
        "runtimeState": "Started",
        "pipeline": {
            "pipelineReference": {
                "referenceName": "Demo",
                "type": "PipelineReference"
            }
        },
        "type": "TumblingWindowTrigger",
        "typeProperties": {
            "frequency": "Hour",
            "interval": 1,
            "startTime": "2018-10-04T00:00:00Z",
            "delay": "00:01:00",
            "maxConcurrency": 50,
            "retryPolicy": {
                "intervalInSeconds": 30
            },
            "dependsOn": [
                {
                    "type": "SelfDependencyTumblingWindowTriggerReference",
                    "size": "01:00:00",
                    "offset": "-01:00:00"
                }
            ]
        }
    }
}

Skenario penggunaan dan contoh

Di bawah ini adalah ilustrasi skenario dan penggunaan properti dependensi jendela jatuh.

Offset dependensi

Offset Example

Ukuran dependensi

Size example

Dependensi mandiri

Self-dependency

Dependensi pada pemicu jendela jatuh lainnya

Pekerjaan pemrosesan telemetri harian tergantung pada pekerjaan harian lain yang mengumpulkan output tujuh hari terakhir dan menghasilkan aliran jendela bergulir tujuh hari:

Dependency example

Dependensi pada dirinya sendiri

Pekerjaan sehari-hari tanpa celah dalam aliran output pekerjaan:

Self-dependency example

Memantau dependensi

Anda dapat memantau rantai dependensi dan jendela yang sesuai dari halaman pemantauan eksekusi pemicu. Navigasikan ke Pemantauan > Eksekusi Pemicu. Jika pemicu Jendela Jatuh memiliki dependensi, Nama Pemicu akan menampilkan hyperlink ke tampilan pemantauan dependensi.

Monitor trigger runs

Klik nama pemicu untuk melihat dependensi pemicu. Panel kanan menunjukkan informasi eksekusi pemicu secara mendetail, seperti RunID, waktu jendela, status, dan sebagainya.

Monitor dependencies list view

Anda dapat melihat status dependensi, dan jendela untuk masing-masing pemicu dependen. Jika salah satu pemicu dependensi gagal, Anda harus berhasil menjalankannya kembali agar pemicu dependen dapat berjalan.

Pemicu jendela jatuh akan menunggu dependensi selama tujuh hari sebelum waktu habis. Setelah tujuh hari, eksekusi pemicu akan gagal.

Catatan

Pemicu jendela tumbling tidak dapat dibatalkan saat berada dalam status Menunggu dependensi . Aktivitas dependen harus selesai sebelum pemicu jendela tumbling dapat dibatalkan. Ini dirancang untuk memastikan aktivitas dependen dapat selesai setelah dimulai, dan membantu mengurangi kemungkinan hasil yang tidak terduga.

Agar lebih visual menampilkan jadwal dependensi pemicu, pilih tampilan Gantt.

Monitor dependencies gantt chart

Kotak transparan menunjukkan jendela dependensi untuk masing-masing pemicu tergantung aliran bawah, sementara kotak berwarna solid di atas menunjukkan masing-masing jendela yang berjalan. Berikut adalah beberapa tips untuk menginterpretasikan tampilan bagan Gantt:

  • Kotak transparan merender biru saat jendela dependen dalam status tertunda atau berjalan
  • Setelah semua jendela berhasil untuk pemicu dependen, kotak transparan akan berubah menjadi hijau
  • Kotak transparan merender merah saat beberapa jendela dependen gagal. Cari kotak merah solid untuk mengidentifikasi eksekusi jendela yang gagal

Untuk menjalankan ulang jendela dalam tampilan bagan Gantt, pilih kotak warna solid untuk jendela, dan panel tindakan akan muncul dengan opsi detail dan jalankan ulang