色関数の構文と例 - Simple Log Service - Alibaba Cloud ドキュメントセンター

このトピックでは、色関数の構文について説明します。このトピックでは、関数の使用方法の例も示します。

次の表に、Simple Log Serviceでサポートされているカラー機能を示します。

重要

分析ステートメントで文字列を使用する場合は、文字列を単一引用符 ('') で囲む必要があります。囲まれていない文字列または二重引用符 ("") で囲まれている文字列は、フィールド名または列名を示します。例えば、 'status' はステータスの文字列を示し、status または "status" はステータスログフィールドを示します。
Simple Log Serviceコンソールでカラー関数を使用すると、クエリおよび分析結果の表示が損なわれます。この問題を回避するには、サーバーでクエリと分析の結果を表示することをお勧めします。
- コンソールでのクエリおよび分析結果の表示
- サーバー上でのクエリおよび分析結果の表示

関数	構文	説明	SQLでサポート	SPLでサポート
バー関数	バー (x、width)	ANSI棒グラフの一部を返します。 widthパラメーターを設定して、ANSI棒グラフの幅を指定できます。ただし、high_colorまたはlow_colorパラメーターを設定して、チャートの色を指定することはできません。 high_colorおよびlow_colorパラメータのデフォルト値が使用されます。 low_colorパラメーターのデフォルト値は赤、high_colorパラメーターのデフォルト値は緑です。さらに、xを設定して、関数によって返される部品の長さを指定できます。	√	×
バー関数	バー (x、width、low_color、high_color)	ANSI棒グラフの一部を返します。 widthパラメーターを設定して、ANSI棒グラフの幅を指定できます。 high_colorパラメーターとlow_colorパラメーターを設定して、チャートのカスタムカラーを指定することもできます。さらに、xを設定して、関数によって返される部品の長さを指定できます。	√	×
カラー関数	色 (文字列)	カラー文字列をカラータイプに変換します。	√	×
	カラー (x、low、high、low_color、high_color)	high_colorとlow_colorの部分に基づいて、high_colorとlow_colorの間の色を返します。この部分は、highとlowとの間のxの割合によって決定される。	√	×
	カラー (y、low_color、high_color)	high_colorとlow_colorの部分に基づいて、high_colorとlow_colorの間の色を返します。部分はyによって決定される。	√	×
レンダリング関数	render( ブール式)	カラーレンダリングを使用して結果を返します。ブール式がtrueに評価された場合、関数は緑のティックを返します。ブール式がfalseに評価された場合、関数は赤十字を返します。	√	×
レンダリング関数	render( x, color)	カスタムカラーレンダリングを使用して結果を返します。	√	×
rgb関数	rgb( 赤く、緑、青い)	RGB値に基づいてカラー値を返します。	√	×

バー関数

bar関数は、ANSI棒グラフを返します。

構文

次の構文を使用すると、この関数はANSI棒グラフの一部を返します。 widthパラメーターを設定して、ANSI棒グラフの幅を指定できます。ただし、high_colorまたはlow_colorパラメーターを設定して、チャートの色を指定することはできません。 high_colorおよびlow_colorパラメータのデフォルト値が使用されます。 low_colorパラメーターのデフォルト値は赤、high_colorパラメーターのデフォルト値は緑です。さらに、xを設定して、関数によって返される部品の長さを指定できます。
```
bar(x, width)
```
次の構文を使用すると、この関数はANSI棒グラフの一部を返します。 widthパラメーターを設定して、ANSI棒グラフの幅を指定できます。 high_colorパラメーターとlow_colorパラメーターを設定して、チャートのカスタムカラーを指定することもできます。さらに、xを設定して、関数によって返される部品の長さを指定できます。
```
bar(x, width, low_color, high_color)
```

パラメーター

パラメーター	説明
x	関数によってANSI棒グラフに返される部品の割合。このパラメーターの値はdouble型です。有効な値: [0,1] 。
幅	ANSI棒グラフの幅。
low_color	開始カラーのRGB値。
high_color	エンドカラーのRGB値。

戻り値のデータ型

varcharタイプ。

例

例1: 指定された時間内のページビュー (PV) の合計PVに対する割合に基づいて、ANSI棒グラフの一部を取得します。

クエリ文

* |
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
      )
  )

