华为云用户手册

参数说明 VERBOSE 启用显示进度信息。 如果指定了VERBOSE，ANALYZE发出进度信息，表明目前正在处理的表。各种有关表的统计信息也会打印出来。 table_name 需要分析的特定表的表名（可能会带模式名），如果省略，将对数据库中的所有表（非外部表）进行分析。 对于ANALYZE收集统计信息，目前仅支持行存表、列存表、HDFS表、ORC格式的OBS外表、CARBONDATA格式的OBS外表、协同分析的外表。 取值范围：已有的表名。 column_name，column_1_name，column_2_name 需要分析特定列的列名，默认为所有列。 取值范围：已有的列名。 partition_name 如果table为分区表，在关键字PARTITION后面指定分区名partition_name表示分析该分区表的统计信息。目前语法上支持分区表做ANALYZE，但功能实现上暂不支持对指定分区统计信息的分析。 取值范围：表的某一个分区名。 foreign_table_name 需要分析的特定外表的表名（可能会带模式名），该表的数据存放于HDFS分布式文件系统中。 取值范围：已有的表名。 FOREIGN TABLES 分析所有当前用户权限下，数据位于HDFS分布式文件系统中的HDFS外表。 index_name 需要分析的特定索引表的表名（可能会带模式名）。 取值范围：已有的表名。 FAST|COMPLETE 对于行存表，FAST模式下主要对于行存表的CRC和page header进行校验，如果校验失败则会告警; 而COMPLETE模式下，则主要对行存表的指针、tuple进行解析校验。 对于列存表，FAST模式下主要对于列存表的CRC和magic进行校验，如果校验失败则会告警；而COMPLETE模式下，则主要对列存表的CU进行解析校验。 CASCADE CASCADE模式下会对当前表的所有索引进行检测处理。

注意事项 只有拥有表INSERT权限的用户，才可以向表中插入数据。 如果使用RETURNING子句，用户必须要有该表的SELECT权限。 如果使用QUERY子句插入来自查询里的数据行，用户还需要拥有在查询里使用的表的SELECT权限。 如果使用OVERWRITE子句覆盖式插入数据，用户还需要拥有该表的SELECT和TRUNCATE权限。 当连接到TD兼容的数据库时，td_compatible_truncation参数设置为on时，将启用超长字符串自动截断功能，在后续的INSERT语句中（不包含外表的场景下），对目标表中char和varchar类型的列上插入超长字符串时，系统会自动按照目标表中相应列定义的最大长度对超长字符串进行截断。 如果向字符集为字节类型编码（SQL_ASCII，LATIN1等）的数据库中插入多字节字符数据（如汉字等），且字符数据跨越截断位置，这种情况下，按照字节长度自动截断，自动截断后会在尾部产生非预期结果。如果用户有对于截断结果正确性的要求，建议用户采用UTF8等能够按照字符截断的输入字符集作为数据库的编码集。

语法格式 1 2 3 4 5 6 7 8 91011121314151617181920212223242526 [ WITH [ RECURSIVE ] with_query [, ...] ]INSERT [ IGNORE | OVERWRITE ] INTO table_name [ AS alias ] [ ( column_name [, ...] ) ] { DEFAULT VALUES | VALUES {( { expression | DEFAULT } [, ...] ) }[, ...] | query } [ ON DUPLICATE KEY duplicate_action | ON CONFLICT [ conflict_target ] conflict_action ] [ RETURNING {* | {output_expression [ [ AS ] output_name ] }[, ...]} ];where duplicate_action can be: UPDATE { column_name = { expression | DEFAULT } | ( column_name [, ...] ) = ( { expression | DEFAULT } [, ...] ) } [, ...]and conflict_target can be one of: ( { index_column_name | ( index_expression ) } [ COLLATE collation ] [ opclass ] [, ...] ) [ WHERE index_predicate ] ON CONSTRAINT constraint_nameand conflict_action is one of: DO NOTHING DO UPDATE SET { column_name = { expression | DEFAULT } | ( column_name [, ...] ) = ( { expression | DEFAULT } [, ...] ) } [, ...] [ WHERE condition ]

