华为云用户手册

DB_TAB_PRIVS DB_TAB_PRIVS视图记录当前用户可访问的所有对象的授权信息。所有用户都可以访问该视图。该视图同时存在于PG_CATA LOG 和SYS Schema下。 表1 DB_TAB_PRIVS字段 名称 类型 描述 grantor character varying(128) 执行授权的用户名。 grantee character varying(128) 被授予权限的用户或角色的名称。 table_schema character varying(128) 对象的模式。 table_name character varying(128) 对象的名称。 privilege character varying(40) 对象上的权限，包括USAGE、UPDATE、DELETE、INSERT、CONNECT、SELECT、EXECUTE。 grantable character varying(3) 该授权是否包含GRANT选项。 YES：包含GRANT选项。 NO：不包含GRANT选项。 type character varying(24) 对象的类型，包括NODE GROUP、COLUMN_ENCRYPTION_KEY、PACKAGE、COLUMN、TABLE、VIEW、SEQUENCE、TYPE、INDEX、DATABASE、DIRECTORY、FOREIGN DATA WRAPPER、FOREIGN SERVER、LANGUAGE、SCHEMA、TEMPLATE、FUNCTION、PROCEDURE、TABLESPACE。 hierarchy character varying(3) 暂不支持，值为NULL。 common character varying(3) 暂不支持，值为NULL。 inherited character varying(3) 暂不支持，值为NULL。 父主题： 用户和权限管理

ADM_SCHEDULER_PROG RAM _ARGS ADM_SCHEDULER_PROGRAM_ARG视图显示数据库中所有程序的有关参数信息。默认只有系统管理员权限才可以访问，普通用户需要授权才可以访问。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 ADM_SCHEDULER_PROGRAM_ARGS字段 名称 类型 描述 owner character varying(128) 参数所属程序的拥有者。 program_name character varying(128) 参数所属程序名。 argument_name character varying(128) 参数名称。 argument_position numeric 参数在参数列表中的位置。 argument_type character varying(257) 参数的数据类型，可以是用户的自定义数据类型。 metadata_attribute character varying(19) 暂不支持，值为NULL。 default_value character varying(4000) 参数默认值。 default_anydata_value character varying(4000) 暂不支持，值为NULL。 out_argument character varying(5) 保留字段，值为NULL。 父主题： 其他系统视图

GLOBAL_REDO_STATUS GLOBAL_REDO_STATUS视图显示整个集群所有实例的日志回放情况，如表1所示。 表1 GLOBAL_REDO_STATUS字段 名称 类型 描述 node_name text 实例名称。 redo_start_ptr bigint 当前实例日志回放的起始点。 redo_start_time bigint 当前实例日志回放的起始UTC时间。 redo_done_time bigint 当前实例日志回放的结束UTC时间。 curr_time bigint 当前实例的当前UTC时间。 min_recovery_point bigint 当前实例日志的完成回放后可对外提供服务的最小一致性点。 read_ptr bigint 当前实例日志的读取位置。 last_replayed_read_ptr bigint 当前实例的日志回放位置。 recovery_done_ptr bigint 当前实例启动完成时的回放位置。 read_xlog_io_counter bigint 当前实例读取回放日志的I/O次数计数。 read_xlog_io_total_dur bigint 当前实例读取回放日志的I/O总用时。 read_data_io_counter bigint 当前实例日志回放过程中，读取数据页面的I/O次数计数。 read_data_io_total_dur bigint 当前实例日志回放过程中，读取数据页面的I/O总用时。 write_data_io_counter bigint 当前实例日志回放过程中，写数据页面的I/O次数计数。 write_data_io_total_dur bigint 当前实例日志回放过程中，写数据页面的I/O总用时。 process_pending_counter bigint 当前实例日志回放过程中，日志分发线程的同步次数计数。 process_pending_total_dur bigint 当前实例日志回放过程中，日志分发线程的同步总用时。 apply_counter bigint 当前实例日志回放过程中，回放线程的同步次数计数。 apply_total_dur bigint 当前实例日志回放过程中，回放线程的同步总用时。 speed bigint 当前实例日志回放速率，每回放256MB日志该值更新一次，单位byte/s。 在集群环境下，建议使用cm_ctl query -rv命令来获取更精确的备机回放速度（cm_ctl命令请参考《工具参考》中“统一集群管理工具”章节）。 local_max_ptr bigint 当前实例启动成功后本地收到的回放日志的最大值。 primary_flush_ptr bigint 主机落盘日志的位置。 worker_info text 当前实例回放线程信息，若没有开并行回放则该值为空。 父主题： Utility

GS_ILM_JOBDETAIL GS_ILM_JOBDETAIL系统表提供了记录策略动作类型、判定条件等。 表1 GS_ILM_JOBDETAIL字段 名称 类型 描述 taskoid bigint 所属ADO Task的oid。 jobtype "char" 当前Job类型：压缩（‘c’）。 jobstatus smallint 当前Job状态： 1：JOB CREATED 2：COMPLETED SUC CES SFULLY 3：FAILED 4：STOPPED 5：JOB CREATION FAILED jobname text ADO Job名称表内唯一，关联系统表PG_JOB的job_name。 starttime timestamp with time zone 启动时间。 completetime timestamp with time zone 完成时间。 payload text 当前Job的具体执行内容PL/SQL代码。 statistics text 当前Job的统计信息。 comments text 记录当前Job执行的描述信息，如失败原因等。 父主题： OLTP表压缩

参数说明 pdb_name PDB名称。 取值范围：字符串，要符合标识符命名规范。此外PDB名不能带“$”符号。 ENCODING [ = ] 'encoding' 可选。指定数据库使用的字符编码，可以是字符串（如'SQL_ASCII'）、整数编号。 不指定时，对于M-Compatibility数据库，默认使用utf8编码；其他默认使用模版数据库的编码。模板数据库template0、template1和templatea的编码默认与操作系统环境相关。template1不允许修改字符编码，因此若要变更编码，A兼容模式数据库请使用templatea创建数据库， 非A兼容模式数据库请使用template0创建数据库。 常用取值：GBK、UTF8、Latin1、GB18030等。 LC_COLLATE [ = ] 'lc_collate' 可选。指定新数据库使用的字符集。例如，通过lc_collate = 'zh_CN.gbk'设定该参数。 该参数的使用会影响到对字符串的排序顺序（如使用ORDER BY执行，以及在文本列上使用索引的顺序）。默认是使用模板数据库的字符集。该参数对M-Compatibility数据库不生效。 取值范围：操作系统支持的字符集。 LC_CTYPE [ = ] 'lc_ctype' 可选。指定新数据库使用的字符分类。例如，通过lc_ctype = 'zh_CN.gbk'设定该参数。该参数的使用会影响到字符的分类，如大写、小写和数字。默认是使用模板数据库的字符分类。该参数对M-Compatibility数据库不生效。 取值范围：操作系统支持的字符分类。 DBCOMPATIBILITY [ = ] compatibility_type 可选。指定兼容的数据库的类型，默认兼容O。 取值范围：A、C、PG、M。分别表示兼容O、TD、POSTGRES和M-Compatibility。 DBTIMEZONE [ = ] time_zone 指定新数据库的时区。例如，通过DBTIMEZONE = '+00:00'设定该参数。该参数会影响新数据库的时区。默认设置为PRC时区。 前提条件：当前连接数据库是A兼容、a_format_version='10c'、a_format_dev_version='s2'。 取值范围：操作系统支持的时区名称和缩写或者-15：59到+15：00时间戳范围。

注意事项 不能在事务块中执行创建PDB的DDL语句，包括CREATE、ALTER、DROP。 只能在GUC参数enable_mtd为on的状态下使用。 只能在非PDB中进行该操作。不支持在M兼容数据库中执行该命令。 操作用户需要为gs_role_create_pdb的角色，或拥有sysadmin权限。 最多可以创建128个用户PDB。 在创建数据库过程中，出现类似“Permission denied”的错误提示，可能是由于文件系统上数据目录的权限不足。出现类似“No space left on device”的错误提示，可能是由于磁盘满引起的。 在兼容性选项缺省的情况下，将创建A兼容模式PDB。 若安装数据库实例时没有指定初始化账户密码，且初始化账户名字区分大小写，且新创建的PDB为M-Compatibility模式数据库的情况下，需要在开启并使用该PDB前，先在命令行执行以下语句，使数据库将双引号中的内容作为对象引用进行处理。语句执行后再开启并使用该PDB，按照提示重置始账户密码。 gs_guc set --pdbname my_pdb -Z datanode -N all -I all -c "sql_mode = 'ansi_quotes'" # my_pdb为新建的PDB名 （该举是为保证能正常为新PDB设置账户密码，后续操作可以按需重置sql_mode参数）

语法格式 CREATE PLUGGABLE DATABASE pdb_name [ [ WITH ] { [ ENCODING [=] 'encoding' ] | [ LC_COLLATE [=] 'lc_collate' ] | [ LC_CTYPE [=] 'lc_ctype' ] | [ DBCOMPATIBILITY [=] 'compatibility_type' ] | [ DBTIMEZONE [=] 'time_zone' ] }];

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

参数说明 SESSION 声明这个命令只对当前会话起作用。 LOCAL 声明该命令只在当前事务中有效。 role_name 用户名。 取值范围：字符串，数据库中已经存在的用户名。 password 角色的密码。要求符合密码的命名规则。 使用密文密码限制如下： 管理员用户不能使用密文密码切换到其他管理员用户，只能向权限更低用户切换； 使用密文密码通常用于gs_dump、gs_dumpall导出场景，其他场景不建议直接使用密文密码。 DEFAULT 重置会话和当前用户标识符为初始认证的用户名。

MY_COL_COMMENTS MY_COL_COMMENTS视图显示当前用户下表的列注释信息。该视图同时存在于PG_CATALOG和SYS Schema下。具体字段信息如表1所示。 表1 MY_COL_COMMENTS字段 名称 类型 描述 owner character varying(128) 表的所有者。 table_name character varying(128) 表的名称。 column_name character varying(128) 列名称。 comments text 注释。 origin_con_id numeric 暂不支持，值为0。 schema character varying(64) 列所属的名称空间的名称。 父主题： 其他系统视图

