华为云用户手册

ts_token_type(parser_oid oid, OUT tokid integer, OUT alias text, OUT description text) 描述：获取分析器定义的记号类型。 返回类型：setof record 示例： 1 2 3 4 5 6 7 8 9101112131415161718192021222324252627 SELECT ts_token_type(3722); ts_token_type -------------------------------------------------------------- (1,asciiword,"Word, all ASCII") (2,word,"Word, all letters") (3,numword,"Word, letters and digits") (4,email,"Email address") (5,url,URL) (6,host,Host) (7,sfloat,"Scientific notation") (8,version,"Version number") (9,hword_numpart,"Hyphenated word part, letters and digits") (10,hword_part,"Hyphenated word part, all letters") (11,hword_asciipart,"Hyphenated word part, all ASCII") (12,blank,"Space symbols") (13,tag,"XML tag") (14,protocol,"Protocol head") (15,numhword,"Hyphenated word, letters and digits") (16,asciihword,"Hyphenated word, all ASCII") (17,hword,"Hyphenated word, all letters") (18,url_path,"URL path") (19,file,"File or path name") (20,float,"Decimal notation") (21,int,"Signed integer") (22,uint,"Unsigned integer") (23,entity,"XML entity")(23 rows)

date_format(timestamp, fmt) date_format函数将日期参数按照fmt指定的格式转换为字符串。 示例： 1 2 3 4 5 6 7 8 9101112131415 SELECT date_format('2009-10-04 22:23:00', '%M %D %W'); date_format-------------------- October 4th Sunday(1 row)SELECT date_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S'); date_format--------------------- 2021-02-20 08:30:45(1 row)SELECT date_format('2021-02-20 18:10:15', '%r-%T'); date_format---------------------- 06:10:15 PM-18:10:15(1 row) 表1显示了可以用于将日期参数格式化输出的格式类型，这些格式类型适用于函数date_format、time_format、str_to_date、str_to_time和from_unixtime。 表1 date_format支持的输出格式 格式 说明 取值 %a 缩写星期名 Sun...Sat %b 缩写月份名 Jan...Dec %c 月份 0...12 %D 带英文后缀的月份日期 0th, 1st, 2nd, 3rd, … %d 一个月里的日，2位 00...31 %e 一个月里的日 0...31 %f 微秒 000000...999999 %H 小时，24小时制 00...23 %h 小时，12小时制 01...12 %I 小时，12小时制，同%h 01...12 %i 分钟 00...59 %j 一年里的日 001...366 %k 小时，24小时制，同%H 0...23 %l 小时，12小时制，同%h 1...12 %M 月份名 January...December %m 月份，两位 00...12 %p 上下午 AM PM %r 时间，12小时制 hh::mm::ss AM/PM %S 秒 00...59 %s 秒，同%S 00...59 %T 时间，24小时制 hh::mm::ss %U 周 (00-53) 星期日是一周的第一天 00...53 %u 周 (00-53) 星期一是一周的第一天 00...53 %V 周 (01-53) 星期日是一周的第一天，与%X搭配使用 01...53 %v 周 (01-53) 星期一是一周的第一天，与%x搭配使用 01...53 %W 星期名 Sunday...Saturday %w 一周的日，周日为0 0...6 %X 年份，其中的星期日是周的第一天，4 位，与%V搭配使用 - %x 年份，其中的星期一是周的第一天，4 位，与%v搭配使用 - %Y 年份，4位 - %y 年份，2位 - %% 字符'%' 字符'%' %x 'x'，上述未列出的任意字符 字符'x' date_format支持的输出格式中，%U、%u、%V、%v、%X、%x暂不支持。

