华为云用户手册

数据仓库服务 GAUSSDB(DWS)-会话信息函数:pg_my_temp_schema()

pg_my_temp_schema() 描述：pg_my_temp_schema返回当前会话中临时模式的OID，如果不存在（没有创建临时表）的话则返回0。如果给定的OID是其它会话中临时模式的OID，pg_is_other_temp_schema则返回true。返回值类型：oid 示例： 1 2 3 4 5 SELECT pg_my_temp_schema(); pg_my_temp_schema ------------------- 0 (1 row)

数据仓库服务 GAUSSDB(DWS) 系统信息函数
数据仓库服务 GAUSSDB(DWS)-会话信息函数:pg_conf_load_time()

pg_conf_load_time() 描述：配置加载时间。pg_conf_load_time返回最后加载服务器配置文件的时间戳。返回值类型：timestamp with time zone 示例： 1 2 3 4 5 SELECT pg_conf_load_time(); pg_conf_load_time ------------------------------ 2017-09-01 16:05:23.89868+08 (1 row)

数据仓库服务 GAUSSDB(DWS) 系统信息函数
数据仓库服务 GAUSSDB(DWS)-下标生成函数:generate_subscripts(array anyarray, dim int, reverse boolean)

generate_subscripts(array anyarray, dim int, reverse boolean) 描述：生成一系列包括给定数组的下标。当reverse为真时，该系列则以相反的顺序返回。返回值类型：setof int 示例： 1 2 3 4 5 6 7 8 SELECT generate_subscripts('{NULL,1,NULL,2}'::int[], 1,TRUE) AS s; s --- 4 3 2 1 (4 rows)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-序列号生成函数:generate_series(start, stop, step)

generate_series(start, stop, step) 描述：生成一个数值序列，从start到stop，步长为step。参数类型：int、bigint、numeric 返回值类型：setof int、setof bigint、setof numeric（与参数类型相同）示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT * FROM generate_series(5,1,-2); generate_series ----------------- 5 3 1 (3 rows) SELECT * FROM generate_series(4,6,-5); generate_series ----------------- (0 rows) SELECT * FROM generate_series(4,3,0); ERROR: step size cannot equal zero

数据仓库服务 GAUSSDB(DWS) 返回集合的函数
数据仓库服务 GAUSSDB(DWS)-序列号生成函数:generate_series(start, stop, step interval)

generate_series(start, stop, step interval) 描述：生成一个数值序列，从start到stop，步长为step。参数类型：timestamp或timestamp with time zone 返回值类型：setof timestamp或setof timestamp with time zone（与参数类型相同）示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 --这个示例应用于date-plus-integer操作符。 SELECT current_date + s.a AS dates FROM generate_series(0,14,7) AS s(a); dates ------------ 2017-06-02 2017-06-09 2017-06-16 (3 rows) SELECT * FROM generate_series('2008-03-01 00:00'::timestamp, '2008-03-04 12:00', '10 hours'); generate_series --------------------- 2008-03-01 00:00:00 2008-03-01 10:00:00 2008-03-01 20:00:00 2008-03-02 06:00:00 2008-03-02 16:00:00 2008-03-03 02:00:00 2008-03-03 12:00:00 2008-03-03 22:00:00 2008-03-04 08:00:00 (9 rows)

数据仓库服务 GAUSSDB(DWS) 返回集合的函数
数据仓库服务 GAUSSDB(DWS)-序列号生成函数:generate_series(start, stop)

generate_series(start, stop) 描述：生成一个数值序列，从start到stop，步长默认为1。参数类型：int、bigint、numeric 返回值类型：setof int、setof bigint、setof numeric（与参数类型相同）示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 SELECT * FROM generate_series(2,4); generate_series ----------------- 2 3 4 (3 rows) SELECT * FROM generate_series(4,3); generate_series ----------------- (0 rows) SELECT * FROM generate_series(1,NULL); generate_series ----------------- (0 rows)

数据仓库服务 GAUSSDB(DWS) 返回集合的函数
数据仓库服务 GAUSSDB(DWS)-数组函数:split(string, delim)

