İş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:

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.

Bkz. Dinamik değer başvurusu nedir?.