参数说明 WITH [ RECURSIVE ] with_query [, ...] 用于声明一个或多个可以在主查询中通过名字引用的子查询，相当于临时表。 如果声明了RECURSIVE，那么允许SELECT子查询通过名字引用它自己。 其中with_query的详细格式为： with_query_name [ ( column_name [, ...] ) ] AS( {select | values | insert | update | delete} ) – with_query_name指定子查询生成的结果集名字，在查询中可使用该名称访问子查询的结果集。 – column_name指定子查询结果集中显示的列名。 – 每个子查询可以是SELECT，VALUES，INSERT，UPDATE或DELETE语句。 IGNORE 用于主键或者唯一约束冲突时忽略冲突的数据。 详细介绍参见UPSERT。 OVERWRITE 用于标识覆盖式插入方式，使用此种插入方式执行结束后，目标原数据被清空，只存在新插入的数据。 OVERWRITE支持指定列插入的功能，其他列为默认值，若无默认值则为NULL。 OVERWRITE不要和INSERT INTO这类实时写入的操作并发，否则实时写入数据有被意外清理的风险。 OVERWRITE适用于大批量数据导入场景，不建议用于少量数据的插入场景。 避免对同一张表执行并发insert overwrite操作，否则会出现类似报错“tuple concurrently updated.”。 如果集群正在扩缩容，且INSERT OVERWRITE的写入表需要执行数据重分布，则INSERT OVERWRITE会清除当前数据，并自动将插入的数据按扩缩容后的节点来进行数据分布。如果INSERT OVERWRITE和该表的数据重分布过程同时执行，INSERT OVERWRITE会中断该表的数据重分布过程。 table_name 要插入数据的目标表名。 取值范围：已存在的表名。 AS 用于给目标表table_name指定别名。alias即为别名的名字。 column_name 目标表中的字段名： 字段名可以用子字段名或者数组下标修饰。 没有在字段列表中出现的每个字段，将由系统默认值，或者声明时的默认值填充，若都没有则用NULL填充。例如，向一个复合类型中的某些字段插入数据的话，其他字段将是NULL。 目标字段（column_name）可以按顺序排列。如果没有列出任何字段，则默认全部字段，且顺序为表声明时的顺序。 如果value子句和query中只提供了N个字段，则目标字段为前N个字段。 value子句和query提供的值在表中从左到右关联到对应列。 取值范围：已存在的字段名。 expression 赋予对应column的一个有效表达式或值： 向表中字段插入单引号时需要使用单引号自身进行转义。 如果插入行的表达式不是正确的数据类型，系统试图进行类型转换，若转换不成功，则插入数据失败，系统返回错误信息。 示例： 1 2 3 4 5 6 7 8 910111213141516171819202122 CREATE TABLE tt01 (id int,content varchar(50));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 tt01 values (1,'Jack say ''hello''');INSERT 0 1INSERT INTO tt01 values (2,'Rose do 50%');INSERT 0 1INSERT INTO tt01 values (3,'Lilei say ''world''');INSERT 0 1INSERT INTO tt01 values (4,'Hanmei do 100%');INSERT 0 1SELECT * FROM tt01; id | content----+------------------- 3 | Lilei say 'world' 4 | Hanmei do 100% 1 | Jack say 'hello' 2 | Rose do 50%(4 rows) DEFAULT 对应字段名的缺省值。如果没有缺省值，则为NULL。 query 一个查询语句（SELECT语句），将查询结果作为插入的数据。 ON DUPLICATE KEY 用于主键或者唯一约束冲突时更新冲突的数据。 duplicate_action指定更新列和更新的数据。 详细介绍参见UPSERT。 ON CONFLICT 用于主键或者唯一约束冲突时忽略或者更新冲突的数据。 conflict_target用于指定列名index_column_name 、包含多个列名的表达式index_expression或者约束名字constraint_name。作用是用于从列名、包含多个列名的表达式或者约束名推断是否有唯一索引。其中index_column_name和index_expression遵循CREATE INDEX的索引列格式。 conflict_action指定主键或者唯一约束冲突时执行的策略。有两种： DO NOTHING冲突忽略。 DO UPDATE SET冲突更新。 后面指定更新列和更新的数据。 详细介绍参见UPSERT。 RETURNING 返回实际插入的行，RETURNING列表的语法与SELECT的输出列表一致。 output_expression INSERT命令在每一行都被插入之后用于计算输出结果的表达式。 取值范围：该表达式可以使用table的任意字段。可以使用*返回被插入行的所有字段。 output_name 字段的输出名称。 取值范围：字符串，符合标识符命名规范。

