Aracılığıyla paylaş

Dataflow 2. Nesil'de Doku değişken kitaplıklarını kullanma (Önizleme)

Uyarı

Bu özellik şu anda önizleme aşamasındadır ve yalnızca CI/CD ile Dataflow 2. Nesil için kullanılabilir. 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, Dataflow 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 (Önizleme) 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:

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

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

Bu iki işlevden herhangi biri için geçirilmesi gereken beklenen tanımlayıcının şu biçime uyması gerekir:

$(/**/LibraryName/VariableName)

Kitaplığım adlı bir değişken kitaplığına ve Değişkenimadlı tür dizesinin değişkenine sahip olduğunuz senaryoda her iki işlev için aşağıdaki örnekler:

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

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

Bu işlevi bir sorgu betiğine uygularken, belirli bir LakehouseId ve WorkspaceId'den Fabric Lakehouse bağlayıcısını kullanarak Table1 adlı tabloya bağlanan aşağıdaki örnek sorguya bakalım.

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = "cfafbeb1-8037-4d0c-896e-a46fb27ff229"]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId = "5b218778-e7a5-4d73-8187-f10824047715"]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

workspaceId ve lakehouseId için geçirilen değerleri değiştirmeyi planlıyorsunuz, böylece CI/CD senaryolarında dinamik olarak doğru aşamadaki doğru öğeye işaret edebilsin.

Bu amaçla, Veri Akışınızın bulunduğu çalışma alanında, veri akışınızda başvurmayı planladığınız aşağıdaki değişkenleri içeren Kitaplığım adlı bir değişken kitaplığınız da vardır:

Değişken adı Değişken türü Varsayılan değer kümesi
Çalışma Alanı Kimliği String a8a1bffa-7eea-49dc-a1d2-6281c1d031f1
Lakehouse Kimliği String 37dc8a41-dea9-465d-b528-3e95043b2356

Bu bilgilerle, sorgu betiğinizi değiştirerek sonraki betikle sonuç veren değerleri değiştirebilirsiniz:

let
  Source = Lakehouse.Contents([]),
  #"Navigation 1" = Source{[workspaceId = Variable.ValueOrDefault("$(/**/My Library/Workspace ID)",  "cfafbeb1-8037-4d0c-896e-a46fb27ff229")]}[Data],
  #"Navigation 2" = #"Navigation 1"{[lakehouseId =  Variable.ValueOrDefault("$(/**/My Library/Lakehouse ID)","5b218778-e7a5-4d73-8187-f10824047715")]}[Data],
  #"Navigation 3" = #"Navigation 2"{[Id = "Table1", ItemKind = "Table"]}[Data]
in
  #"Navigation 3"

Dataflow'u değiştirilmiş betikle çalıştırdığınızda, değişkendeki değere ve değişken tarafından tanımlanan doğru veri türüne çözümlenmiş olur. Bu, Veri akışınızı çalıştırırken kullanılabilen değerlere bağlı olarak farklı bir Çalışma Alanı ve Lakehouse'a işaret eder.

Dikkat

Power Query düzenleyicisi şu anda değişkenlerin değerlendirilmesini desteklememektedir. Yazma deneyiminizin prototip oluşturma için varsayılan değeri kullandığından emin olmak için Variable.ValueOrDefault işlevini kullanmanızı öneririz.

Variable.ValueOrDefault aracılığıyla varsayılan bir değer kullanmak, çözümünüzü başvuru değişkeni kitaplığı olmayan başka bir ortama kopyaladığınızda veya taşıdığınızda bile formülünüzün çözümlendiğinden emin olunmasını sağlar. Çalışma zamanında değişken doğru değere çözümlenir.

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 bir kitaplığa yapılan değişiklikler çalışmasını durdurmaz veya etkilemez.

  • Power Query düzenleyicisi desteği: Power Query düzenleyicisinde değişkenleri çözümlemek veya değerlendirmek için geçerli destek yoktur.

  • 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.

  • Değişken sınırı: Veri akışları yalnızca en fazla 50 değişken alabilir.

  • SPN desteği: Veri akışları ancak yenileme kimlik doğrulaması için SPN kullanmıyorsa başarıyla yenilenebilir.

  • Last updated on