华为云用户手册

数据仓库服务 GaussDB(DWS)-EXTRACT:epoch

epoch 如果source为timestamp with time zone，表示自1970-01-01 00:00:00-00 UTC以来的秒数（结果可能是负数）；如果source为date和timestamp，表示自1970-01-01 00:00:00-00当地时间以来的秒数；如果source为interval，表示时间间隔的总秒数。 12345 SELECT EXTRACT(epoch FROM TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40.12-08'); date_part -------------- 982384720.12(1 row) 12345 SELECT EXTRACT(epoch FROM interval '5 days 3 hours'); date_part ----------- 442800(1 row) 将epoch值转换为时间戳的方法。 12345 SELECT TIMESTAMP WITH TIME ZONE 'epoch' + 982384720.12 * interval '1 second' AS RESULT; result --------------------------- 2001-02-17 12:38:40.12+08(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXTRACT:month

month 如果source为timestamp，表示一年里的月份数（1-12）。 12345 SELECT EXTRACT(month FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 2(1 row) 如果source为interval，表示月的数目，然后对12取模（0-11）。 12345 SELECT EXTRACT(month FROM interval '2 years 13 months'); date_part ----------- 1(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXTRACT:day

day 如果source为timestamp，表示月份里的日期（1-31）。 12345 SELECT EXTRACT(day FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 16(1 row) 如果source为interval，表示天数。 12345 SELECT EXTRACT(day FROM INTERVAL '40 days 1 minute'); date_part ----------- 40(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXTRACT:isoyear

isoyear 日期中的ISO 8601标准年（不适用于间隔）。每个带有星期一开始的周中包含1月4日的ISO年，所以在年初的1月或12月下旬的ISO年可能会不同于阳历的年。详细信息请参见后续的week描述。 12345 SELECT EXTRACT(isoyear FROM DATE '2006-01-01'); date_part ----------- 2005(1 row) 12345 SELECT EXTRACT(isoyear FROM DATE '2006-01-02'); date_part ----------- 2006(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXTRACT:week

week 该天在所在的年份里是第几周。ISO 8601定义一年的第一周包含该年的一月四日（ISO-8601 的周从星期一开始）。换句话说，一年的第一个星期四在第一周。在ISO定义里，一月的头几天可能是前一年的第52或者第53周，十二月的后几天可能是下一年第一周。比如，2005-01-01是2004年的第53周，而2006-01-01是2005年的第52周，2012-12-31是2013年的第一周。建议isoyear字段和week一起使用以得到一致的结果。 12345 SELECT EXTRACT(week FROM TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 7(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-DO:示例

示例授予用户webuser对模式tpcds下视图的所有操作权限： 12345678 DO $$DECLARE r record;BEGIN FOR r IN SELECT c.relname,n.nspname FROM pg_class c,pg_namespace n WHERE c.relnamespace = n.oid AND n.nspname = 'tpcds' AND relkind IN ('r','v') LOOP EXECUTE 'GRANT ALL ON ' || quote_ident(r.table_schema) || '.' || quote_ident(r.table_name) || ' TO webuser'; END LOOP;END$$;

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXPLAIN PLAN:参数说明

参数说明 PLAN 表示需要将计划信息存储于PLAN_TABLE中，存储成功将返回“EXPLAIN SUC CES S”。 STATEMENT_ID 用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。用户在执行EXPLAIN PLAN时，如果没有进行SET STATEMENT_ID，则默认为空值。同时，用户可输入的STATEMENT_ID最大长度为30个字节，超过长度将会产生报错。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXPLAIN PLAN:注意事项

注意事项 EXPLAIN PLAN不支持在DN上执行。对于执行错误的SQL无法进行计划信息的收集。 PLAN_TABLE中的数据是session级生命周期并且session隔离和用户隔离，用户只能看到当前session、当前用户的数据。 PLAN_TABLE无法与GDS外表进行关联查询。对于不能下推的查询，无法收集到具体的object信息，object只能收集到REMOTE_QUERY或CTE等信息。详见示例 2。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-EXPLAIN PLAN:示例 2

示例 2 对于不能下推的查询，执行explain plan后plan_table中object仅收集到REMOTE_QUERY或CTE等信息。优化器生成下发语句的计划，此时仅能收集到REMOTE_QUERY。 12345 explain plan set statement_id = 'test remote query' for select current_user from customer; 查询PLAN_TABLE。 1 SELECT * FROM PLAN_TABLE;

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-REINDEX:示例

示例重建分区表customer_address分区P1的分区索引： DROP TABLE IF EXISTS customer_address;CREATE TABLE customer_address( ca_address_sk INTEGER NOT NULL , ca_address_id CHARACTER(16) NOT NULL , ca_street_number CHARACTER(10) , ca_street_name CHARACTER varying(60) , ca_street_type CHARACTER(15) , ca_suite_number CHARACTER(10) )DISTRIBUTE BY HASH (ca_address_sk)PARTITION BY RANGE(ca_address_sk)( PARTITION P1 VALUES LESS THAN(2450815), PARTITION P2 VALUES LESS THAN(2451179), PARTITION P3 VALUES LESS THAN(2451544), PARTITION P4 VALUES LESS THAN(MAXVALUE));CREATE INDEX customer_address_index on customer_address(CA_ADDRESS_SK) LOCAL;REINDEX TABLE customer_address PARTITION P1;

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-PREPARE TRANSACTION:功能描述

功能描述为两阶段提交准备当前事务。在这个命令之后，该事务不再与当前会话关联。相反，它的状态完全保存在磁盘上，并且它有很高的可能性被提交成功，即使是在请求提交之前数据库发生了崩溃也如此。一旦被准备好，事务稍后就可以用COMMIT PREPARED或 ROLLBACK PREPARED命令分别进行提交或者回滚。这些命令可以从任何会话中发出，而不仅是执行原始事务的会话。从发出命令的会话的角度来看，PREPARE TRANSACTION不同于ROLLBACK：在执行它之后，就不再有活跃的当前事务了，并且预备事务的效果也不再可见 (如果该事务被提交，其效果会重新变得可见)。如果PREPARE TRANSACTION因为某些原因失败，那么它就会变成一个ROLLBACK，当前事务被取消。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-REINDEX:参数说明

参数说明 INDEX 重新建立指定的索引。 TABLE 重新建立指定表的所有索引，如果表有从属的"TOAST"表，则这个表也会重建索引。 DATABASE 重建当前数据库里的所有索引。 SYSTEM 在当前数据库上重建所有系统表上的索引。不会处理在用户表上的索引。 name 需要重建索引的索引、表、数据库的名称。表和索引可以有模式修饰。 REINDEX DATABASE和SYSTEM只能重建当前数据库的索引，所以name必须和当前数据库名称相同。 FORCE 无效选项，会被忽略。 partition_name 需要重建索引的分区的名字或者索引分区的名字。取值范围：如果前面是REINDEX INDEX，则这里应该指定索引分区的名字；如果前面是REINDEX TABLE，则这里应该指定分区的名字； REINDEX DATABASE和SYSTEM这种形式的重建索引不能在事务块中执行。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-SET SESSION AUTHORIZATION:语法格式

语法格式为当前会话设置会话用户标识符和当前用户标识符。 1 SET [ SESSION | LOCAL ] SESSION AUTHORIZATION role_name PASSWORD 'password'; 重置会话和当前用户标识符为初始认证的用户名。 12 {SET [ SESSION | LOCAL ] SESSION AUTHORIZATION DEFAULT | RESET SESSION AUTHORIZATION};

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-DELETE:语法格式

语法格式 12345 [ WITH [ RECURSIVE ] with_query [, ...] ]DELETE FROM [ ONLY ] table_name [ * ] [ [ AS ] alias ] [ USING using_list ] [ WHERE condition | WHERE CURRENT OF cursor_name ] [ RETURNING { * | { output_expr [ [ AS ] output_name ] } [, ...] } ];

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-DELETE:参数说明

参数说明 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语句。 ONLY 如果指定ONLY则只有该表被删除；如果没有声明，则该表和它的所有子表将都被删除。 table_name 目标表的名字（可以有模式修饰）。取值范围：已存在的表名。 alias 目标表的别名。取值范围：字符串，符合标识符命名规范。 using_list using子句。 condition 一个返回boolean值的表达式，用于判断哪些行需要被删除。 WHERE CURRENT OF cursor_name 当前不支持，仅保留语法接口。 output_expr DELETE命令删除行之后计算输出结果的表达式。该表达式可以使用表的任意字段。可以使用*返回被删除行的所有字段。 output_name 一个字段的输出名称。取值范围：字符串，符合标识符命名规范。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-DELETE:注意事项

注意事项要删除表中的数据，用户必须对它有DELETE权限。同样也必须有USING子句引用的表以及condition上读取的表的SELECT权限。对于复制表，仅支持两种场景下的DELETE操作：有主键约束的场景。执行计划能下推的场景。对于列存表，暂时不支持RETURNING子句。避免使用UPDATE/DELETE大批量刷新和删除数据，考虑使用TRUNCATE PARTITION/DROP PARTITION代替。更多开发设计规范参见总体开发设计规范。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-BEGIN:语法格式

语法格式开启匿名块 12345 [DECLARE [declare_statements]] BEGINexecution_statements END;/ 开启事务 1234567 BEGIN [ WORK | TRANSACTION ] [ { ISOLATION LEVEL { READ COMMITTED | READ UNCOMMITTED | SERIALIZABLE | REPEATABLE READ } | { READ WRITE | READ ONLY } } [, ...] ];

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-date_part

date_part date_part函数是在传统的Ingres函数的基础上制作的（该函数等效于SQL标准函数extract）： 1 date_part('field', source) 这里的field参数必须是一个字符串，而不是一个名字。有效的field与extract一样，详细信息请参见EXTRACT。示例： 12345 SELECT date_part('day', TIMESTAMP '2001-02-16 20:38:40'); date_part ----------- 16(1 row) 12345 SELECT date_part('hour', interval '4 hours 3 minutes'); date_part ----------- 4(1 row) 父主题：时间、日期处理函数和操作符

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-UPDATE:参数说明

参数说明 table_name 要更新的表名，可以使用模式修饰。取值范围：已存在的表名称。 alias 目标表的别名。取值范围：字符串，符合标识符命名规范。 column_name 要修改的字段名。支持使用目标表的表名加字段名来引用这个字段。例如： 1 UPDATE foo SET foo.col_name = ' GaussDB '; 支持使用目标表的别名加字段名来引用这个字段。例如： 1 UPDATE foo AS f SET f.col_name = 'GaussDB'; 取值范围：已存在的字段名。 expression 赋给字段的值或表达式。 DEFAULT 用对应字段的缺省值填充该字段。如果没有缺省值，则为NULL。 sub_query 子查询。使用同一数据库里其他表的信息来更新一个表可以使用子查询的方法。其中SELECT子句具体介绍请参考SELECT。 from_list 一个表的表达式列表，允许在WHERE条件里使用其他表的字段。与在一个SELECT语句的FROM子句里声明表列表类似。目标表绝对不能出现在from_list里，除非在使用一个自连接（此时它必须以from_list的别名出现）。 condition 一个返回boolean类型结果的表达式。只有这个表达式返回true的行才会被更新。 output_expression 在所有需要更新的行都被更新之后，UPDATE命令用于计算返回值的表达式。取值范围：使用任何table以及FROM中列出的表的字段。*表示返回所有字段。 output_name 字段的返回名称。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-UPDATE:语法格式

语法格式 1 2 3 4 5 6 7 8 91011121314 UPDATE [ ONLY ] table_name [ * ] [ [ AS ] alias ]SET {column_name = { expression | DEFAULT } |( column_name [, ...] ) = {( { expression | DEFAULT } [, ...] ) |sub_query }}[, ...] [ FROM from_list] [ WHERE condition ] [ RETURNING {* | {output_expression [ [ AS ] output_name ]} [, ...] }];where sub_query can be:SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]{ * | {expression [ [ AS ] output_name ]} [, ...] }[ FROM from_item [, ...] ][ WHERE condition ][ GROUP BY grouping_element [, ...] ][ HAVING condition [, ...] ]

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-UPDATE:注意事项

注意事项要修改表，用户必须对该表有UPDATE权限。对expression或condition条件里涉及到的任何表要有SELECT权限。不允许对表的分布列（distribute column）进行修改。对于列存表，暂时不支持RETURNING子句。列存表不支持结果不确定的更新（non-deterministic update）。试图对列存表用多行数据更新一行时会报错。列存表的更新操作，旧记录空间不会回收，需要执行VACUUM FULL table_name进行清理。 UPDATE操作频繁的表不建议创建为复制表。对于列存表，支持轻量化UPDATE操作。轻量化UPDATE只重写更新列，减少空间使用量。列存轻量化UPDATE通过GUC参数enable_light_colupdate控制是否开启。列存轻量化UPDATE在以下场景不能使用：更新索引列，更新主键列，更新分区列，更新PCK列和在线扩容，会自动转化为普通UPDATE方式。避免使用UPDATE/DELETE大批量刷新和删除数据，考虑使用TRUNCATE PARTITION/DROP PARTITION代替。避免UPDATE/UPSERT并发更新同一张列存表。更多开发设计规范参见总体开发设计规范。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-START TRANSACTION:语法格式

语法格式格式一：START TRANSACTION格式 1234567 START TRANSACTION [ { ISOLATION LEVEL { READ COMMITTED | READ UNCOMMITTED | SERIALIZABLE | REPEATABLE READ } | { READ WRITE | READ ONLY } } [, ...] ]; 格式二：BEGIN格式 1234567 BEGIN [ WORK | TRANSACTION ] [ { ISOLATION LEVEL { READ COMMITTED | READ UNCOMMITTED | SERIALIZABLE | REPEATABLE READ } | { READ WRITE | READ ONLY } } [, ...] ];

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-START TRANSACTION:参数说明

参数说明 WORK | TRANSACTION BEGIN格式中的可选关键字，没有实际作用。 ISOLATION LEVEL 指定事务隔离级别，它决定当一个事务中存在其他并发运行事务时它能够看到什么数据。在事务中第一个数据修改语句（INSERT，DELETE，UPDATE，FETCH，COPY）执行之后，事务隔离级别就不能再次设置。取值范围： READ COMMITTED：读已提交隔离级别，只能读到已经提交的数据，而不会读到未提交的数据。这是缺省值。 READ UNCOMMITTED：读未提交隔离级别，GaussDB(DWS)不支持READ UNCOMMITTED，如果设置了READ UNCOMMITTED，实际上使用的是READ COMMITTED。 REPEATABLE READ：可重复读隔离级别，仅看到事务开始之前提交的数据，它不能看到未提交的数据，以及在事务执行期间由其它并发事务提交的修改。 SERIALIZABLE：事务可序列化，GaussDB(DWS)不支持SERIALIZABLE，如果设置了SERIALIZABLE，实际上使用的是REPEATABLE READ。 READ WRITE | READ ONLY 指定事务访问模式（读/写或者只读）。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-START TRANSACTION:示例

示例以默认方式启动事务： 1234 START TRANSACTION;CREATE TABLE IF NOT EXISTS table1 (a int,b int);SELECT * FROM table1;END; 以隔离级别为READ COMMITTED，读/写方式启动事务： 1234 START TRANSACTION ISOLATION LEVEL READ COMMITTED READ WRITE;CREATE TABLE IF NOT EXISTS table1 (a int,b int);SELECT * FROM table1;COMMIT;

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-DROP SCHEMA:注意事项

注意事项只有模式的所有者或者被授予了模式DROP权限的用户有权限执行DROP SCHEMA命令，系统管理员默认拥有此权限。不得随意删除pg_temp或pg_toast_temp开头的模式，这些模式是系统内部使用的，如果删除，可能导致无法预知的结果。无法删除当前模式。如果要删除当前模式，须切换到其他模式下。 DROP对象操作（如DATABASE、USER/ROLE、SCHEMA、TABLE、VIEW等对象）存在数据丢失风险，尤其含带CASCADE级联删除场景，会将关联的对象一并删除，操作需谨慎，操作前需考虑数据备份。更多开发设计规范参见总体开发设计规范。

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-文本检索函数:to_tsvector([ config regconfig , ] document text)

to_tsvector([ config regconfig , ] document text) 描述：去除文件信息，并转换为tsvector类型。返回类型：tsvector 示例： 12345 SELECT to_tsvector('english', 'The Fat Rats'); to_tsvector ----------------- 'fat':2 'rat':3(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-文本检索函数:ts_rank([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ])

ts_rank([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ]) 描述：文档查询排名。返回类型：float4 示例： 12345 SELECT ts_rank('hello world'::tsvector, 'world'::tsquery); ts_rank ---------- .0607927(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-文本检索函数:plainto_tsquery([ config regconfig , ] query text)

plainto_tsquery([ config regconfig , ] query text) 描述：产生tsquery类型的词汇，并忽略标点。返回类型：tsquery 示例： 12345 SELECT plainto_tsquery('english', 'The Fat Rats'); plainto_tsquery ----------------- 'fat' & 'rat'(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-文本检索函数:setweight(tsvector, "char")

setweight(tsvector, "char") 描述：给tsvector类型的每个元素分配权值。返回类型：tsvector 示例： 12345 SELECT setweight('fat:2,4 cat:3 rat:5B'::tsvector, 'A'); setweight ------------------------------- 'cat':3A 'fat':2A,4A 'rat':5A(1 row)

数据仓库服务 GaussDB(DWS)
数据仓库服务 GaussDB(DWS)-文本检索函数:ts_rank_cd([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ])

ts_rank_cd([ weights float4[], ] vector tsvector, query tsquery [, normalization integer ]) 描述：排序文件查询使用覆盖密度。返回类型：float4 示例： 12345 SELECT ts_rank_cd('hello world'::tsvector, 'world'::tsquery); ts_rank_cd ------------ 0(1 row)

数据仓库服务 GaussDB(DWS)

共100000条

undefined

意见反馈

0/200

提交取消

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

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线