Lakeflow Designer'da parametreleri kullanın

Lakeflow Designer'daki parametreler, görsel veri hazırlığının bütünü için tanımlanmış adlandırılmış değerlerdir. Parametrelere SQL ve Python operatör kodlarında, desteklenen operatör yapılandırma alanlarında ve operatörleri etkinleştiren veya devre dışı bırakan ifadelerde referans verebilirsiniz. Parametreler, aynı görsel veri hazırlığını farklı ortamlara karşı çalıştırmanıza olanak tanır; örneğin geliştirme sırasında bir test kataloğuna ve üretimde bir üretim kataloğuna karşı.

Requirements

  • Parametre oluşturmak veya alan bağlamalarını değiştirmek için görsel veri hazırlığını düzenleme iznine sahip olmanız gerekir.
  • Bir grubu parametreleştirmek için düzenleme iznine sahip olmanız gerekir
    • Görsel Veri Hazırlığını düzenle
    • Önizlemeleri çalıştır

Parametreleri tanımlayın

Parametreleri yönetmek için sol paneldeParametreler'i seçin. Her parametreyi tanımlarken ayarladığınız bir değer vardır. Görsel veri hazırlığı zamanlanmış olarak veya iş olarak çalıştığında, bu değeri geçersiz kılabilirsiniz. Bkz. Üretimde parametre değerlerini geçersiz kılma.

Panel, her parametri kullanan operatörleri listeler. Tuval üzerinde odaklamak için bir operatör adı seçin.

Bir operatörden bir parametreye referans ver

Bir parametreye nasıl referans vereceğiniz, kullandığınız yere bağlıdır:

  • SQL operatörü: Adı verilen parametre belirteci sözdizimi kullanın, örneğin :environment. Bkz . Adlandırılmış parametre işaretçilerini kullanma.
  • Python operatörü: Şunu çağırın: dbutils.widgets.get(), örneğin dbutils.widgets.get("environment"). Bkz. Widgets aracı (dbutils.widgets).
  • Desteklenen operatör yapılandırma alanları: Operatörün yapılandırma panelinde alanın üzerine gelin, ardından küme parantezi simgesini seçin. (Bir parametre kullanın). Bir ifade girin, örneğin :source_table, veya mevcut bir parametreyi seçin. Desteklenen alanlar şunlardır:
    • Kaynak: Tablo, Dosya yolu ve Dosya formatı.
    • Çıktı: Katalog, Şema, Tablo, Görünüm, Hacim, Dosya adı ve Yazma modu.
    • Sınır: Sınır.
    • Filtre: Bireysel koşul ifadeleri.
    • Hazırlık: Bireysel eylemler içinde desteklenen alanlar.
    • Birleştir: Küme işlemi, Birleştirme stratejisi, Ada göre birleşim ve Eksik sütunlara izin ver.

Desteklenen bir alanı yapılandırırken bir parametre tanımlamak için, parametre seçicide Parametre Oluştur seçeneğini seçin. Yeni parametreyi Parametreler panelinde yapılandırın, sonra alanda kullanın.

Düzenlemek üzere bir SQL veya Python işleci açtığınızda, Lakeflow Designer kaynak düzenleyicisinin üzerindeki kullanılabilir parametrelere nasıl başvurabileceğinize ilişkin bir örnek gösterir.

Parametreleri sabit metinle birleştirin

Bir kaynak veya çıktı operatörü için parametre ifadesinde, bir değerin tamamını değiştirmek için :parameter_name kullanın. Parametreleri sabit metinle birleştirmek için, metni tek tırnak içine alın ve || kullanın. Örneğin, aşağıdaki Kaynak Tablo ifadesi tam nitelikli bir tablo adı oluşturur:

:catalog || '.' || :schema || '.' || :table

Parametre ile bir operatörü etkinleştirin veya devre dışı bırakın

Yapılandırılmış bir operatörün çalışıp çalışmayacağını kontrol etmek için:

  1. Operatörün yapılandırma panelini açın ve Dişli simgesini seçin. (Operatör ayarları).
  2. Disabled'in yanında, Parantez kıvırımlı simgesini seçin. (Bir parametre kullanın).
  3. Bir Boole ifadesi girin, örneğin :skip_operator.

İfade, Doğru olarak değerlendirildiğinde operatörü devre dışı bırakır. Devre dışı bırakılmış bir operatör çıkış satırı üretmez.

Tüm grubu kontrol etmek için, grubun araç çubuğunda Grubu devre dışı bırak veya Grubu etkinleştir seçeneğini açın, ardından Disabled seçeneğinin yanındaki Kıvrımlı parantez simgesini seçin. (Bir parametre kullan). Bir Boolean ifadesi girin ve uygulamak için düzenleyiciyi kapatın.

Bunun yerine bir operatörü manuel olarak etkinleştirmek veya devre dışı bırakmak için bkz. Operatörleri Yeniden Adlandır, Kopyala, Sil ve Devre Dışı Bırak.

Üretimde parametre değerlerinin üzerine yazılması

Çalışma zamanında, görsel veri hazırlığı parametrelerini etkileşimli ya da iş olarak çalışsa da aynı şekilde okur, böylece aynı dosya tüm ortamlarınızda değişiklik olmadan çalışır. Her ortam için aşağıdaki gibi farklı değerler sağlayın:

  • Arayüzde bir işi planlarken: Her zamanlama için parametre değerlerini geçersiz kılın. Örneğin, aynı görsel veri hazırlığını her gün öğlen saatlerinde environment parametresi test olarak ayarlanmışken ve saat 14:00'te environment parametresi production olarak ayarlanmışken çalıştırılacak şekilde planlayın. Bir iş olarak zamanla bölümüne bakın.
  • Bir paketle dağıtım yaptığınızda: Parametre değerlerini işin parameters aracılığıyla ayarlayın ve paket hedeflerini kullanarak ortam başına farklı değerler sağlayın. Paket geliştirme ve üretim hedefleri, aynı işi ortama özgü ayarlarla ayrı ortamlara dağıtmanıza olanak tanır. Bkz . Bildirim temelli Otomasyon Paketleri dağıtım modları ve Bildirim temelli Otomasyon Paketleri yapılandırması.

Ek kaynaklar

  • Son güncelleştirme: