İşleri parametreleştirme
Bu makalede, işler ve görevlerle parametrelerin kullanımına genel bir bakış sağlanır.
İşler için parametreleri anlamaya yönelik temel kavramlar aşağıdadır:
- İş parametresi: İş düzeyinde tanımlanan ve görevlere gönderilen 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ı: İş koşulları, meta veriler ve parametrelere başvurular için söz dizimi. Bkz. Dinamik değer başvurusu nedir?.
- Görev değerleri: Görev çalıştırmaları sırasında oluşturulan değerleri yakalamak ve buna başvurmak için bir söz dizimi. Bkz . Görevler arasında bilgi geçirmek için görev değerlerini kullanma.
Parametrelerle ne 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.
- Çalıştırmaları koşullulaştırma.
- 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.
İş ve görev parametreleri arasındaki fark nedir?
İş parametreleri, iş düzeyinde tanımlanan anahtar-değer çiftleridir. Şimdi farklı parametrelerle çalıştırdığınızda veya REST API kullanarak bir iş çalıştırmasını tetiklediğinizde iş parametreleri için varsayılan ayarları geçersiz kılabilirsiniz. İş parametreleri, anahtar-değer parametrelerini kullanan görevlere iletilir. Diğer görevler, dinamik değer başvurularını kullanarak iş parametrelerine başvurabilir.
Görev parametreleri, görev düzeyinde tanımlanan JSON dizilerinin anahtar-değer çiftleridir. Her görev türü, görev değerlerini yapılandırılan kod varlıklarına farklı şekilde geçirir. Örneğin, not defteri görevleri alt modülü kullanırken dbutils.widgets
Python betikleri değerleri komut satırından çağrılır gibi betiklere bağımsız değişken olarak geçirir. Aşağı akış görevleri, dinamik değer başvuruları kullanarak yukarı akış görevlerinden görev parametrelerine başvurabilir.
Not
Bazı görevlerin ayrılmış Parametreler alanı yoktur, ancak diğer alanlarda görev değerlerine veya dinamik değer başvurularına izin verir. Bkz . Parametreli dbt komutları örnekleri ve If/else göreviyle bir işe dallanma mantığı ekleme.
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 değer ayarlamak yalnızca varsayılan bir değeri yapılandırmaktır. Bu değeri farklı parametrelerle çalıştırdığı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. - Not defteri sorgusunun çıkışını liste olarak yakalayın ve her görev için içinde döngü yapın.
- If/else koşulu görevi kullanılarak işlenen kayıt sayısına göre çatal oluşturma mantığı oluşturma.
- Diğer görevlerin parametrelerine bakın.