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.

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.
  • 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.

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 dalam Fabric adalah sistem terstruktur yang dirancang untuk mengelola parameter konfigurasi di seluruh ruang kerja dan tahap penyebaran. Intinya adalah variabel yang ditentukan pengguna, yang dapat berupa jenis dasar (seperti string, bilangan bulat, boolean) atau jenis kompleks seperti referensi item. Variabel ini dikelompokkan dalam item Pustaka Variabel dan dapat direferensikan oleh item konsumen dalam ruang kerja yang sama.

Untuk mendukung konfigurasi dinamis, setiap variabel dapat memiliki beberapa set nilai atau set nilai alternatif yang disesuaikan untuk lingkungan yang berbeda (misalnya, dev, test, prod). Satu set nilai ditetapkan sebagai "aktif" per ruang kerja, menentukan nilai mana yang digunakan selama runtime.

Pengguna dapat membuat, mengedit, dan mengelola variabel dan set nilai melalui Fabric UI atau API, dengan validasi bawaan dan pemeriksaan izin. Sistem ini mendukung alur kerja CI/CD, memungkinkan variabel dikelola sebagai kode, terintegrasi dengan Git, dan disebarkan melalui alur. Struktur ini memastikan manajemen konfigurasi yang dapat diskalakan, otomatis, dan diatur di seluruh sistem data yang kompleks.

Cuplikan layar pustaka variabel dengan beberapa variabel dan komponen intinya.

Item yang didukung

Item berikut mendukung pustaka variabel:

Konvensi penamaan

Nama item pustaka variabel itu sendiri harus mengikuti konvensi ini:

  • Tidak kosong
  • Tidak memiliki spasi di depan atau di belakang
  • Dimulai dengan huruf
  • Dapat menyertakan huruf, angka, garis bawah, tanda hubung, dan spasi
  • Panjangnya tidak melebihi 256 karakter

Nama pustaka variabel tidak peka huruf besar/kecil.

Pertimbangan dan keterbatasan

Batasan untuk variabel

  • 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.

Konten terkait

  • Last updated on