Öğ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 reference değişkeni, Fabric Variable Library içinde, çalışma alanı kimliğini ve öğe kimliğini depolayarak lakehouse, not defteri veya veri işlem hattı gibi mevcut bir Fabric öğesine referans tutmak için kullanılan ileri seviye bir değişken türüdür. Bu değişken türü, geliştiricilerin dağıtım aşamasına veya çalışma alanı bağlamını temel alarak öğeleri belirli Doku öğelerine dinamik olarak bağlamasına olanak tanıyarak iç bağlantı parametresini etkinleştirir.

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.

Microsoft Fabric'te oturum açma
Çalışma alanınıza ve değişken kitaplığınıza gidin
Üst kısımda + Yeni Değişken'i seçin
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
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.

6. Seçildikten sonra, varlib sayfasında şöyle görünür - öğenin adını gösteren salt okunur bir bileşen olarak.

Öğ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.

Nasıl çalışır?

Öğe Başvurusu değişkeninin değeri temelde Çalışma Alanı Kimliği + Öğe Kimliği ile tanımlanan bir Yapı öğ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 başvuruları, geliştiricilerin dağıtım aşamasına veya çalışma alanı bağlamı temelinde öğeleri belirli Doku kaynaklarına dinamik olarak bağlamasına olanak tanıyarak iç bağlantı parametresini etkinleştirir.
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.

Desteklenen öğeler

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

Uyarı

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

Sınırlamalar

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

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

Öğe Başvurusu değişkenlerini kullanmak iki izin katmanı içerir:

Oluştur/Düzenle - Çalışma alanı katkıda bulunanları değişken değerlerini değiştirebilir, ancak Öğe başvuru değişkeni kullanıcıların yalnızca okuma izinlerine sahip oldukları değer öğeleri olarak ayarlamasına izin verir. Bu, tüm değerler, varsayılan etkin değer kümesi veya diğer değer kümeleri için geçerlidir. Değişken Kitaplığı öğesini kaydederken, öğeyi kaydeden kullanıcı için öğe başvuru değişkenlerinin etkin değerleri üzerinde bu değerler değişmeden kalsa bile bir izin denetiminin gerçekleştirildiğini unutmayın.
Öğe başvuru değişkeni kullanma - Tüketici öğesindeki bir değişkene başvuru oluştururken/güncelleştirirken, kullanıcılar etkin değer kümesindeki öğe için en az OKUMA iznine sahip olmadığı sürece bir öğe başvuru değişkenine başvuru ayarlayamaz.

İzin doğrulama

İzin doğrulaması aşağıdaki kullanım örneklerinde tetikleniyor:

Öğe başvuru değişkenleri olan değişken kitaplığı öğesini düzenleme Düzenlerken, aşağıdaki senaryolar için hem başvurulan öğelerin mevcut olduğunu hem de kullanıcının etkin değer kümesindeki tüm öğe başvuru değerleri için en az okuma izinlerine sahip olduğunu doğrularız:
Ui - Değişken Kitaplığı öğesini kaydetme sırasında , öğeyi kaydeden kullanıcı için öğe başvuru değişkenlerinin etkin değerleri üzerinde bu değerler değişmeden kalsa bile bir izin denetimi gerçekleştirilir.
API'ler/Git Güncellemesi - Güncelleme sırasında izin doğrulaması yapılır ve öğenin referansının çalışma alanının güncellenmiş etkin değerine okuma izni yoksa başarısız olur.
Dağıtım - Hedef çalışma alanındaki öğe referansının etkin değeri için okuma izni yoksa, değişken kitaplık öğesinin dağıtımı başarısız olur.
Öğe başvuru ek ayrıntılarını Değişken kitaplığı sayfasında görüntüle (yalnızca UI). Değişken kitaplığına erişimi olan kullanıcılar (WS görüntüleyicisi veya üzeri) ve başvurulan öğe değişkenindeki öğe için izinleri bulunmayanlar, kullanıcı arabiriminde ayrıntılarını göremez. Bunun yerine, öğe kimliğini ayrıntılar bileşeni yerine bir vurgulama iletisiyle birlikte görürler.

Öğe başvuru değişkenlerini oluşturma/düzenleme
- Ui - Herhangi bir değer kümesinin değerini güncelleştirirken (Varsayılan veya diğer), kullanıcı yalnızca en az okuma iznine sahip olduğu öğeleri gösteren bir listeden öğe seçebilir.
- API'ler/Git Güncelleştirmesi veya Dağıtımı - Yukarıdaki Değişken kitaplığı öğesini düzenleme bölümüne bakın.
Tüketici öğesinde öğe başvuru değişkeninin kullanımı
- Ui - Değişken başvurusu oluşturma - 'Değişken seç' kullanıcı arabirimi iletişim kutusunu kullanarak bir 'Öğe başvurusu' değişkenine başvuru oluştururken (Lakehouse ve Veri işlem hattı kısayolunda olduğu gibi), başvuruyu oluşturan kullanıcının 'öğe başvurusu' değişkenlerindeki öğeler için en az okuma iznine sahip olduğu doğrulanır (doğrulama yalnızca etkin değerler içindir). Aksi takdirde, kullanıcı yalnızca öğelerin kimliğini görür.

CI/CD İşlem Hatlarında ve Dağıtım Aşamalarında Davranış

Değişken Kütüphanesi, aşamaya özgü yapılandırmalar için Öğe Referansı değişkenlerini kullanarak ortamlar genelinde (Geliştirme, Test, Üretim) Fabric içeriği için CI/CD'yi etkinleştirir. Aşağıdakileri aklınızda bulundurun:

Statik Referanslar

Öğ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.

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 Doku'da ö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.

Değişken kitaplığına genel bakış
Değişken türleri
Değer kümeleri
Değişken kütüphane izinleri](./variable-library-permissions.md)

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-01-29