Menggunakan pustaka variabel Fabric di Dataflow Gen2

Nota

Untuk informasi selengkapnya tentang cara memanfaatkan kemampuan ini dalam skenario integrasi berkelanjutan/ penyebaran berkelanjutan (CI/CD), pastikan untuk membaca artikel tentang arsitektur solusi CI/CD dan ALM untuk Dataflow Gen2 dan tutorial menyeluruh tentang Referensi variabel dalam Aliran Data.

Pustaka variabel Fabric menawarkan cara terpusat untuk mengelola nilai konfigurasi di seluruh beban kerja Microsoft Fabric. Dengan integrasi baru di Dataflow Gen2, Anda dapat mereferensikan variabel ini langsung di aliran data Anda, memungkinkan perilaku dinamis di seluruh lingkungan dan menyederhanakan alur kerja CI/CD.

Prasyarat

Untuk menggunakan pustaka variabel Fabric di Dataflow Gen2, pastikan hal berikut:

Variabel referensi menggunakan widget input

Dialog Dataflow Gen2 menyertakan widget input yang memungkinkan Anda memilih cara memasukkan nilai bidang. Dalam dialog yang didukung, Anda dapat memilih variabel dengan menggunakan widget ini.

Cuplikan layar widget input dalam dialog baris filter memperlihatkan beberapa opsi yang tersedia untuk input.

Nota

Untuk menggunakan widget input, pada tab Tampilan di pita, di grup Parameter , pilih Selalu izinkan. Cuplikan layar kotak centang 'Selalu Izinkan' di tab Tampilan di pita untuk mengaktifkan widget input.

Beberapa dialog mendukung pengalaman widget input dan pustaka variabel Fabric, termasuk:

Saat Anda memilih opsi variabel di widget input, dialog pemilih variabel muncul. Dalam dialog ini, Anda dapat menelusuri pustaka variabel dan variabel yang dikandungnya.

Cuplikan layar dialog pilih variabel yang menampilkan semua pustaka dan variabel yang tersedia di ruang kerja saat ini.

Setelah Anda memilih variabel, dialog menampilkan pustaka dan nama variabel sehingga Anda dapat mengonfirmasi pilihan Anda sebelum menerapkan.

Cuplikan layar variabel dengan nama Ceiling dari pustaka Pustaka saya ditampilkan seperti yang dipilih dalam dialog baris filter.

Nota

Tidak semua pengalaman Aliran Data mendukung widget input. Untuk pengalaman atau skenario kustom yang tidak didukung, gunakan fungsi variabel secara manual.

Fungsi variabel

Di dalam Dataflow Gen2, Anda dapat mereferensikan variabel dengan menggunakan salah satu fungsi berikut:

Pengidentifikasi yang Anda berikan ke salah satu dari kedua fungsi harus menggunakan format berikut:

$(/**/LibraryName/VariableName)

Contoh berikut mengasumsikan pustaka variabel bernama Pustaka Saya dan variabel string bernama Variabel Saya:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

Menggunakan nilai default melalui Variable.ValueOrDefault membantu memastikan bahwa rumus Anda diselesaikan bahkan saat Anda menyalin atau memindahkan solusi Anda ke lingkungan lain yang tidak memiliki pustaka variabel yang dirujuk.

Petunjuk / Saran

Simpan setiap variabel sebagai kueri terpisah yang tidak memerlukan penahapan. Pendekatan ini memungkinkan Anda menggunakan nilai-nilai ini dalam dialog yang mendukung input kueri dan membantu menjaga tampilan variabel yang terorganisir dalam aliran data Anda.

Pertimbangan dan keterbatasan

Daftar berikut menguraikan batasan dan perilaku penting yang perlu diingat saat menggunakan pustaka variabel Fabric dengan Dataflow Gen2. Batasan ini memengaruhi bagaimana variabel dirujuk, dievaluasi, dan diterapkan selama desain dan runtime.

  • Cakupan Ruang Kerja: Pustaka variabel harus berada di ruang kerja yang sama dengan Dataflow Gen2 dengan CI/CD.

  • Lokasi Referensi: Variabel hanya dapat digunakan di dalam file mashup.pq dari Dataflow Gen2 dengan CI/CD.

  • Perilaku runtime: Nilai variabel diambil pada awal operasi eksekusi dan bertahan di seluruh operasi. Perubahan pada pustaka saat menjalankan Dataflow tidak menghentikan atau mempengaruhi proses tersebut.

  • Menggunakan nilai default: Saat menggunakan nilai default melalui fungsi Variable.ValueOrDefault, pastikan bahwa jenis data nilai default cocok dengan jenis data variabel yang dirujuk.

  • Jenis yang Didukung: Hanya variabel jenis dasar yang didukung (boolean, , datetime, guidinteger, number, dan string).

  • Koneksi tetap: Variabel tidak dapat mengubah informasi koneksi. Koneksi tetap terikat pada konfigurasi jalur sumber daya yang dibuat.

  • Risiko penggantian: Pengguna yang memiliki akses untuk memodifikasi pustaka variabel dapat mengganti nilai variabel, yang berpotensi memengaruhi output aliran data.

  • Pemetaan skema: Variabel tidak dapat mengubah pemetaan skema tujuan; pemetaan mengikuti penyiapan yang ditulis.

  • Visibilitas silsilah: Tampilan silsilah data tidak menampilkan tautan antara Dataflow Gen2 dan pustaka variabel yang direferensikannya.

  • Last updated on