Lakeflow Designer'da parametreleri kullanın

Parametreler , görsel veri hazırlığı için bütünü için tanımlanan 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şı.

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.

Bir operatördeki parametreye başvur

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

  • SQL işleci: gibi :environmentadlandırılmış parametre işaretçisi söz dizimlerini kullanın. Bkz . Adlandırılmış parametre işaretçilerini kullanma.
  • Python işleci: Örneğin dbutils.widgets.get() gibi, dbutils.widgets.get("environment") öğesini çağırın. Bkz. Widgets aracı (dbutils.widgets).
  • Desteklenen operatör yapılandırma alanları: Operatörün yapılandırma panelinde, sağ üst köşede Parametreler'i seçin. Bir alan seçin ve örneğin :source_tablebir ifade girin. 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.
    • Limit: Limit.
    • Birleştir: Küme işlemi, Birleştirme stratejisi, Ada göre birleştirme ve Eksik sütunlara izin ver.

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

Herhangi bir yapılandırılmış operatörü etkinleştirmek veya devre dışı bırakmak için bir parametre kullanabilirsiniz. Parametreler panelinde Disabled seçin ve bir Boolean ifadesi girin. Örneğin, :skip_operator parametre olduğunda trueoperatörü devre dışı bırakır. Devre dışı bırakılmış bir operatör çıkış satırı üretmez.

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:

  • Kullanıcı arabiriminde bir iş zamanladığınızda: 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 parametersaracılığıyla ayarlayın ve ortam başına farklı değerler sağlamak için paket hedeflerini kullanı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