华为云用户手册

数据仓库服务 GAUSSDB(DWS)-获取残留文件列表函数:pg_get_residualfiles()

pg_get_residualfiles() 描述：用于获取当前节点的所有残留文件记录。该函数为实例级函数，与当前所在的数据库无关，可以在任意实例上运行。返回值类型：record 返回信息如下：表1 pg_get_residualfiles()返回字段名称类型描述 isverified bool 是否已经验证。 isdeleted bool 是否已经被删除。 dbname text 所属数据库名称。 residualfile text 数据文件路径。 filepath text 残留文件记录路径。 notes text 注释。示例： 1 2 3 4 5 6 7 SELECT * FROM pg_get_residualfiles(); isverified | isdeleted | dbname | residualfile | filepath | notes ------------+-----------+--------+-------------------+---------------------------+------- f | f | db2 | base/49155/114691 | pgrf_20200908160211441546 | f | f | db2 | base/49155/114694 | pgrf_20200908160211441546 | f | f | db2 | base/49155/114696 | pgrf_20200908160211441546 | (3 rows)

数据仓库服务 GAUSSDB(DWS) 残留文件管理函数
数据仓库服务 GAUSSDB(DWS)-计算子集群函数:pv_compute_pool_workload()

pv_compute_pool_workload() 描述：返回计算子集群当前的负载状态。返回类型：void 示例： SELECT * from pv_compute_pool_workload(); nodename | rpinuse | maxrp | nodestate -----------+---------+-------+----------- datanode1 | 0 | 1000 | normal datanode2 | 0 | 1000 | normal (2 rows)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-事务ID和快照:txid_visible_in_snapshot(bigint, txid_snapshot)

txid_visible_in_snapshot(bigint, txid_snapshot) 描述：在快照中事务ID是否可见（不使用子事务ID）。返回类型：boolean 内部事务ID类型（xid）是32位，每40亿事务一次循环。这些函数使用的数据类型txid_snapshot，存储在特定时刻事务ID可见性的信息。其组件描述在表1。表1 快照组件名字描述 xmin 最早的事务ID（txid）仍然活动。所有较早事务将是已经提交可见的，或者是直接回滚。 xmax 作为尚未分配的txid。所有大于或等于此txids的都是尚未开始的快照时间，因此不可见。 xip_list 当前快照中活动的txids。这个列表只包含在xmin和xmax之间活动的txids；有可能活动的txids高于xmax。介于大于等于xmin、小于xmax，并且不在这个列表中的txid，在这个时间快照已经完成的，因此按照提交状态查看他是可见还是回滚。这个列表不包含子事务的txids。 txid_snapshot的文本表示为：xmin:xmax:xip_list。示例：10:20:10,14,15意思为：xmin=10, xmax=20, xip_list=10, 14, 15。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-注释信息函数:col_description(table_oid, column_number)

col_description(table_oid, column_number) 描述：获取一个表字段的注释。返回类型：text 备注：col_description返回一个表中字段的注释，通过表OID和字段号来声明。示例：查询pg_class系统表获取表OID，查询INFORMATION_SCHEMA.COLUMNS系统视图获取column_number。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 SELECT COLUMN_NAME,ORDINAL_POSITION FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 't' AND COLUMN_NAME = 'a'; column_name | ordinal_position -------------+------------------ a | 1 (1 row) SELECT oid FROM pg_class WHERE relname='t'; oid ------- 44020 (1 row) SELECT col_description(44020,1); col_description ----------------------- This is a test table. (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-注释信息函数:obj_description(object_oid, catalog_name)

obj_description(object_oid, catalog_name) 描述：获取一个数据库对象的注释。返回类型：text 备注：带有两个参数的obj_description返回一个数据库对象的注释，该对象是通过其OID和其所属的系统表名字声明。比如，obj_description(123456,'pg_class')将返回OID为123456的表的注释。只带一个参数的obj_description只要求对象OID。 obj_description不能用于表字段，因为字段没有自己的OID。

数据仓库服务 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_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_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_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_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)-系统表信息函数: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_options_to_table(reloptions)

pg_options_to_table(reloptions) 描述：获取存储选项名称/值对的集合。返回类型：setof record 备注：pg_options_to_table当通过pg_class.reloptions或pg_attribute.attoptions时返回存储选项名字/值对（option_name/option_value）的集合。示例： 1 2 3 4 5 6 7 CREATE TABLE customer_test ( state_ID CHAR(2), state_NAME VARCHAR2(40), area_ID NUMBER ) WITH (ORIENTATION = COLUMN,COMPRESSION=middle); 1 2 3 4 5 6 7 8 9 SELECT pg_options_to_table(reloptions) FROM pg_class WHERE relname='customer_test'; pg_options_to_table ---------------------- (orientation,column) (compression,middle) (bucketnums,16384) (colversion,2.0) (enable_delta,false) (5 rows)