PG_STAT_REPLICATION PG_STAT_REPLICATION视图显示日志同步线程的信息，如发起端发送日志位置，接收端接收日志位置等。 表1 PG_STAT_REPLICATION字段 名称 类型 描述 pid bigint 线程的PID。 usesysid oid 用户系统ID。 usename name 用户名。 application_name text 程序名称。 client_addr inet 客户端地址。 client_hostname text 客户端名。 client_port integer 客户端端口。 backend_start timestamp with time zone 程序启动时间。 state text 日志同步线程的状态： startup：线程正在启动。 catchup：线程正在建立备用服务器和主服务器的连接。 streaming：线程已建立备用服务器和主服务器的连接，正在进行数据的流复制。 backup：线程正在发送备份。 stopping：线程正在停止。 sender_sent_location text 发送端发送日志位置。 receiver_write_location text 接收端write日志位置。 receiver_flush_location text 接收端flush日志位置。 receiver_replay_location text 接收端replay日志位置。 sync_priority integer 同步复制的优先级（0表示异步）。 sync_state text 同步状态： async：异步复制。 sync：同步复制。 potential：该备用服务器现在是异步的，但假如一个当前的同步服务器发生故障，该服务器会变成同步的。 quorum：在同步与异步之间切换，保证备机中有大于一定数量的同步备机，同步备机数量一般为(n+1)/2-1，n为总副本个数。是否为同步备机取决于是否先接到了日志。详情可参考synchronous_standby_names参数描述。 父主题： 其他系统视图

ADM_SYS_PRIVS ADM_SYS_PRIVS视图显示授予用户和角色的系统权限信息。默认只有系统管理员权限才可以访问此系统视图，普通用户需要授权才可以访问。该视图同时存在于PG_CATALOG和SYS Schema下。 表1 ADM_SYS_PRIVS字段 名称 类型 描述 grantee character varying(128) 被授予权限的用户或角色的名称。 privilege character varying(40) 用户拥有的系统权限或ANY权限。 系统权限包括rolsuper、rolinherit、rolcreaterole、rolcreatedb、rolcatupdate、rolcanlogin、rolreplication、rolauditadmin、rolsystemadmin、roluseft、rolmonitoradmin、roloperatoradmin、rolpolicyadmin。 ANY权限的取值请参考表1。 admin_option character varying(3) 该授权是否包含ADMIN选项。 YES：包含ADMIN选项。 NO：不包含ADMIN选项。 common character varying(3) 暂不支持，值为NULL。 inherited character varying(3) 暂不支持，值为NULL。 父主题： 用户和权限管理

_PG_FOREIGN_DATA_WRAPPERS 显示外部数据封装器的信息，如表1所示。该视图只有sysadmin权限可以查看。 表1 _PG_FOREIGN_DATA_WRAPPERS字段 名称 类型 描述 oid oid 外部数据封装器的oid。 fdwowner oid 外部数据封装器的所有者的oid。 fdwoptions text[] 外部数据封装器指定选项，使用“keyword=value”格式的字符串。 foreign_data_wrapper_catalog information_schema.sql_identifier 外部封装器所在的数据库名称（永远为当前数据库）。 foreign_data_wrapper_name information_schema.sql_identifier 外部数据封装器名称。 authorization_identifier information_schema.sql_identifier 外部数据封装器所有者的角色名称。 foreign_data_wrapper_language information_schema.character_data 外部数据封装器的实现语言。 父主题： Information Schema

什么是数据倾斜，如何检查？ 答：数据倾斜即多个DN内数据分布不均，对于hash分表策略，如果分布列选择不当，可能导致数据倾斜，查询时部分DN出现效率短板，从而影响整体查询性能。因此在采用Hash分表策略之后需对表的数据定期进行数据倾斜性检查或监控，以确保数据在各个DN上是均匀分布的。执行如下语句，查看各DN内元组数目。 gaussdb=# SELECT a.count,b.node_name FROM (SELECT count(*) AS count,xc_node_id FROM tablename GROUP BY xc_node_id) a, pgxc_node b WHERE a.xc_node_id=b.node_id ORDER BY a.count DESC; 如果各DN内元组数目相差较大（如相差数倍、数十倍），则表明已发生数据倾斜现象。需要重新选择分布列，当前不支持通过ALTER TABLE语句调整分布列，因此调整分布列时需要重新建表。 父主题： FAQ

GS_JOB_ARGUMENT GS_JOB_ARGUMENT系统表提供了DBE_SCHEDULER定时任务和程序的参数属性。 表1 GS_JOB_ARGUMENT字段 名称 类型 描述 oid oid 行标识符（隐含字段）。 argument_position integer 定时任务或程序的参数位置。 argument_type name 定时任务或程序的参数类型。 job_name text 定时任务或程序名。 argument_name text 定时任务或程序的参数名（定时任务继承了程序的参数名，所以为空）。 argument_value text 定时任务的参数值（程序本身无法绑定值）。 default_value text 程序的参数默认值。 父主题： 其他系统表

GS_AUDITING_POLICY_ACCESS GS_AUDITING_POLICY_ACCESS系统表记录与DML数据库相关操作的统一审计信息。需要有系统管理员或安全策略管理员权限才可以访问此系统表。 表1 GS_AUDITING_POLICY_ACCESS字段 名称 类型 描述 oid oid 行标识符（隐含属性，必须明确选择）。 accesstype name DML数据库操作相关类型。例如SELECT、INSERT、DELETE等。 labelname name 资源标签名称。对应系统表GS_AUDITING_POLICY中的polname字段。 policyoid oid 所属审计策略的OID。对应系统表12.2.9.1 GS_AUDITING_POLICY中的oid。 modifydate timestamp without time zone 创建或修改的最新时间戳。 父主题： 审计

