类别：: :doc:`/sql-reference/functions-aggregation`（基数估算）、:doc:`窗口函数 </sql-reference/functions-window-syntax>`（基数估算）

HLL_COMBINE¶

将多个输入状态组合（合并）为单个输出状态。

这允许 HLL_ACCUMULATE 在同一表的水平分区上运行，从而为每个表分区生成算法状态。这些状态稍后可以使用 HLL_COMBINE 进行组合，生成与整个表的 HLL_ACCUMULATE 单次运行相同的输出状态。

另请参阅：: HLL、HLL_ACCUMULATE、HLL_ESTIMATE

语法¶

聚合函数

HLL_COMBINE( [ DISTINCT ] <state> )

Copy

窗口函数

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

Copy

有关 OVER 子句的详细信息，请参阅窗口函数的语法和用法。

实参¶

state: 一个表达式，其中包含通过调用 HLL_ACCUMULATE 生成的状态信息。

使用说明¶

此函数可用作聚合函数或窗口函数。
DISTINCT 在语法上受支持，但不起作用。
此函数的输出不是完全确定的。对相同的输入运行此函数可能会在不同时间返回不同的结果。差异通常很小，并且与 HLL_* 函数是近似函数这一事实一致。

示例¶

此示例说明如何使用三个相关函数 HLL_ACCUMULATE、HLL_ESTIMATE 和 HLL_COMBINE。

创建简单的表和数据：

-- Create a sequence to use to generate values for the table.
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);

-- Double the number of rows a few times, until there are 8 rows:
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;

Copy

创建一个包含“state”的表，该“state”表示名为 sequence_demo 的表的当前近似基数信息：

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

Copy

现在创建另一个表并添加数据。（在更实际的情况下，用户可以将更多数据加载到第一个表中，并根据加载数据的时间将数据划分为非重叠集）。

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

Copy

仅获取新数据的“状态”信息。

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

Copy

合并两批行的“状态”信息：

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

Copy

获取行组合集的近似基数：

SELECT hll_estimate(c1) FROM combined_resultstate;

Copy

输出：

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

Copy