Öğe referans değişken türü (önizleme)

Esnekliği ve ölçeklenebilirliği geliştirmek için mevcut temel değişken türlerinin yanı sıra gelişmiş değişkenler sunuyoruz. Bu gelişmiş değişkenler, dış ve iç bağlantıları (örneğin, Snowflake, AWS, OneLake) parametreleme gibi temel gereksinimleri karşılamak için tasarlanmıştır.

item başvurusu değişkeni, çalışma alanı kimliğini ve öğe kimliğini depolayarak göl evi, not defteri veya veri işlem hattı gibi mevcut bir Fabric öğesine başvuruyu tutmak için Fabric Değişken Kitaplığı içinde kullanılan gelişmiş bir değişken türüdür. Bu tür bir değişken, geliştiricilerin dağıtım aşamasına veya çalışma alanı bağlamı temelinde öğeleri belirli Fabric öğelere dinamik olarak bağlamasına olanak tanıyarak iç bağlantı parametresileştirmesini sağlar.

Nasıl kullanılır?

Bir öğe 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 belirtin, tür için öğe başvurusu seçin ve ardından bir değer seçmek için ... öğesine tıklayın
  5. Bu işlem, istenen öğeyi seçmek için bir iletişim kutusu açar. İzinleriniz olan ve seçilebilen tüm öğeleri görürsünüz. Listeyi çalışma alanına göre filtrelemek için sol taraftaki gezgini kullanın. Türe göre filtrelemek için sağ üst köşedeki filtreyi kullanın.

Öğe başvurusu için kullanılabilen öğelerin ekran görüntüsü. 6. Seçildikten sonra, varlib sayfasında şöyle görünür - öğenin adını gösteren salt okunur bir bileşen olarak.

Öğe başvurusunun ekran görüntüsü.

Öğe referansını düzenlemeniz veya değeri çift kontrol etmeniz gerektiğinde:

  • ek ayrıntıları görmek için değere tıklayın
  • bu değeri veya diğer değer kümelerinin değerlerini düzenlemek için değerin yanındaki düğmeye tıklayın.

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

Nasıl çalışır?

Öğe Başvurusu değişkeninin değeri temelde Çalışma Alanı Kimliği + Öğe Kimliği tarafından tanımlanan bir Fabric öğesinin statik işaretçisidir. Değer, hedef öğenin çalışma alanına ve öğenin kendisine karşılık gelen bir çift GUID olarak depolanır. Örneğin, bir referans dahili olarak şöyle depolanabilir:

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

Bu iki kimlik birlikte başvuruda bulunan öğeyi benzersiz bir şekilde tanımlar.

Öğe referansları ile çalışırken aşağıdakileri göz önünde bulundurun:

  • Öğe referansları, geliştiricilerin, dağıtım aşaması veya çalışma alanı bağlamına göre öğeleri belirli Fabric kaynaklarına dinamik olarak bağlamalarını sağlayan iç bağlantı yapılandırmasını mümkün kılar.
  • Başvuru statiktir ve belirli bir öğeye işaret ediyor ve ortamlar arasında otomatik olarak ayarlenmiyor.
  • Aşamaya özgü çeşitlemeler için, her kümenin farklı bir statik öğeye işaret edebildiği değer kümelerini kullanın (örneğin, aşama başına farklı göl evleri).
  • Uyumluluk sağlamak ve çalışma zamanı hatalarını önlemek için değer kümelerindeki tüm değerler aynı öğe türünde olmalıdır . Ancak, değer kümeleri arasında aynı öğe türüne sahip olmayı zorunlu kılmayız.

Git ve API'lerde temsil

Değişken Kitaplığı kod olarak yönetilir. Git veya REST API'lerini kullanarak, Öğe Başvurusu değişkenleri net bir JSON biçimine sahiptir. Tüm değişkenler, Ad, tür ve değer gibi özellikleri listeleyerek Değişken Kitaplığı'nın tanım dosyasında (git'te depolanır, genellikle .json) görünür.

Öğe Başvurusu (Statik) değişkeni için değer, çalışma alanı ve öğe kimlikleri için yapılandırılmış verilerdir. Örnek:


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

API aracılığıyla çalışırken aşağıdakileri unutmayın:

  • Yalnızca kimlikler depolanır; adlar ve meta veriler çalışma zamanında alınır veya Fabric'de önbelleğe alınır.
  • API üzerinden oluşturma/güncelleme işlemi yaparken, çalışma alanı ve öğe kimliklerini sağlarsınız. Geçersiz kimlikler hatalara neden oluyor.

Desteklenen öğeler

Şu anda öğe başvurusu kullanılarak desteklenen öğelerin listesi aşağıdadır:

Uyarı

%%configure aracılığıyla defter desteklenmez.

Python kod örneği

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

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)

Bu kod aşağıdakileri yapar:

  • Fabric Değişken Kitaplığındaki bir Öğe Başvurusu değişkenini çözümler
  • Başvuruda bulunan öğenin meta veri nesnesini alır
  • Çalışma alanı kimliğini ve öğe kimliğini ayıklar
  • Program aracılığıyla kullanılabilmesi için bunları yazdırır.

Öğe başvuru değişkenlerini Oluşturmak/Kullanmak için Gereken İzinler

Öğe başvuru değişkenlerini kullanmak iki izin katmanı içerir:

  • Öğe başvuru değişkenini oluşturma ve düzenleme: Çalışma alanında Katkıda Bulunan veya daha üst rollere sahip kullanıcılar kitaplıkta değişkenler oluşturabilir ve düzenleyebilirken, Görüntüleyiciler salt okunur durumdadır.
  • Öğe başvuru değişkenine erişme: Değişken Kitaplığı'ndaki haklara ek olarak, başvurmak istediğiniz öğe 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

Sınırlamalar

Şu anda yalnızca doku öğelerine ve anlamsal modellere başvurabilirsiniz. Dataflow 1. Nesil gibi diğer Power BI öğeleri şu anda desteklenmiyor.

Ek bilgiler

Değişken Kitaplığı, evreye özel yapılandırmalar için Öğe Referansı değişkenlerini kullanarak, ortamlar arasında (Geliştirme, Test, Üretim) Fabric içeriği için CI/CD'yi etkinleştirir. Aşağıdakileri aklınızda bulundurun:

  • Öğe Başvuruları belirli bir çalışma alanına ve öğe kimliğine bağlıdır.
  • Yeni bir aşamaya dağıtılırken, bu referanslar elle güncellenmedikçe orijinal çalışma alanına işaret eder.
  • Her aşama için Birden Çok Value-Sets kullanın ve doğru kümeyi el ile veya API betikleri aracılığıyla etkinleştirin.

Daha fazla bilgi için bkz. Değişken kitaplıklarındaki değer kümeleri.

İlgili içerik

  • Last updated on