GLOBAL_PAGEWRITER_STATUS GLOBAL_PAGEWRITER_STATUS视图显示整个集群所有实例的刷页信息和检查点信息，如表1所示。 表1 GLOBAL_PAGEWRITER_STATUS字段 名称 类型 描述 node_name text 实例名称。 pgwr_actual_flush_total_num bigint 从启动到当前时间刷脏页的总计数量。 pgwr_last_flush_num integer 上一批刷脏页数量。 remain_dirty_page_num bigint 当前预计剩余的脏页数量。 queue_head_page_rec_lsn text 当前实例的脏页队列第一个脏页的recovery_lsn。 queue_rec_lsn text 当前实例的脏页队列的recovery_lsn。 current_xlog_insert_lsn text 当前实例xLog写入的位置。 ckpt_redo_point text 当前实例的检查点。 父主题： Utility

注意事项 只有模式的所有者或者被授予了模式ALTER权限的用户有权限执行ALTER SCHEMA命令，三权分立开关关闭时，系统管理员默认拥有此权限。但要修改模式的所有者，当前用户必须是该模式的所有者或者系统管理员，且该用户是新所有者角色的成员。 对于除public以外的系统模式，如pg_catalog、sys等，只允许初始用户修改模式的所有者。修改系统自带模式的名称可能会导致部分功能不可用甚至影响数据库正常运行，默认情况下不允许修改系统自带模式的名称，考虑到前向兼容性，仅允许当系统在启动或升级过程中或参数allow_system_table_mods为on时修改。 除初始用户外，其他用户无法将schema的所有者修改为运维管理员。

示例 修改模式的防篡改属性。 修改普通模式为防篡改模式，需设置GUC参数enable_ledger，用于控制是否启用账本数据库功能。参数使用请联系管理员处理。 --创建模式test_schema1。 gaussdb=# CREATE SCHEMA test_schema1; --修改模式test_schema1为防篡改模式。 gaussdb=# ALTER SCHEMA test_schema1 WITH BLOCKCHAIN; --查询模式信息，防篡改属性为true。 gaussdb=# \dn+ test_schema1 List of schemas Name | Owner | Access privileges | Description | WithBlockChain --------------+-------+-------------------+-------------+---------------- test_schema1 | omm | | | t (1 row) 修改模式名称。 --将模式test_schema1重命名为test_sch1。 gaussdb=# ALTER SCHEMA test_schema1 RENAME TO test_sch1; --查询模式信息。 gaussdb=# \dn+ test* List of schemas Name | Owner | Access privileges | Description | WithBlockChain -----------+-------+-------------------+-------------+---------------- test_sch1 | omm | | | t (1 row) 修改模式所有者。 --创建用户test_user。 gaussdb=# CREATE ROLE test_user PASSWORD '********'; --将模式test_sch1的所有者修改为test_user。 gaussdb=# ALTER SCHEMA test_sch1 OWNER TO test_user; --查询模式信息。 gaussdb=# \dn+ test_sch1; List of schemas Name | Owner | Access privileges | Description | WithBlockChain -----------+-----------+-------------------+-------------+---------------- test_sch1 | test_user | | | t (1 row) --删除。 gaussdb=# DROP SCHEMA test_sch1; gaussdb=# DROP ROLE test_user; 修改默认字符集和字符序。 仅在B模式数据库下（即sql_compatibility = 'B'）支持该语法。 除binary字符集和字符序外，当前仅支持指定与数据库编码相同的字符集。 --创建并切换至测试数据库。 gaussdb=# CREATE DATABASE test1 WITH DBCOMPATIBILITY = 'B' ENCODING = 'UTF8' LC_COLLATE = 'zh_CN.utf8' LC_CTYPE = 'zh_CN.utf8'; gaussdb=# \c test1 --创建模式test_sch2。 test1=# CREATE SCHEMA test_sch2; --修改其默认字符为utf8mb4，默认字符序修改为utf8mb4_bin。 test1=# ALTER SCHEMA test_sch2 CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; --删除。 test1=# DROP SCHEMA test_sch2; --切换至默认数据库。（根据实际情况修改数据库名） test1=# \c postgres gaussdb=# DROP DATABASE test1;

参数说明 schema_name 现有模式的名称。 取值范围：已存在的模式名。 RENAME TO new_name 修改模式的名称。非系统管理员要改变模式的名称，则该用户必须在此数据库上有CREATE权限。 new_name：模式的新名称。 模式名不能和当前数据库里其他的模式重名。 模式名不能和当前数据库的初始用户重名。 模式的名称不可以“pg_”开头。 模式的名称不可以“gs_role_”开头。 取值范围：字符串，要符合标识符命名规范。 OWNER TO new_owner 修改模式的所有者。非系统管理员要改变模式的所有者，该用户还必须是新的所有角色的直接或间接成员， 并且该成员必须在此数据库上有CREATE权限。 new_owner：模式的新所有者。 取值范围：已存在的用户名/角色名。 { WITH | WITHOUT } BLOCKCHAIN 修改模式的防篡改属性，使用WITH选项为防篡改模式。具有防篡改属性模式下的普通行存表均为防篡改历史表，不包括外表，临时表，系统表。当该模式下不包含任何表时才可修改防篡改属性。另外，不支持临时表模式、toast表模式、dbe_perf模式、blockchain模式修改防篡改属性。只有模式中不包含任何表的情况下，才能使用该语法在普通模式和防篡改模式中互转。 修改普通模式为防篡改模式，需设置GUC参数enable_ledger为on，该参数默认值为off，级别为SIGHUP。

