Fungsi konversi tipe - Simple Log Service

Anda dapat menggunakan fungsi konversi tipe dalam pernyataan kueri untuk mengonversi data ke tipe yang diperlukan.

Tabel berikut menjelaskan fungsi konversi tipe yang didukung oleh Simple Log Service.

Penting

Jika Anda ingin menggunakan string dalam pernyataan analitik, Anda harus mengapit string tersebut dengan tanda kutip tunggal (''). String yang tidak diapit atau string yang diapit dengan tanda kutip ganda ("") menunjukkan nama bidang atau nama kolom. Sebagai contoh, 'status' menunjukkan string status, sedangkan status atau "status" menunjukkan bidang log status.

Fungsi	Sintaksis	Deskripsi	Didukung di SQL	Didukung di SPL
fungsi cast	cast(x as tipe)	Mengonversi nilai dari bidang x ke tipe data tertentu. Jika fungsi cast gagal mengonversi nilai, pernyataan kueri yang menggunakan fungsi ini akan gagal.	√	√
fungsi try_cast	try_cast(x as tipe)	Mengonversi nilai dari bidang x ke tipe data tertentu. Jika fungsi try_cast gagal mengonversi nilai, fungsi ini mengembalikan NULL. Pernyataan kueri yang menggunakan fungsi ini melewati nilai tersebut dan melanjutkan eksekusi. Catatan Log mungkin berisi data kotor. Saat Anda mengkueri log, kami sarankan Anda menggunakan fungsi try_cast. Dengan cara ini, kegagalan konversi tidak akan menyebabkan pernyataan kueri Anda gagal.	√	×
fungsi typeof	typeof(x)	Mengembalikan tipe data dari bidang x.	√	×

fungsi cast

Fungsi cast mengonversi nilai dari bidang x ke tipe data tertentu. Jika fungsi cast gagal mengonversi nilai, pernyataan kueri yang menggunakan fungsi ini akan gagal.

Sintaksis

cast(x as type)

Parameter

Parameter

Deskripsi

Nilai parameter ini adalah tipe data arbitrer.

tipe

Nilai parameter ini adalah tipe data SQL. Nilai valid: bigint, varchar, double, boolean, timestamp, decimal, array, dan map.

Contoh: cast(json_parse(key) as array(varchar)).

Setiap tipe data SQL dipetakan ke tipe data yang dapat digunakan dalam indeks Simple Log Service. Untuk informasi lebih lanjut, lihat Lampiran: Pemetaan tipe data.

Tipe Nilai Pengembalian

Tipe data yang ditentukan oleh parameter tipe.

Contoh

SQL

Konversikan angka 1 ke tipe Boolean.

Pernyataan Kueri
```
* | select cast(1 as boolean)
```
Hasil Kueri dan Analisis

SPL

Konversikan angka 1 ke tipe Boolean.

Pernyataan Kueri

* | extend a = cast(1 as boolean)

Hasil Kueri dan Analisis

fungsi try_cast

Fungsi try_cast mengonversi nilai dari bidang x ke tipe data tertentu. Jika fungsi try_cast gagal mengonversi nilai, fungsi ini mengembalikan NULL. Pernyataan kueri yang menggunakan fungsi ini melewati nilai tersebut dan melanjutkan eksekusi.

Sintaksis

try_cast(x as type)

Parameter

Parameter

Deskripsi

Nilai parameter ini adalah tipe data arbitrer.

tipe

Nilai parameter ini adalah tipe data SQL. Nilai valid: bigint, varchar, double, boolean, timestamp, decimal, array, dan map.

Contoh: try_cast(json_parse(key) as map(varchar, varchar)).

Setiap tipe data SQL dipetakan ke tipe data yang dapat digunakan dalam indeks Simple Log Service. Untuk informasi lebih lanjut, lihat Lampiran: Pemetaan tipe data.

Tipe Nilai Pengembalian

Tipe data yang ditentukan oleh parameter tipe.

Contoh

Konversikan nilai dari bidang uid ke tipe varchar.

Pernyataan Kueri
```
* | select try_cast(uid as varchar)
```
Hasil Kueri dan Analisis

fungsi typeof

Fungsi typeof mengembalikan tipe data dari bidang x.

Sintaksis

typeof(x)

Parameter

Parameter	Deskripsi
x	Nilai parameter ini adalah tipe data arbitrer.

Tipe Nilai Pengembalian

Tipe varchar.

Contoh

Peroleh tipe data dari bidang request_time.

Pernyataan Kueri
```
* |SELECT typeof(request_time)
```
Hasil Kueri dan Analisis

Lampiran: Pemetaan tipe data

Tabel berikut menjelaskan pemetaan antara tipe data SQL dan tipe data yang didukung oleh indeks Simple Log Service.

Tipe data yang didukung oleh indeks Simple Log Service	Tipe data SQL
long	bigint
text	varchar
double	double
json	varchar