カテゴリ：: 集計関数（カーディナリティ推定）、ウィンドウ関数（カーディナリティ推定）

HLL_COMBINE¶

入力状態を単一の出力状態に結合（マージ）します。

これにより、 HLL_ACCUMULATE が同じテーブルの水平パーティションで実行され、各テーブルパーティションのアルゴリズム状態が生成されるシナリオが可能になります。その後、これらの状態を HLL_COMBINE を使用して結合し、テーブル全体で HLL_ACCUMULATE を1回実行するのと同じ出力状態を生成できます。

こちらもご参照ください。: HLL、 HLL_ACCUMULATE、 HLL_ESTIMATE

構文¶

集計関数

HLL_COMBINE( [ DISTINCT ] <state> )

ウィンドウ関数

HLL_COMBINE( [ DISTINCT ] <state> ) OVER ( [ PARTITION BY <expr1> ] )

OVER句の詳細については、ウィンドウ関数の構文と使用法をご参照ください。

引数¶

state: HLL_ACCUMULATE の呼び出しによって生成された状態情報を含む式です。

使用上の注意¶

この関数は集計関数またはウィンドウ関数として使用できます。
DISTINCT はサポートされていますが、効果はありません。
この関数の出力は、完全に決定論的ではありません。同じ入力でこの関数を実行すると、異なるタイミングで異なる結果が返される場合があります。通常、違いは小さく、 HLL_* 関数が近似関数であるという事実と一致しています。

例¶

This example shows how to use the three related functions HLL_ACCUMULATE, HLL_ESTIMATE, and HLL_COMBINE.

簡単なテーブルとデータを作成します。

CREATE OR REPLACE SEQUENCE seq92;
CREATE OR REPLACE TABLE sequence_demo (c1 INTEGER DEFAULT seq92.nextval, dummy SMALLINT);
INSERT INTO sequence_demo (dummy) VALUES (0);

INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;
INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;
INSERT INTO sequence_demo (dummy) SELECT dummy FROM sequence_demo;

Create a table that contains the "state" that represents the current approximate cardinality information for the table named sequence_demo:

CREATE OR REPLACE TABLE resultstate1 AS (
  SELECT HLL_ACCUMULATE(c1) AS rs1
    FROM sequence_demo);

Now create a second table and add data. (In a more realistic situation, the user could have loaded more data into the first table and divided the data into non-overlapping sets based on the time that the data was loaded.)

CREATE OR REPLACE TABLE test_table2 (c1 INTEGER);
INSERT INTO test_table2 (c1) SELECT c1 + 4 FROM sequence_demo;

新しいデータのみの「状態」情報を取得します。

CREATE OR REPLACE TABLE resultstate2 AS
  (SELECT HLL_ACCUMULATE(c1) AS rs1
     FROM test_table2);

行の2つのバッチの「状態」情報を結合します。

CREATE OR REPLACE TABLE combined_resultstate (c1) AS
  SELECT HLL_COMBINE(rs1) AS apc1
    FROM (
      SELECT rs1 FROM resultstate1
      UNION ALL
      SELECT rs1 FROM resultstate2
    );

行の結合セットのおおよそのカーディナリティを取得します。

SELECT HLL_ESTIMATE(c1)
  FROM combined_resultstate;

+------------------+
| HLL_ESTIMATE(C1) |
|------------------|
|               12 |
+------------------+