GS_COMM_LISTEN_ADDRESS_EXT_INFO GS_COMM_LISTEN_ADDRESS_EXT_INFO描述了查询连接扩展IP的相关线程、会话、socket等DFX信息。当前不支持查询该视图。 表1 GS_COMM_LISTEN_ADDRESS_EXT_INFO字段 名称 类型 描述 node_name text 当前实例名。 app text 当前连接DN的客户端。 tid bigint 当前线程的线程号。 lwtid integer 当前线程的轻量级线程号。 query_id bigint 当前线程的查询ID。 socket integer 当前物理连接的socket fd。 remote_ip text 当前连接对端IP。 remote_port text 当前连接对端port。 local_ip text 当前连接本端IP。 local_port text 当前连接本端port。 父主题： 通信

操作步骤 创建schema，具体操作请参见CREATE SCHEMA。 执行如下命令来创建一个schema。 1 gaussdb=# CREATE SCHEMA myschema; 当结果显示为如下信息，则表示成功创建一个名为myschema的schema。 1 CREATE SCHEMA 如果需要在模式中创建或者访问对象，其完整的对象名称由模式名称和具体的对象名称组成，中间由符号“.”隔开。例如：myschema.table。 执行如下命令在创建schema时指定owner。 1 gaussdb=# CREATE SCHEMA myschema AUTHORIZATION omm; 当结果显示为如下信息，则表示成功创建一个属于omm用户，名为myschema的schema。 1 CREATE SCHEMA 使用schema 在特定schema下创建对象或者访问特定schema下的对象，需要使用有schema修饰的对象名。该名称包含schema名以及对象名，schema名和对象名之间用“.”号分开。 执行如下命令在myschema下创建mytable表。 1 2 gaussdb=# CREATE TABLE myschema.mytable(id int, name varchar(20)); CREATE TABLE 如果在数据库中指定对象的位置，就需要使用有schema修饰的对象名称。 执行如下命令查询myschema下mytable表的所有数据。 1 2 3 4 gaussdb=# SELECT * FROM myschema.mytable; id | name ----+------ (0 rows) schema的搜索路径 可以设置search_path配置参数指定查询对象可用schema的顺序。在搜索路径列出的第一个schema会变成默认的schema。如果在创建对象时不指定schema，则会创建在默认的schema中。 执行如下命令查看搜索路径。 1 2 3 4 5 gaussdb=# SHOW SEARCH_PATH; search_path ---------------- "$user",public (1 row) 执行如下命令将搜索路径设置为myschema, public。首先搜索myschema，然后搜索public。 1 2 gaussdb=# SET SEARCH_PATH TO myschema, public; SET schema的权限控制 默认情况下，用户只能访问属于自己的schema中的数据库对象。如果需要访问其他schema的对象，则该schema的所有者应该授予他对该schema的usage权限。 通过将模式的CREATE权限授予某用户，被授权用户就可以在此模式中创建对象。默认情况下，所有角色都拥有在public模式上的usage权限，但是普通用户没有在public模式上的CREATE权限。普通用户能够连接到一个指定数据库并在它的public模式中创建对象是不安全的，如果普通用户具有在public模式上的CREATE权限则建议通过如下语句撤销该权限。 撤销PUBLIC在public模式下创建对象的权限，下面语句中第一个“public”是模式，第二个“PUBLIC”指的是所有角色。 1 2 gaussdb=# REVOKE CREATE ON SCHEMA public FROM PUBLIC; REVOKE 执行如下命令查看现有的schema。 1 2 3 4 5 gaussdb=# SELECT current_schema(); current_schema ---------------- myschema (1 row) 执行如下命令创建用户jack，并将myschema的usage权限授予用户jack。 1 2 3 4 gaussdb=# CREATE USER jack IDENTIFIED BY '********'; CREATE ROLE gaussdb=# GRANT USAGE ON schema myschema TO jack; GRANT 将用户jack对于myschema的usage权限收回。 1 2 gaussdb=# REVOKE USAGE ON schema myschema FROM jack; REVOKE 删除schema，具体操作请参见DROP SCHEMA。 当schema为空时，即该schema下没有数据库对象，使用DROP SCHEMA命令进行删除。例如删除名为nullschema的空schema。 1 2 gaussdb=# DROP SCHEMA IF EXISTS nullschema; DROP SCHEMA 当schema非空时，如果要删除一个schema及其包含的所有对象，需要使用CASCADE关键字。例如删除myschema及该schema下的所有对象。 1 2 gaussdb=# DROP SCHEMA myschema CASCADE; DROP SCHEMA 执行如下命令删除用户jack。 1 2 gaussdb=# DROP USER jack; DROP ROLE

