Bagikan melalui


Fungsi ekspresi dalam pemetaan aliran data

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Aliran data tersedia di alur Azure Data Factory dan alur Azure Synapse Analytics. Artikel ini berlaku untuk memetakan aliran data. Jika Anda baru mengenal transformasi, lihat artikel pengantar Mengubah data menggunakan aliran data pemetaan.

Artikel ini menyediakan detail tentang fungsi ekspresi yang didukung oleh Azure Data Factory dan Azure Synapse Analytics dalam pemetaan aliran data.

Daftar fungsi ekspresi

Di alur Azure Data Factory dan Azure Synapse Analytics, gunakan bahasa ekspresi fitur aliran data pemetaan untuk mengonfigurasi transformasi data.

Fungsi ekspresi Tugas
abs Memberikan nilai absolut angka.
acos Menghitung nilai terbalik kosinus.
penambahan Menambahkan sepasang untai atau angka. Menambahkan tanggal ke jumlah hari. Menambahkan durasi ke stempel waktu. Menambahkan satu larik dengan jenis yang sama ke larik lainnya. Sama seperti operator +.
dan Menggunakan operator logis AND . Sama seperti &&.
asin Menghitung nilai sinus terbalik.
assertErrorMessages Mengembalikan pemetaan semua pesan penegasan.
atan Menghitung nilai tangen terbalik.
atan2 Menampilkan sudut dalam radian antara sumbu x positif dari bidang dan titik yang ditentukan oleh koordinat.
between Memeriksa apakah nilai pertama berada di antara dua nilai lainnya secara inklusif. Anda dapat membandingkan numerik, string, dan datetime nilai.
bitwiseAnd Menggunakan operator bitwise And di seluruh jenis integral. Sama seperti operator &.
bitwiseOr Menggunakan operator bitwise Or di seluruh jenis integral. Sama seperti operator |.
bitwiseXor Menggunakan operator bitwise Or di seluruh jenis integral. Sama seperti operator |.
blake2b Menghitung hash Blake2 dari sekumpulan kolom dengan berbagai jenis data primitif saat diberi panjang bit. Panjang bit hanya dapat kelipatan 8 antara 8 dan 512. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
blake2bBinary Menghitung ringkasan Blake2 dari sekumpulan kolom dengan berbagai tipe data primitif ketika diberi panjang bit, yang hanya dapat berupa kelipatan 8 antara 8 dan 512. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
case Menerapkan satu nilai atau nilai lainnya berdasarkan kondisi alternatif. Jika jumlah input merata, yang lain default ke NULL untuk kondisi terakhir.
cbrt Menghitung akar kubus dari angka.
Ceil Menampilkan bilangan bulat terkecil yang tidak lebih kecil dari angkanya.
gabungkan Menampilkan nilai non-null pertama dari sekumpulan input. Semua input harus memiliki jenis yang sama.
columnNames Mendapatkan nama semua kolom output untuk aliran. Anda dapat meneruskan nama aliran opsional sebagai argumen pertama dan argumen kedua opsional untuk mengembalikan hanya kolom penyimpangan skema.
columns Mendapatkan nilai dari semua kolom output untuk aliran. Anda dapat meneruskan nama aliran opsional sebagai argumen kedua.
compare Membandingkan dua nilai dengan jenis yang sama. Mengembalikan bilangan bulat negatif jika nilai1 < nilai2 atau 0 jika value1 == value2, dan mengembalikan nilai positif jika value1 > value2.
concat Menggabungkan jumlah variabel untai bersama-sama. Sama seperti operator + dengan string-string.
concatWS Menggabungkan jumlah variabel untai bersama-sama dengan pemisah. Parameter pertama adalah pemisah.
cos Menghitung nilai kosinus.
cosh Menghitung kosinus hiperbolik nilai.
crc32 Menghitung hash CRC32 dari sekumpulan kolom dengan berbagai jenis data primitif saat diberi panjang bit. Panjang bit harus berupa nilai 0 (256), 224, 256, 384, dan 512. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
degrees Mengonversi radian menjadi derajat.
divide Membagi dua angka. Sama seperti operator /.
dropLeft Menghapus karakter sebanyak yang ditentukan dari sebelah kiri string. Jika drop yang diminta melebihi panjang untai, untai kosong akan dikembalikan.
dropRight Menghapus karakter sebanyak yang ditentukan dari sebelah kanan string. Jika drop yang diminta melebihi panjang untai, untai kosong akan dikembalikan.
endsWith Memeriksa apakah untai berakhiran untai yang disediakan.
setara Menggunakan operator pembanding kesetaraan. Sama seperti operator ==.
equalsIgnoreCase Menggunakan operator perbandingan sama dengan dan mengabaikan kasus. Sama seperti operator <=>.
melarikan diri Melewati untai sesuai dengan format. Nilai harfiah untuk format yang dapat diterima adalah json, , xml, ecmascripthtml, dan java.
expr Menghasilkan ekspresi dari string. Setara dengan menulis ekspresi dalam bentuk nonliteral. Anda dapat menggunakannya untuk meneruskan parameter sebagai representasi string.
factorial Menghitung faktorial angka.
salah Selalu menampilkan nilai false. Gunakan fungsi syntax(false()) jika ada kolom bernama false.
lantai Menampilkan bilangan bulat terbesar yang tidak lebih besar dari angka.
fromBase64 Mendekode string yang dikodekan base64 tertentu.
lebih besar Menggunakan perbandingan yang lebih besar dari operator. Sama seperti operator >.
greaterOrEqual Menggunakan perbandingan yang lebih besar dari atau sama dengan operator. Sama seperti operator >=.
greatest Menampilkan nilai terbesar di antara daftar nilai sebagai input yang melewati nilai null. Menampilkan null jika semua input null.
hasColumn Memeriksa nilai kolom menurut nama di aliran. Anda dapat meneruskan nama aliran opsional sebagai argumen kedua. Nama kolom yang diketahui pada waktu desain harus ditangani dengan menggunakan namanya saja. Input komputasi tidak didukung, tetapi Anda dapat menggunakan substitusi parameter.
hasError Memeriksa apakah pernyataan dengan ID yang disediakan ditandai sebagai kesalahan.
iif Menerapkan satu nilai atau nilai lainnya berdasarkan kondisi. Jika yang lain tidak ditentukan, nilainya dianggap NULL. Kedua nilai harus kompatibel (misalnya, numerik atau string).
iifNull Mengembalikan item pertama bukan null saat diberikan dua input atau lebih. Fungsi ini setara dengan coalesce.
initCap Mengonversi huruf pertama setiap kata menjadi huruf besar. Kata-kata diidentifikasi sebagai dipisahkan oleh spasi putih.
instr Menemukan posisi sub-string dalam string, dengan posisi dimulai dari 1. Jika tidak ditemukan, 0 dikembalikan.
isDelete Memeriksa apakah baris ditandai untuk dihapus. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2, dan nilai defaultnya adalah 1.
isError Memeriksa apakah baris ditandai sebagai kesalahan. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
isIgnore Memeriksa apakah baris harus diabaikan. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
isInsert Memeriksa apakah baris ditandai untuk disisipkan. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
isMatch Memeriksa apakah baris cocok di pencarian. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
isNull Memeriksa apakah nilainya adalah NULL.
isUpdate Memeriksa apakah baris ditandai untuk diperbarui. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
isUpsert Memeriksa apakah baris ditandai untuk disisipkan. Untuk transformasi yang mengambil lebih dari satu aliran input, Anda dapat meneruskan indeks aliran (berbasis 1). Indeks aliran harus berupa 1 atau 2. Nilai defaultnya adalah 1.
jaroWinkler Mendapatkan jarak JaroWinkler antara dua untai.
least Menggunakan perbandingan yang lebih kecil dari atau sama dengan operator. Sama seperti operator <=.
left Mengekstrak substring yang dimulai dari indeks 1 dengan jumlah karakter tertentu. Sama seperti SUBSTRING(str, 1, n).
length Menampilkan panjang untai.
lesser Menggunakan operator perbandingan lebih sedikit. Sama seperti operator <.
lesserOrEqual Menggunakan perbandingan yang lebih kecil dari atau sama dengan operator. Sama seperti operator <=.
levenshtein Mendapatkan jarak levenshtein antara dua untai.
like Menggunakan pola dengan string yang sesuai secara harfiah. Pengecualian adalah simbol khusus _ yang cocok dengan satu karakter pada masukan (mirip dengan .* dalam posix ekspresi reguler).
locate Menemukan posisi (berbasis 1) dari substring dalam string yang dimulai dari posisi tertentu. Jika posisi dihilangkan, mulailah dari awal teks. Jika tidak ditemukan, 0 dikembalikan.
log Menghitung nilai log. Anda dapat menyediakan basis opsional atau nomor Euler jika digunakan.
log10 Menghitung nilai log berdasarkan basis 10.
lower Memberi huruf kecil pada untai.
lpad String akan ditambah padding ke kiri dengan padding yang diberikan hingga mencapai panjang tertentu. Jika string sama dengan atau lebih besar dari panjang tertentu, string dipangkas agar sesuai dengan panjang tersebut.
ltrim Memangkas kiri untai karakter awal. Jika parameter kedua tidak ditentukan, parameter tersebut akan memangkas spasi kosong. Jika tidak, ia memangkas karakter apa pun yang ditentukan dalam parameter kedua.
md5 Menghitung hash MD5 dari sekumpulan kolom dari berbagai jenis data primitif dan mengembalikan string heksa 32 karakter. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
minus Mengurangi angka. Mengurangi jumlah hari dari tanggal. Mengurangi durasi dari stempel waktu. Mengurangi dua stempel waktu untuk mendapatkan perbedaan dalam milidetik. Sama seperti operator -.
mod Memberikan modulus sepasang angka. Sama seperti operator %.
multiply Mengalikan sepasang angka. Sama seperti operator *.
negate Meniadakan angka. Mengubah angka positif menjadi negatif dan sebaliknya.
nextSequence Menampilkan urutan unik berikutnya. Nomor hanya berturut-turut di dalam partisi dan diawali dengan ID partisi.
normalize Menormalkan nilai string untuk memisahkan karakter Unicode beraksen.
Tidak Menggunakan operator negasi logis.
notEquals Menggunakan perbandingan yang tidak sama dengan operator. Sama seperti operator !=.
nihil Mengembalikan nilai NULL. Gunakan fungsi syntax(null()) jika ada kolom bernama null. Setiap operasi yang menggunakannya menghasilkan NULL.
atau Menggunakan operator logis OR . Sama seperti ||.
pMod Menghasilkan modulus positif dari dua bilangan.
PartitionId Mengembalikan ID partisi saat ini tempat baris input berada.
power Menaikkan satu angka ke kekuatan angka lainnya.
radians Mengonversi derajat menjadi radian.
random Mengembalikan angka acak ketika diberi seed opsional dalam partisi. The seed harus berupa nilai tetap dan digunakan dengan ID partisi untuk menghasilkan nilai acak.
regexExtract Mengekstrak substring yang cocok untuk pola regex tertentu. Parameter terakhir mengidentifikasi grup kecocokan dan default ke 1 jika dihilangkan. Gunakan `<regex>` untuk mencocokkan string tanpa melarikan diri.
regexMatch Memeriksa apakah string cocok dengan pola regex tertentu. Gunakan `<regex>` untuk mencocokkan string tanpa melarikan diri.
regexReplace Mengganti semua kemunculan pola regex dengan substring lain dalam string tertentu. Gunakan `<regex>` untuk mencocokkan string tanpa melarikan diri.
regexSplit Memisahkan untai berdasarkan pemisah berdasarkan regex dan menampilkan larik untai.
mengganti Mengganti semua kemunculan substring dengan substring lain dalam string tertentu. Jika parameter terakhir dihilangkan, parameter tersebut default ke string kosong.
reverse Membalikkan untai.
right Mengekstrak substring yang terdiri dari sejumlah karakter dari bagian kanan. Sama seperti SUBSTRING(str, LENGTH(str) - n, n).
rlike Memeriksa apakah string cocok dengan pola regex tertentu.
round Membulatkan angka saat diberikan skala opsional dan mode pembulatan opsional. Jika skala dihilangkan, skala akan default ke 0. Jika mode dihilangkan, maka akan default ke ROUND_HALF_UP(5).
rpad String dipasangkan dengan padding di bagian kanan hingga mencapai panjang yang ditentukan. Jika string sama dengan atau lebih besar dari panjang tertentu, string dipangkas agar sesuai dengan panjang tersebut.
rtrim Pangkas kanan untai karakter terakhir. Jika parameter kedua tidak ditentukan, parameter tersebut akan memangkas spasi kosong. Jika tidak, ia memangkas karakter apa pun yang ditentukan dalam parameter kedua.
sha1 Menghitung hash SHA-1 dari sekumpulan kolom dengan berbagai jenis data primitif dan mengembalikan string heksa 40 karakter. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
sha2 Menghitung hash SHA-2 dari sekumpulan kolom dengan berbagai jenis data primitif saat diberi panjang bit, yang hanya dapat berupa nilai 0 (256), 224, , 256, 384dan 512. Anda dapat menggunakannya untuk menghitung sidik jari sebuah baris.
sin Menghitung nilai sinus.
sinh Menghitung nilai sinus hiperbolik.
soundex Mendapatkan kode soundex untuk untai.
belah Memisahkan untai berdasarkan pemisah dan menampilkan larik untai.
sqrt Menghitung akar kuadrat angka.
startsWith Memeriksa apakah untai dimulai dengan untai yang disediakan.
substring Mengekstrak substring dengan panjang tertentu dari posisi. Posisi berbasis 1. Jika panjangnya dihilangkan, maka secara default akan menggunakan akhir string.
substringIndex Mengekstrak substring sebelum kejadian pemisah count. Jika count positif, semua yang ada di sebelah kiri pembatas akhir (dihitung dari kiri) dikembalikan. Jika count negatif, semua yang ada di sebelah kanan pembatas akhir (dihitung dari kanan) dikembalikan.
tan Menghitung nilai tangen.
tanh Menghitung nilai tangen hiperbolik.
translate Mengganti satu set karakter dengan sekumpulan karakter lain dalam string. Karakter memiliki penggantian satu-ke-satu.
trim Memangkas untai karakter depan dan belakang. Jika parameter kedua tidak ditentukan, parameter tersebut akan memangkas spasi kosong. Jika tidak, ia memangkas karakter apa pun yang ditentukan dalam parameter kedua.
benar Selalu menampilkan nilai true. Gunakan fungsi syntax(true()) jika kolom bernama true.
typeMatch Cocok dengan jenis kolom. Digunakan hanya dalam ekspresi pola. Angka cocok dengan pendek, bilangan bulat, panjang, ganda, mengambang, atau desimal. Integral mencocokkan tipe data short, int, dan long. Pencocokan fraksional untuk tipe data double, float, dan decimal. Tanggal dan waktu sesuai dengan jenis cap waktu.
unescape Tidak mengabaikan untai sesuai dengan format. Nilai harfiah untuk format yang dapat diterima adalah json, , xml, ecmascripthtml, dan java.
upper Membuat huruf besar pada untai.
uuid Menampilkan UUID yang dihasilkan.
xor Menampilkan operator logis XOR. Sama seperti operator ^.