to_timestamp(double precision) 描述：把UNIX纪元转换成时间戳。 返回值类型：timestamp with time zone 示例： 12345 SELECT to_timestamp(1284352323); to_timestamp ------------------------ 2010-09-13 12:32:03+08(1 row)

to_clob(char/nchar/varchar/nvarchar/varchar2/nvarchar2/text/raw) 描述：将RAW类型或者文本字符集类型CHAR、NCHAR、VARCHAR、VARCHAR2、NVARCHAR2、TEXT转成CLOB类型。 返回值类型：clob 示例： 12345 SELECT to_clob('ABCDEF'::RAW(10)); to_clob --------- ABCDEF(1 row) 12345 SELECT to_clob('hello111'::CHAR(15)); to_clob ---------- hello111(1 row) 12345 SELECT to_clob('gauss123'::NCHAR(10)); to_clob ---------- gauss123(1 row) 12345 SELECT to_clob('gauss234'::VARCHAR(10)); to_clob ---------- gauss234(1 row) 12345 SELECT to_clob('gauss345'::VARCHAR2(10)); to_clob ---------- gauss345(1 row) 12345 SELECT to_clob('gauss456'::NVARCHAR2(10)); to_clob ---------- gauss456(1 row) 12345 SELECT to_clob('World222!'::TEXT); to_clob ----------- World222!(1 row)

to_timestamp(text, text) 描述：将字符串类型的值转换为指定格式的时间戳。 返回值类型：timestamp 示例： 12345 SELECT to_timestamp('05 Dec 2000', 'DD Mon YYYY'); to_timestamp--------------------- 2000-12-05 00:00:00(1 row) 表1显示了可以用于格式化数值的模板模式，适用于函数to_number。

to_char (datetime/interval [, fmt]) 描述：将一个DATE、TIMESTAMP、TIMESTAMP WITH TIME ZONE或者TIMESTAMP WITH LOCAL TIME ZONE类型的DATETIME或者INTERVAL值按照fmt指定的格式转换为VARCHAR类型。 可选参数fmt可以为以下几类：日期、时间、星期、季度和世纪。每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：HH、MI、SS、YYYY、MM、DD。 模板可以有修饰词，常用的修饰词是FM，可以用来抑制前导的零或尾随的空白。 返回值类型：varchar 示例： 12345 SELECT to_char(current_timestamp,'HH12:MI:SS'); to_char ---------- 10:19:26(1 row) 12345 SELECT to_char(current_timestamp,'FMHH12:FMMI:FMSS'); to_char ---------- 10:19:46(1 row)

to_date(string, fmt) 描述：将字符串string按fmt指定格式转化为DATE类型的值。该函数不能直接支持CLOB类型，但是CLOB类型的参数能够通过隐式转换实现。 返回值类型：date 示例： 12345 SELECT TO_DATE('05 Dec 2010','DD Mon YYYY'); to_date --------------------- 2010-12-05 00:00:00(1 row)

to_number ( expr [, fmt]) 描述：将expr按指定格式转换为一个NUMBER类型的值。 类型转换格式请参考表1。 转换十六进制字符串为十进制数字时，最多支持16个字节的十六进制字符串转换为无符号数。 转换十六进制字符串为十进制数字时，格式字符串中不允许出现除“x”或“X”以外的其他字符，否则报错。 返回值类型：number 示例： 12345 SELECT to_number('12,454.8-', '99G999D9S'); to_number ----------- -12454.8(1 row)