クエリと分析結果 (コンソール)
クエリと分析結果 (サーバー)

例2: 赤と白で表示され、幅が50のANSI棒グラフを取得します。
- クエリ文
```
* | SELECT bar(1,50,rgb(255,255,255),rgb(255,0,0))
```
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)

カラー関数

color関数は、値に対応する色を返します。

構文

次の構文を使用すると、関数はカラー文字列をカラータイプに変換します。
```
color(string)
```
次の構文を使用すると、関数はhigh_colorとlow_colorの部分に基づいてhigh_colorとlow_colorの間の色を返します。この部分は、highとlowとの間のxの割合によって決定される。
```
color(x, low, high, low_color, high_color)
```
次の構文を使用すると、関数はhigh_colorとlow_colorの部分に基づいてhigh_colorとlow_colorの間の色を返します。部分はyによって決定される。
```
color(y, low_color, high_color)
```

パラメーター

パラメーター	説明
x	このパラメーターの値はdouble型です。
y	このパラメーターの値はdouble型です。有効な値: [0,1] 。
低い	最小値。このパラメーターの値はdouble型です。
高い	最大値。このパラメーターの値はdouble型です。
low_color	開始カラーのRGB値。
high_color	エンドカラーのRGB値。
文字列	文字列有効な値: 黒、赤、緑、黄、青、マゼンタ、シアン、白。値は、カスケードスタイルシート (CSS) 形式のRGB値にすることもできます。例: #000。

戻り値のデータ型

カラータイプ。

例

例1: カラー文字列をカラータイプに変換します。
- クエリ文
```
* | SELECT color('#000')
```
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)
例2: ANSI棒グラフの一部を取得します。 request_lengthフィールド値の残りが計算される。次に、色関数は残りに対応する色を返し、バー関数は色に基づいてANSI棒グラフの一部を返します。
- クエリ文
```
*|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))
```
  から (SELECT * FROM (SELECT request_length % 10 x FROM log))
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)
例3: ANSI棒グラフの一部を取得します。 color関数は色を返し、bar関数はその色に基づいてANSI棒グラフの一部を返します。
- クエリ文
```
*|SELECT bar(10,10, color(0.3, rgb(255,255,255), rgb(255,0,0)), rgb(0,255,0))
```
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)

レンダリング関数

render関数は、カラーレンダリングを使用して結果を返します。

構文

次の構文を使用する場合、関数はカラーレンダリングを使用して結果を返します。ブール式がtrueに評価された場合、関数は緑のティックを返します。ブール式がfalseに評価された場合、関数は赤十字を返します。
```
render(boolean expression)
```
次の構文を使用する場合、関数はカスタムカラーレンダリングを使用して結果を返します。
```
render(x, color)
```

パラメーター

パラメーター	説明
ブール式	ブール式。
x	X座標。このパラメーターの値は整数型です。
カラー	色。このパラメータの値はカラータイプです。

戻り値のデータ型

varcharタイプ。

例

例1: PVの数が1,000未満かどうかを確認します。 count関数はPVの数を返し、render関数はPVの数が1,000未満かどうかを判断し、カラーレンダリングを使用して結果を返します。 PVの数が1,000未満の場合、render関数は緑色のティックを返します。
- クエリ文
```
* | SELECT render(count(*)<1000)
```
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)
例2: 緑のレンダリングを使用してログの総数を取得します。 count関数はログの総数を返し、render関数は緑色のレンダリングを使用して結果を返します。
- クエリ文
```
* | SELECT render(count(*),rgb(48,169,16))
```
- クエリと分析結果 (コンソール)
- クエリと分析結果 (サーバー)

rgb関数

rgb関数は、RGB値に基づいてカラー値を返します。

構文

rgb(red, green, blue)

パラメーター

パラメーター	説明
赤	赤の部分。有効な値: [0,255] 。このパラメーターの値は整数型です。
グリーン	緑の部分。有効な値: [0,255] 。このパラメーターの値は整数型です。
ブルー	青の部分。有効な値: [0,255] 。このパラメーターの値は整数型です。

戻り値のデータ型

カラータイプ。

例

RGB値に基づいてカラー値を取得します。

クエリ文
```
*|SELECT rgb(255,0,0)
```
クエリと分析結果 (コンソール)
クエリと分析結果 (サーバー)