Variabel sistem yang didukung oleh Azure Data Factory dan Azure Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory di Microsoft Fabric adalah generasi Azure Data Factory berikutnya, dengan arsitektur yang lebih sederhana, AI bawaan, dan fitur baru. Jika Anda baru menggunakan integrasi data, mulailah dengan Fabric Data Factory. Beban kerja ADF yang ada dapat ditingkatkan ke Fabric untuk mengakses kemampuan baru di seluruh ilmu data, analitik real time, dan pelaporan.

Artikel ini menjelaskan variabel sistem yang didukung oleh Azure Data Factory dan Azure Synapse. Anda dapat menggunakan variabel ini dalam ekspresi saat menentukan entitas dalam salah satu layanan.

Cakupan alur

Variabel sistem ini dapat dirujuk di mana saja dalam alur JSON.

Nama Variabel Description
@pipeline().DataFactory Nama data atau ruang kerja Synapse tempat alur dijalankan
@pipeline().Pipeline Nama jalur
@pipeline().RunId ID jalannya pipeline tertentu
@pipeline().TriggerType Jenis pemicu yang memanggil alur (misalnya, ScheduleTrigger, BlobEventsTrigger). Untuk daftar jenis pemicu yang didukung, lihat Alur eksekusi dan pemicu. Jenis Manual pemicu menunjukkan bahwa alur dipicu secara manual.
@pipeline().TriggerId ID pemicu yang mengaktifkan pipeline
@pipeline().TriggerName Nama pemicu yang memanggil alur
@pipeline().TriggerTime Waktu eksekusi pemicu yang menjalankan pipeline. Ini adalah waktu di mana pemicu benar-benar diaktifkan untuk memanggil eksekusi alur, dan itu bisa sedikit berbeda dari waktu terjadwal pemicu.
@pipeline().GroupId ID grup tempat jalur pipa dieksekusi.
@pipeline()?. TriggeredByPipelineName Nama pipeline yang memicu jalannya pipeline. Berlaku saat alur kerja pipeline dipicu oleh aktivitas *ExecutePipeline*. Evaluasi ke Null ketika digunakan dalam situasi lain. Perhatikan tanda tanya setelah @pipeline()
@pipeline()?. TriggeredByPipelineRunId ID eksekusi dari pipeline yang memicu jalannya pipeline. Berlaku saat alur kerja pipeline dipicu oleh aktivitas *ExecutePipeline*. Evaluasi ke Null ketika digunakan dalam situasi lain. Perhatikan tanda tanya setelah @pipeline()

Note

Variabel sistem tanggal/waktu terkait pemicu (dalam lingkup alur dan pemicu) mengembalikan tanggal UTC dalam format ISO 8601, misalnya, 2017-06-01T22:20:00.4061448Z.

Menjadwalkan cakupan pemicu

Variabel sistem ini dapat direferensikan di mana saja dalam pemicu JSON untuk pemicu jenis ScheduleTrigger.

Nama Variabel Description
@trigger().scheduledTime Waktu pemicu dijadwalkan untuk memulai pelaksanaan alur.
@trigger().startTime Waktu di mana pemicu benar-benar diaktifkan untuk memicu jalannya pipeline. Ini mungkin sedikit berbeda dari waktu terjadwal pemicu.

Cakupan pemicu jendela tumbling

Variabel sistem ini dapat direferensikan di mana saja dalam pemicu JSON untuk pemicu jenis TumblingWindowTrigger.

Nama Variabel Description
@trigger().outputs.windowStartTime Awal jendela yang terkait dengan proses pemicu.
@trigger().outputs.windowEndTime Akhir jendela yang terkait dengan eksekusi pemicu.
@trigger().scheduledTime Waktu pemicu dijadwalkan untuk memulai pelaksanaan alur.
@trigger().startTime Waktu di mana pemicu benar-benar diaktifkan untuk memicu jalannya pipeline. Ini mungkin sedikit berbeda dari waktu terjadwal pemicu.

Ruang lingkup pemicu kejadian penyimpanan

Variabel sistem ini dapat direferensikan di mana saja dalam JSON pemicu untuk pemicu jenis BlobEventsTrigger.

Nama Variabel Description
@triggerBody().fileName Nama file yang pembuatan atau penghapusannya menyebabkan pemicu diaktifkan.
@triggerBody().folderPath Jalur ke folder yang berisi file yang ditentukan oleh @triggerBody().fileName. Segmen pertama jalur folder adalah nama kontainer Azure Blob Storage.
@trigger().startTime Waktu di mana pemicu diaktifkan untuk memanggil eksekusi alur.

Note

Jika Anda membuat alur dan pemicu di Azure Synapse Analytics, Anda harus menggunakan @trigger().outputs.body.fileName dan @trigger().outputs.body.folderPath sebagai parameter. Kedua properti tersebut menangkap informasi blob. Gunakan properti tersebut alih-alih menggunakan @triggerBody().fileName dan @triggerBody().folderPath.

Cakupan pemicu peristiwa kustom

Variabel sistem ini dapat direferensikan di mana saja dalam pemicu JSON untuk pemicu jenis CustomEventsTrigger.

Note

Layanan ini mengharapkan peristiwa kustom diformat dengan skema peristiwa Azure Event Grid.

Nama Variabel Description
@triggerBody().event.eventType Jenis peristiwa yang memicu beroperasinya Pemicu Peristiwa Kustom. Jenis peristiwa adalah bidang yang ditentukan pelanggan dan dapat memiliki nilai apa pun yang berupa tipe string.
@triggerBody().event.subject Subjek peristiwa kustom yang menyebabkan pemicu diaktifkan.
@triggerBody().event.data._keyName_ Bidang data dalam peristiwa kustom bebas dari blob JSON, yang dapat digunakan pelanggan untuk mengirim pesan dan data. Gunakan data. keyName untuk mereferensikan setiap bidang. Misalnya, @triggerBody().event.data.callback mengembalikan nilai untuk bidang panggilan balik yang disimpan di bawah data.
@trigger().startTime Waktu di mana pemicu diaktifkan untuk memanggil eksekusi alur.

Note

Jika Anda membuat alur dan pemicu di Azure Synapse Analytics, Anda harus menggunakan @trigger().outputs.body.event sebagai parameter. Properti ini merekam informasi acara. Gunakan properti ini alih-alih menggunakan @triggerBody().event.

Konten terkait

  • Last updated on