Sintaks dan contoh fungsi warna - Simple Log Service

Topik ini menjelaskan sintaks fungsi warna serta memberikan contoh penggunaannya.

Tabel berikut menjelaskan fungsi warna yang didukung oleh Simple Log Service.

Penting

Jika Anda ingin menggunakan string dalam pernyataan analitik, apit string tersebut dengan tanda kutip tunggal (''). String tanpa tanda kutip atau yang diapit tanda kutip ganda ("") menunjukkan nama bidang atau kolom. Sebagai contoh, 'status' menunjukkan string status, sedangkan status atau "status" menunjukkan bidang log status.
Saat menggunakan fungsi warna di konsol Simple Log Service, tampilan hasil kueri dan analisis mungkin terganggu. Untuk menghindari masalah ini, disarankan melihat hasil kueri dan analisis di server Anda.
- Tampilan hasil kueri dan analisis di konsol
- Tampilan hasil kueri dan analisis di server

Fungsi	Sintaks	Deskripsi	Didukung di SQL	Didukung di SPL
fungsi bar	bar(x, width)	Mengembalikan sebagian dari diagram batang ANSI. Anda dapat mengonfigurasi parameter width untuk menentukan lebar diagram batang ANSI. Namun, Anda tidak dapat mengonfigurasi parameter high_color atau low_color untuk menentukan warna untuk diagram tersebut. Nilai default dari parameter high_color dan low_color digunakan. Nilai default dari parameter low_color adalah merah, dan nilai default dari parameter high_color adalah hijau. Selain itu, Anda dapat mengonfigurasi x untuk menentukan panjang bagian yang dikembalikan oleh fungsi.	√	×
fungsi bar	bar(x, width, low_color, high_color)	Mengembalikan sebagian dari diagram batang ANSI. Anda dapat mengonfigurasi parameter width untuk menentukan lebar diagram batang ANSI. Anda juga dapat mengonfigurasi parameter high_color dan low_color untuk menentukan warna kustom untuk diagram tersebut. Selain itu, Anda dapat mengonfigurasi x untuk menentukan panjang bagian yang dikembalikan oleh fungsi.	√	×
fungsi color	color(string)	Mengonversi string warna menjadi tipe warna.	√	×
	color(x, low, high, low_color, high_color)	Mengembalikan warna antara high_color dan low_color berdasarkan proporsi high_color dan low_color. Proporsi ditentukan oleh perbandingan x antara high dan low.	√	×
	color(y, low_color, high_color)	Mengembalikan warna antara high_color dan low_color berdasarkan proporsi high_color dan low_color. Proporsi ditentukan oleh y.	√	×
fungsi render	render(ekspresi boolean)	Mengembalikan hasil menggunakan rendering warna. Jika ekspresi Boolean bernilai benar, fungsi mengembalikan centang hijau. Jika ekspresi Boolean bernilai salah, fungsi mengembalikan tanda silang merah.	√	×
fungsi render	render(x, warna)	Mengembalikan hasil menggunakan rendering warna kustom.	√	×
fungsi rgb	rgb(red, green, blue)	Mengembalikan nilai warna berdasarkan nilai RGB.	√	×

fungsi bar

Fungsi bar mengembalikan diagram batang ANSI.

Sintaks

Dengan sintaks berikut, fungsi mengembalikan sebagian dari diagram batang ANSI. Parameter width dapat dikonfigurasi untuk menentukan lebar diagram. Namun, parameter high_color atau low_color tidak dapat dikonfigurasi, sehingga nilai default digunakan. Nilai default untuk low_color adalah merah, dan untuk high_color adalah hijau. Parameter x dapat dikonfigurasi untuk menentukan panjang bagian yang dikembalikan.
```
bar(x, width)
```
Dengan sintaks berikut, fungsi mengembalikan sebagian dari diagram batang ANSI. Parameter width dapat dikonfigurasi untuk menentukan lebar diagram. Parameter high_color dan low_color juga dapat dikonfigurasi untuk menentukan warna kustom. Parameter x dapat dikonfigurasi untuk menentukan panjang bagian yang dikembalikan.
```
bar(x, width, low_color, high_color)
```

Parameter

Parameter	Deskripsi
x	Proporsi bagian yang dikembalikan oleh fungsi ke diagram batang ANSI. Nilai parameter ini bertipe double. Nilai valid: [0,1].
width	Lebar diagram batang ANSI.
low_color	Nilai RGB dari warna awal.
high_color	Nilai RGB dari warna akhir.

Tipe Nilai Pengembalian

Tipe varchar.

Contoh

Contoh 1: Dapatkan sebagian dari diagram batang ANSI berdasarkan proporsi jumlah tampilan halaman (PV) dalam satu jam tertentu terhadap total PV.

Pernyataan kueri

* |
SELECT
  Method,
  bar(pv/m,100)
FROM(
    SELECT
      *,
      max(pv) over() AS m
    FROM(
        SELECT
          Method,
          count(1) AS pv
        FROM         internal-operation_log
        WHERE
          __date__ > '2021-09-10 00:00:00'
          AND __date__ < '2021-09-10 01:00:00'
        GROUP BY
          Method
      )
  )

