Jenis variabel dalam pustaka variabel

Pustaka variabel di Microsoft Fabric adalah item khusus yang memusatkan definisi dan manajemen variabel, memungkinkan konfigurasi yang dapat diskalakan dan otomatis di seluruh ruang kerja dan item.

Variabel dalam pustaka variabel dapat menjadi jenis dasar atau tingkat lanjut, dan setiap variabel diidentifikasi secara unik dengan namanya dalam item pustaka.

• Jenis variabel dasar dalam Pustaka Variabel mencakup jenis data sederhana, seperti Boolean, DateTime (dalam format ISO 8601 UTC), Guid, Bilangan Bulat, Angka, dan String. Ini adalah nilai langsung yang dapat langsung ditetapkan dan digunakan di berbagai tahap dan lingkungan.
• Jenis variabel tingkat lanjut dirancang untuk kasus penggunaan yang lebih canggih, seperti merujuk item Fabric internal atau koneksi eksternal. Ini termasuk jenis "referensi item" yang menyimpan ID ruang kerja dan item untuk menunjuk item Fabric tertentu.

Tipe yang didukung dalam pustaka variabel

Variabel dalam pustaka variabel memiliki jenis variabel yang didukung berikut

TypeType	Kategori	Description
Boolean	Dasar	Mewakili nilai benar/salah.
Integer	Dasar	Bilangan bulat tanpa desimal.
Number	Dasar	Nilai numerik, termasuk desimal.
String	Dasar	Nilai teks atau urutan karakter.
DateTime	Dasar	Tanggal dan waktu dinyatakan sebagai standar ISO 8601 yyyy-MM-ddTHH:mm:ss.xxxZ, di mana: yyyy-MM-dd adalah tahun empat digit, diikuti oleh bulan dua digit dan hari dua digit. T memisahkan tanggal dan waktu. HH:mm:ss.xxx adalah jam dua digit dalam format 24 jam, diikuti oleh menit dua digit, detik dua digit, dan milidetik tiga digit. Z menunjukkan bahwa waktunya dalam Waktu Universal Terkoordinasi (UTC).
Panduan	Dasar	Pengidentifikasi unik global yang digunakan untuk identifikasi objek yang berbeda.
Referensi item	Tingkat Lanjut	Digunakan dalam Pustaka Variabel Fabric untuk menyimpan referensi ke item Fabric yang ada, seperti lakehouse, notebook, atau alur data. Ini dilakukan dengan menyimpan ID ruang kerja serta ID item.

Properti variabel

Setiap variabel dalam pustaka variabel memiliki properti berikut:

Harta benda	Description
Nama	Pengidentifikasi unik untuk variabel. Digunakan untuk mereferensikan variabel dalam skrip atau alur kerja.
Catatan (opsional)	Komentar deskriptif atau anotasi tentang variabel . Dapat mencakup konteks, catatan penggunaan, atau instruksi khusus. Panjang maksimum: 2.048 karakter.
Tipe	Menentukan jenis data variabel (misalnya, string, bilangan bulat, boolean, array). Menentukan bagaimana nilai ditafsirkan dan divalidasi.
Nilai default diatur	Nilai awal yang ditetapkan ke variabel ketika tidak ada nilai lain yang disediakan. Memastikan perilaku yang konsisten dalam alur kerja. Kumpulan nilai default tidak dapat diganti namanya.
Set nilai alternatif (opsional)	Set nilai tambahan yang telah ditentukan sebelumnya yang dapat diterapkan dalam kondisi atau skenario tertentu. Berguna untuk konfigurasi spesifik lingkungan atau opsi cadangan.

Konvensi penamaan

Nama variabel

Nama variabel di dalam pustaka variabel harus mengikuti konvensi berikut:

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

Nama variabel tidak peka terhadap huruf besar atau kecil.

Setelah variabel memiliki nilai yang ditentukan, jika Anda mencoba mengubah jenisnya, dialog persetujuan akan muncul. Dialog memberi tahu Anda bahwa semua nilai variabel akan diatur ulang dan bahwa perubahan ini bisa menjadi perubahan yang melanggar di sisi item konsumen.

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.