Bagikan melalui

Jenis variabel referensi koneksi (pratinjau)

Variabel referensi koneksi adalah variabel ruang kerja yang menyimpan ID koneksi data eksternal (Misalnya, Snowflake, Azure SQL), memungkinkan item untuk mereferensikan sumber daya eksternal tanpa menyematkan kredensial atau string koneksi.

Cara penggunaan

Variabel referensi koneksi 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 koneksi untuk jenis tersebut, lalu klik ... untuk memilih nilai

Cuplikan layar item yang tersedia untuk referensi koneksi. 5. Setelah dipilih, referensi koneksi Anda harus siap digunakan.

Cuplikan layar referensi koneksi.

Jika Anda perlu mengedit referensi koneksi atau perlu memeriksa kembali nilainya, Anda dapat mengklik kanan nilai untuk memunculkan pop-up dengan informasi tentang referensi koneksi.

Cuplikan layar pop-up referensi koneksi.

Cara kerjanya

Nilai variabel referensi koneksi adalah penunjuk statis ke objek koneksi yang diidentifikasi oleh ID koneksinya. Nilai disimpan sebagai string yang sesuai dengan ID koneksi target. Contohnya:

ConnectionID = aaaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

ID ini secara unik mengidentifikasi koneksi yang dirujuk. Referensi statis tidak secara otomatis menyesuaikan dengan lingkungan penyebaran yang berbeda. Ini mengharuskan koneksi target ada pada saat pemilihan dan tetap menunjuk ke koneksi tertentu tersebut kecuali diubah secara manual.

Perlu diingat hal berikut saat bekerja dengan referensi koneksi:

  • Menyimpan ID koneksi yang telah ditentukan sebelumnya di tingkat penyewa.
  • Referensi koneksi tidak terikat otomatis selama penyebaran. Nilainya tetap di seluruh lingkungan.
  • Mendukung CI/CD dan otomatisasi dengan membuat parameter koneksi eksternal untuk lingkungan yang berbeda (dev, test, prod).
  • Mengaktifkan konfigurasi dinamis hubungan eksternal (Misalnya, mengalihkan sumber data atau kredensial per lingkungan).
  • Nilai dipilih melalui dialog UI, bukan teks gratis, memastikan hanya koneksi resmi yang dapat dipilih.
  • Hanya koneksi dengan setidaknya izin baca yang tersedia untuk dipilih.

Representasi di Git dan API

Referensi Koneksi adalah jenis variabel tingkat lanjut yang skema nilainya menyimpan connectionId (dan platform menyelesaikan/menampilkan metadata). Payload penulisan meliputi:

  • nama: displayName dari variabel referensi koneksi
  • catatan: opsional, dapat digunakan untuk deskripsi atau catatan lainnya.
  • type: "connectionReference" (tipe tingkat lanjut)
  • nilai: per set nilai, setiap nilai menyimpan { "connectionId": "<string GUID/ID>" }

Contoh:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Izin yang Diperlukan untuk Membuat/Menggunakan Referensi Koneksi

Menggunakan variabel referensi koneksi melibatkan dua lapisan izin:

  • Membuat dan Mengedit variabel referensi koneksi: Pengguna dengan peran Pengontribusi atau lebih tinggi di ruang kerja dapat membuat dan mengedit variabel di perpustakaan, sementara Penonton hanya dapat membaca.
  • Mengakses variabel referensi koneksi: Selain hak pada Pustaka Variabel, Anda harus memiliki setidaknya izin Baca pada variabel referensi koneksi yang ingin Anda referensikan.

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

Item yang didukung

Berikut ini adalah daftar item yang mendukung variabel referensi koneksi:

Contoh kode Python

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

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

Kode ini melakukan hal berikut:

  • Menyelesaikan variabel Referensi Koneksi dari Perpustakaan Variabel Fabric
  • Mengambil objek metadata koneksi
  • Mengekstrak _connectionId_
  • Mencetak ID sehingga dapat digunakan dalam kode atau panggilan API.

Keterbatasan

Batasan berikut berlaku untuk variabel referensi koneksi:

  • Koneksi Bawaan di Buku Catatan tidak didukung karena connection_id untuk koneksi Notebook tidak sama.

Konten terkait

  • Last updated on