log(double precision or numeric) 描述：以10为底的对数。 ORA和TD兼容模式下，表现为以10为底的对数。 MySQL兼容模式下，表现为自然对数。 返回值类型：与输入相同。 示例： 1 2 3 4 5 6 7 8 9101112131415161718 -- ORA兼容模式SELECT log(100.0); log -------------------- 2.0000000000000000(1 row)-- TD兼容模式SELECT log(100.0); log-------------------- 2.0000000000000000(1 row)-- MySQL兼容模式SELECT log(100.0); log-------------------- 4.6051701859880914(1 row)

width_bucket(operand numeric, b1 numeric, b2 numeric, count int) 描述：设定分组范围的最小值、最大值和分组个数，构建指定个数的大小相同的分组，返回指定字段值落入的分组编号。b1为分组范围的最小值，b2为分组范围的最大值，count为分组的个数。 返回值类型：integer 示例： 12345 SELECT width_bucket(5.35, 0.024, 10.06, 5); width_bucket-------------- 3(1 row)

width_bucket(operand double precision, b1 double precision, b2 double precision, count int) 描述：设定分组范围的最小值、最大值和分组个数，构建指定个数的大小相同的分组，返回指定字段值落入的分组编号。b1为分组范围的最小值，b2为分组范围的最大值，count为分组的个数。 返回值类型：integer 示例： 12345 SELECT width_bucket(5.35, 0.024, 10.06, 5); width_bucket-------------- 3(1 row)

round(double precision or numeric) 描述：离输入参数最近的整数。 返回值类型：与输入相同。 示例： 1 2 3 4 5 6 7 8 91011 SELECT round(42.4); round ------- 42(1 row)SELECT round(42.6); round ------- 43(1 row) 当调用round函数时，数值类型将舍入零，而（在大多数计算机上） 实数和双精度型，以最接近的偶数为结果。

yearweek(date[, mode]) 描述：返回给定日期date在本年中对应的年份和周数，周数范围为[1, 53]。 返回值类型：integer 示例： 1 2 3 4 5 6 7 8 91011 select yearweek('2019-12-31'); yearweek---------- 201952(1 row)select yearweek('2019-1-1'); yearweek---------- 201852(1 row)

time_format(time, fmt) 描述：time_format函数将日期参数按照fmt指定的格式转换为字符串。与date_format函数类似，但格式字符串只能包含小时、分钟、秒和微秒的格式说明符，如果包含其他说明符则会返回NULL值或0。 返回值类型：text 示例： 1 2 3 4 5 6 7 8 9101112131415 SELECT time_format('2009-10-04 22:23:00', '%M %D %W'); time_format-------------------- (1 row)SELECT time_format('2021-02-20 08:30:45', '%Y-%m-%d %H:%i:%S'); time_format--------------------- 0000-00-00 08:30:45(1 row)SELECT time_format('2021-02-20 18:10:15', '%r-%T'); time_format---------------------- 06:10:15 PM-18:10:15(1 row) time_format仅支持时间相关的格式输出（%f、%H、%h、%I、%i、%k、%l、%p、%r、%S、%s、%T），不支持日期相关格式，其他情况处理为普通字符。

str_to_date(str, format) 描述：将日期/时间格式的字符串（str），按照所提供的显示格式（format）转换为日期类型的值。 返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 910 SELECT str_to_date('01,5,2021','%d,%m,%Y'); str_to_date--------------------- 2021-05-01 00:00:00(1 row)SELECT str_to_date('01,5,2021,09,30,17','%d,%m,%Y,%h,%i,%s'); str_to_date--------------------- 2021-05-01 09:30:17(1 row) 适用于str_to_date的格式化输入的格式类型参考表1。这里仅支持“日期”格式、“日期+时间”格式的输入转换，对于仅“时间”格式的输入场景请使用str_to_time。

str_to_time(str, format) 描述：将时间格式的字符串（str），按照所提供的显示格式（format）转换为时间类型的值。 返回值类型：time 示例： 12345 SELECT str_to_time('09:30:17','%h:%i:%s'); str_to_time------------- 09:30:17(1 row) 适用于str_to_time的格式化输入的格式类型参考表1，这里仅支持“时间”格式的输入转换，对于“日期”格式、“日期+时间”格式的输入场景请使用str_to_date。

