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 tumbling, lihat Membuat pemicu jendela tumbling.

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 tumbling.

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

Membuat dependensi di UI

Untuk membuat dependensi pada pemicu, pilih Picu>Tingkat Lanjut>Baru. Kemudian pilih pemicu untuk bergantung pada offset dan ukuran yang sesuai. Pilih Selesai dan terbitkan perubahan agar dependensi diterapkan.

Cuplikan layar yang memperlihatkan jendela pembuatan dependensi.

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 Deskripsi Jenis Wajib
type Semua pemicu jendela tumbling yang ada ditampilkan dalam daftar dropdown ini. Memilih pemicu untuk mengaktifkan dependensi. TumblingWindowTriggerDependencyReference atau SelfDependencyTumblingWindowTriggerReference Ya
offset Offset pemicu dependensi. Berikan nilai dalam format rentang waktu. Offset negatif dan positif diizinkan. Properti ini wajib jika pemicu tergantung pada dirinya sendiri. Dalam semua kasus lain, itu 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)
No

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 dependensi mandiri yang bergantung pada keberhasilan eksekusi sebelumnya dalam jam sebelumnya memiliki properti yang ditunjukkan dalam 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 eksekusi pemicu paralel, atur konkurensi pemicu maksimum.

{
    "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

Skenario berikut menunjukkan penggunaan properti dependensi jendela tumbling.

Offset dependensi

Diagram yang memperlihatkan contoh offset.

Ukuran dependensi

Diagram yang memperlihatkan contoh ukuran.

Dependensi mandiri

Diagram yang memperlihatkan contoh dependensi mandiri.

Dependensi pada pemicu jendela jatuh lainnya

Contoh berikut menunjukkan pekerjaan pemrosesan telemetri harian yang bergantung pada pekerjaan harian lain yang menggabungkan output tujuh hari terakhir dan menghasilkan aliran jendela bergulir tujuh hari.

Diagram yang memperlihatkan contoh dependensi.

Dependensi pada dirinya sendiri

Contoh berikut menunjukkan pekerjaan harian tanpa celah dalam aliran output pekerjaan.

Diagram yang menunjukkan contoh dependensi mandiri tanpa celah dalam aliran output.

Memantau dependensi

Anda dapat memantau rantai dependensi dan jendela yang sesuai dari halaman pemantauan eksekusi pemicu. Buka Pemantauan>Eksekusi Pemicu. Jika pemicu jendela tumbling memiliki dependensi, nama pemicu menanggung hyperlink ke tampilan pemantauan dependensi.

Cuplikan layar yang memperlihatkan Monitor eksekusi pemicu.

Klik nama pemicu untuk melihat dependensi pemicu. Panel di sebelah kanan memperlihatkan informasi eksekusi pemicu seperti ID eksekusi, waktu jendela, dan status.

Cuplikan layar yang memperlihatkan tampilan daftar Dependensi monitor.

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

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

Catatan

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

Untuk cara yang lebih visual untuk melihat jadwal dependensi pemicu, pilih tampilan Gantt.

Cuplikan layar yang memperlihatkan bagan Gantt dependensi monitor.

Kotak transparan memperlihatkan jendela dependensi untuk setiap pemicu yang bergantung pada hilir. Kotak berwarna solid yang diperlihatkan dalam gambar sebelumnya memperlihatkan masing-masing jendela berjalan. Berikut adalah beberapa tips untuk menginterpretasikan tampilan bagan Gantt:

  • Kotak transparan merender biru saat jendela dependen berada dalam status Tertunda atau Berjalan .
  • Setelah semua jendela berhasil untuk pemicu dependen, kotak transparan berubah menjadi hijau.
  • Kotak transparan merender merah saat jendela dependen gagal. Cari kotak merah solid untuk mengidentifikasi eksekusi jendela kegagalan.

Untuk menjalankan ulang jendela dalam tampilan bagan Gantt, pilih kotak warna solid untuk jendela. Panel tindakan muncul dengan informasi dan opsi jalankan ulang.