Aracılığıyla paylaş


Dataflow 2. Nesil'de genel parametreleri kullanma (Önizleme)

Uyarı

Fabric Dataflow Gen2'deki genel parametreler önizleme işlevi olarak kullanılabilir. Bu deneyimi yalnızca CI/CD desteğine sahip Dataflow 2. Nesil uygulayabilir.

Dataflow 2. Nesil'deki parametreler, veri akışlarını dinamik olarak denetlemenize ve özelleştirmenize olanak tanıyarak veri akışını değiştirmeden farklı giriş ve senaryoları etkinleştirerek daha esnek ve yeniden kullanılabilir hale getirmenizi sağlar. Birden çok veri akışı gereksinimini azaltarak ve denetimi tek, parametreli bir veri akışı içinde merkezileştirerek her şeyin düzenli kalmasına yardımcı olur.

Dataflow 2. Nesil'deki genel parametreler, Parametre değerlerini Doku REST API'si aracılığıyla veya yerel Doku deneyimleri aracılığıyla Power Query düzenleyicisinin dışına geçirerek Veri akışınızın yenilenmesine izin verebileceğiniz yeni bir moddur. Her yenilemenin, Veri Akışınızın yenilenme biçimini etkileyen farklı parametrelerle çağrılabildiği Veri akışınızla daha dinamik bir deneyim yaşamanıza olanak tanır.

Önkoşullar

Dikkat edilmesi gerekenler ve sınırlamalar

  • Genel parametreler modu etkinleştirilmiş veri akışları, Fabric zamanlayıcısı aracılığıyla yenileme için zamanlanamaz. Tek özel durum, gerekli parametre ayarsız bir veri akışıdır.
  • Genel parametreler modunda etkinleştirilmiş veri akışları, Fabric Çalışma Alanı listesi veya köken görünümü aracılığıyla manuel olarak tetiklenemez. Tek özel durum, gerekli parametre ayarsız bir veri akışıdır.
  • Veri kaynağının veya hedefin kaynak yolunu etkileyen parametreler desteklenmez. Bağlantılar, yazılan veri akışında tanımlanan tam veri kaynağı yoluna bağlanır ve şu anda diğer bağlantıları veya kaynak yollarını kullanmak için geçersiz kılınamaz.
  • Artımlı yenilemeye sahip veri akışları bu yeni moddan yararlanamaz.
  • Geçersiz kılma için yalnızca ondalık sayı, tamsayı, metin ve true/false türündeki parametreler geçirilebilir. Diğer veri türleri yenileme geçmişinde yenileme isteği oluşturmaz ancak izleme hub'ında gösterilir.
  • Genel parametreler modu, kullanıcıların parametre değerlerini geçersiz kılarak Veri Akışı içinde tanımlanan mantığı değiştirmesine olanak tanır. Veri akışı üzerinde izinleri olan diğer kişilerin verileri başka değerlerle yenilemesine olanak tanıyarak veri akışında kullanılan veri kaynaklarından farklı çıkışlar elde edilir.
  • İzleme hub'ı, veri akışının çağrılması sırasında geçirilen parametreler hakkında bilgi görüntülemez.
  • Aşamalı sorgular yalnızca Staging Lakehouse'da depolanan veri akışının son veri yenilemesini tutar. Kullanıcılar, hangi verilerin depolandığını belirlemek için Dataflows bağlayıcısını kullanarak Staging Lakehouse'daki verilere bakabilir. Genel parametre modunu kullanırken veri hedeflerinin tanımlanması kesinlikle önerilir.
  • Aynı parametre değerleri için yinelenen bir istek gönderilirken, yalnızca ilk istek kabul edilir ve ilk istek değerlendirmesini bitirene kadar izleyen istek reddedilir.

Genel parametre modunu etkinleştirme

Veri akışının yazarı olarak Veri Akışı'nı açın. Şeridin Giriş sekmesinde Seçenekler düğmesini seçin.

Power Query Düzenleyicisi şeridinin Giriş sekmesinde bulunan Seçenekler düğmesinin ekran görüntüsü.

Düğmeyi seçtiğinizde yeni bir Seçenekler iletişim kutusu açılır. Dikey menüde, veri akışı grubunun içinde Parametreler etiketine sahip seçeneği belirleyin. Parametreler bölümünde genel parametre modunu etkinleştirmek için "Parametrelerin bulunmasını etkinleştir ve yürütme için geçersiz kıl" seçeneğini etkinleştirebilirsiniz.

Genel parametreler modunu etkinleştirmeye yönelik Seçenekler iletişim kutusunun ekran görüntüsü.

Bu değişiklikleri işlemek için Tamam düğmesini seçin.

Bu mod etkinleştirildiğinde, Parametreleri yönet iletişim kutusunda iletişim kutusunun üst kısmındaki "Genel parametre modu etkinleştirildi" yazan bir bildirim alırsınız.

Genel parametre modunun etkinleştirildiği bildirimini gösteren parametreleri yönet iletişim kutusunun ekran görüntüsü.

Genel parametre modu etkinleştirildikten sonra veri akışınızı kaydedebilirsiniz.

Şeridin ana sekmesindeki veri akışını kaydetme seçeneklerinin ekran görüntüsü.

Yenileme için özel parametre değerlerini geçirme

Genel parametre modu, gerekli ve sorgulanmayan parametreler arasında ayrım yapılan veri akışı içindeki parametrelerin tanımını izler.

  • Gerekli parametreler: Bir parametre gerektiği gibi ayarlanırsa, veri akışını yenilemek için yenileme işine bir değer geçirilmelidir. Gerekli olarak ayarlanmış bir parametre için hiçbir değer geçirilmediyse yenileme başarısız olur.
  • Gerekli olmayan parametreler: Bunlar isteğe bağlı parametreler olarak da adlandırılır ve yenilemenin tetiklenmesi için hiçbir değer geçirilmesi gerekmez. Hiçbir değer geçirilmediyse, parametrenizin içinde tanımlanan Geçerli değer yenileme için kullanılır. Ancak, her zaman yenileme için kullanılan bir geçersiz kılma değeri verebilirsiniz.

Veri İşlem Hatları içinde Veri Akışı yenileme etkinliğini kullanma

Uyarı

Tüm özelliklerini anlamak için Doku veri işlem hatlarından veri akışı etkinliği hakkında daha fazla bilgi okumanızı öneririz.

Fabric'te bir işlem hattı oluşturduğunuzda, genel parametreler modunun etkinleştirildiği CI/CD desteğine sahip bir Dataflow Gen2'nin yenilenmesini tetiklemek için veri akışı yenileme etkinliğini kullanabilirsiniz.

Kullanmak istediğiniz veri akışını seçebilir ve veri akışı parametreleri bölümünde kullanmak istediğiniz parametreleri ayarlayabilirsiniz.

Yenileme için parametreleri geçirmenize olanak tanıyan Fabric Veri hattındaki veri akışı etkinliğinin ekran görüntüsü.

Veri akışı parametreleri bölümünde parametrenin adını, geçirmek istediğiniz değer türünü ve geçirebileceğiniz değeri geçirebilirsiniz. Geçersiz kılmak istediğiniz tüm desteklenen parametreleri el ile ekleyebilirsiniz.

Önemli

Parametre adları büyük/küçük harfe duyarlı olduğundan, parametrelerin adını veri akışının içine tam olarak yazıldığı şekilde geçirmeyi unutmayın.