rawtohex(string) 描述：将RAW数据类型值转换为相应的十六进制表示的字符串。string中的每个字节都被转换一个双字节的字符串。 结果为输入字符的A CS II码，以十六进制表示。 返回值类型：varchar 示例： 12345 SELECT rawtohex('1234567'); rawtohex ---------------- 31323334353637(1 row)

to_char (integer/number[, fmt]) 描述：将一个整型或者浮点类型的值转换为指定格式的字符串。 可选参数fmt可以为以下几类：十进制字符、“分组”符、正负号和货币符号，每类都可以有不同的模板，模板之间可以合理组合，常见的模板有：9、0、,（千分隔符）、.（小数点）。 模板可以有类似FM的修饰词，但FM不抑制由模板0指定而输出的0。 要将整型类型的值转换成对应16进制值的字符串，使用模板X或x。 返回值类型：varchar 示例： 12345 SELECT to_char(1485,'9,999'); to_char --------- 1,485(1 row) 12345 SELECT to_char( 1148.5,'9,999.999'); to_char ------------ 1,148.500(1 row) 12345 SELECT to_char(148.5,'990999.909'); to_char ------------- 0148.500(1 row) 12345 SELECT to_char(123,'XXX'); to_char --------- 7B(1 row)

pg_cancel_backend(pid int) 描述：取消一个后端的当前查询。 返回值类型：boolean 备注：pg_cancel_backend向由pid标识的后端进程发送一个查询取消（SIGINT）信号。一个活动的后端进程的PID可以从pg_stat_activity视图的pid字段找到，或者在服务器上用ps列出数据库进程。 示例： 1 2 3 4 5 6 7 8 91011 SELECT pid FROM pg_stat_activity WHERE stmt_type ='RESET'; pid----------------- 281471222065200(1 row)SELECT pg_cancel_backend(281471222065200); pg_cancel_backend------------------- t(1 row)

pg_wlm_jump_queue(pid int) 描述：调整任务到CN队列的最前端。 返回值类型：boolean 备注：如果成功，函数返回true，否则返回false。 示例： 1 2 3 4 5 6 7 8 91011 SELECT pid FROM pg_stat_activity WHERE stmt_type ='RESET'; pid----------------- 281471222065200(1 row)SELECT pg_wlm_jump_queue(281471222065200); pg_wlm_jump_queue------------------- t(1 row)

pg_terminate_query(queryId int) 描述：终止一个后端的当前查询。该函数8.1.2及以上版本支持。 返回值类型：boolean 示例： 1 2 3 4 5 6 7 8 9101112 SELECT query_id FROM pgxc_stat_activity WHERE stmt_type ='RESET'; query_id---------- 0 0(2 rows)SELECT pg_terminate_query(0); pg_terminate_query-------------------- f(1 row)

pg_terminate_backend(pid int) 描述：终止一个后台线程。 返回值类型：boolean 备注：如果成功，函数返回true，否则返回false。 示例： 1 2 3 4 5 6 7 8 910111213141516171819 SELECT pid FROM pg_stat_activity; pid ----------------- 140657876268816 140433774061312 140433587902208 140433656592128 140433723717376 140433637189376 140433552770816 140433481983744 140433349310208(9 rows)SELECT pg_terminate_backend(140657876268816); pg_terminate_backend ---------------------- t(1 row)

pg_cancel_query(queryId int) 描述：取消一个后端的当前查询。该函数8.1.2及以上版本支持。 返回值类型：boolean 备注：pg_cancel_query向由query_id标识的后端进程发送一个查询取消（SIGINT）信号。一个活动的后端进程的query_id可以从pg_stat_activity视图的query_id字段找到。 示例： 1 2 3 4 5 6 7 8 9101112 SELECT query_id FROM pgxc_stat_activity WHERE stmt_type ='RESET'; query_id---------- 0 0(2 rows)SELECT pg_cancel_query(0); pg_cancel_query----------------- f(1 row)

