Bagikan melalui

Integrasi pustaka variabel dengan alur

Pustaka Variabel adalah jenis item baru di Microsoft Fabric yang memungkinkan pengguna untuk menentukan dan mengelola variabel di tingkat ruang kerja, sehingga dapat digunakan di berbagai item ruang kerja, seperti alur kerja, buku catatan, pintasan Lakehouse dan banyak lagi. Ini menyediakan cara terpadu dan terpusat untuk mengelola konfigurasi, mengurangi kebutuhan akan nilai yang dikodekan secara permanen dan menyederhanakan proses CI/CD Anda, sehingga lebih mudah untuk mengelola konfigurasi di berbagai lingkungan.

Cara menggunakan Pustaka variabel dengan alur

  1. Navigasi ke ruang kerja Anda dan buat item baru.

    Cuplikan layar memperlihatkan tempat untuk menambahkan item baru di ruang kerja Fabric Anda disorot.

  2. Gunakan filter untuk menemukan Pustaka variabel atau gulir ke bawah ke bagian Kembangkan data.

    Cuplikan layar memperlihatkan filter untuk item pustaka Variabel baru.

  3. Pilih Pustaka variabel untuk membuat pustaka Variabel baru. Pilih nama dan tekan Buat.

    Cuplikan layar yang memperlihatkan item pustaka Variabel baru dengan nama ditetapkan dan menyorot tombol Buat.

  4. Setelah pustaka Variabel selesai dibuat, Anda akan dibawa ke beranda. Klik + Baru untuk menambahkan variabel baru.

    Cuplikan layar memperlihatkan halaman mulai untuk item pustaka Variabel baru.

  5. Setelah menambahkan variabel baru, Anda dapat mengonfigurasi variabel anda dan mengatur kumpulan nilai Nama, Jenis, dan Default. Anda juga dapat menambahkan Catatan.

    Cuplikan layar memperlihatkan konfigurasi yang akan diatur untuk variabel baru.

  6. Tambahkan Set nilai alternatif sesuai kebutuhan Anda (misalnya, nilai yang berbeda untuk lingkungan alur penyebaran yang berbeda). Setelah Anda mengatur nama dan mengklik Buat, Anda bisa mengedit nilai variabel dan memilih nilai yang diatur untuk aktif.

    Cuplikan layar menyoroti tempat menambahkan set nilai baru untuk variabel.

    Cuplikan layar yang menunjukkan cara menambahkan nama untuk kumpulan nilai baru.

  7. Simpan perubahan setelah selesai.

Cuplikan layar memperlihatkan tombol Simpan disorot di sudut kiri atas.

Gunakan variabel pustaka variabel dalam pipeline Anda

  1. Untuk menggunakan variabel dari pustaka variabel dalam pipeline Anda, buat pipeline baru atau akses pipeline yang sudah ada.

    Cuplikan layar menyoroti tombol buat item baru di sudut kiri atas dan item alur disorot.

  2. Di alur Anda, Anda perlu membuat referensi ke variabel pustaka variabel Anda di panel bawah.

    Cuplikan layar menyoroti tab Variabel pustaka dan tombol +Baru di panel bawah kanvas alur.

  3. Setelah Anda mengklik + Baru, pop-up akan terbuka yang menampilkan semua pustaka Variabel Anda. Anda dapat menggunakan pemilih ini untuk memilih variabel Pustaka variabel Anda dan klik Ok.

    Cuplikan layar memperlihatkan tombol +Baru di tab Variabel pustaka disorot.

    Cuplikan layar memperlihatkan variabel Pustaka yang dipilih di pemilih variabel.

    Cuplikan layar memperlihatkan kumpulan konfigurasi untuk referensi variabel Pustaka baru.

  4. Setelah Anda menambahkan referensi variabel pustaka, tambahkan aktivitas pipeline Anda. Di pengaturan aktivitas, klik Tambahkan konten dinamis untuk pengaturan yang ingin Anda parameterisasi.

    Cuplikan layar memperlihatkan Tambahkan konten dinamis yang disorot dalam pengaturan aktivitas Pencarian.

  5. Penyusun ekspresi terbuka. Jika Anda tidak melihat variabel Pustaka, klik 3 titik di samping Fungsi dan pilih Variabel pustaka.

    Cuplikan layar memperlihatkan 3 titik di samping Fungsi di pembangun ekspresi dan tab Variabel Pustaka disorot.

  6. Klik referensi variabel Pustaka Anda untuk menambahkan ekspresi baru ke penyusun ekspresi. Lalu, klik Ok untuk menambahkan ekspresi Anda.

    Cuplikan layar menunjukkan referensi variabel Pustaka yang disorot untuk ditambahkan ke dalam perangkat pembuat ekspresi.

    Cuplikan layar memperlihatkan kumpulan ekspresi di penyusun ekspresi.

  7. Sekarang Anda akan melihat bahwa konten dinamis ditambahkan ke pengaturan aktivitas Anda.

    Cuplikan layar memperlihatkan kumpulan ekspresi sebagai konten dinamis di pengaturan aktivitas Pencarian.

  8. Anda dapat mempratinjau data Anda dengan mengklik Pratinjau data. Ini akan membuka panel baru yang memperlihatkan nilai variabel pustaka Anda. Klik Ok untuk mendapatkan pratinjau data Anda.

    Cuplikan layar menunjukkan opsi pratinjau data.

    Cuplikan layar memperlihatkan panel data pratinjau.

  9. Simpan dan jalankan rangkaian proses Anda seperti biasa. Anda akan melihat bahwa nilai yang diteruskan adalah nilai apa pun yang ditetapkan sebagai Aktif di pustaka Variabel Anda.

    Cuplikan layar memperlihatkan pengaturan Simpan dan Jalankan yang disorot pada kanvas alur kerja.

Batasan yang diketahui

Batasan yang diketahui berikut berlaku untuk integrasi perpustakaan Variabel dalam pipeline di Data Factory di Microsoft Fabric:

  • Pustaka Variabel mendukung Boolean, Datetime, Guid, Integer, Number, dan String sebagai jenis data. Dalam alur Anda, Anda akan melihat Boolean sebagai jenis Bool, Datetime sebagai jenis String, Guid sebagai jenis String, Integer sebagai jenis Int, dan String sebagai jenis String. Jenis angka tidak didukung dalam pipeline.
  • Parameterisasi koneksi eksternal didukung dengan pustaka variabel yang terintegrasi dengan pipeline. Namun, Anda harus mencari GUID untuk koneksi Anda dari Pengaturan | Mengelola koneksi dan gateway. Di sana Anda akan menemukan GUID untuk koneksi Anda dengan memilih Pengaturan di samping nama koneksi Anda.

Konten terkait

  • Last updated on