华为云用户手册

数据仓库服务 GAUSSDB(DWS)-数组表达式:IN

IN expression IN (value [, ...]) 右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果列表中的内容符合左侧表达式的结果，则IN的结果为true。如果没有相符的结果，则IN的结果为false。示例如下： 1 2 3 4 5 SELECT 8000+500 IN (10000, 9000) AS RESULT; result ---------- f (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-数组表达式:NOT IN

NOT IN expression NOT IN (value [, ...]) 右侧括号中的是一个表达式列表。左侧表达式的结果与表达式列表的内容进行比较。如果在列表中的内容没有符合左侧表达式结果的内容，则NOT IN的结果为true。如果有符合的内容，则NOT IN的结果为false。示例如下： 1 2 3 4 5 SELECT 8000+500 NOT IN (10000, 9000) AS RESULT; result ---------- t (1 row) 如果查询语句返回结果为空，或者表达式列表不符合表达式的条件且右侧表达式列表返回结果至少一处为空，则NOT IN的返回结果为null，而不是false。这样的处理方式和SQL返回空值的布尔组合规则是一致的。提示：在所有情况下X NOT IN Y等价于NOT(X IN Y)。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-产生XML内容:XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type

XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type 描述：从XML类型的值生成一个字符串。返回值类型：type，可以是character，character varying或text（或其别名）示例： 1 2 3 4 5 SELECT xmlserialize(content 'good' AS CHAR(10)); xmlserialize -------------- good (1 row)

数据仓库服务 GAUSSDB(DWS) XML函数
数据仓库服务 GAUSSDB(DWS)-ALTER DATABASE:示例

示例设置music数据库的连接数为10： 1 ALTER DATABASE music CONNECTION LIMIT= 10; 将music名称改为music1： 1 ALTER DATABASE music RENAME TO music1; 将数据库music1的所属者改为tom： 1 ALTER DATABASE music1 OWNER TO tom; 设置music1的表空间为PG_DEFAULT： 1 ALTER DATABASE music1 SET TABLESPACE PG_DEFAULT; 关闭在数据库music1上缺省的索引扫描： 1 ALTER DATABASE music1 SET enable_indexscan TO off; 重置enable_indexscan参数： 1 ALTER DATABASE music1 RESET enable_indexscan;

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-ALTER DATABASE:注意事项

注意事项只有拥有数据库所有者权限的用户才能执行ALTER DATABASE命令，系统管理员默认拥有此权限。如果是非系统管理员，针对所要修改属性的不同，对其还有以下权限约束：修改数据库名称，必须拥有CREATEDB权限。修改数据库所有者，当前用户必须是该数据库的所有者，且拥有CREATEDB权限，并确保该用户是新所有者角色的成员。修改数据库默认表空间，该用户必须是该数据库的所有者或系统管理员，且拥有新表空间的CREATE权限。该语法会从物理上将一个数据库原来缺省表空间上的表和索引移至新的表空间。注意不在缺省表空间的表和索引不受此影响。修改某个按数据库设置的相关参数，只有数据库所有者或者系统管理员可以改变这些设置。修改某个数据库对象隔离属性，只有数据库所有者或者系统管理员可以执行此操作。不能重命名当前使用的数据库，如果需要重新命名，须连接至其他数据库上。不支持修改现有数据库的兼容模式，只能在创建数据库时指定兼容模式，详情请参见CREATE DATABASE。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-ALTER DATABASE:参数说明

参数说明 database_name 需要修改属性的数据库名称。取值范围：字符串，要符合标识符的命名规范。 connlimit 数据库可以接收的最大并发连接数（管理员用户连接除外）。取值范围：整数，建议填写1~50的整数。-1（缺省）表示没有限制。 new_name 数据库的新名称。取值范围：字符串，要符合标识符的命名规范。 new_owner 数据库的新所有者。取值范围：字符串，有效的用户名。 configuration_parameter value 把指定的数据库会话参数值设置为给定的值。如果value是DEFAULT或者RESET，则在新的会话中使用系统的缺省设置。OFF关闭设置。取值范围：字符串， DEFAULT OFF RESET FROM CURRENT 根据当前会话连接的数据库设置该参数的值。 RESET configuration_parameter 重置指定的数据库会话参数值。 RESET ALL 重置全部的数据库会话参数值。修改数据库默认表空间，会将旧表空间中的所有表和索引转移到新表空间中，该操作不会影响其他非默认表空间中的表和索引。修改的数据库会话参数值，将在下一次会话中生效。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-ALTER DATABASE:语法格式

语法格式修改数据库的最大连接数。 1 2 ALTER DATABASE database_name [ [ WITH ] CONNECTION LIMIT connlimit ]; 修改数据库名称。 1 2 ALTER DATABASE database_name RENAME TO new_name; 若该数据库中有OBS冷热表，则不支持修改数据库名。修改数据库所属者。 1 2 ALTER DATABASE database_name OWNER TO new_owner; 修改数据库默认表空间。 1 2 ALTER DATABASE database_name SET TABLESPACE new_tablespace; 修改数据库的表空间时不能修改为OBS表空间。修改数据库指定会话参数值。 1 2 ALTER DATABASE database_name SET configuration_parameter { { TO | = } { value | DEFAULT } | FROM CURRENT }; 数据库配置参数重置。 1 2 ALTER DATABASE database_name RESET { configuration_parameter | ALL };

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-ALTER GROUP:语法格式

语法格式向用户组中添加用户。 1 2 ALTER GROUP group_name ADD USER user_name [, ... ]; 从用户组中删除用户。 1 2 ALTER GROUP group_name DROP USER user_name [, ... ]; 修改用户组的名称。 1 2 ALTER GROUP group_name RENAME TO new_name;

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-CREATE EXCEPT RULE:示例

示例创建一个异常规则集except_rule1并指定其blocktime规则阈值为3000秒，下盘空间为4000MB。 1 CREATE EXCEPT RULE except_rule1 WITH (blocktime=3000, spillsize=4000, action=abort); 创建一个异常规则集except_rule2并指定其memsize规则阈值为5000MB，默认所采取的异常规则操作为abort。 1 CREATE EXCEPT RULE except_rule2 WITH (memsize=3000); 创建一个资源池并绑定异常规则集except_rule3。 1 CREATE resource pool resource_pool_a1 WITH (except_rule='except_rule3');

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-CREATE EXCEPT RULE:参数说明

参数说明 rule_name 异常规则集名称。取值范围：字符串（1-64个字符），要符合标识符的命名规范。 blocktime 作业排队阻塞的最大时间，单位：秒。取值范围：数值型，-1，1~INT64_MAX。 elapsedtime 作业执行的最大时间，单位：秒。取值范围：数值型，-1，1~INT64_MAX。 allcputime 作业运行中使用的最大CPU时间，单位：秒。取值范围：数值型，-1，1~INT64_MAX。 cpuskewpercent 作业执行时的平均CPU使用率，单位：百分比。取值范围：数值型，-1，1~100。 cpuavgpercent 作业执行时的CPU使用倾斜率，单位：百分比。取值范围：数值型，-1，1~100。 spillsize 作业执行的最大下盘大小，单位：MB。取值范围：数值型，-1，1~INT64_MAX。 broadcastsize 作业执行的最大广播大小，单位：MB。取值范围：数值型，-1，1~INT64_MAX。 memsize 作业执行使用的最大内存大小，单位：MB。取值范围：数值型，-1，1~INT64_MAX。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-CREATE EXCEPT RULE:语法格式

语法格式 1 CREATE EXCEPT RULE rule_name WITH ({BLOCKTIME=value | ALLCPUTIME=value | ELAPSEDTIME=value | CPUSKEWPERCENT=value | SPILLSIZE=value | BROADCASTSIZE=value | MEMSIZE=value | CPUAVGPERCENT=value}[, ... ]);

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-CLEAN CONNECTION:参数说明

参数说明 CHECK 仅在节点列表为TO ALL时可以指定。如果指定该参数，会在清理连接之前检查数据库是否被其他会话连接访问。此参数主要用于DROP DATABASE之前的连接访问检查，如果发现有其他会话连接，则将报错并停止删除数据库。 FORCE 仅在节点列表为TO ALL时可以指定，如果指定该参数，所有和指定dbname和username相关的线程都会收到SIGTERM信号，然后被强制关闭。 COORDINATOR ( nodename [, ... ] } ) | NODE ( nodename [, ... ] ) | ALL 删除指定节点上的连接。有三种场景：删除指定CN上的连接。删除指定DN上的连接。删除所有节点上的连接，包括CN和DN。取值范围：可替换其中的nodename为已存在的节点名。 dbname 删除指定数据库上的连接。如果不指定，则删除所有数据库的连接。取值范围：已存在数据库名。 username 删除指定用户上的连接。如果不指定，则删除所有用户的连接。取值范围：已存在的用户。参数dbname和username必须至少指定一个。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-CLEAN CONNECTION:示例