split(string, delim) 描述：将字符串string按分隔符delimiter进行分隔，并返回数组。该函数仅8.2.0及以上集群版本支持。返回类型：text[] 示例： 1 2 3 4 5 6 7 8 9 10 SELECT SPLIT('a-b-c-d-e', '-') AS RESULT; result ------------- {a,b,c,d,e} (1 row) SELECT SPLIT('a-b-c-d-e', '-')[4] AS RESULT; result -------- d (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组函数:string_to_array(text, text [, text])

string_to_array(text, text [, text]) 描述：使用第二个text指定分隔符，使用第三个可选的text作为NULL值替换模板，如果分隔后的子串与第三个可选的text完全匹配，则将其替换为NULL。返回类型：text[] 示例： 1 2 3 4 5 6 7 8 9 10 SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'yy') AS RESULT; result -------------- {xx,NULL,zz} (1 row) SELECT string_to_array('xx~^~yy~^~zz', '~^~', 'y') AS RESULT; result ------------ {xx,yy,zz} (1 row) 在string_to_array中，如果分隔符参数是NULL，输入字符串中的每个字符将在结果数组中变成一个独立的元素。如果分隔符是一个空白字符串，则整个输入的字符串将变为一个元素的数组。否则输入字符串将在每个分隔字符串处分开。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组函数:array_to_string(anyarray, text [, text])

array_to_string(anyarray, text [, text]) 描述：使用第一个text作为数组的新分隔符，使用第二个text替换数组值为null的值。返回类型：text 示例： 1 2 3 4 5 SELECT array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*') AS RESULT; result ----------- 1,2,3,*,5 (1 row) 在string_to_array中，如果省略null字符串参数或为NULL，将字符串中没有输入内容的子串替换为NULL。在array_to_string中，如果省略null字符串参数或为NULL，运算中将跳过在数组中的任何null元素，并且不会在输出字符串中出现。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组函数:array_cat(anyarray, anyarray)

array_cat(anyarray, anyarray) 描述：连接两个数组，支持多维数组。返回类型：anyarray 示例： 1 2 3 4 5 6 7 8 9 10 11 SELECT array_cat(ARRAY[1,2,3], ARRAY[4,5]) AS RESULT; result ------------- {1,2,3,4,5} (1 row) SELECT array_cat(ARRAY[[1,2],[4,5]], ARRAY[6,7]) AS RESULT; result --------------------- {{1,2},{4,5},{6,7}} (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组函数:unnest(anyarray)

unnest(anyarray) 描述：扩大一个数组为一组行。返回类型：setof anyelement 示例： 1 2 3 4 5 6 SELECT unnest(ARRAY[1,2]) AS RESULT; result -------- 1 2 (2 rows) unnest函数配合string_to_array数组使用。数组转列，先将字符串按逗号分割成数组，然后再把数组转成列： 1 2 3 4 5 6 7 8 SELECT unnest(string_to_array('a,b,c,d',',')) AS RESULT; result -------- a b c d (4 rows)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组函数:interval(N, N1, N2, N3 ... )

interval(N, N1, N2, N3 ... ) 描述：从输入的整数数组中，查找返回最后一个小于等于目标参数n的数组索引。若n为NULL，返回-1。interval函数不支持interval(N, N1)的场景。该函数仅8.2.0及以上集群版本支持。返回类型：int 示例： 1 2 3 4 5 SELECT INTERVAL(10, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 10, 11) AS RESULT; result -------- 11 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组操作符:||

|| 描述：数组与数组进行连接示例： 1 2 3 4 5 SELECT ARRAY[1,2,3] || ARRAY[4,5,6] AS RESULT; result --------------- {1,2,3,4,5,6} (1 row) 1 2 3 4 5 SELECT ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]] AS RESULT; result --------------------------- {{1,2,3},{4,5,6},{7,8,9}} (1 row)

数据仓库服务 GAUSSDB(DWS) 数组函数和操作符
数据仓库服务 GAUSSDB(DWS)-内置函数

