Simple Log Service:近似関数

approx_distinct関数

approx_distinct関数は、xの異なる値の数を推定します。

構文

• 次の構文のapprox_distinct関数は、xの異なる値の数を推定します。 デフォルトの標準エラーは2.3% です。

  approx_distinct(x)

• 次の構文のapprox_distinct関数は、xの異なる値の数を推定します。 カスタム標準エラーを指定できます。

  approx_distinct(x, e)

パラメーター

戻り値のデータ型

bigint型。

例

• 例1: カウント関数を使用して、ページビュー (PV) の数を計算します。 次に、approx_distinct関数を使用して、client_ipフィールドの一意の値を一意の訪問者 (UV) の数として推定します。 標準エラーは2.3% です。

  • クエリ文

    * |SELECT count(*) AS PV, approx_distinct(client_ip) AS UV

  • クエリと分析結果

• 例2: count関数を使用してPVの数を計算します。 次に、approx_distinct関数を使用して、client_ipフィールドの一意の値をUVの数として推定します。 標準エラーは10% です。

  • クエリ文

    * |SELECT count(*) AS PV, approx_distinct(client_ip,0.1) AS UV

  • クエリと分析結果

approx_percentile関数

approx_percentile関数は、xの値を昇順でソートし、おおよそパーセントの位置にあるxの値を返します。

構文

• 次の構文のapprox_percentile関数は、xの値を昇順でソートし、おおよそpercentageの位置にあるxの値を返します。 戻り値はdouble型です。

  approx_percentile(x, percentage)

• 次の構文のapprox_percentile関数は、xの値を昇順でソートし、percentage01とpercentage02の位置にあるxの値を返します。 戻り値は配列 (double,double) 型です。

  approx_percentile(x, array[percentage01, percentage02...])

• 次の構文のapprox_percentile関数は、xの値と重みの積に基づいてxの値を昇順にソートし、おおよそパーセント位置にあるxの値を返します。 戻り値はdouble型です。

  approx_percentile(x, weight, percentage)

• 次の構文のapprox_percentile関数は、xの値と重みの積に基づいてxの値を昇順でソートし、percentage01とpercentage02の位置にあるxの値を返します。 戻り値は配列 (double,double) 型です。

  approx_percentile(x, weight, array[percentage01, percentage02...])

• 次の構文のapprox_percentile関数は、xの値と重みの積に基づいてxの値を昇順にソートし、おおよそパーセント位置にあるxの値を返します。 戻り値はdouble型です。 戻り値の精度を指定できます。

  approx_percentile(x, weight, percentage, accuracy)

パラメーター

戻り値のデータ型

doubleまたはarray(double、double) タイプ。

例

• 例1: request_time列の値を昇順でソートし、ほぼ50% の位置にあるrequest_timeフィールドの値を返します。

  • クエリ文

    *| SELECT approx_percentile(request_time,0.5)

  • クエリと分析結果

• 例2: request_time列の値を昇順でソートし、ほぼ10% 、20% 、および70% の位置にあるrequest_timeフィールドの値を返します。

  • クエリ文

    *| SELECT approx_percentile(request_time,array[0.1,0.2,0.7])

  • クエリと分析結果

• 例3: request_time列の値と重みの積に基づいて、request_time列の値を昇順でソートし、ほぼ50% の位置にあるrequets_timeフィールドの値を返します。 request_timeの値が20未満の場合、重みは100である。 それ以外の場合、重量は10です。

  • クエリ文

    * |
    SELECT
      approx_percentile(
        request_time,case
          when request_time < 20 then 100
          else 10
        end,
        0.5
      )

  • クエリと分析結果

• 例4: request_time列の値と重みの積に基づいてrequest_time列の値をソートし、ほぼ80% と90% の位置にあるrequest_timeフィールドの値を返します。 request_timeの値が20未満の場合、重みは100である。 それ以外の場合、重量は10です。

  • クエリ文

    * |
    SELECT
      approx_percentile(
        request_time,case
          when request_time < 20 then 100
          else 10
        end,
        array [0.8,0.9]
      )

  • クエリと分析結果

• 例5: request_timeの値と重みの積に基づいてrequest_time列の値をソートし、ほぼ50% の位置にあるrequest_timeフィールドの値を返します。 精度は0.2です。 request_timeの値が20未満の場合、重みは100である。 それ以外の場合、重量は10です。

  • クエリ文

    * |
    SELECT
      approx_percentile(
        request_time,case
          when request_time < 20 then 100
          else 10
        end,
        0.5,
        0.2
      )

  • クエリと分析結果

numeric_histogram関数

numeric_histogram関数は、バケットパラメーターで指定されたヒストグラム列の数に基づいて、xの近似ヒストグラムを返します。 戻り値はJSON型です。

構文

• 次の構文のnumeric_histogram関数は、バケットパラメーターで指定されたヒストグラム列の数に基づいて、xの近似ヒストグラムを返します。

  numeric_histogram(bucket, x)

• 次の構文のnumeric_histogram関数は、バケットパラメーターで指定されたヒストグラム列の数に基づいて、xの近似ヒストグラムを返します。 xの値に重みを指定できます。

  numeric_histogram(bucket, x, weight)

パラメーター

戻り値のデータ型

JSON型。

例

• 例1: POSTメソッドのリクエスト期間のおおよそのヒストグラムを返します。

  • クエリ文

    request_method:POST | SELECT numeric_histogram(10,request_time)

  • クエリと分析結果

• 例2: request_timeフィールドの値と重みの積に基づいて、request_timeフィールドの値をグループ化し、POSTメソッドのリクエスト期間の近似ヒストグラムを返します。

  • クエリ文

    request_method:POST| SELECT numeric_histogram(10, request_time,case when request_time<20 then 100 else 10 end)

  • クエリと分析結果

numeric_histogram_u関数

numeric_histogram_u関数は、バケットパラメーターで指定されたヒストグラム列の数に基づいて、xの近似ヒストグラムを返します。 複数の行と列を含むテーブルが返されます。

構文

numeric_histogram_u(bucket, x)

パラメーター

戻り値のデータ型

ダブルタイプ。

例

POSTメソッドのリクエスト期間のおおよそのヒストグラムを返します。

• クエリ文

  request_method:POST | select numeric_histogram_u(10,request_time)

• クエリと分析結果