Değişkenler - Data Management - Alibaba Cloud Dokümantasyon Merkezi

Değişkenlere genel bakış

Değişkenler, bir görev akışındaki dinamik değerlerdir ve sistem değişkenleri, zaman değişkenleri ile zamansız değişkenler olarak sınıflandırılır. Bir düğüm içinde herhangi bir değişkene ${varName} sözdizimini kullanarak başvurabilirsiniz.

Sistem değişkenleri

Sistem değişkenleri, geçerli görev akışı kimliği ve görev akışının çalışma zamanı gibi önceden tanımlanmış değerlerdir.

Not

Özel bir değişken bir sistem değişkeniyle aynı ada sahipse, özel değişkenin değeri sistem değişkeninin değerini geçersiz kılar; bu da özel değişkene daha yüksek öncelik tanır.

Zaman değişkenleri

Görev akışı değişkeni (global değişken): Görev akışı değişkeni, veri zaman damgasına bir zaman ofseti uygulanarak hesaplanır. Varsayılan olarak veri zaman damgası, çalışma zamanından bir gün öncesidir. Global bir değişken olarak, geçerli görev akışındaki tüm düğümlerde kullanılabilir.

Not
Bir görev akışındaki herhangi bir düğümde görev akışı değişkeni yapılandırabilirsiniz. Yapılandırma otomatik olarak diğer tüm düğümlere senkronize edilir.
Düğüm değişkeni: Yerleşik bizdate (T-1) değişkenine bir zaman ofseti uygulanarak oluşturulan bir zaman değişkenidir. Bir düğüm değişkeni, tanımlandığı düğümle sınırlıdır.

Örneğin, geçerli tarih 22 Ağustos 2023 ise ve +1 günlük bir zaman ofseti uygularsanız, değişkenin değeri 23 Ağustos 2023 olur.

Zamansız değişkenler

Görev akışı sabiti (global değişken): Görev akışı sabiti, geçerli görev akışındaki tüm düğümlerde kullanılabilecek sabit bir değerdir.
Giriş değişkeni: Sistem giriş değişkenlerini otomatik olarak doldurur. Geçerli düğümün SQL deyimlerinde ${var_name} sözdizimini kullanarak veya Koşullu Dal düğümünde koşullu bir değişken olarak bir giriş değişkenine başvurabilirsiniz. Giriş değişkenleri şunları içerir:
- Yukarı akış değişkeni: Yukarı akış düğümünden gelen bir çıkış değişkeni.
- Durum değişkeni: Daha fazla bilgi için bkz. Durum değişkenleri.
- Sistem değişkeni: Daha fazla bilgi için bkz. Sistem değişkenleri.
Çıkış değişkeni: Geçerli düğümde bir çıkış değişkeni tanımlayıp buna bir değer atarsınız. Aşağı akış düğümleri daha sonra buna erişip başvurabilir.

Örneğin, bir Betik düğümünde bir çıkış değişkeni yapılandırırsanız, bu değişkene aşağı akış düğümünün SQL deyimlerinde başvurulabilir.
Tek Örnekli SQL düğümünden çıkış değişkeni: Bir SQL sorgusundan elde edilen sonuç kümesini tanımlamak için Tek Örnekli SQL düğümü kullanabilirsiniz. Bu sonuç kümesi iki boyutlu bir matris oluşturur. Değişken tanımı sırasında tek bir öğeyi çıkarabilir veya bir satır ya da sütundaki tüm değerleri birleştirebilirsiniz.
Betik çıkış değişkeni: Bir betiğin çıktısının son satırı { key1: value1, key2: value2, … } biçiminde bir JSON nesnesiyse ve değerler String türündeyse, betik görevi JSON anahtar-değer çiftlerini otomatik olarak ayrıştırır. Bu işlem anahtar adlı bir değişken oluşturur ve anahtar değişkeninin değeri ilgili değere ayarlanır. Değişkene ${key} şeklinde başvurabilirsiniz.

Örneğin, betiğin son satırı echo {"hello": "world"} ise, betik görevi hello adlı bir değişken oluşturur ve hello değişkeninin değeri world olur.

Zaman değişkenlerini yapılandırma

Parametre

Açıklama

Variable name

Özel değişkenin adını girin.

Not

Yapılandırılmış bir değişkeni silmek için 删除-变量 simgesini tıklayın.

Variable rule

Zaman değişkeni için kuralları yapılandırın.

Zaman biçimi: İstenen zaman biçimini belirtin. Daha fazla bilgi için bkz. Zaman biçimleri.
Zaman ofseti: Bir zaman değişkeni, varsayılan olarak görev akışının çalışma zamanından bir gün önce olan veri zaman damgasına (bizdate) bir ofset uygulanarak hesaplanır.

Örneğin, 6_month_ago adlı bir değişkeni yyyy-MM-dd zaman biçimiyle ve -6 aylık bir ofsetle düşünün. Çalışma zamanı 2021-08-12 ise (bizdate 2021-08-11 olur), ${6_month_ago} değişkeninin değeri 2021-02-11 olur.

Ofset birimi olarak ay veya yıl kullanmak süreksiz tarih dizilerine neden olabilir. Sürekli bir günlük dizi için ofset birimi olarak gün kullanın.

Not