内置函数 HLL（HyperLogLog）有一系列内置函数用于内部对数据进行处理，一般情况下不建议用户使用。表1 内置函数函数名称功能描述 hll_in 以string格式接收hll数据。 hll_out 以string格式发送hll数据。 hll_recv 以bytea格式接收hll数据。 hll_send 以bytea格式发送hll数据。 hll_trans_in 以string格式接收hll_trans_type数据。 hll_trans_out 以string格式发送hll_trans_type数据。 hll_trans_recv 以bytea形式接收hll_trans_type数据。 hll_trans_send 以bytea形式发送hll_trans_type数据。 hll_typmod_in 接收typmod类型数据。 hll_typmod_out 发送typmod类型数据。 hll_hashval_in 接收hll_hashval类型数据。 hll_hashval_out 发送hll_hashval类型数据。 hll_add_trans0 类似于hll_add所提供的功能，通常在分布式聚合运算的第一阶段DN上使用。 hll_union_trans 类似hll_union所提供的功能，在分布式聚合运算的第一阶段DN上使用。 hll_union_collect 类似于hll_union所提供的功能，在分布式聚合运算第二阶段CN上使用，汇总各个DN上的结果。 hll_pack 在分布式聚合运算第三阶段CN上使用，把自定义hll_trans_type类型最后转换成hll类型。 hll 用于hll类型转换成hll类型，根据输入参数会设定指定参数。 hll_hashval 用于bigint类型转换成hll_hashval类型。 hll_hashval_int4 用于int4类型转换成hll_hashval类型。父主题： HLL函数和操作符

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_union(hll, hll)

hll_union(hll, hll) 描述：把两个hll数据结构union成一个。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_union(hll_add(hll_empty(), hll_hash_integer(1)), hll_add(hll_empty(), hll_hash_integer(2))); hll_union ------------------------------------------ \x128b7f8895a3f5af28cafeda0ce907e4355b60 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_add_rev(hll_hashval, hll)

