Dataflow Gen2'de Fabric değişken kitaplıklarını kullanma

Uyarı

Sürekli tümleştirme/sürekli dağıtım (CI/CD) senaryolarında bu özelliğin nasıl yararlanılacağı hakkında daha fazla bilgi için, Veri Akışı 2. Nesil için CI/CD ve ALM çözüm mimarileri makalesini ve Veri Akışındaki Değişken başvuruları hakkındaki uçtan uca öğreticiyi okuduğunuzdan emin olun.

Fabric değişken kitaplıkları, Microsoft Fabric iş yükleri genelinde yapılandırma değerlerini yönetmek için merkezi bir yol sunar. Dataflow 2. Nesil'deki yeni tümleştirmeyle, bu değişkenlere doğrudan veri akışınızda başvurarak ortamlar arasında dinamik davranışı etkinleştirebilir ve CI/CD iş akışlarını basitleştirebilirsiniz.

Önkoşullar

Dataflow Gen2'de Fabric değişken kitaplıklarını kullanmak için aşağıdakilerden emin olmalısınız:

Girdi arabirim öğelerini kullanarak değişkenleri referans alma

Veri Akışı 2. Nesil iletişim kutuları, alan değerinin nasıl girileceğini seçmenizi sağlayan bir giriş pencere öğesi içerir. Desteklenen iletişim kutusunda, bu pencere öğesini kullanarak değişkenleri seçebilirsiniz.

Giriş için kullanılabilen birden çok seçeneği gösteren bir filtre satırları iletişim kutusundaki giriş pencere öğesinin ekran görüntüsü.

Uyarı

Giriş pencere öğesini kullanmak için şeritteki Görünüm sekmesinin Parametreler grubunda Her zaman izin ver'i seçin. Şeridin Görünüm sekmesinde bulunan giriş pencere öğesini etkinleştirmek için 'Her zaman izin ver' onay kutusunun ekran görüntüsü.

Giriş widget deneyimini ve Fabric değişken kitaplıklarını destekleyen bazı iletişim kutuları şunlardır:

Giriş pencere öğesinde değişken seçeneğini belirlediğinizde değişken seçici iletişim kutusu görüntülenir. Bu iletişim kutusunda, değişken kitaplıklarınıza ve bunların içerdiği değişkenlere göz atabilirsiniz.

Geçerli çalışma alanında kullanılabilen tüm kitaplıkları ve değişkenleri görüntüleyen değişken seç iletişim kutusunun ekran görüntüsü.

Bir değişken seçtikten sonra, işlemeden önce seçiminizi onaylayabileceğiniz kitaplık ve değişken adı iletişim kutusunda görüntülenir.

Benim Kitaplığım'dan Tavan adlı bir değişkenin ekran görüntüsü, filtre satırları iletişim kutusunda seçili olarak gösteriliyor.

Uyarı

Tüm Veri Akışı deneyimleri giriş pencere öğesini desteklemez. Desteklenmeyen deneyimler veya özel senaryolar için değişken işlevlerini el ile kullanın.

Değişken işlevler

Veri Akışı 2. Nesil'inizin içinde, aşağıdaki işlevlerden birini kullanarak bir değişkene başvurabilirsiniz:

her iki işleve de geçirdiğiniz tanımlayıcı aşağıdaki biçimi kullanmalıdır:

$(/**/LibraryName/VariableName)

Aşağıdaki örneklerde Kitaplığım adlı bir değişken kitaplığı ve Değişkenim adlı bir dize değişkeni varsayılır:

Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")

Variable.Value("$(/**/My Library/My Variable)")

aracılığıyla Variable.ValueOrDefault varsayılan bir değer kullanmak, çözümünüzü başvurulan değişken kitaplığına sahip olmayan başka bir ortama kopyaladığınızda veya taşıdığınızda bile formülünüzün çözümlendiğinden emin olmanıza yardımcı olur.

Tip

Her değişkeni hazırlama gerektirmeyen ayrı bir sorgu olarak depolayın. Bu yaklaşım, sorgu girişini destekleyen ve veri akışınızdaki değişkenlerin düzenli bir görünümünün korunmasına yardımcı olan iletişim kutularındaki bu değerleri kullanmanıza olanak tanır.

Dikkat edilmesi gerekenler ve sınırlamalar

Aşağıdaki listede, Dataflow 2. Nesil ile Doku değişken kitaplıkları kullanılırken göz önünde bulundurulması gereken önemli kısıtlamalar ve davranışlar özetlenmiştir. Bu sınırlamalar, değişkenlere tasarım ve çalışma zamanı sırasında başvurma, değerlendirme ve uygulama şeklini etkiler.

  • Çalışma Alanı Kapsamı: Değişken kitaplıkları, CI/CD ile Veri Akışı 2. Nesil ile aynı çalışma alanında bulunmalıdır.

  • Başvuru Konumu: Değişkenler yalnızca CI/CD ile Dataflow Gen2'nin mashup.pq dosyasında kullanılabilir.

  • Çalışma zamanı davranışı: Değişken değerleri bir çalıştırma işleminin başlangıcında alınır ve işlem boyunca kalıcı hale gelir. Veri Akışı çalıştırması sırasında kitaplıkta yapılan değişiklikler bu çalıştırmayı durdurmaz veya etkilemez.

  • Varsayılan değer kullanma: Variable.ValueOrDefault işlevi aracılığıyla varsayılan bir değer kullanırken, varsayılan değerin veri türünün başvurulan değişkenin veri türüyle eşleştiğinden emin olun.

  • Desteklenen Türler: Yalnızca temel türlerdeki değişkenler desteklenir (boolean, datetime, guid, integer, numberve string).

  • Sabit bağlantılar: Değişkenler bağlantı bilgilerini değiştiremez. Bağlantılar, oluşturulmuş kaynak yolu yapılandırmalarına sabit kalır.

  • Geçersiz kılma riski: Değişken kitaplıklarını değiştirme erişimi olan kullanıcılar değişken değerlerini geçersiz kılabilir ve bu da veri akışı çıkışını etkileyebilir.

  • Şema eşlemesi: Değişkenler hedef şema eşlemelerini değiştiremez; eşlemeleri, yazılan kurulumu izler.

  • Köken görünürlüğü: Köken görünümleri, Veri Akışı 2. Nesil ile başvuruda bulunan değişken kitaplıkları arasındaki bağlantıları göstermez.

  • Last updated on