Bağlantı referans değişken türü (önizleme)

Bağlantı başvuru değişkeni, dış veri bağlantısının kimliğini (örneğin Snowflake, Azure SQL) depolayan ve öğelerin kimlik bilgilerini veya bağlantı dizelerini eklemeden dış kaynaklara başvurmasını sağlayan bir çalışma alanı değişkenidir.

Nasıl kullanılır?

Bağlantı başvuru değişkeni, değişken kitaplığındaki diğer değişkenler gibi kullanılabilir.

  1. Microsoft Fabric'da oturum açın
  2. Çalışma alanınıza ve değişken kitaplığınıza gidin
  3. Üst kısımda + Yeni Değişken'i seçin
  4. Değişken için bir ad girin, tür için bağlantı başvurusunu seçin ve ardından bir değer seçmek için ... öğesine tıklayın.

Bağlantı başvurusu için kullanılabilen öğelerin ekran görüntüsü. 5. Seçildikten sonra bağlantı başvurunuz kullanıma hazır olmalıdır.

Bağlantı başvurusunun ekran görüntüsü.

Bağlantı başvurusunu düzenlemeniz veya değeri iki kez denetlemeniz gerekiyorsa, bağlantı başvurusu hakkında bilgi içeren bir açılır pencere açmak için değere sağ tıklayabilirsiniz.

Bağlantı başvurusu açılır penceresinin ekran görüntüsü.

Nasıl çalışır?

Bağlantı başvuru değişkeninin değeri, bağlantı kimliğiyle tanımlanan bir bağlantı nesnesinin statik işaretçisidir. Değer, hedef bağlantının kimliğine karşılık gelen bir dize olarak depolanır. Örneğin:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb

Bu kimlik, başvuruda bulunılan bağlantıyı benzersiz olarak tanımlar. Statik referans, farklı dağıtım ortamlarına kendiliğinden ayarlanmaz. Hedef bağlantının seçim sırasında mevcut olmasını gerektirir ve el ile değiştirilmediği sürece bu bağlantıya işaret edilir.

Bağlantı referanslarıyla çalışırken aşağıdakileri göz önünde bulundurun:

  • Önceden tanımlanmış bir bağlantı tanımlayıcısını kiracı düzeyinde depolar.
  • Bağlantı başvuruları dağıtım sırasında otomatik olarak bağlanmaz. Değerleri ortamlar arasında sabit kalır.
  • Farklı ortamlar (geliştirme, test, üretim) için dış bağlantıları parametreleştirerek CI/CD ve otomasyonu destekler.
  • Dış ilişkilerin dinamik yapılandırmasını etkinleştirir (Örneğin, ortam başına veri kaynakları veya kimlik bilgileri arasında geçiş yapma).
  • Değerler, yalnızca yetkili bağlantıların seçilebilmesi için serbest metin yerine bir kullanıcı arabirimi iletişim kutusu aracılığıyla seçilir.
  • Yalnızca en az okuma izinlerine sahip bağlantılar seçim için kullanılabilir.

Git ve API'lerde temsil

Bağlantı referansı, bağlantı kimliği (connectionId) değerini depolayan ve platformun meta verileri çözümleyip görüntülediği gelişmiş bir değişken türüdür. Yazma yükü şunları içerir:

  • name: bağlantı başvuru değişkeninin displayName'i
  • not: isteğe bağlı, açıklama veya diğer notlar için kullanılabilir.
  • type: "connectionReference" (gelişmiş tür)
  • value: her değer kümesi için, her değer şu bilgiyi saklar: { "connectionId": "<GUID/ID string>" }

Örnek:


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

Bağlantı Başvuruları Oluşturmak/Kullanmak için Gereken İzinler

Bağlantı başvuru değişkenlerini kullanmak iki izin katmanı içerir:

  • Bağlantı referans değişkeni oluşturma ve düzenleme: Çalışma alanında Katkıda Bulunan veya daha üst rollere sahip kullanıcılar kütüphanede değişkenler oluşturabilir ve düzenleyebilirken, Görüntüleyiciler sadece salt okunur erişime sahiptir.
  • Bağlantı başvuru değişkenine erişme: Değişken Kitaplığı'ndaki haklara ek olarak, başvurmak istediğiniz bağlantı başvuru değişkeni üzerinde en azından Okuma izniniz olmalıdır .

İzinler ve izin doğrulaması hakkında daha fazla bilgi için bkz . Değişken kitaplığı izinleri

Desteklenen öğeler

Bağlantı başvuru değişkenlerini destekleyen öğelerin listesi aşağıdadır:

Python kodu örneği

Aşağıdaki kod örneğinde python betiğinde bağlantı başvurusunun nasıl kullanılacağı gösterilmektedir.

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

Bu kod aşağıdakileri yapar:

  • Bağlantı Referansı değişkenini Birleşik Değişken Kütüphanesi'nden çözümler.
  • Bağlantı meta veri nesnesini alır
  • Bağlantı kimliğini ayıklar
  • Kod veya API çağrılarında kullanılabilmesi için kimliği yazdırır.

Sınırlamalar

Bağlantı başvurusu değişkenleri için aşağıdaki sınırlamalar geçerlidir:

  • Not Defteri bağlantısı için connection_id aynı olmadığından, Not Defterlerindeki Yerleşik Bağlantılar desteklenmez.

İlgili içerik

  • Last updated on