Hasil kueri dan analisis (konsol)
Hasil kueri dan analisis (server)

Contoh 2: Dapatkan diagram batang ANSI berwarna merah dan putih dengan lebar 50.
- Pernyataan kueri
```
* | SELECT bar(1,50,rgb(255,255,255),rgb(255,0,0))
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)

fungsi color

Fungsi color mengembalikan warna yang sesuai dengan suatu nilai.

Sintaks

Dengan sintaks berikut, fungsi mengonversi string warna menjadi tipe warna.
```
color(string)
```
Dengan sintaks berikut, fungsi mengembalikan warna antara high_color dan low_color berdasarkan proporsi high_color dan low_color. Proporsi ditentukan oleh perbandingan x antara high dan low.
```
color(x, low, high, low_color, high_color)
```
Dengan sintaks berikut, fungsi mengembalikan warna antara high_color dan low_color berdasarkan proporsi high_color dan low_color. Proporsi ditentukan oleh y.
```
color(y, low_color, high_color)
```

Parameter

Parameter	Deskripsi
x	Nilai parameter ini bertipe double.
y	Nilai parameter ini bertipe double. Nilai valid: [0,1].
low	Nilai minimum. Nilai parameter ini bertipe double.
high	Nilai maksimum. Nilai parameter ini bertipe double.
low_color	Nilai RGB dari warna awal.
high_color	Nilai RGB dari warna akhir.
string	String. Nilai valid: hitam, merah, hijau, kuning, biru, magenta, cyan, dan putih. Nilai juga bisa berupa nilai RGB dalam format Cascading Style Sheet (CSS). Contoh: #000.

Tipe Nilai Pengembalian

Tipe warna.

Contoh

Contoh 1: Konversi string warna menjadi tipe warna.
- Pernyataan kueri
```
* | SELECT color('#000')
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)
Contoh 2: Dapatkan sebagian dari diagram batang ANSI. Sisa dari nilai bidang request_length dihitung. Fungsi color mengembalikan warna yang sesuai dengan sisa tersebut, dan fungsi bar mengembalikan sebagian dari diagram batang ANSI berdasarkan warna tersebut.
- Pernyataan kueri
```
*|SELECT x,bar(10,10, color(x, 0,10, rgb(255,0,0), rgb(0,255,0)), rgb(0,255,0)) FROM(SELECT  *FROM (SELECT  request_length%10 x FROM  log))
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)
Contoh 3: Dapatkan sebagian dari diagram batang ANSI. Fungsi color mengembalikan warna, dan fungsi bar mengembalikan sebagian dari diagram batang ANSI berdasarkan warna tersebut.
- Pernyataan kueri
```
*|SELECT bar(10,10, color(0.3, rgb(255,255,255), rgb(255,0,0)), rgb(0,255,0))
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)

fungsi render

Fungsi render mengembalikan hasil menggunakan rendering warna.

Sintaks

Dengan sintaks berikut, fungsi mengembalikan hasil menggunakan rendering warna. Jika ekspresi Boolean bernilai benar, fungsi mengembalikan centang hijau. Jika ekspresi Boolean bernilai salah, fungsi mengembalikan tanda silang merah.
```
render(boolean expression)
```
Dengan sintaks berikut, fungsi mengembalikan hasil menggunakan rendering warna kustom.
```
render(x, color)
```

Parameter

Parameter	Deskripsi
boolean expression	Ekspresi Boolean.
x	Koordinat X. Nilai parameter ini bertipe integer.
color	Warna. Nilai parameter ini bertipe warna.

Tipe Nilai Pengembalian

Tipe varchar.

Contoh

Contoh 1: Periksa apakah jumlah PV kurang dari 1.000. Fungsi count mengembalikan jumlah PV, dan fungsi render menentukan apakah jumlah PV kurang dari 1.000 serta mengembalikan hasil menggunakan rendering warna. Jika jumlah PV kurang dari 1.000, fungsi render mengembalikan centang hijau.
- Pernyataan kueri
```
* | SELECT render(count(*)<1000)
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)
Contoh 2: Dapatkan jumlah total log menggunakan rendering hijau. Fungsi count mengembalikan jumlah total log, dan fungsi render mengembalikan hasil menggunakan rendering hijau.
- Pernyataan kueri
```
* | SELECT render(count(*),rgb(48,169,16))
```
- Hasil kueri dan analisis (konsol)
- Hasil kueri dan analisis (server)

fungsi rgb

Fungsi rgb mengembalikan nilai warna berdasarkan nilai RGB.

Sintaks

rgb(red, green, blue)

Parameter

Parameter	Deskripsi
red	Proporsi merah. Nilai valid: [0,255]. Nilai parameter ini bertipe integer.
green	Proporsi hijau. Nilai valid: [0,255]. Nilai parameter ini bertipe integer.
blue	Proporsi biru. Nilai valid: [0,255]. Nilai parameter ini bertipe integer.

Tipe Nilai Pengembalian

Tipe warna.

Contoh

Dapatkan nilai warna berdasarkan nilai RGB.

Pernyataan kueri
```
*|SELECT rgb(255,0,0)
```
Hasil kueri dan analisis (konsol)
Hasil kueri dan analisis (server)