week(date[, mode]) 描述：根据模式返回指定日期时间所处年份中对应的周数，默认模式为0。 返回值类型：integer 表1 week函数中mode模式的工作原理 模式 一周的第一天 周数范围 第一周的判断规则 0 星期日 0-53 元旦后的第一个星期日所在周 1 星期一 0-53 元旦后有四天或者更多天所在周 2 星期日 1-53 元旦后的第一个星期日所在周 3 星期一 1-53 元旦后有四天或者更多天所在周 4 星期日 0-53 元旦后有四天或者更多天所在周 5 星期一 0-53 元旦后的第一个星期一所在周 6 星期日 1-53 元旦后有四天或者更多天所在周 7 星期一 1-53 元旦后的第一个星期一所在周 示例： 1 2 3 4 5 6 7 8 91011121314151617181920212223 select week('2018-01-01'); week------ 0(1 row)select week('2018-01-01', 0); week------ 0(1 row)select week('2020-12-31', 1); week------ 53(1 row)select week('2020-12-31', 5); week------ 52(1 row)

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

rb_contain_rb(roaringbitmap,roaringbitmap) 描述：判断第一个roaringbitmap是否包含第二个roaringbitmap。 返回值类型：bool 示例： 12345 SELECT rb_contain_rb(rb_build('{1,3}'), rb_build('{2,3}'));rb_contain_rb---------------f(1 row)

rb_clear(roaringbitmap,int,int) 描述：从roaringbitmap中清除指定范围内的元素。 返回值类型：roaringbitmap 示例： 1 SELECT rb_to_array(rb_clear(rb_build('{1,2,3}'),1,2)); rb_to_array ------------- {2,3} (1 row)

rb_containedby_rb(roaringbitmap,roaringbitmap) 描述：判断跟定的第二个roaringbitmap是否包含第一个roaringbitmap。 返回值类型：bool 示例： 12345 SELECT rb_containedby_rb(rb_build('{1,3}'), rb_build('{2,3}'));rb_containedby_rb---------------f(1 row)

rb_andnot(roaringbitmap, roaringbitmap) 描述：在第一个roaringbitmap集合中，但是不在第二个roaringbitmap中的集合。 返回值类型：roaringbitmap 示例： 12345 SELECT rb_to_array(rb_andnot(rb_build('{1,2,3}'), rb_build('{2,3,4}')));rb_to_array-------------{1}(1 row)

rb_or_cardinality(roaringbitmap, roaringbitmap) 描述：计算两个roaringbitmap的并集的基数。 返回值类型：int 示例： 12345 SELECT rb_or_cardinality(rb_build('{1,2,3}'), rb_build('{2,3,4}'));rb_or_cardinality-------------------4(1 row)

rb_xor_cardinality(roaringbitmap, roaringbitmap) 描述：计算两个roaringbitmap异或以后的基数。 返回值类型：int 示例： 12345 SELECT rb_xor_cardinality(rb_build('{1,2,3}'), rb_build('{2,3,4}'));rb_xor_cardinality--------------------2(1 row)

rb_build(array) 描述：将int数组转成roaringbitmap类型。 返回值类型：roaringbitmap 示例： 12345 SELECT rb_build('{1,2,3}');rb_build------------------------------------------------\x3a300000010000000000020010000000010002000300(1 row) 1 2 3 4 5 6 7 8 91011121314151617181920212223 CREATE TABLE r_row (a int, b text, c roaringbitmap);NOTICE: The 'DISTRIBUTE BY' clause is not specified. Using round-robin as the distribution mode by default.HINT: Please use 'DISTRIBUTE BY' clause to specify suitable data distribution column.CREATE TABLEINSERT INTO r_row values (1, 'a', rb_build('{1,2,3}'));INSERT 0 1SELECT * FROM r_row; a | b | c---+---+------------------------------------------------ 1 | a | \x3a300000010000000000020010000000010002000300(1 row)INSERT INTO r_row values (2, 'b', rb_build('{}'));INSERT 0 1SELECT * FROM r_row; a | b | c---+---+------------------------------------------------ 2 | b | \x3a30000000000000 1 | a | \x3a300000010000000000020010000000010002000300(2 rows)

