Parameter global di Azure Data Factory

  • Artikel

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!

Parameter global adalah konstanta di seluruh pabrik data yang dapat dikonsumsi oleh alur dalam ekspresi apa pun. Ini berguna ketika Anda memiliki beberapa alur dengan nama dan nilai parameter yang identik. Saat mempromosikan pabrik data menggunakan proses integrasi dan penyebaran berkelanjutan (CI/CD), Anda dapat mengganti parameter ini di setiap lingkungan.

Membuat parameter global

Untuk membuat parameter global, buka tab Parameter global di bagian Kelola. Pilih Baru untuk membuka navigasi samping pembuatan.

Screenshot that highlights the New button you select to create global parameters.

Di navigasi samping, masukkan nama, pilih jenis data, dan tentukan nilai parameter Anda.

Screenshot that shows where you add the name, data type, and value for the new global parameter.

Setelah parameter global dibuat, Anda dapat mengeditnya dengan mengklik nama parameter. Untuk mengubah beberapa parameter sekaligus, pilih Edit semua.

Create global parameters

Menggunakan parameter global dalam alur

Parameter global dapat digunakan dalam ekspresi alur apa pun. Jika alur mereferensikan sumber daya lain seperti himpunan data atau aliran data, Anda dapat mewariskan nilai parameter global melalui parameter sumber daya tersebut. Parameter global direferensikan sebagai pipeline().globalParameters.<parameterName>.

Using global parameters

Parameter global dalam CI/CD

Sebaiknya masukkan parameter global dalam templat ARM selama CI/CD. Mekanisme baru termasuk parameter global dalam templat ARM (dari 'Kelola hub' -> 'Templat ARM' -> 'Sertakan parameter global dalam templat ARM ') seperti yang diilustrasikan di bawah ini, tidak akan bertentangan/ mengambil alih pengaturan tingkat pabrik seperti yang digunakan sebelumnya, sehingga tidak memerlukan PowerShell tambahan untuk penyebaran parameter global selama CI/CD.

Screenshot of 'Include in ARM template'.

Catatan

Kami telah memindahkan pengalaman UI untuk menyertakan parameter global dari bagian 'Parameter global' ke bagian 'templat ARM' di hub kelola. Jika Anda sudah menggunakan mekanisme yang lebih lama (dari 'Kelola hub' -> 'Parameter global' -> 'Sertakan dalam templat ARM'), Anda dapat melanjutkan. Kami akan terus mendukungnya.

Jika Anda menggunakan alur lama untuk mengintegrasikan parameter global dalam solusi integrasi dan penyebaran berkelanjutan Anda, ini akan terus berfungsi:

  • Sertakan parameter global dalam templat ARM (dari 'Kelola hub' -> 'Parameter global' -> 'Sertakan dalam templat ARM') Screenshot of deprecated 'Include in ARM template'.

  • Menyebarkan parameter global melalui skrip PowerShell

Kami sangat menyarankan untuk menggunakan mekanisme baru termasuk parameter global dalam templat ARM (dari 'Kelola hub' -> 'Templat ARM' -> 'Sertakan parameter global dalam templat ARM') karena membuat CICD dengan parameter global jauh lebih mudah dan lebih mudah dikelola.

Catatan

Konfigurasi Sertakan parameter global dalam templat ARM hanya tersedia dalam "mode Git". Saat ini dinonaktifkan dalam "mode langsung" atau "mode Data Factory".

Peringatan

Anda tidak dapat menggunakan ‘-‘ dalam nama parameter. Anda akan menerima kode kesalahan "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}". Tapi, Anda dapat menggunakan '_' dalam nama parameter.

Konten terkait