Bagikan melalui


Apa itu pustaka variabel?

Pustaka variabel Microsoft Fabric adalah wadah variabel yang dapat dikonsumsi item lain di ruang kerja sebagai bagian dari manajemen siklus hidup aplikasi (ALM). Ini berfungsi sebagai item dalam ruang kerja yang berisi daftar variabel, bersama dengan nilai masing-masing untuk setiap tahap alur rilis. Ini menyajikan pendekatan terpadu untuk manajemen konfigurasi item yang efisien dalam ruang kerja, untuk membantu memastikan skalabilitas dan konsistensi di seluruh tahap siklus hidup.

Misalnya, pustaka variabel dapat berisi variabel yang menyimpan nilai untuk:

  • Bilangan bulat yang digunakan untuk aktivitas penundaan dalam sebuah pipeline.
  • Referensi lakehouse menjadi sumber dalam aktivitas salin data . Setiap nilai digunakan dalam alur yang berbeda, berdasarkan tahap rilis alur.
  • Referensi lakehouse yang akan dikonfigurasi sebagai lakehouse default notebook. Setiap nilai digunakan dalam alur yang berbeda, berdasarkan tahap rilis buku catatan.

Penilaian nilai dalam item konsumen tidak selalu terkait dengan penerapannya. Sebaliknya, setiap item konsumen menentukan nilainya berdasarkan konteksnya sendiri.

Pengalaman pustaka variabel berbeda berdasarkan jenis variabel, tetapi semua pustaka variabel memungkinkan Anda menentukan dan mengelola variabel yang dapat digunakan item lain.

Pustaka variabel Fabric:

  • Kompatibel dengan proses integrasi berkelanjutan dan pengiriman berkelanjutan (CI/CD). Kompatibilitas ini memungkinkan integrasi dengan Git dan penyebaran melalui alur penyebaran.
  • Mendukung otomatisasi melalui API publik Fabric.

Keuntungan

Pustaka variabel memungkinkan pelanggan untuk menyesuaikan dan berbagi konfigurasi.

Menyesuaikan konfigurasi

Anda dapat mengonfigurasi nilai variabel berdasarkan tahap alur rilis. Anda dapat mengonfigurasi pustaka variabel dengan set nilai: satu nilai untuk setiap tahap alur rilis. Kemudian, setelah pengaturan satu kali nilai aktif yang ditetapkan untuk setiap tahap, nilai yang benar secara otomatis digunakan dalam tahap alur. Contohnya meliputi:

  • Mengubah koneksi item berdasarkan tahapan.
  • Beralih ke sumber data cloud yang berbeda berdasarkan tahapan.
  • Menyesuaikan kuantitas data dalam kueri berdasarkan tahapan.

Berbagi konfigurasi

Pustaka variabel menyediakan cara terpusat untuk mengelola konfigurasi di seluruh item ruang kerja. Misalnya, jika Anda memiliki beberapa lakehouse di ruang kerja dan masing-masing memiliki pintasan yang menggunakan sumber data yang sama, Anda dapat membuat pustaka variabel dengan sumber data tersebut sebagai salah satu variabel. Dengan begitu, jika Anda ingin mengubah sumber data, Anda harus mengubahnya hanya sekali di pustaka variabel. Anda tidak perlu mengubahnya di setiap lakehouse secara terpisah.

Struktur perpustakaan variabel

Pustaka variabel berisi satu atau beberapa variabel. Setiap variabel memiliki nama, jenis, dan nilai default. Anda juga dapat menambahkan catatan ke setiap variabel untuk menjelaskan tujuannya atau cara menggunakannya.

Cuplikan layar pustaka variabel dengan beberapa variabel dan komponen intinya.

Nilai standar

Nilai default adalah nilai yang digunakan kecuali Anda secara khusus menentukan nilai yang berbeda.

Semua variabel harus memiliki nilai default. Jika jenis variabel adalah string, nilai defaultnya bisa .null

Set nilai alternatif

Set nilai menentukan nilai setiap variabel di pustaka variabel. Pustaka variabel biasanya berisi beberapa set nilai. Kumpulan nilai aktif (atau efektif) berisi nilai yang diterima item konsumen untuk ruang kerja tersebut.

Di setiap ruang kerja, Anda memilih satu set nilai untuk diaktifkan. Kumpulan nilai aktif ruang kerja tidak berubah selama penyebaran atau pembaruan dari Git.

Cuplikan layar pustaka variabel dengan beberapa set nilai alternatif.

Saat Anda membuat set nilai alternatif, kumpulan nilai baru dibuat dengan penunjuk ke nilai default untuk setiap variabel. Anda kemudian dapat mengubah nilai untuk setiap variabel dalam kumpulan nilai baru.

Item yang didukung

Item berikut mendukung pustaka variabel:

Pertimbangan dan keterbatasan

Batasan ukuran

  • Mungkin ada hingga 1.000 variabel dan hingga 1.000 set nilai, selama Anda memenuhi kedua persyaratan ini:

    • Jumlah total sel dalam set nilai alternatif kurang dari 10.000.
    • Ukuran item tidak melebihi 1 MB.

    Persyaratan ini divalidasi saat Anda menyimpan perubahan.

  • Bidang catatan dapat memiliki hingga 2.048 karakter.

  • Bidang deskripsi himpunan nilai dapat memiliki hingga 2.048 karakter.

Batasan untuk set nilai alternatif

  • Set nilai alternatif dalam pustaka variabel muncul dalam urutan Anda menambahkannya. Saat ini, Anda tidak dapat menyusun ulang di UI. Untuk mengubah urutan, edit file JSON secara langsung.
  • Nama setiap set nilai harus unik dalam pustaka variabel.
  • Nama variabel harus unik dalam pustaka variabel. Anda dapat memiliki dua variabel dengan nama yang sama di ruang kerja jika berada di item yang berbeda.
  • Selalu ada satu (dan hanya satu) nilai aktif yang ditetapkan dalam pustaka variabel sekaligus. Anda tidak dapat menghapus nilai yang ditetapkan saat aktif. Untuk menghapusnya, pertama-tama konfigurasikan nilai lain yang diatur menjadi aktif. Anda dapat memiliki nilai aktif yang berbeda yang ditetapkan untuk setiap tahap alur penyebaran.