Dataflow 2. Nesil'de genel parametreleri kullanma

Tavsiye

Sürekli tümleştirme/sürekli dağıtım (CI/CD) senaryolarında bu özelliği nasıl kullanacağınız hakkında daha fazla bilgi için, Dataflow 2. Nesil için CI/CD ve ALM çözüm mimarileri makalesi ile Parametreli Dataflow 2. Nesil için uçtan uca öğreticiyi okuyun.

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 çalıştırılmasına izin verebileceğiniz yeni bir moddur. Her çalıştırmanın, Veri Akışınızın çalışma 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

• CI/CD desteğine sahip bir Veri Akışı 2. Nesil
• Parametreler Veri akışınızda ayarlanmalıdır.Veri Akışı'nda sorgu parametrelerini ayarlama hakkında daha fazla bilgi edinin.

Genel parametre modunu etkinleştirme

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

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.

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 modu etkinleştirildikten sonra veri akışınızı kaydedebilirsiniz.

Dataflow çalıştırmaları 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 gerekli olarak ayarlandıysa, veri akışını çalıştırmak için çalıştırma işine bir değer geçirilmelidir. Gerekli olarak ayarlanmış bir parametre için hiçbir değer geçirilmediyse çalıştırma başarısız olur.
• Gerekli olmayan parametreler: Bunlar isteğe bağlı parametreler olarak da adlandırılır ve çalıştırmanın tetiklenebilmek için herhangi bir değer geçirilmesi gerekmez. Hiçbir değer geçirilmediyse, çalıştırma için parametrenizin içinde tanımlanan Geçerli değer kullanılır.

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

Uyarı

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

Fabric'de bir işlem hattı oluşturduğunuzda, genel parametreler modu etkinleştirildiğinde CI/CD desteğine sahip bir Dataflow Gen2'nin çalıştırılmasını tetiklemek için veri akışı etkinliğini kullanabilirsiniz.

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

Veri akışı parametreleri bölümünde, Veri Akışınızda kullanılabilen tüm parametreleri ve değer bölümünün içindeki her birinin varsayılan değerini görebilirsiniz.

Gerekli parametrelerin adının yanında bir yıldız işareti bulunurken isteğe bağlı parametreler yoktur. Aynı zamanda isteğe bağlı parametreler kılavuzdan kaldırılabilir, ancak gerekli parametreler silinemez ve veri akışının çalışması için bir değer geçirilmelidir.

Veri akışınızdan en son parametre bilgilerini istemek için yenile düğmesini seçebilirsiniz.

Desteklenen parametre türleri

Tavsiye

Veri akışı bulma parametresi REST API'sini okuyun ve kullanın. Belgeler tüm kullanılabilir parametre türlerini ve beklenen değerlerini sağlar ve REST API veri akışınızdan parametre bilgilerini almak için bir yol sağlar.

Aşağıdaki tabloda, REST API tarafından beklenen değerlerin ne olduğunu anlamak için şu anda desteklenen parametre türleri ve REST API tanımının bağlantısı gösterilir.

Veri akışı parametre türü	REST API tanımı
Metin	DataflowStringParameter
Tamsayı (int64)	DataflowIntegerParameter
Ondalık sayı	DataflowNumberParameter
Date	DataflowDateParameter
DateTime	DataflowDateTimeParameter
Time	DataflowTimeParameter
TarihSaatDilimi	DataflowDateTimeZoneParameter
Süre	DataflowDurationParameter
Doğru/Yanlış	DataflowBooleanParameter

Dikkat edilmesi gerekenler ve sınırlamalar

Aşağıda, Ci/CD ile Dataflow 2. Nesil'de genel parametre modunu kullanırken dikkat edilmesi gereken tüm noktaların ve sınırlamaların listesi yer alıyor:

• Zamanlama ve el ile tetikleme: Gerekli parametre ayarlanmadığı sürece genel parametrelere sahip veri akışları Doku aracılığıyla zamanlanamaz veya el ile tetiklenemez.
• Desteklenmeyen parametreleştirme: Kaynaklar veya hedefler için kaynak yollarını değiştiren parametreler desteklenmez. Bağlantılar, yazılan yola sabitlenir.
• Artımlı yenileme: Genel parametre moduyla uyumlu değil.
• Mantıksal Değişiklik: Genel parametreler, değerleri geçersiz kılma erişimine sahip kullanıcıların veri akışı çıkışını değiştirmesine olanak sağlar.
• İzleme Merkezi: İzleme Hub'ı yürütme sırasında kullanılan parametre değerlerini göstermez.
• Hazırlama davranışı: Yalnızca en son çalıştırma Dataflow Staging Lakehouse'da depolanır ve Veri Akışı Bağlayıcısı tarafından döndürülür. Her çalıştırmanın verilerini tutmak için bir veri hedefi kullanmayı göz önünde bulundurun.
• Yinelenen İstekler: Aynı parametre değerleri birden çok kez gönderilirse, tamamlanana kadar yalnızca ilk istek kabul edilir.
• Şema Eşlemesi: Parametreler hedef şema eşlemelerini değiştiremez. Tüm eşlemeler, yazılan yapılandırmayı izler. Veri akışı 2. Nesil'de veri hedefleri ve yönetilen ayarlar hakkında daha fazla bilgi için makaleye göz atın.