Bir zaman değişkeni yapılandırdıktan sonra, SQL deyimlerinde ${var_name} sözdizimini kullanarak buna başvurabilirsiniz. Zaman değişkeninin değerini kontrol etmek için SQL Preview seçeneğini de tıklayabilirsiniz.

Zaman biçimleri

Aşağıdaki tabloda desteklenen zaman biçimi belirteçleri açıklanmaktadır.

Belirteç	Açıklama	Örnek giriş	Örnek çıkış
Era	`G` era'yı belirtir.	Gyyyy	AD 2021
Yıl	`y` veya `yyyy`: Yıl. `yy`: Yılın son iki basamağı. `Y`: Hafta numaralı yıl, yani haftanın sonunda (Pazar) yer alan yıldır.	yyyy	2021
Ay	`M`: Yılın ayı. Geçerli değerler: [1,12]. `MM`: Sıfır dolgulu. Geçerli değerler: [01,12].	MM	08
Hafta	`w`: Yılın haftası. Geçerli değerler: [1, 52]. `ww`: Sıfır dolgulu. Geçerli değerler: [01, 52]. `W`: Ayın haftası. Geçerli değerler: [1, 5].	ww	13
Gün	`D`: Yılın günü. Geçerli değerler: [1, 365]. `DD`: Sıfır dolgulu. Geçerli değerler: [01, 365]. `DDD`: İki baştaki sıfır ile dolgulu. Geçerli değerler: [001, 365]. `d`: Ayın günü. Geçerli değerler: [1, 31]. `dd`: Sıfır dolgulu. Geçerli değerler: [01, 31].	D	360
Haftanın günü	`E`: Pazartesiden Pazara kadar haftanın gününün adı. `e`: Haftanın gününün numarası. Geçerli değerler: [1, 7]. Varsayılan olarak 1, Pazartesi'yi temsil eder. Not 1'in Pazar'ı temsil ettiği takvimlerle uyumlu olması için zaman ofsetini +1 gün olarak ayarlayabilirsiniz.	e	1
AM/PM	`a`: AM/PM göstergesi. 00:00 ile 11:59 arasındaki saatler için AM, 12:00 ile 23:59 arasındaki saatler için PM döndürür.	a	AM
Saat	`H`: Günün saati (0-23). `0` gece yarısını temsil eder. Geçerli değerler: [0, 23]. `HH`: Sıfır dolgulu. Geçerli değerler: [00, 23]. `h`: AM/PM formatındaki saat (1-12). `1` ilk saati temsil eder. Geçerli değerler: [1, 12]. `hh`: Sıfır dolgulu. Geçerli değerler: [01, 12]. `K`: AM/PM formatındaki saat (0-11). `0` ilk saati temsil eder. Geçerli değerler: [0, 11]. `KK`: Sıfır dolgulu. Geçerli değerler: [00, 11]. `k`: Günün saati (1-24). `1` ilk saati temsil eder. Geçerli değerler: [1, 24]. `kk`: Sıfır dolgulu. Geçerli değerler: [01, 24].	HH	10
Dakika	`m`: Saatin dakikası. Geçerli değerler: [0, 59]. `mm`: Sıfır dolgulu. Geçerli değerler: [00, 59].	m	27
Saniye	`s`: Dakikanın saniyesi. `S`: Milisaniye.	ss	08
Saat dilimi	`z`: Saat dilimi.	z	UTC+08:00

Birleştirilmiş zaman biçimi örnekleri:

Örnek giriş	Örnek çıkış
`yyyy-MM-dd`	2021-08-12
`yyyyMM01`	20210801
`HH:mm:ss`	11:05:21
`yyyyMMdd HH:mm:ss`	20210812 11:05:21

Sistem değişkenleri

Değişken adı	Açıklama	Örnek
sys.flow.start.timestamp	Çalışma zamanının zaman damgası.	2021-05-24T11:20:07.562+08:00
sys.flow.start.year	Çalışma zamanının yılı.	2021
sys.flow.start.month	Çalışma zamanının ayı.	5
sys.flow.start.day	Çalışma zamanının günü.	24
sys.flow.start.hour	Çalışma zamanının saati.	11
sys.flow.start.minute	Çalışma zamanının dakikası.	20
sys.flow.start.second	Çalışma zamanının saniyesi.	7
sys.flow.start.milliseconds	Çalışma zamanının milisaniyeleri.	562
sys.flow.start.timezone	Çalışma zamanının saat dilimi.	Asia/Shanghai
sys.flow.biztime	Veri zaman damgası. Varsayılan olarak bu, çalışma zamanından bir gün öncesidir.	1621740007562
sys.flow.name	Görev akışı adı.	dwd_activity_daily_pv
sys.node.name	Düğüm adı.	Single Instance SQL-1

Durum değişkenleri

Değişken adı	Açıklama
all_success	Tüm yukarı akış görevleri başarıyla çalıştı.
all_failed	Tüm yukarı akış görevleri başarısız oldu.
one_success	En az bir yukarı akış görevi başarıyla çalıştı.
one_failed	En az bir yukarı akış görevi başarısız oldu.

Not

Koşullu Dal düğümünde durum değişkenlerini kullanarak, belirli bir çalışma durumuna göre görev akışının sonraki görevleri çalıştırıp çalıştırmayacağını kontrol edebilirsiniz.