hll_add_rev(hll_hashval, hll) 描述：把hll_hashval加入到hll中，和hll_add功能一样，只是参数位置进行了交换。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_add_rev(hll_hash_integer(1), hll_empty()); hll_add_rev -------------------------- \x128b7f8895a3f5af28cafe (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_add(hll, hll_hashval)

hll_add(hll, hll_hashval) 描述：把hll_hashval加入到hll中。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_add(hll_empty(), hll_hash_integer(1)); hll_add -------------------------- \x128b7f8895a3f5af28cafe (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_print(hll)

hll_print(hll) 描述：打印hll的一些debug参数信息。返回值类型：cstring 示例： 1 2 3 4 5 SELECT hll_print(hll_empty()); hll_print ----------------------------------------------------------- EMPTY, nregs=2048, nbits=5, expthresh=-1(160), sparseon=1gongne (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_empty(int32 log2m, int32 regwidth, int64 expthresh)

hll_empty(int32 log2m, int32 regwidth, int64 expthresh) 描述：创建空的hll并依次指定参数log2m、regwidth、expthresh。expthresh取值范围是-1到7之间的整数。该参数可以用来设置从Explicit模式到Sparse模式的阈值大小。-1表示自动模式，0表示跳过Explicit模式，取1-7表示在基数到达2expthresh时切换模式。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_empty(10, 4, 7); hll_empty ----------- \x116a48 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-功能函数:hll_empty(int32 log2m, int32 regwidth, int64 expthresh, int32 sparseon)

hll_empty(int32 log2m, int32 regwidth, int64 expthresh, int32 sparseon) 描述：创建空的hll并依次指定参数log2m、regwidth、expthresh、sparseon。sparseon取0或者1。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_empty(10,4,7,0); hll_empty ----------- \x116a08 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_add_agg(hll_hashval, int32 log2m, int32 regwidth, int64 expthresh, int32 sparseon)

hll_add_agg(hll_hashval, int32 log2m, int32 regwidth, int64 expthresh, int32 sparseon) 描述：把哈希后的数据按照分组放到hll中，依次指定参数log2m、regwidth、expthresh、sparseon。sparseon取值范围为0或者1。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_cardinality(hll_add_agg(hll_hash_text(c), NULL, 1, 4, 0)) FROM t_data; hll_cardinality ------------------ 496.628982624022 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_union_agg(hll)

hll_union_agg(hll) 描述：将多个hll类型数据union成一个hll。返回值类型：hll 示例：将各组中的hll数据union成一个hll，并计算distinct值。 1 2 3 4 5 SELECT #hll_union_agg(c) as cardinality FROM t_a_c_hll; cardinality ------------------ 496.628982624022 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_add_agg(hll_hashval)

hll_add_agg(hll_hashval) 描述：把哈希后的数据按照分组放到hll中。返回值类型：hll 示例：准备数据。 1 2 3 4 CREATE TABLE t_id(id int); INSERT INTO t_id VALUES(generate_series(1,500)); CREATE TABLE t_data(a int, c text); INSERT INTO t_data SELECT mod(id,2), id FROM t_id; 创建表并指定列为hll。 1 CREATE TABLE t_a_c_hll(a int, c hll); 根据a列group by对数据分组，把各组数据加到hll中。 1 INSERT INTO t_a_c_hll SELECT a, hll_add_agg(hll_hash_text(c)) FROM t_data GROUP BY a; 得到每组数据中hll的Distinct值。 1 2 3 4 5 6 SELECT a, #c as cardinality FROM t_a_c_hll order by a; a | cardinality ---+------------------ 0 | 250.741759091658 1 | 250.741759091658 (2 rows)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_add_agg(hll_hashval, int32 log2m, int32 regwidth)

hll_add_agg(hll_hashval, int32 log2m, int32 regwidth) 描述：把哈希后的数据按照分组放到hll中。依次指定参数log2m，regwidth。 regwidth取值范围为1~5。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_cardinality(hll_add_agg(hll_hash_text(c), NULL, 1)) FROM t_data; hll_cardinality ------------------ 496.628982624022 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_add_agg(hll_hashval, int32 log2m)

hll_add_agg(hll_hashval, int32 log2m) 描述：把哈希后的数据按照分组放到hll中。并指定参数log2m，取值范围为10~16。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_cardinality(hll_add_agg(hll_hash_text(c), 10)) FROM t_data; hll_cardinality ------------------ 503.932348927339 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-聚合函数:hll_add_agg(hll_hashval, int32 log2m, int32 regwidth, int64 expthresh)

hll_add_agg(hll_hashval, int32 log2m, int32 regwidth, int64 expthresh) 描述：把哈希后的数据按照分组放到hll中，依次指定参数log2m、regwidth、expthresh。expthresh的取值范围是-1~7之间的整数，该参数可以用来设置从Explicit模式到Sparse模式的阈值大小。-1表示自动模式，0表示跳过Explicit模式，取1~7表示在基数到达 2expthresh时切换模式。返回值类型：hll 示例： 1 2 3 4 5 SELECT hll_cardinality(hll_add_agg(hll_hash_text(c), NULL, 1, 4)) FROM t_data; hll_cardinality ------------------ 496.628982624022 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-精度函数:hll_expthresh(hll)

hll_expthresh(hll) 描述：得到当前hll中expthresh大小，hll通常会由Explicit模式到Sparse模式再到Full模式，这个过程称为promotion hierarchy策略。可以通过调整expthresh值的大小改变策略，比如expthresh为0的时候就会跳过Explicit模式而直接进入Sparse模式。当显式指定expthresh的取值为1-7之间时，该函数得到的是 2expthresh。返回值类型：record 示例： 1 2 3 4 5 6 7 8 9 10 11 SELECT hll_expthresh(hll_empty()); hll_expthresh --------------- (-1,160) (1 row) SELECT hll_expthresh(hll_empty(11,5,3)); hll_expthresh --------------- (8,8) (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-哈希函数:hll_hash_smallint(smallint, int32)

hll_hash_smallint(smallint, int32) 描述：设置hash seed（即改变哈希策略）同时对smallint类型数据计算哈希值。返回值类型：hll_hashval 示例： 1 2 3 4 5 SELECT hll_hash_smallint(100::smallint, 10); hll_hash_smallint --------------------- 8349353095166695771 (1 row)

数据仓库服务 GAUSSDB(DWS) HLL函数和操作符
数据仓库服务 GAUSSDB(DWS)-哈希函数:hll_hash_any(anytype, int32)

hll_hash_any(anytype, int32) 描述：对任意类型数据计算哈希值，并设置hashseed（即改变哈希策略）。返回值类型：hll_hashval 示例： 1 2 3 4 5 SELECT hll_hash_any(1, 10); hll_hash_any ---------------------- -1478847531811254870 (1 row)

数据仓库服务 GAUSSDB(DWS) HLL函数和操作符
数据仓库服务 GAUSSDB(DWS)-哈希函数:hll_hashval_eq(hll_hashval, hll_hashval)

hll_hashval_eq(hll_hashval, hll_hashval) 描述：比较两个hll_hashval类型数据是否相等。返回值类型：bool 示例： 1 2 3 4 5 SELECT hll_hashval_eq(hll_hash_integer(1), hll_hash_integer(1)); hll_hashval_eq ---------------- t (1 row)

数据仓库服务 GAUSSDB(DWS) HLL函数和操作符

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线