Parametreler
Parametreler, bir akış için bir kez tanımlanan ve akışın herhangi bir düğümünde kullanılabilen adlandırılmış değerlerdir. Aynı değeri birden fazla alana yazmak yerine değer tek bir yerde tutulur ve gereken her yerde ona başvurulur.
Özellikle ortama veya çalışmaya göre değişen değerler için kullanışlıdır, örneğin:
-
bir kaynağın okuduğu şema veya tablo (
orders_$$env), -
bir hedefin yazdığı dizin (
$$output_dir/daily), -
bir filtrenin karşılaştırdığı değer (
region = $$region).
Böylece parametrenin değeri değiştirildiğinde, ona başvuran tüm alanlar düğümleri tek tek düzenlemeye gerek kalmadan değişmiş olur.
Parametre Kullanımı
Bir düğüm veya akış alanında parametreye, adının önüne
$$ yazılarak başvurulur:
$$parametre_adi
Başvuru tek başına ya da daha uzun bir metnin parçası olarak kullanılabilir:
| Alan değeri | Parametre | Kullanılan değer |
|---|---|---|
$$env |
env = prod
|
prod |
orders_$$env |
env = prod
|
orders_prod |
$$base_dir/exports |
base_dir =
/data
|
/data/exports |
Alan, başvuruyu yazıldığı haliyle saklar; başvuru akış çalıştığında parametrenin değeriyle değiştirilir. Değere daha önce ihtiyaç duyulduğunda, örneğin adında parametre geçen bir tablonun kolonları listelenirken, güncel değer yalnızca o sorgu için kullanılır.
Bir parametrenin adı diğerinin başlangıcıysa ($$table
ve $$table_name) önce uzun olan eşleştirilir;
böylece birbirlerine karışmazlar.
Parametrelerin Kullanılamadığı Yerler
Bazı adlar motor tarafından yazıldığı haliyle kullanıldığı için
$$ başvurusu içeremez:
- bir düğümün çıktı tablosu adı,
- bir düğümün şemasındaki kolon adı.
Başvuru, kullanıldığı alanın tipine göre kontrol edilmez. Örneğin sayısal
bir kolonu $$limit ile karşılaştıran bir filtre
düzenleme sırasında kabul edilir; değer sayı değilse hata akış
çalıştığında bildirilir.
Parametre Tanımlama
Her parametrenin şu alanları vardır:
| Alan | Açıklama |
|---|---|
| İsim |
$$ ardından kullanılan ad. Yalnızca
harf, rakam ve alt çizgi (_)
içerebilir; benzersiz olmalıdır.
|
| Açıklama | Parametrenin ne için kullanıldığı. Zorunlu değildir, ancak akışı kullanan diğer kişilere yardımcı olur. |
| Tip | Statik veya İfade. |
| Değer | Başvuruların yerine kullanılacak değer. |
Parametre Ekle yeni bir satır ekler, satırdaki silme butonu ise o parametreyi kaldırır. Değişiklikler Kaydet ile uygulanır.
Parametrenin adı $$ olmadan saklanır:
env adlı bir parametreye
$$env olarak başvurulur.
Parametre Tipleri
| Tip | Açıklama |
|---|---|
| Statik | Değer yazıldığı haliyle kullanılır. |
| İfade | Değer akış çalıştığında hesaplanır ve sonucu kullanılır. |
Bilinmesi Gerekenler
- Parametreler yalnızca akışın varsayılan versiyonunda düzenlenebilir. Başka bir versiyonun parametrelerini değiştirmek için önce Versiyonlar panelinden o versiyonu varsayılan yapın.
- İş başka bir kullanıcı tarafından kilitlendiğinde parametreler değiştirilemez.
- Bir parametrenin adını değiştirmeden veya parametreyi silmeden önce ona başvuran alanları kontrol edin: artık var olmayan bir parametreye yapılan başvuru değiştirilmez.