İşleri parametreleştirme

Parametreler, bir işe ve onun görevlerine değer aktarmanıza ve görevler arasında değerlere başvurmanıza olanak tanır. Bu makalede Lakeflow İşleri'nde kullanılabilen parametre türleri ve bunların kullanıcı arabiriminde nasıl yapılandırılması anlatılır. Ayrıca, parametrelere başvurmak için görev olarak yapılandırdığınız kaynak kodu varlıklarını da güncelleştirmeniz gerekir. Parametre başvuruları dile ve görev türüne göre değişir. Bkz. bir görevdenparametre değerlerine eriş.

İşler için parametreleri anlamaya yönelik temel kavramlar aşağıdadır:

• İş parametresi: İş düzeyinde tanımlanan ve görevlere aktarılan anahtar-değer çifti. bkz. İş parametrelerini yapılandırma.
• Görev parametresi: Görev düzeyinde tanımlanan bir anahtar-değer çifti veya JSON dizisi. bkz. Görev parametrelerini yapılandırma.
• Dinamik değer başvuruları: Görevleri yapılandırırken iş koşullarına, meta verilerine ve parametrelere başvurmaya yönelik söz dizimi. Bkz. Dinamik değer başvuruları.
• Görev değerleri: Görev çalıştırmaları sırasında oluşturulan değerleri yakalamak ve referans vermek için bir söz dizimi. Bkz. Görevler arasında bilgi aktarmak için görev değerlerini kullanma.
• Koddaki parametre değerlerine erişme: Görev kodunuzun içinden, görev türüne göre parametre değerlerini okuma. Bkz. bir görevdenparametre değerlerine eriş.

Not

Dağıtıma özgü yapılandırmayı uygulama koduna parametreler yerine ortam değişkenleri olarak aktarmak için, sunucusuz işler için ortam değişkenlerini kullanın. Sunucusuz işler için ortam değişkenlerini yapılandırma bölümüne bakınız.

Parametrelerle neler yapabilirsiniz?

Aşağıdakiler de dahil olmak üzere gelişmiş kullanım örnekleri için işlere ve görevlere parametreler ekleyin:

• Kod varlıklarına genişletilebilir mantık ekleyin.
• Yürütmeleri koşullara bağlama.
• Birden çok görev arasında ortak parametrelere başvurun.
• Başka bir görevde bir görevde oluşturulan bilgileri kullanın.
• İş çalıştırmasında meta veriler ve durum bilgilerine başvurun.

İş parametreleri ile görev parametreleri karşılaştırması

İş parametreleri, iş düzeyinde tanımlanan anahtar-değer çiftleridir. İş parametrelerinin varsayılan ayarlarını, Şimdi çalıştır'ı farklı parametrelerle kullanarak veya REST API'yi kullanarak bir iş çalıştırmasını tetikleyerek geçersiz kılabilirsiniz. İş parametreleri, anahtar-değer parametrelerini kullanan görevlere aktarılır. Diğer görevler, dinamik değer başvurularını kullanarak iş parametrelerine başvurabilir.

Not

Bir işte CAN MANAGE RUN iznine veya daha yüksek bir izne sahip herhangi bir kullanıcı, Farklı parametrelerle şimdi çalıştır seçeneğini kullanarak manuel çalıştırma için iş parametresi değerlerini geçersiz kılabilir. Varsayılan parametre değeri bir güvenlik denetimi değildir. Değişiklikleri önlemek için işin izinlerini kısıtlayın.

Görev parametreleri, görev düzeyinde tanımlanan anahtar-değer çiftleri veya JSON dizileridir. Her görev türü, görev değerlerini yapılandırılan kod varlıklarına farklı şekilde geçirir. Örneğin, defter görevleri dbutils.widgets alt modülünü kullanırken, Python betikleri değerleri komut satırından çağrılır gibi betiklere parametre olarak aktarır. Aşağı akış görevleri, dinamik değer başvuruları kullanarak yukarı akış görevlerinden görev parametrelerine başvurabilir. Bkz. bir görevdenparametre değerlerine eriş.

Not

Bazı görevlerin özel bir Parametreleri alanı yoktur, ancak diğer alanlarda görev değerlerine ya da dinamik değer referanslarına izin verir. Bkz Parametreli dbt komutları örneklerine ve If/else göreviyle bir işe dallanma mantığı ekleyin.

Dinamik değerleri kullanarak iş akışları oluşturma

Statik değerlerle ayarlanan görev parametreleri yalnızca görev tanımı güncelleştirilerek geçersiz kılınabilir. Bir iş parametresi için statik bir değer ayarlamak, sadece varsayılan bir değeri yapılandırmaktır. Bu değeri, Şimdi çalıştır'ı farklı parametrelerle kullandığınızda veya REST API kullanarak bir iş çalıştırmasını tetiklediğinizde geçersiz kılabilirsiniz.

Aşağıdaki gibi desenleri uygulamak için görev parametrelerini tanımlarken dinamik değer başvurularını kullanın:

• İş parametresini output_table bir görev için, input_table diğeri için kullanın.
• Bir not defteri sorgusunun çıktısını bir liste olarak yakalayın ve bu liste üzerinde her görev için bir içinde döngü yapın.
• İşlenen kayıt sayısına göre dallanma mantığı oluşturmak için bir If/else koşulu görevi kullanma.
• Diğer görevlerin parametrelerine bakın.

Bkz. Dinamik değer başvuruları.