Nama dan jenis variabel

Item pustaka variabel di Microsoft Fabric berisi daftar variabel dan nilai defaultnya. Ini juga dapat berisi set nilai lain yang menyimpan nilai alternatif.

Setiap variabel dalam pustaka variabel memiliki properti berikut:

• Nama
• Catatan (opsional), hingga 2.048 karakter
• Tipe
• Nilai default diatur
• Set nilai alternatif (opsional)

Konvensi penamaan

Nama pustaka variabel

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.

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.

Nama nilai set

Nama kumpulan nilai memiliki batasan yang sama dengan nama variabel.

Jenis variabel

Sebelum dapat menambahkan nilai ke variabel, Anda harus menentukan jenis variabel. Variabel dalam pustaka variabel dapat berupa salah satu jenis berikut:

• String: Karakter apa pun. null Bisa atau kosong.

• Boolean: True atau False.

• DateTime: 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).

  Contohnya adalah 2025-01-14T16:15:20.123Z.

• Nomor: Angka apa pun.

• GUID: Pengidentifikasi unik global.

• Bilangan bulat: Bilangan bulat yang bisa positif, negatif, atau nol.

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.

Set nilai alternatif

Saat Anda membuat nilai baru yang ditetapkan dalam pustaka variabel, nilai baru diatur sebagai penunjuk ke nilai default. Anda dapat mengubahnya menjadi nilai tetap.

Jika Anda mengubah nilai variabel dalam kumpulan nilai alternatif, nilai alternatif disimpan dalam file JSON untuk set nilai. Anda dapat mengubah urutan di mana kumpulan nilai muncul, atau mengubah nilai variabel dalam set nilai alternatif, dalam file JSON ini di Git.

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.