Bagikan melalui

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

Variabel referensi item adalah jenis variabel lanjutan yang digunakan dalam Pustaka Variabel Fabric untuk menyimpan referensi ke item Fabric yang ada—seperti lakehouse, notebook, atau alur data, dengan menyimpan ID ruang kerja dan ID itemnya. 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 Microsoft 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 pointer 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 secara dinamis menautkan item 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.

Item yang didukung

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

Cuplikan layar buku catatan referensi item.

Nota

Notebook tidak didukung melalui %%configure.

Keterbatasan

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

Izin yang Diperlukan untuk Membuat/Menggunakan Referensi Item

Menggunakan variabel Referensi Item melibatkan dua lapisan izin:

  • Buat/Edit - Meskipun kontributor ruang kerja apa pun dapat memodifikasi nilai variabel, variabel referensi Item hanya mengizinkan pengguna untuk mengatur sebagai item nilai yang memiliki izin baca. Ini berlaku untuk nilai apa pun, set nilai aktif default atau set nilai lainnya. Ketahuilah bahwa selama menyimpan item Pustaka Variabel, pemeriksaan izin dilakukan pada nilai aktif variabel referensi item untuk pengguna yang menyimpan item, bahkan jika nilai tersebut tetap tidak berubah.
  • Gunakan variabel ref item - Saat membuat/memperbarui referensi ke variabel dalam item konsumen, pengguna tidak dapat mengatur referensi ke variabel referensi item kecuali mereka memiliki setidaknya izin BACA untuk item dalam kumpulan nilai aktif.

Validasi izin

Validasi izin dipicu dalam kasus penggunaan berikut:

  • Edit item pustaka variabel yang memiliki variabel referensi item. Saat mengedit, kami memvalidasi bahwa item yang direferensikan ada, dan pengguna memiliki setidaknya izin baca terhadap mereka, untuk semua nilai referensi item dalam kumpulan nilai aktif, dalam skenario berikut:

  • UI - Selama SIMPAN item Pustaka Variabel, pemeriksaan izin dilakukan pada nilai aktif variabel referensi item untuk pengguna yang menyimpan item, bahkan jika nilai tersebut tetap tidak berubah.

  • API/Pembaruan Git - Validasi izin dilakukan selama Pembaruan dan gagal jika tidak ada izin baca ke nilai aktif Item ref dari ruang kerja yang diperbarui.

  • Penyebaran - Penyebaran item pustaka variabel akan gagal jika tidak ada izin baca ke nilai aktif Item ref dari ruang kerja target.

  • Lihat detail tambahan referensi item di halaman Pustaka variabel (hanya UI) Pengguna dengan akses ke pustaka Variabel (penampil WS atau lebih tinggi) yang tidak memiliki izin untuk item dalam variabel item yang dirujuk, tidak akan melihat detailnya di UI. Sebagai gantinya, mereka akan melihat ID item disertai dengan pesan hover, bukan komponen detail.

Cuplikan layar izin.

  • Membuat/Mengedit variabel referensi item

    • UI - Saat memperbarui Nilai dari kumpulan nilai apa pun (Default atau lainnya), pengguna dapat memilih item dari daftar yang hanya menampilkan item yang setidaknya memiliki izin baca.
    • API/Pembaruan Git atau Penyebaran - lihat bagian 'Sunting Item Pustaka Variabel' di atas.

  • Penggunaan variabel referensi item dalam item konsumen

    • UI - Membuat Referensi ke Variabel - Saat membuat referensi dalam sebuah item ke variabel 'Referensi item' menggunakan dialog UI 'Pilih variabel' (seperti dalam Pintasan untuk Lakehouse dan Pipeline Data), ada pemeriksaan bahwa pengguna yang membuat referensi memiliki izin baca minimal pada item dalam variabel 'referensi item' (pemeriksaan hanya untuk nilai aktif). Jika tidak, pengguna hanya melihat ID item.

Perilaku Di Seluruh Alur CI/CD dan Tahap Penyebaran

Perpustakaan Variabel mengaktifkan CI/CD untuk konten Fabric di seluruh lingkungan (Dev, Test, Prod) dengan menggunakan variabel Referensi Item untuk konfigurasi yang spesifik untuk setiap tahap. Ingatlah hal berikut ini:

Referensi Statis

  • 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 kumpulan nilai untuk setiap tahap dan aktifkan kumpulan yang tepat secara manual atau melalui skrip API.

Untuk informasi selengkapnya, lihat set nilai dalam pustaka variabel.

Representasi di Git dan API

Pustaka Variabel dikelola sebagai kode. Menggunakan Git atau REST API, variabel Referensi Item memiliki 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.

Konten terkait

  • Last updated on