注意事项 数据库集群包含一个或多个已命名数据库。用户和用户组在整个集群范围内是共享的，但是其数据并不共享。任何与服务器连接的用户都只能访问连接请求里声明的数据库。 一个数据库可以包含一个或多个已命名的schema，schema又包含表及其他数据库对象，包括数据类型、函数和操作符等。同一对象名可以在不同的schema中使用而不会引起冲突。例如，schema1和schema2都可以包含一个名为mytable的表。 和数据库不同，schema不是严格分离的。用户根据其对schema的权限，可以访问所连接数据库的schema中的对象。进行schema权限管理首先需要对数据库的权限控制进行了解。 不能创建以PG_为前缀的schema名，该类schema名为数据库系统预留的。 在每次创建新用户时，系统会在当前登录的数据库中为新用户创建一个同名Schema。对于其他数据库，若需要同名Schema，则需要用户手动创建。 通过未修饰的表名（名称中只含有表名，没有“schema名”）引用表时，系统会通过search_path（搜索路径）来判断该表是哪一个schema下的表。pg_temp和pg_catalog始终会作为搜索路径顺序中的前两位，无论二者是否出现在search_path中，或者出现在search_path中的任何位置。search_path（搜索路径）是一个schema名列表，在其中找到的第一个表就是目标表，如果没有找到则报错。（某个表即使存在，如果它的schema不在search_path中，依然会查找失败）在搜索路径中的第一个schema叫做"当前schema"。它是搜索时查询的第一个schema，同时在没有声明schema名时，新创建的数据库对象会默认存放在该schema下。 每个数据库都包含一个pg_catalog schema，它包含系统表和所有内置数据类型、函数和操作符。pg_catalog是搜索路径中的一部分，始终在临时表所属的模式后面，并在search_path中所有模式的前面，即具有第二搜索优先级，以确保可以搜索到数据库内置对象。如果用户需要使用和系统内置对象重名的自定义对象时，可以在操作自定义对象时带上自己的模式。

GS_WORKLOAD_RULE_STAT GS_WORKLOAD_RULE_STAT系统视图记录SQL限流规则相关的信息。只有具有sysadmin权限的用户才可以访问此系统视图。多租场景下，non-PDB访问该视图时返回全部信息，PDB访问该视图时返回空列表。 表1 GS_WORKLOAD_RULE_STAT字段 名称 类型 描述 rule_id bigint 限流规则ID。 rule_name name 限流规则的名称，用于检索限流规则。 databases name[] 限流规则作用的数据库列表，为NULL表示对所有库生效。 rule_type text 限流规则类型，当前仅支持：“sqlid”、“select”、“insert”、“update”、“delete”、“merge”、“resource”，其他取值为非法值。 start_time timestamp with time zone 限流规则开始的时间，为NULL表示从现在开始生效。 end_time timestamp with time zone 限流规则结束的时间，为NULL表示一直生效。 max_workload bigint 限制规则设置的最大并发数。 option_val text[] 限流规则的参数值，包括：sqlid，关键字列表，资源限制情况。 详细请参见•gs_add_workload_rule(rule_type, rule_name, databases, start_time, end_time, max_workload, option_val)接口说明。 is_valid boolean 限流规则是否生效，超时的限流规则会设为false。 validate_count bigint 限流规则拦截SQL的次数。 node_names text[] 预留字段，限流规则生效的节点名称列表，当前不生效。 user_names text[] 预留字段，限流规则生效的用户名称列表，当前不生效。 父主题： 其他系统视图

参数说明 relname为查询中表table的名字，表有别名时，需要优先使用别名alias，此时relname=alias。当表名中有特殊符号，比如“@”、“.”时，relname需要用""括起来，以避免和查询块和schema名的声明重合。比如表名relnametest@1，需要写做"relnametest@1"。 schema为表所处的schema，可缺省，缺省时hint不区分schema对relname进行查找。 queryblock为表所处的queryblock，可缺省，缺省时hint不区分queryblock对relname进行查找。

GLOBAL_TRANSACTIONS_RUNNING_XA CTS 显示数据库主节点运行事务的信息汇总，如表1所示。多租场景下，non-PDB访问该视图时返回全部信息，PDB访问该视图时仅返回该PDB相关信息。 表1 GLOBAL_TRANSACTIONS_RUNNING_XACTS字段 名称 类型 描述 handle integer 事务对应的事务管理器中的槽位句柄，该值恒为-1。 gxid xid 事务id号。 state tinyint 事务状态（3：prepared或者0：starting）。 node text 节点名称。 xmin xid 节点上当前数据涉及的最小事务号xmin。 vacuum boolean 标志当前事务是否是lazy vacuum事务（lazy vacuum是一种vacuum机制，在需要时进行vacuum）。 true：表示是。 false：表示否。 timeline bigint 标志数据库重启次数。 prepare_xid xid 处于prepared状态的事务的id号，若不在prepared状态，值为0。 pid bigint 事务对应的线程id。 next_xid xid 其余节点发送给当前节点的事务id，该值恒为0。 dbid oid 事务对应的数据库id。 父主题： Transaction