示例删除数据库template1在dn1和dn2节点上的连接。 1 CLEAN CONNECTION TO NODE (dn1,dn2) FOR DATABASE template1; 删除用户jack在dn1节点上的连接。 1 CLEAN CONNECTION TO NODE (dn1) TO USER jack; 删除在数据库gaussdb上的所有连接。 1 CLEAN CONNECTION TO ALL FORCE FOR DATABASE gaussdb;

数据仓库服务 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) HLL函数和操作符
数据仓库服务 GAUSSDB(DWS)-冷热表用户函数:pg_lifecycle_table_data_distribute(table_name)

pg_lifecycle_table_data_distribute(table_name) 描述：查看某个冷热表的数据分布情况。 table_name为表名，不可缺省。返回值：record 示例：根据节点数量形成多条记录，如下示例为只有一个dn节点时w1表数据分布情况。 1 2 3 4 5 SELECT * FROM pg_catalog.pg_lifecycle_table_data_distribute('w1'); schemaname | tablename | nodename | hotpartition | coldpartition | switchablepartition | hotdatasize | colddatasize | switchabledatasize ------------+-----------+----------+--------------+---------------+---------------------+-------------+--------------+-------------------- public | w1 | dn_1 | p2 | p1 | | 80 KB | 0 bytes | 0 bytes (1 row)

