Jenis variabel referensi item (pratinjau)

Untuk meningkatkan fleksibilitas dan skalabilitas, kami memperkenalkan variabel tingkat lanjut bersama jenis variabel dasar yang ada. Variabel lanjutan ini dirancang untuk memenuhi persyaratan utama seperti membuat parameter koneksi eksternal dan internal (misalnya, Snowflake, AWS, OneLake).

Referensi item adalah jenis variabel tingkat lanjut yang digunakan dalam Pustaka Variabel Fabric untuk menyimpan referensi ke item Fabric yang ada—seperti lakehouse, notebook, atau alur data, dengan menyimpan ID ruang kerjanya serta ID dari item tersebut. Jenis variabel ini memungkinkan parameterisasi koneksi internal, memungkinkan pengembang untuk secara dinamis menautkan item ke item Fabric tertentu berdasarkan tahap penyebaran atau konteks ruang kerja.

Cara penggunaan

Variabel referensi item dapat digunakan seperti variabel lain dalam pustaka variabel.

  1. Masuk ke Fabric.
  2. Menavigasi ke ruang kerja dan pustaka variabel Anda
  3. Di bagian atas, pilih + Variabel Baru
  4. Berikan nama untuk variabel, pilih referensi item untuk jenis tersebut, lalu klik ... untuk memilih nilai
  5. Ini akan membuka dialog untuk memilih item yang diinginkan. Anda akan melihat semua item yang anda miliki izinnya, tersedia untuk pilihan. Gunakan penjelajah di sebelah kiri untuk memfilter daftar menurut ruang kerja. Gunakan filter di sudut kanan atas untuk memfilter menurut jenis.

Cuplikan layar item yang tersedia untuk referensi item. 6. Setelah dipilih, akan muncul seperti ini di halaman varlib - sebagai komponen baca saja yang menunjukkan nama item.

Cuplikan layar referensi item.

Jika Anda perlu mengedit referensi item atau perlu memeriksa kembali nilainya:

  • untuk melihat detail tambahan, klik nilai
  • untuk mengedit nilai atau nilai dari kumpulan nilai lainnya, klik tombol di samping nilai.

Cuplikan layar referensi item pada pop-up.

Cara kerjanya

Nilai variabel referensi item pada dasarnya adalah penunjuk statis ke item Fabric yang diidentifikasi oleh ID Ruang Kerja + ID Item. Nilai disimpan sebagai sepasang GUID yang sesuai dengan ruang kerja item target dan item itu sendiri. Misalnya, referensi mungkin disimpan secara internal sebagai:

  • WorkspaceID = aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb
  • ItemID = 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Kedua ID ini bersama-sama secara unik mengidentifikasi item yang dirujuk.

Ingatlah hal berikut ini saat bekerja dengan referensi item:

  • Referensi item memungkinkan parameterisasi koneksi internal, memungkinkan pengembang untuk menautkan item secara dinamis ke sumber daya Fabric tertentu berdasarkan tahap penyebaran atau konteks ruang kerja.
  • Referensinya statis, menunjuk ke item tertentu dan tidak secara otomatis menyesuaikan di seluruh lingkungan.
  • Untuk variasi khusus tahap, gunakan set nilai, di mana setiap set dapat menunjuk ke item statis yang berbeda (misalnya, lakehouse yang berbeda per tahap).
  • Semua nilai di seluruh set nilai harus memiliki jenis item yang sama untuk memastikan kompatibilitas dan mencegah kesalahan runtime. Namun, kami tidak memberlakukan memiliki jenis item yang sama di seluruh set nilai.

Representasi di Git dan API

Kelola pustaka variabel sebagai kode. Dengan menggunakan Git atau REST API, Anda dapat bekerja dengan variabel referensi item melalui format JSON yang jelas. Semua variabel muncul dalam file definisi pustaka variabel (disimpan di Git, biasanya .json), mencantumkan properti seperti nama, jenis, dan nilai.

Untuk variabel referensi item (statis), nilainya adalah data terstruktur untuk ID ruang kerja dan item. Contoh:


{
 "name": "MyDataLake",
 "note": "",
 "type": "ItemReference",
 "value": {
  "itemId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
 }
}

Ingat hal-hal berikut saat bekerja melalui API:

  • Hanya ID yang disimpan; nama dan metadata diambil saat runtime atau di-cache di Fabric.
  • Membuat atau memperbarui melalui API, Anda harus menyediakan ID ruang kerja dan ID item. ID tidak valid menyebabkan kesalahan.

Item yang didukung

Berikut ini adalah daftar item yang saat ini didukung menggunakan referensi item:

Nota

Notebook tidak didukung melalui %%configure.

contoh kode Python

Contoh kode berikut menunjukkan cara menggunakan referensi item dalam skrip python.

var_ref = "$(/**/VarLibItem/itemReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
workspace_id = var_obj.get("workspaceId").value()
item_id = var_obj.get("itemId").value()
print(workspace_id)
print(item_id)

Kode ini melakukan hal berikut:

  • Menyelesaikan variabel referensi item dari pustaka variabel di Fabric.
  • Mengambil objek metadata untuk item yang dirujuk tersebut
  • Mengekstrak ID ruang kerja dan ID item
  • Mencetaknya sehingga dapat digunakan secara terprogram.

Izin Diperlukan untuk Membuat/Menggunakan variabel referensi item

Menggunakan variabel referensi item melibatkan dua lapisan izin:

  • Membuat dan Mengedit variabel referensi item: Pengguna dengan peran Kontributor atau lebih tinggi di ruang kerja dapat membuat dan mengedit variabel di pustaka, sementara Pemirsa bersifat hanya-baca.
  • Mengakses variabel referensi item: Selain hak pada Pustaka Variabel, Anda harus memiliki setidaknya izin Baca pada variabel referensi item yang ingin Anda referensikan.

Untuk informasi selengkapnya tentang izin dan validasi izin, lihat Izin pustaka variabel

Keterbatasan

Saat ini, Anda hanya dapat mereferensikan item fabric dan model semantik. Item Power BI lainnya, seperti Dataflow Gen1 saat ini tidak didukung.

Informasi tambahan

Pustaka variabel memungkinkan penerapan CI/CD pada konten Fabric di berbagai lingkungan (Dev, Test, Prod) dengan menggunakan variabel referensi item untuk konfigurasi spesifik setiap tahap. Ingatlah poin-poin berikut:

  • Referensi item terkait dengan ruang kerja dan ID item tertentu.
  • Menyebarkan ke tahap baru, referensi ini masih menunjuk ke ruang kerja asli kecuali diperbarui secara manual.
  • Gunakan beberapa set nilai untuk setiap tahap dan aktifkan set yang benar secara manual atau melalui skrip API.

Untuk informasi selengkapnya, lihat set nilai dalam pustaka variabel.

Konten terkait

  • Last updated on