pgxc_cancel_query(queryId int) 描述：取消当前集群下正在执行的查询。该函数8.1.2及以上版本支持。 返回值类型：boolean 备注：如果所有节点的查询均已取消，函数返回true，否则返回false。 示例： 1 2 3 4 5 6 7 8 9101112 SELECT query_id FROM pgxc_stat_activity WHERE stmt_type ='RESET'; query_id---------- 0 0(2 rows)SELECT pgxc_cancel_query(0); pgxc_cancel_query------------------- f(1 row)

pgxc_terminate_query(queryId int) 描述：终止当前集群下正在执行的查询。该函数8.1.2及以上版本支持。 返回值类型：boolean 示例： 1 2 3 4 5 6 7 8 91011 SELECT query_id FROM pgxc_stat_activity; query_id ----------------- 72339069014638631(1 rows)SELECT pgxc_terminate_query(72339069014638631); pgxc_terminate_query ---------------------- t(1 row)

checksum(expression) 描述：返回所有输入值的CHECKSUM值。使用该函数可以用来验证 GaussDB (DWS)数据库（不支持GaussDB(DWS)之外的其他数据库）的备份恢复或者数据迁移操作前后表中的数据是否相同。在备份恢复或者数据迁移操作前后都需要用户通过手工执行SQL命令的方式获取执行结果，通过对比获取的执行结果判断操作前后表中的数据是否相同。 对于大表，CHECKSUM函数可能会需要很长时间。 如果某两表的CHECKSUM值不同，则表明两表的内容是不同的。由于CHECKSUM函数中使用散列函数不能保证无冲突，因此两个不同内容的表可能会得到相同的CHECKSUM值，存在这种情况的可能性较小。对于列进行的CHECKSUM也存在相同的情况。 对于时间类型timestamp, timestamptz和smalldatetime，计算CHECKSUM值时请确保时区设置一致。 若计算某列的CHECKSUM值，且该列类型可以默认转为TEXT类型，则expression为列名。 若计算某列的CHECKSUM值，且该列类型不能默认转为TEXT类型，则expression为列名::TEXT。 若计算所有列的CHECKSUM值，则expression为表名::TEXT。 可以默认转换为TEXT类型的类型包括：char, name, int8, int2, int1, int4, raw, pg_node_tree, float4, float8, bpchar, varchar, nvarchar2, date, timestamp, timestamptz, numeric, smalldatetime，其他类型需要强制转换为TEXT。 返回类型：numeric 示例： 表中可以默认转为TEXT类型的某列的CHECKSUM值： 12345 SELECT CHECKSUM(inv_quantity_on_hand) FROM tpcds.inventory; checksum ------------------- 24417258945265247(1 row) 表中不能默认转为TEXT类型的某列的CHECKSUM值（注意此时CHECKSUM参数是列名::TEXT）： 12345 SELECT CHECKSUM(inv_quantity_on_hand::TEXT) FROM tpcds.inventory; checksum ------------------- 24417258945265247(1 row) 表中所有列的CHECKSUM值。注意此时CHECKSUM参数是表名::TEXT，且表名前不加Schema： 12345 SELECT CHECKSUM(inventory::TEXT) FROM tpcds.inventory; checksum ------------------- 25223696246875800(1 row)