语法格式 CREATE AGGREGATE name ( input_data_type [ , ... ] ) ( SFUNC = sfunc, -- SFUNC1 = sfunc, STYPE = state_data_type -- STYPE1 = state_data_type, [ , FINALFUNC = ffunc ] [ , INITCOND = initial_condition ] -- [ , INITCOND1 = initial_condition ] [ , SORTOP = sort_operator ] [ , CFUNC = collection_func ] [ , INITCOLLECT = initial_collection_condition ] [ , IFUNC = init_func ] [ , SHIPPABLE = is_shippable ] ); 也可使用： CREATE AGGREGATE name ( BASETYPE = base_type, SFUNC = sfunc, -- SFUNC1 = sfunc, STYPE = state_data_type -- STYPE1 = state_data_type, [ , FINALFUNC = ffunc ] [ , INITCOND = initial_condition ] -- [ , INITCOND1 = initial_condition ] [ , SORTOP = sort_operator ] [ , CFUNC = collection_func ] [ , INITCOLLECT = initial_collection_condition ] [ , IFUNC = init_func ] );

参数说明 name 要创建的聚集函数名（可以有模式修饰)）。 input_data_type 该聚集函数要处理的输入数据类型。要创建一个零参数聚集函数，可以使用*代替输入数据类型列表。（count(*)就是这种聚集函数的一个实例。） base_type 在CREATE AGGREGATE语法中，输入数据类型是通过basetype参数指定的，而不是写在聚集函数的名称之后。需要注意的是这种语法仅允许一个输入参数。要创建一个零参数聚集函数，可以将basetype指定为ANY，而不是*。 sfunc 将在每一个输入行上调用的状态转换函数的名称。 对于有N个参数的聚合函数，sfunc必须有+1个参数，其中的第一个参数类型为state_data_type，其余的匹配已声明的输入数据类型。 函数必须返回一个state_data_type类型的值。 这个函数接受当前状态值和当前输入数据，并返回下个状态值。ORA数据库的转换函数默认行为为strict，即会跳过null输入值。 GaussDB 需要用户自行定义转换函数strict属性。 state_data_type 聚合的状态值的数据类型。 ffunc 在转换完所有输入行后调用的最终处理函数，它计算聚合的结果。 此函数必须接受一个类型为state_data_type的参数。 聚合的输出数据类型被定义为此函数的返回类型。 如果没有声明ffunc则使用聚合结果的状态值作为聚合的结果，且输出类型为state_data_type。 initial_condition 状态值的初始设置(值)。 它必须是一个state_data_type类型可以接受的文本常量值。 如果没有声明，状态值初始为null。 sort_operator 用于MIN或MAX类型聚合的排序操作符。 这个只是一个操作符名(可以有模式修饰)。这个操作符假设接受和聚合一样的输入数据类型。 collection_func 如果希望分布式聚合来提高性能，用户可以提供collection_func。collection_func本质上是组合不同Datanode产生的状态转换结果。如果没有最终函数，collection_func产生的结果就是聚合的结果。如果需要collection_func跳过null值，请将collection_func标记为strict函数。如果没有标记为strict，用户需要妥善处理好null值输入。collection_func必须有两个类型为state_data_type的入参。第一个入参state_data_type将传给下一次collection_func执行的第一个参数。如果is_shippable为false，则不会执行collection_func。 initial_collection_condition collection_func状态值的初始设置(值)。 它必须是一个state_data_type类型可以接受的文本常量值。 如果没有声明，状态值初始为null。 init_func sfunc状态值的初始设置函数。 它不能返回null值，必须返回state_data_type类型并且没有入参。如果同时设置init_func和initial_condition，init_func的返回值将会优先作为初始状态值。 is_shippable 标记该聚集函数是否能够下推执行，仅可以取值true或者false。目前该参数不影响系统内置聚集函数的下推行为，仅影响用户自定义聚集函数的行为，默认值为false。仅当存在collection_func且is_shippable为true时，用户自定义聚集可以下推。

示例 --创建自定义函数。 gaussdb=# CREATE OR REPLACE FUNCTION int_add(int,int) returns int as $BODY$ declare begin return $1 + $2; end; $BODY$ language plpgsql; --创建聚集函数。 gaussdb=# CREATE AGGREGATE sum_add(int) ( sfunc = int_add, stype = int, initcond = '0' ); --创建测试表和添加数据。 gaussdb=# CREATE TABLE test_sum(a int,b int,c int); gaussdb=# INSERT INTO test_sum VALUES(1,2),(2,3),(3,4),(4,5); --执行聚集函数。 gaussdb=# SELECT sum_add(a) FROM test_sum; sum_add ----------- 10 --删除聚集函数。 gaussdb=# DROP AGGREGATE sum_add(int); --删除自定义函数。 gaussdb=# DROP FUNCTION int_add(int,int); --删除测试表。 gaussdb=# DROP TABLE test_sum;