数据仓库服务 GAUSSDB(DWS) 数据库对象函数
数据仓库服务 GAUSSDB(DWS)-冷热表用户函数:pg_lifecycle_node_data_distribute()

pg_lifecycle_node_data_distribute() 描述：查看所有冷热表数据分布情况。返回值：record 示例：数据库中当前存在两个冷热表，其数据分布情况如下。 1 2 3 4 5 6 SELECT * FROM pg_catalog.pg_lifecycle_node_data_distribute(); schemaname | tablename | nodename | hotpartition | coldpartition | switchablepartition | hotdatasize | colddatasize | switchabledatasize ------------+-----------+----------+--------------+---------------+---------------------+-------------+--------------+-------------------- public | w1 | dn_1 | p2 | p1 | | 81920 | 0 | 0 public | w2 | dn_1 | p2 | p1 | | 81920 | 0 | 0 (2 rows)

数据仓库服务 GAUSSDB(DWS) 数据库对象函数
数据仓库服务 GAUSSDB(DWS)-冷热表用户函数:pg_refresh_storage()

pg_refresh_storage() 描述：切换所有冷热表，将符合冷热切换规则的数据由热数据切换至冷数据（OBS中）。返回值类型：int 返回值字段： success_count int：切换成功的表个数 failed_count int：切换失败的表个数示例： 1 2 3 4 5 SELECT * FROM pg_refresh_storage(); success_count | failed_count ---------------+-------------- 1 | 0 (1 row)

