Perhitungan SQL untuk data terstruktur - Simple Log Service

Topik ini menjelaskan cara menggunakan instruksi perhitungan SQL untuk data terstruktur dalam Structured Process Language (SPL) serta menyediakan contoh penggunaannya.

extend

Membuat field baru dengan mengevaluasi ekspresi SQL. Untuk daftar fungsi SQL yang didukung, lihat Fungsi SQL yang didukung oleh SPL.

Sintaks

| extend <output>=<sql-expr>, ...

Deskripsi parameter

Parameter	Tipe	Wajib	Deskripsi
output	Field	Ya	Nama field tujuan yang akan ditambahkan. Anda tidak dapat mengeluarkan hasil dari beberapa ekspresi ke field tujuan yang sama. Penting Jika field tujuan memiliki nama yang sama dengan field dalam data masukan, field asli akan ditimpa dengan tipe dan nilai baru.
sql-expr	SQLExpr	Ya	Ekspresi pemrosesan data. Penting Untuk informasi tentang penanganan nilai null, lihat Penanganan nilai null dalam ekspresi SPL.

Contoh

Contoh 1: Gunakan ekspresi perhitungan.

* | extend Duration = EndTime - StartTime

Contoh 2: Gunakan ekspresi reguler.

* | extend server_protocol_version=regexp_extract(server_protocol, '\d+')

Contoh 3: Ekstrak konten dari jalur JSON dan ubah tipe data suatu field.

Pernyataan SPL

*
| extend a=json_extract(content, '$.body.a'), b=json_extract(content, '$.body.b')
| extend b=cast(b as BIGINT)

Data masukan
```
content: '{"body": {"a": 1, "b": 2}}'
```

Hasil output

content: '{"body": {"a": 1, "b": 2}}'
a: '1'
b: 2

where

Menyaring entri data berdasarkan ekspresi boolean SQL. Hanya entri yang dievaluasi sebagai true yang dipertahankan. Untuk daftar fungsi SQL yang didukung oleh instruksi where, lihat Fungsi SQL yang didukung oleh SPL.

Sintaks

| where <sql-expr>

Deskripsi parameter

Parameter	Tipe	Wajib	Deskripsi
sql-expr	SQLExp	Ya	Ekspresi SQL. Entri data yang memenuhi ekspresi ini dipertahankan. Penting Untuk informasi tentang penanganan nilai null dalam ekspresi SQL, lihat Penanganan nilai null dalam ekspresi SPL.

Contoh

Contoh 1: Saring entri data berdasarkan konten field.
```
* | where userId='123'
```
Contoh 2: Gunakan ekspresi reguler untuk menyaring entri data.
```
* | where regexp_like(server_protocol, '\d+')
```
Contoh 3: Ubah tipe data lalu saring semua error sisi server.
```
* | where cast(status as BIGINT) >= 500
```

Fungsi SQL yang didukung oleh SPL