variance(expexpression,ression) 描述：var_samp的别名。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision类型，其他输入返回numeric类型。 示例： 12345 SELECT VARIANCE(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; variance -------------------- 83650.730277028768(1 row)

stddev_pop(expression) 描述：总体标准差。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision，其他输入返回numeric。 示例： 12345 SELECT STDDEV_POP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; stddev_pop ------------------ 289.224294957556(1 row)

var_pop(expression) 描述：总体方差（总体标准差的平方）。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision类型，其他输入返回numeric类型。 示例： 12345 SELECT VAR_POP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; var_pop -------------------- 83650.692793695475(1 row)

var_samp(expression) 描述：样本方差（样本标准差的平方）。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision类型，其他输入返回numeric类型。 示例： 12345 SELECT VAR_SAMP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; var_samp -------------------- 83650.730277028768(1 row)

bit_and(expression) 描述：所有非NULL输入值的按位与（AND），如果全部输入值皆为NULL，那么结果也为NULL 。 返回类型：和参数数据类型相同。 示例： 12345 SELECT BIT_AND(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; bit_and --------- 0(1 row)

group_concat(expression [ORDER BY {col_name | expr} [ASC | DESC]] [SEPARATOR str_val]) 描述：将列数据使用指定的str_val分隔符，按照ORDER BY子句指定的排序方式拼接成字符串，ORDER BY子句必须指定排序方式，不支持ORDER BY 1的写法。 expression：必选，指定列名或基于列的有效表达式，不支持DISTINCT关键字和VARIADIC参数。 str_val：可选，指定的分隔符，可以是字符串常数或基于分组列的确定性表达式。缺省时表示分隔符为逗号。 返回类型：text group_concat函数仅8.1.2及以上版本支持。 示例： 默认分隔符为逗号： 12345 SELECT group_concat(sname) FROM group_concat_test; group_concat------------------------------------------ ADAMS,FORD,JONES,KING,MILLER,SCOTT,SMITH(1 row) group_concat函数支持自定义分隔符： 12345 SELECT group_concat(sname separator ';') from group_concat_test; group_concat------------------------------------------ ADAMS;FORD;JONES;KING;MILLER;SCOTT;SMITH(1 row) group_concat函数支持ORDER BY子句，将列数据进行有序拼接： 12345 SELECT group_concat(sname order by snumber separator ';') FROM group_concat_test; group_concat------------------------------------------ MILLER;FORD;SCOTT;SMITH;KING;JONES;ADAMS(1 row)

bit_or(expression) 描述：所有非NULL输入值的按位或（OR），如果全部输入值皆为NULL，那么结果也为NULL。 返回类型：和参数数据类型相同 示例： 12345 SELECT BIT_OR(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; bit_or -------- 1023(1 row)

stddev(expression) 描述：stddev_samp的别名。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision，其他输入返回numeric。 示例： 12345 SELECT STDDEV(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; stddev ------------------ 289.224359757315(1 row)

stddev_samp(expression) 描述：样本标准差。 当入参类型为DOUBLE PRECISION时，入参取值范围为1.34E-154~1.34E+154，若数值超过取值范围则报错：value out of range: overflow。如果实际使用中不可避免入参超出范围，则使用cast函数强转该列类型为numeric。 返回类型：对于浮点类型的输入返回double precision，其他输入返回numeric。 示例： 12345 SELECT STDDEV_SAMP(inv_quantity_on_hand) FROM tpcds.inventory WHERE inv_warehouse_sk = 1; stddev_samp ------------------ 289.224359757315(1 row)

listagg(expression [, delimiter]) WITHIN GROUP(ORDER BY order-list) 描述：将聚集列数据按WITHIN GROUP指定的排序方式排列，并用delimiter指定的分隔符拼接成一个字符串。 expression：必选。指定聚集列名或基于列的有效表达式，不支持DISTINCT关键字和VARIADIC参数。 delimiter：可选。指定分隔符，可以是字符串常数或基于分组列的确定性表达式，缺省时表示分隔符为空。 order-list：必选。指定分组内的排序方式。 返回类型：text listagg是兼容Oracle 11g2的列转行聚集函数，可以指定OVER子句用作窗口函数。为了避免与函数本身WITHIN GROUP子句的ORDER BY造成二义性，listagg用作窗口函数时，OVER子句不支持ORDER BY的窗口排序或窗口框架。 示例： 聚集列是文本字符集类型： 1234567 SELECT deptno, listagg(ename, ',') WITHIN GROUP(ORDER BY ename) AS employees FROM emp GROUP BY deptno; deptno | employees --------+-------------------------------------- 10 | CLARK,KING,MILLER 20 | ADAMS,FORD,JONES,SCOTT,SMITH 30 | ALLEN,BLAKE,JAMES,MARTIN,TURNER,WARD(3 rows) 聚集列是整型： 1234567 SELECT deptno, listagg(mgrno, ',') WITHIN GROUP(ORDER BY mgrno NULLS FIRST) AS mgrnos FROM emp GROUP BY deptno; deptno | mgrnos --------+------------------------------- 10 | 7782,7839 20 | 7566,7566,7788,7839,7902 30 | 7698,7698,7698,7698,7698,7839(3 rows) 聚集列是浮点类型： 123456789 SELECT job, listagg(bonus, '($); ') WITHIN GROUP(ORDER BY bonus DESC) || '($)' AS bonus FROM emp GROUP BY job; job | bonus ------------+------------------------------------------------- CLERK | 10234.21($); 2000.80($); 1100.00($); 1000.22($) PRESIDENT | 23011.88($) ANALYST | 2002.12($); 1001.01($) MANAGER | 10000.01($); 2399.50($); 999.10($) SALESMAN | 1000.01($); 899.00($); 99.99($); 9.00($)(5 rows) 聚集列是时间类型： 1234567 SELECT deptno, listagg(hiredate, ', ') WITHIN GROUP(ORDER BY hiredate DESC) AS hiredates FROM emp GROUP BY deptno; deptno | hiredates --------+------------------------------------------------------------------------------------------------------------------------------ 10 | 1982-01-23 00:00:00, 1981-11-17 00:00:00, 1981-06-09 00:00:00 20 | 2001-04-02 00:00:00, 1999-12-17 00:00:00, 1987-05-23 00:00:00, 1987-04-19 00:00:00, 1981-12-03 00:00:00 30 | 2015-02-20 00:00:00, 2010-02-22 00:00:00, 1997-09-28 00:00:00, 1981-12-03 00:00:00, 1981-09-08 00:00:00, 1981-05-01 00:00:00(3 rows) 聚集列是时间间隔类型： 1234567 SELECT deptno, listagg(vacationTime, '; ') WITHIN GROUP(ORDER BY vacationTime DESC) AS vacationTime FROM emp GROUP BY deptno; deptno | vacationtime --------+------------------------------------------------------------------------------------ 10 | 1 year 30 days; 40 days; 10 days 20 | 70 days; 36 days; 9 days; 5 days 30 | 1 year 1 mon; 2 mons 10 days; 30 days; 12 days 12:00:00; 4 days 06:00:00; 24:00:00(3 rows) 分隔符缺省时，默认为空： 1234567 SELECT deptno, listagg(job) WITHIN GROUP(ORDER BY job) AS jobs FROM emp GROUP BY deptno; deptno | jobs --------+---------------------------------------------- 10 | CLERKMANAGERPRESIDENT 20 | ANALYSTANALYSTCLERKCLERKMANAGER 30 | CLERKMANAGERSALESMANSALESMANSALESMANSALESMAN(3 rows) listagg作为窗口函数时，OVER子句不支持ORDER BY的窗口排序，listagg列为对应分组的有序聚集： 1 2 3 4 5 6 7 8 9101112131415161718 SELECT deptno, mgrno, bonus, listagg(ename,'; ') WITHIN GROUP(ORDER BY hiredate) OVER(PARTITION BY deptno) AS employees FROM emp; deptno | mgrno | bonus | employees --------+-------+----------+------------------------------------------- 10 | 7839 | 10000.01 | CLARK; KING; MILLER 10 | | 23011.88 | CLARK; KING; MILLER 10 | 7782 | 10234.21 | CLARK; KING; MILLER 20 | 7566 | 2002.12 | FORD; SCOTT; ADAMS; SMITH; JONES 20 | 7566 | 1001.01 | FORD; SCOTT; ADAMS; SMITH; JONES 20 | 7788 | 1100.00 | FORD; SCOTT; ADAMS; SMITH; JONES 20 | 7902 | 2000.80 | FORD; SCOTT; ADAMS; SMITH; JONES 20 | 7839 | 999.10 | FORD; SCOTT; ADAMS; SMITH; JONES 30 | 7839 | 2399.50 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN 30 | 7698 | 9.00 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN 30 | 7698 | 1000.22 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN 30 | 7698 | 99.99 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN 30 | 7698 | 1000.01 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN 30 | 7698 | 899.00 | BLAKE; TURNER; JAMES; MARTIN; WARD; ALLEN(14 rows)