数据仓库服务 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)-系统表信息函数: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)-访问权限查询函数:has_any_column_privilege(table, privilege)

has_any_column_privilege(table, privilege) 描述：当前用户是否有访问表任何列的权限。返回类型：boolean 备注：has_any_column_privilege检查用户是否以特定方式访问表的任何列。其参数可能与has_table_privilege类似，除了访问权限类型必须是SELECT、INSERT、UPDATE或REFEREN CES 的一些组合。拥有表的表级别权限则隐含的拥有该表每列的列级权限，因此如果与has_table_privilege参数相同，has_any_column_privilege总是返回true。但是如果授予至少一列的列级权限也返回成功。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-访问权限查询函数:has_database_privilege(database, privilege)

has_database_privilege(database, privilege) 描述：当前用户是否有访问数据库的权限。返回类型：boolean 备注：has_database_privilege检查用户是否能以在特定方式访问数据库。其参数类似has_table_privilege。访问权限类型必须是CREATE、CONNECT、TEMPORARY或TEMP（等价于TEMPORARY）的一些组合。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-访问权限查询函数:has_table_privilege(table, privilege)

has_table_privilege(table, privilege) 描述：当前用户是否有访问表的权限。返回类型：boolean 备注：has_table_privilege检查用户是否以特定方式访问表。用户可以通过名字或OID（pg_authid.oid）来指定，public表明PUBLIC伪角色，如果缺省该参数，则使用current_user。该表可以通过名字或者OID声明。如果用名字声明，则在必要时可以用模式进行修饰。如果使用文本字符串来声明权限类型，该文本字符串必须是SELECT、INSERT、UPDATE、DELETE、TRUNCATE、REFERENCES或TRIGGER之一的值。可以给权限类型添加WITH GRANT OPTION，用来测试权限是否拥有授权选项。也可以用逗号分隔列出的多个权限类型，如果拥有任何所列出的权限，则结果便为true。示例： 1 2 3 4 5 6 7 8 9 10 11 SELECT has_table_privilege('tpcds.web_site', 'select'); has_table_privilege --------------------- t (1 row) SELECT has_table_privilege('dbadmin', 'tpcds.web_site', 'select,INSERT WITH GRANT OPTION '); has_table_privilege --------------------- t (1 row)

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-访问权限查询函数:pg_has_role(role, privilege)

pg_has_role(role, privilege) 描述：当前用户是否有角色的权限。返回类型：boolean 备注：pg_has_role检查用户是否能以特定方式访问角色。其参数类似has_table_privilege，除了public不能用做用户名。访问权限类型必须是MEMBER或USAGE的一些组合。 MEMBER表示的是角色中的直接或间接成员关系（也就是SET ROLE的权限），而USAGE表示无需通过SET ROLE也直接拥有角色的使用权限。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-访问权限查询函数:has_column_privilege(table, column, privilege)

has_column_privilege(table, column, privilege) 描述：当前用户是否有访问列的权限。返回类型：boolean 备注：has_column_privilege检查用户是否以特定方式访问一列。其参数类似于has_table_privilege，可以通过列名或属性号添加列。想要的访问权限类型必须是SELECT、INSERT、UPDATE或REFERENCES的一些组合。拥有表的表级别权限则隐含的拥有该表每列的列级权限。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-访问权限查询函数:has_function_privilege(function, privilege)

has_function_privilege(function, privilege) 描述：当前用户是否有访问函数的权限。返回类型：boolean 备注：has_function_privilege检查一个用户是否能以指定方式访问函数。其参数类似has_table_privilege。使用文本字符而不是OID声明一个函数时，允许输入的类型和regprocedure数据类型一样（请参考对象标识符类型）。访问权限类型必须是EXECUTE。

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

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

数据仓库服务 GAUSSDB(DWS) 系统信息函数
数据仓库服务 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)-会话信息函数:version()

version() 描述：版本信息。version返回一个描述服务器版本信息的字符串。返回值类型：text 示例： 1 2 3 4 5 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)

数据仓库服务 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)-会话信息函数:pgxc_version()

pgxc_version() 描述：Postgres-XC版本信息。返回值类型：text 示例： 1 2 3 4 5 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)

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

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

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

pg_postmaster_start_time() 描述：服务器启动时间。pg_postmaster_start_time返回服务器启动时的timestamp with time zone。返回值类型：timestamp with time zone 示例： 1 2 3 4 5 SELECT pg_postmaster_start_time(); pg_postmaster_start_time ------------------------------ 2017-08-30 16:02:54.99854+08 (1 row)

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

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

共100000条

undefined

意见反馈

0/200

提交取消

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

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线