Kategori	Deskripsi	Fungsi umum
Fungsi agregasi	Menghitung satu nilai statistik dari sekumpulan data.	Fungsi avg Fungsi count Fungsi max Fungsi min Fungsi sum
Fungsi string	Memproses data teks, termasuk operasi seperti pencarian, penggantian, ekstraksi substring, penggabungan, dan pemformatan.	Fungsi concat Fungsi length Fungsi position Fungsi replace Fungsi split
Fungsi tanggal dan waktu	Menjalankan operasi pada tanggal dan waktu dalam log, seperti konversi format, pengelompokan, dan agregasi.	Fungsi current_date Fungsi date Fungsi day Fungsi date_trunc Fungsi time_series
Fungsi JSON	Mengekstrak data dari, mengonversi, atau menghitung statistik pada objek JSON.	Fungsi json_array_contains Fungsi json_array_get Fungsi json_array_length Fungsi json_extract Fungsi json_extract_scalar
Fungsi ekspresi reguler	Menjalankan pencocokan pola dan pemrosesan teks.	Fungsi regexp_extract_all Fungsi regexp_extract Fungsi regexp_extract_bool Fungsi regexp_replace Fungsi regexp_split
Fungsi year-over-year dan period-over-period	Menghitung perubahan relatif dalam data deret waktu.	Fungsi compare Fungsi ts_compare
Fungsi dan operator array	Menjalankan operasi pada array, termasuk pembuatan, manipulasi, traversal, dan transformasi.	Operator subscript Fungsi array_distinct Fungsi array_intersect Fungsi array_join Fungsi reverse
Fungsi dan operator map	Bekerja dengan pasangan kunci-nilai.	Fungsi cardinality Fungsi element_at Fungsi histogram Fungsi histogram_u Fungsi map
Fungsi matematika	Menjalankan perhitungan numerik, pembulatan, pembangkitan bilangan acak, dan perhitungan trigonometri.	Fungsi abs Fungsi ceil Fungsi log Fungsi mod Fungsi random
Fungsi statistik	Menjalankan analisis distribusi data dan perhitungan numerik.	Fungsi corr Fungsi covar_pop Fungsi regr_intercept Fungsi beta_cdf Fungsi inverse_chi_squared_cdf
Fungsi konversi tipe	Mengonversi antar tipe data.	Fungsi cast Fungsi try_cast Fungsi typeof
Fungsi window	Mengagregasi atau mengurutkan data dalam sebuah window.	Fungsi agregasi Fungsi dense_rank Fungsi lag
Fungsi IP	Mengurai dan menghitung alamat IP.	Fungsi ip_to_city Fungsi ip_prefix Fungsi ipv6_to_city
Fungsi URL	Mengurai struktur URL.	Fungsi url_encode Fungsi url_decode Fungsi url_extract_fragment Fungsi url_extract_path Fungsi url_extract_query
Fungsi aproksimasi	Menjalankan perhitungan agregat perkiraan pada dataset besar, menyeimbangkan akurasi dengan konsumsi resource.	Fungsi approx_distinct Fungsi approx_percentile Fungsi numeric_histogram Fungsi numeric_histogram_u
Fungsi biner	Beroperasi pada data biner.	Fungsi from_base64 Fungsi from_big_endian_64 Fungsi from_hex Fungsi to_hex Fungsi sha256
Fungsi bitwise	Memanipulasi bit biner secara langsung.	Fungsi bit_count Fungsi bitwise_and Fungsi bitwise_not Fungsi bitwise_or Fungsi bitwise_xor
Fungsi spasial	Beroperasi pada data geometri spasial.	Fungsi ST_AsText Fungsi ST_GeometryFromText Fungsi ST_Boundary Fungsi ST_Buffer Fungsi ST_Contains
Fungsi geografis	Menjalankan analisis lokasi geografis dan perhitungan peta.	Fungsi geohash
Fungsi warna	Merepresentasikan dan mengonversi warna.	Fungsi bar fungsi warna Fungsi render Fungsi rgb
Fungsi HyperLogLog	Menjalankan pemrosesan statistik pada dataset besar, menukar presisi demi efisiensi memori.	Fungsi approx_set Fungsi cardinality Fungsi empty_approx_set Fungsi merge
Operator perbandingan	Membandingkan nilai. Operator ini berlaku untuk semua tipe data yang dapat dibandingkan, seperti double, bigint, varchar, timestamp, dan date.	Operator dasar Operator ALL Operator ANY Operator BETWEEN Operator DISTINCT
Operator logika	Menggabungkan beberapa kondisi boolean untuk mengontrol alur logika.	Operator AND Operator OR Operator NOT
Fungsi konversi satuan	Mengonversi satuan ukuran data atau interval waktu.	Fungsi convert_data_size Fungsi format_duration
Fungsi window funnel	Menganalisis data seperti perilaku pengguna, traffic aplikasi, dan konversi tujuan produk.	Fungsi window_funnel
Ekspresi lambda	Memungkinkan Anda mendefinisikan ekspresi lambda dalam pernyataan SQL dan SPL serta meneruskannya ke fungsi lain untuk fleksibilitas lebih besar.	Fungsi filter Fungsi reduce Fungsi transform
Ekspresi kondisional	Mengembalikan nilai berdasarkan kondisi tertentu.	Ekspresi CASE WHEN Ekspresi IF Ekspresi COALESCE Ekspresi NULLIF Ekspresi TRY