数据仓库服务 GAUSSDB(DWS) 数据库对象函数
数据仓库服务 GAUSSDB(DWS)-冷热表用户函数:pg_obs_cold_refresh_time(table_name, time)

pg_obs_cold_refresh_time(table_name, time) 描述：用来修改冷热表的冷数据切换至OBS上的时间，默认为每日0点。 table_name为冷热表表名，类型为name，time为数据切换任务调度时间，类型为Time。返回值：SUCCESS，任务时间修改成功。示例： 1 2 3 4 5 SELECT * FROM pg_obs_cold_refresh_time('lifecycle_table', '06:30:00'); pg_obs_cold_refresh_time -------------------------- SUCCESS (1 row)

数据仓库服务 GAUSSDB(DWS) 数据库对象函数
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:collation for (any)

collation for (any) 描述：获取参数的排序。返回类型：text 备注：表达式collation for返回传递给他的值的排序。示例： 1 2 3 4 5 SELECT collation for (description) FROM pg_description LIMIT 1; pg_collation_for ------------------ "default" (1 row) 值可能是引号括起来的并且模式限制的。如果没有为参数表达式排序，则返回一个null值。如果参数不是排序的类型，则抛出一个错误。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_tabledef(table_oid)

pg_get_tabledef(table_oid) 描述：根据table_oid获取表定义。返回类型：text 示例：先通过系统表pg_class获取表customer_t2的OID，再使用此函数查询表customer_t2的定义，可获取创建表customer_t2时的表字段，表的存储方式（行存或列存）及表的分布方式等信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 SELECT oid FROM pg_class WHERE relname ='customer_t2'; oid ------- 17353 (1 row) SELECT * FROM pg_get_tabledef(17353); pg_get_tabledef -------------------------------------------- SET search_path = dbadmin; + CREATE TABLE customer_t2 ( + state_id character(2), + state_name character varying(40), + area_id numeric + ) + WITH (orientation=column, compression=low)+ DISTRIBUTE BY HASH(state_id) + TO GROUP group_version1; (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_typeof(any)

pg_typeof(any) 描述：获取任何值的数据类型。返回类型：regtype 备注： pg_typeof返回传递给他的值的数据类型OID。这可能有助于故障排除或动态构造SQL查询。声明此函数返回regtype，这是一个OID别名类型（请参考对象标识符类型）；这意味着它是一个为了比较而显示类型名字的OID。示例： 1 2 3 4 5 6 7 8 9 10 11 SELECT pg_typeof(33); pg_typeof ----------- integer (1 row) SELECT typlen FROM pg_type WHERE oid = pg_typeof(33); typlen -------- 4 (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_indexdef(index_oid, column_no, pretty_bool)

pg_get_indexdef(index_oid, column_no, pretty_bool) 描述：获取索引的CREATE INDEX命令，或者如果column_no不为零，则只获取一个索引字段的定义。返回类型：text 1 2 3 4 5 6 7 8 9 10 SELECT * FROM pg_get_indexdef(136035,0,false); pg_get_indexdef --------------------------------------------------------------------------------------------------------------- CREATE INDEX ds_ship_mode_t1_index1 ON tpcds.ship_mode_t1 USING psort (sm_ship_mode_sk) TABLESPACE pg_default (1 row) SELECT * FROM pg_get_indexdef(136035,1,false); pg_get_indexdef ----------------- sm_ship_mode_sk (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_viewdef(viewname text [, pretty bool [, fullflag bool]])

pg_get_viewdef(viewname text [, pretty bool [, fullflag bool]]) 描述：为视图获取底层的SELECT命令。返回类型：text 备注： pg_get_viewdef重构定义视图的SELECT查询。pretty bool参数为true时，显示格式“适合打印”，且该格式易读。pretty bool参数缺省值为false，显示格式不易读。如果用于转储，那么尽可能使用缺省格式。pretty bool参数只对有效视图生效。 fullflag bool参数为true时，显示视图的完整定义。其缺省值为false。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_functiondef(func_oid)

pg_get_functiondef(func_oid) 描述：获取函数的定义。返回类型：text func_oid为函数的OID，可以通过PG_PROC系统表查询。示例：查询函数justify_days的OID及其函数定义。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 SELECT oid FROM pg_proc WHERE proname ='justify_days'; oid ------ 1295 (1 row) SELECT * FROM pg_get_functiondef(1295); headerlines | definition -------------+-------------------------------------------------------------- 4 | CREATE OR REPLACE FUNCTION pg_catalog.justify_days(interval)+ | RETURNS interval + | LANGUAGE internal + | IMMUTABLE STRICT NOT FENCED NOT SHIPPABLE + | AS $function$interval_justify_days$function$ + | (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_indexdef(index_oid)

pg_get_indexdef(index_oid) 描述：获取索引的CREATE INDEX命令。返回类型：text index_oid为索引的OID，可以通过PG_STATIO_ALL_INDEXES系统视图查询。示例：查询索引ds_ship_mode_t1_index1的OID及其创建命令。 1 2 3 4 5 6 7 8 9 10 SELECT indexrelid FROM PG_STATIO_ALL_INDEXES WHERE indexrelname = 'ds_ship_mode_t1_index1'; indexrelid ------------ 136035 (1 row) SELECT * FROM pg_get_indexdef(136035); pg_get_indexdef --------------------------------------------------------------------------------------------------------------- CREATE INDEX ds_ship_mode_t1_index1 ON tpcds.ship_mode_t1 USING psort (sm_ship_mode_sk) TABLESPACE pg_default (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:pg_get_expr(pg_node_tree, relation_oid, pretty_bool)

pg_get_expr(pg_node_tree, relation_oid, pretty_bool) 描述：反编译表达式的内部形式，假设其中的任何Vars都引用第二个参数指定的关系。返回类型：text 备注：pg_get_expr反编译一个独立表达式的内部形式，比如一个字段的缺省值。在检查系统表的内容的时候很有用。如果表达式可能包含关键字，则指定它们引用相关的OID作为第二个参数；如果没有关键字，设置为零即可。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-系统表信息函数:format_type(type_oid, typemod)

format_type(type_oid, typemod) 描述：获取数据类型的SQL名称。返回类型：text 备注： format_type通过数据类型的类型OID以及可能的类型修饰词，返回其SQL名称。如果不知道具体的修饰词，则在类型修饰词的位置传入NULL。类型修饰词一般只对有长度限制的数据类型有意义。format_type所返回的SQL名称中包含数据类型的长度值，其大小是：实际存储长度len - sizeof(int32)，单位字节。数据存储时需要32位的空间来存储用户对数据类型的自定义长度信息，即实际存储长度要比用户定义长度多4个字节。在下例中，format_type返回的SQL名称为“character varying(6)”，6表示varchar类型的长度值是6字节，因此该类型的实际存储长度为10字节。 1 2 3 4 5 SELECT format_type((SELECT oid FROM pg_type WHERE typname='varchar'), 10); format_type ---------------------- character varying(6) (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-time_format:str_to_time(str, format)

str_to_time(str, format) 描述：将时间格式的字符串（str），按照所提供的显示格式（format）转换为时间类型的值。返回值类型：time 示例： 1 2 3 4 5 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。

数据仓库服务 GAUSSDB(DWS) 时间、日期处理函数和操作符
数据仓库服务 GAUSSDB(DWS)-time_format:yearweek(date[, mode])

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

数据仓库服务 GAUSSDB(DWS) 时间、日期处理函数和操作符
数据仓库服务 GAUSSDB(DWS)-time_format:str_to_date(str, format)

str_to_date(str, format) 描述：将日期/时间格式的字符串（str），按照所提供的显示格式（format）转换为日期类型的值。返回值类型：timestamp 示例： 1 2 3 4 5 6 7 8 9 10 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。

数据仓库服务 GAUSSDB(DWS) 时间、日期处理函数和操作符

共100000条

undefined

意见反馈

0/200

提交取消

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

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线