Konfigurasikan parameter penjadwalan untuk berbagai jenis node - DataWorks

Anda dapat merujuk pada metode konfigurasi parameter penjadwalan untuk node SQL, seperti node MaxCompute SQL, sebagai panduan untuk menetapkan variabel kustom dan mengaitkan parameter penjadwalan ke variabel tersebut pada jenis node lainnya—kecuali node Shell umum dan node PyODPS. Konfigurasi untuk node Shell umum dan node PyODPS memiliki pendekatan yang berbeda. Topik ini memberikan contoh cara mengonfigurasi parameter penjadwalan untuk berbagai jenis node.

Node SQL dan node sinkronisasi batch

Parameter penjadwalan untuk node SQL dan node sinkronisasi batch dikonfigurasi menggunakan metode yang berlaku umum bagi sebagian besar jenis node. Contoh berikut menggunakan node MaxCompute SQL untuk menjelaskan cara menetapkan parameter kustom ke variabel kustom serta mereferensikannya dalam kode.

Catatan

Beberapa jenis node tertentu tidak mendukung parameter penjadwalan. Untuk informasi selengkapnya mengenai dukungan parameter penjadwalan pada suatu jenis node, lihat dokumentasi jenis node tersebut.

-- Dapatkan waktu data.
SELECT '${var1}' '${var2}';
-- Dapatkan waktu penjadwalan.
SELECT '${var3}' '${var4}';
-- Dapatkan konstanta.
SELECT '${var5}';

Tetapkan nilai parameter di area penetapan parameter. Anda kemudian dapat mereferensikan variabel sistem bawaan var1 dan var3, parameter kustom var2 dan var4, serta konstanta var5 dalam kode. Contoh penetapan nilainya adalah sebagai berikut:

var1: Tetapkan $bizdate sebagai var1. Variabel ini digunakan untuk mendapatkan waktu data. $bizdate adalah parameter sistem bawaan.
var3: Tetapkan $cyctime sebagai var3. Variabel ini digunakan untuk mendapatkan waktu penjadwalan. $cyctime adalah parameter sistem bawaan.
var2: Tetapkan ${yyyymmdd} sebagai var2. Variabel ini digunakan untuk mendapatkan waktu data.
var4: Tetapkan $[yyyymmddhh24:mi:ss] sebagai var4. Variabel ini digunakan untuk mendapatkan waktu penjadwalan.
var5: Tetapkan konstanta abc ke variabel ini.

Untuk informasi selengkapnya tentang cara mengonfigurasi dan menggunakan parameter penjadwalan, lihat bagian Konfigurasikan properti penjadwalan untuk sebuah node dalam topik "Properti penjadwalan". Untuk informasi lebih lanjut tentang cara menetapkan parameter kustom ke variabel kustom, lihat Format parameter penjadwalan yang didukung.

Node PyODPS

Untuk menghindari perubahan kode, node PyODPS tidak memungkinkan penggantian variabel yang telah didefinisikan dengan string dalam format ${param_name} dalam kode. Namun, Anda dapat menambahkan objek kamus bernama args ke variabel global sebelum kode dijalankan. Dengan demikian, node PyODPS dapat memperoleh nilai parameter penjadwalan dari objek kamus tersebut.

# Parameter kustom: var1 mendapatkan parameter bawaan
a =args['var1']
print (format(a))
# Parameter kustom: var2 mendapatkan nilai dalam format ${...}
b =args['var2']
print (format(b))
# Parameter kustom: var3 mendapatkan nilai dalam format $[...]
c =args['var3']
print (format(c))

Tetapkan nilai di area penetapan parameter. Anda kemudian dapat mereferensikan parameter bawaan var1 serta parameter kustom var2 dan var3 dalam kode. Setelah objek kamus ditambahkan, parameter direferensikan sebagai args['var1'], args['var2'], dan args['var3']. Contoh penetapan nilainya adalah sebagai berikut:

var1: Tetapkan $bizdate sebagai var1. Variabel ini digunakan untuk mendapatkan waktu data. $bizdate adalah parameter sistem bawaan.
var2: Tetapkan ${yyyymmdd} sebagai var2. Variabel ini digunakan untuk mendapatkan waktu data.
var3: Tetapkan $[yyyymmdd] sebagai var3. Variabel ini digunakan untuk mendapatkan waktu data.

Contoh Konfigurasi Node Shell

Anda tidak diperbolehkan menentukan nama variabel kustom untuk node Shell umum. Variabel harus diberi nama berdasarkan nomor urutnya, seperti $1, $2, dan $3. Jika jumlah parameter mencapai atau melebihi 10, gunakan ${Nomor} untuk mendeklarasikan variabel tambahan tersebut. Misalnya, gunakan ${10} untuk mendeklarasikan variabel kesepuluh.

# Parameter kustom: Dapatkan parameter bawaan
echo $1
# Parameter kustom: ${...}
echo $2
# Parameter kustom: $[...]
echo $3

Tetapkan nilai di area penetapan parameter. Anda kemudian dapat mereferensikan parameter $1, $2, dan $3 dalam kode. Contoh penetapan nilainya adalah sebagai berikut:

Catatan

Untuk node Shell umum, Anda hanya dapat menetapkan parameter kustom ke variabel kustom menggunakan ekspresi. Pisahkan beberapa parameter kustom dengan spasi, dan pastikan penugasannya mengikuti urutan yang sama dengan definisi variabel kustom tersebut. Sebagai contoh, parameter pertama $bizdate yang dimasukkan di bagian Parameter Penjadwalan akan ditetapkan ke variabel pertama $1.

$1: Tetapkan $bizdate sebagai $1. Variabel ini digunakan untuk mendapatkan waktu data. $bizdate adalah parameter sistem bawaan.
$2: Tetapkan ${yyyymmdd} sebagai $2. Variabel ini digunakan untuk mendapatkan waktu data.
$3: Tetapkan $[yyyymmdd] sebagai $3. Variabel ini digunakan untuk mendapatkan waktu penjadwalan.