ASP报告信息 表1 Report Header信息 列名称 描述 Start Time 开始时间。 End Time 结束时间。 Slot Count 指标展示时分割的时间段的个数。 Elapsed Time 生成报告的时间段。 Sample Count 生成ASP报告的总的样本数。 Slice Count 总的采样次数。 Average Active Sessions 平均活跃会话数。 Boundary Time 内存中样本和磁盘样本的分割时间点。 Data Source 生成ASP报告的样本中，来自内存中样本数和来自磁盘上的样本数。 表2 System Load信息 列名称 描述 Host Node Name 节点名称。 CPUs CPU核心总量。 Cores 单个CPU核心数量。 Sockets CPU插槽数量。 Physical Memory 内存大小。 GaussDB Version GaussDB Kernel版本。 表3 Top Client信息 列名称 描述 Client Addr 客户端地址。 User Id 用户id。 Application Name 客户端连接程序名称。 %Activity 活跃百分比（活跃会话总数/样本数量）。 Avg Active Sessions 平均活跃数量（活跃会话总数/切面个数）。 表4 Active sessions信息 列名称 描述 sample_time（x_axis） 采样时间。 count（y_axis） 采样事件数量。 表5 Top Events Summary信息 列名 描述 Wait Status wait status名称。 Wait Status Count wait status数量。 %Wait Status wait status百分比（wait status数量/样本数量）。 Avg Active Session wait status平均活跃会话数（wait status数量/切面数量）。 Event wait event名称。 Event Count wait event数量。 表6 Top Events Graph信息 列名 描述 smaple_time（x_axis） 采样时间。 count（y_axis） 采样事件数量。 表7 Top Sessions with Top event信息 列名 描述 Session Id 会话id。 Session Start 会话开始事件。 Session Count 活跃会话数量。 %Activity 活跃百分比（活跃会话总数/样本数量）。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 Event 活跃会话事件。 Event Count 该会话的wait event的数量。 %Event 会话事件百分比（事件数量/样本数量）。 表8 Top Sessions with Top event split by slots信息 列名 描述 Slot time 分片时间。 Session Id 会话id。 Session Start 会话开始事件。 Session Count 会话事件数量。 %Activity 活跃百分比（活跃会话总数/样本数量）。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 Event 活跃会话事件。 Event Count 该会话的wait event的数量。 %Event 会话事件百分比（事件数量/样本数量）。 表9 Top Sessions with Top SQL信息 列名 描述 Session Id 会话id。 Session Start 会话开始事件。 Session Count 会话事件数量。 %Activity 活跃百分比。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 SQL Id sqlid。 Parent SQL Id 调用本条语句的父语句SQL Id。 Node Id 节点id。 SQL Text SQL语句。 表10 Top Sessions with Top SQL split by slots信息 列名 描述 Slot Time 分片时间。 Session Id 会话id。 Session Start 会话开始事件。 Session Count 会话事件数量。 %Activity 活跃百分比（活跃会话总数/样本数量）。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 SQL Id SQL id。 Parent SQL Id 调用本条语句的父语句SQL_Id。 Node Id 节点id。 SQLText SQL语句。 表11 Top final blocking sessions with Top event split by slots信息 列名 描述 Slot Time 分片时间。 Final Blocking Session Id 阻塞会话id。 Session Start 持锁会话开始时间。 Blocked count 被该会话阻塞的会话的数量。 Blocked%Activity 阻塞会话占活跃会话百分比（阻塞会话总数/样本数量）。 Event Caused final Blocking Session等待事件。 Event Caused Count final Blocking Session等待事件的数量。 %Event 等待事件百分比（等待事件数量/样本数量）。 PID 线程id。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 Xact Start Time 持锁事务开始时间。 Global Session Id 全局会话id。 表12 Top blocked sessions with Top SQL split by slots信息 列名 描述 Slot Time 分片时间。 Lock Tag 锁tag。 Lock Mode 锁模式。 Waiting Session Count 等待会话数。 Waiting Session Id 等锁会话id。 Session Start 等锁会话开始时间。 Session Count 等锁会话数量。 Block Session Id 阻塞会话id。 Final Block Session Id 阻塞队列头部会话id。 PID 线程id。 User Id 用户id。 Application Name 连接程序名称。 Client Addr 客户端地址。 Client Port 客户端端口信息。 Xact Start Time 持锁事务开始时间。 Global Session Id 全局会话id。 SQL Id SQL id。 Parent SQL Id 调用本条语句的父语句SQL_Id。 Query Start SQL开始的时间。 SQL Count SQL的数量。 Node Id 节点id。 SQL Text SQL语句。 表13 Top SQL with Top event信息 列名 描述 SQL Id SQL id。 Parent SQL Id 调用本条语句的父语句SQL_Id。 Node Id 节点id。 User Id 用户id。 Count 会话事件数量。 %Activity 活跃百分比（SQL会话总数/样本数量）。 Event 活跃会话事件。 Event Count wait event数量。 %Event 会话事件百分比（SQL事件数量/样本数量）。 SQL Text SQL语句。 表14 Top SQL with Top event split by slots信息 列名 描述 Slot Time 分片时间。 SQL Id SQL id。 Parent SQL Id 调用本条语句的父语句SQL_Id。 Node Id 节点id。 User Id 用户id。 Count 会话事件数量。 %Activity 活跃百分比（SQL会话总数/样本数量）。 Event 活跃会话事件。 Event Count wait event数量。 %Event 会话事件百分比（SQL事件数量/样本数量）。 SQL Text SQL语句。 表15 Top SQL Text信息 列名 描述 SQL Id SQL id。 Parent SQL Id 调用本条语句的父语句SQL_Id。 Node Id 节点id。 User Id 用户id。 SQL Text SQL语句。 父主题： 附录