rb_and_cardinality(roaringbitmap, roaringbitmap) 描述：计算两个roaringbitmap的交集的基数。 返回值类型：int 示例： 12345 SELECT rb_and_cardinality(rb_build('{1,2,3}'), rb_build('{2,3,4}'));rb_and_cardinality--------------------2(1 row)

rb_andnot_cardinality(roaringbitmap, roaringbitmap) 描述：计算两个roaringbitmap按照andnot计算结果以后的基数。 返回值类型：int 示例： 12345 SELECT rb_andnot_cardinality(rb_build('{1,2,3}'), rb_build('{2,3,4}'));rb_andnot_cardinality-----------------------1(1 row)

rb_to_array(roaringbitmap) 描述：rb_build的逆向操作，把roaringBitmap转成int数组。 返回值类型: array 示例： 1 2 3 4 5 6 7 8 910 SELECT rb_to_array(c) FROM r_row;rb_to_array-------------{1,2,3}(1 row)SELECT rb_to_array('\x3a300000010000000000020010000000010002000300');rb_to_array-------------{1,2,3}(1 row)

version() 描述：版本信息。version返回一个描述服务器版本信息的字符串。 返回值类型：text 示例： 12345 SELECT version(); version --------------------------------------------------------------------------------------------------------------------------------------- PostgreSQL 9.2.4 gsql (( GaussDB 8.2.1 build 39137c2d) compiled at 2022-09-23 15:43:11 commit 3629 last mr 5138 release) on x86_64-unknown-linux-gnu, compiled by g++ (GCC) 5.4.0, 64-bit(1 row)

pgxc_version() 描述：Postgres-XC版本信息。 返回值类型：text 示例： 12345 SELECT pgxc_version(); pgxc_version ------------------------------------------------------------------------------------------------------------- Postgres-XC 1.1 on x86_64-unknown-linux-gnu, based on PostgreSQL 9.2.4, compiled by g++ (GCC) 5.4.0, 64-bit(1 row)

current_schema[()] 描述：current_schema返回在搜索路径中第一个顺位有效的模式名。（如果搜索路径为空则返回NULL，没有有效的模式名也返回NULL）。如果创建表或者其他命名对象时没有声明目标模式，则将使用这些对象的模式。 返回值类型：name 示例： 12345 SELECT current_schema(); current_schema---------------- public(1 row)

current_user 描述：当前执行环境下的用户名。current_user是用于权限检查的用户标识。通常用来表示会话用户，但是可以通过SET ROLE改变这个设置。在函数执行的过程中随着属性SECURITY DEFINER的改变，其值也会改变。 返回值类型：name 示例： 12345 SELECT current_user; current_user-------------- dbadmin(1 row)

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

current_schemas(boolean) 描述：current_schemas(boolean)返回搜索路径中所有模式名字的数组。布尔选项决定像pg_catalog这样隐含包含的系统模式是否包含在返回的搜索路径中。 返回值类型：name[] 示例： 12345 SELECT current_schemas(true); current_schemas--------------------- {pg_catalog,public}(1 row) 搜索路径可以通过运行时设置更改。命令是： 1 SET search_path TO schema [, schema, ...]

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

pg_postmaster_start_time() 描述：数据库实例启动时间。pg_postmaster_start_time返回数据库实例启动时的timestamp with time zone。 返回值类型：timestamp with time zone 示例： 12345 SELECT pg_postmaster_start_time(); pg_postmaster_start_time ------------------------------ 2017-08-30 16:02:54.99854+08(1 row)