华为云用户手册

  • raise_errors_if_no_files 参数说明:设置导入时是否区分“导入文件记录数为空”和“导入文件不存在”。该参数开启时,“导入文件不存在”的时候, GaussDB 将抛出“文件不存在”的错误。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示导入时区分“导入文件记录数为空”和“导入文件不存在”。 off:表示导入时不区分“导入文件记录数为空”和“导入文件不存在”。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。 raise_errors_if_no_files参数只在GDS工具使用场景有意义,在当前形态不生效。
  • safe_data_path 参数说明:设置初始用户以外的路径前缀限制,目前包括copy和高级包路径限制。 参数类型:字符串 参数单位:无 取值范围:合法目录路径,需要小于4096个字符。 默认值:"" 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:尽量控制safe_data_path路径覆盖有限范围,不要设置过大的路径范围。 设置不当的风险与影响:当enable_copy_server_files打开,并且safe_data_path路径范围设置过大时,可能导致恶意用户访问到服务器上的敏感文件。 如果safe_data_path目录下存在软链接文件,则会按软链接实际指向的文件路径进行处理,实际路径如果不在safe_data_path下会报错处理。 如果safe_data_path目录下存在硬链接文件,则可以正常使用。为安全起见,请谨慎使用硬链接文件,切勿在safe_data_path目录下创建指向目录以外的硬链接文件,并确保safe_data_path目录权限最小化。
  • enable_copy_server_files 参数说明:是否开启copy服务器端文件的权限。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启copy服务端文件的权限,允许具有SYSADMIN权限的用户或继承了内置角色gs_role_copy_files权限的用户执行COPY FROM FILENAME或COPY TO FILENAME命令。该参数设置为on时,多租场景下,当前依旧不支持非初始用户在PDB内部执行COPY FROM FILENAME或COPY TO FILENAME命令。 off:表示不开启copy服务端文件的权限,只允许初始用户执行COPY FROM FILENAME或COPY TO FILENAME命令。 默认值:off 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:仅在需要copy服务端文件时打开,打开后建议同步设置safe_data_path。 设置不当的风险与影响:打开该参数后,如果safe_data_path设置路径范围过大,可能导致恶意用户访问到服务器上的敏感文件。
  • a_format_load_with_constraints_violation 参数说明:gs_loader导入数据支持约束冲突时,是否开启不回滚功能。该参数可在PDB级别设置。 参数类型:字符串 参数单位:无 取值范围: "s1":表示gs_loader支持约束冲突时,开启不回滚功能。 "":表示gs_loader支持约束冲突时,不开启不回滚功能。 "s2":表示copy、\copy以及gs_loader均支持跳过约束冲突的错误。 默认值:""。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
  • 系统表和系统视图概述 系统表是GaussDB存放结构元数据的地方,它是 GaussDB数据库 系统运行控制信息的来源,是数据库系统的核心组成部分。 系统视图提供了查询系统表和访问数据库内部状态的方法。 系统表和系统视图要么只对管理员可见,要么对所有用户可见。下面的系统表和视图有些标识了需要管理员权限,这些系统表和视图只有管理员可以查询。 用户可以删除后重新创建这些表、增加列、插入和更新数值,但是用户修改系统表会导致系统信息的不一致,从而导致系统控制紊乱。正常情况下不应该由用户手工修改系统表或系统视图,或者手工重命名系统表或系统视图所在的模式,而是由SQL语句关联的系统表操作自动维护系统表信息。 不建议用户修改系统表和系统视图的权限。 用户应该禁止对系统表进行增删改等操作,人为对系统表的修改或破坏可能会导致系统各种异常情况甚至数据库不可用。 系统表和系统视图中的字段类型详见数据类型章节介绍。 对于ADM类视图,由于访问到的对象是数据库下所有的该类型的对象,考虑对ADM类视图进行统一权限管理,默认只有系统管理员有权限访问该类型视图,部分ADM类的视图数据来自基表中公开、非敏感的字段;对于DB类视图,查询到的是数据库内当前用户有权限访问的对象,普通用户即可访问该类视图;对于MY类视图,查询到的是当前用户所属的对象,普通用户即可访问该类视图。 父主题: 系统表和系统视图
  • PG_TABLESPACE PG_TABLESPACE系统表存储表空间信息。 表1 PG_TABLESPACE字段 名称 类型 描述 oid oid 行标识符(隐含属性,必须明确选择)。 spcname name 表空间名称。 spcowner oid 表空间的所有者,通常是创建它的人。 spcacl aclitem[] 访问权限。具体请参见GRANT和REVOKE。 spcoptions text[] 表空间的选项。 spcmaxsize text 可使用的最大磁盘空间大小,单位Byte。 relative boolean 标识表空间指定的存储路径是否为相对路径。 t(true):表示是。 f(false):表示不是。 父主题: 其他系统表
  • 创建数据库用户 默认只有数据库安装时创建的管理员用户可以访问初始数据库,您还可以创建其他数据库用户账号。 1 gaussdb=# CREATE USER joe WITH PASSWORD '********'; 当结果显示为如下信息,则表示创建成功。 1 CREATE ROLE 如上创建了一个用户名为joe,密码为********的用户。 执行如下命令设置joe用户为系统管理员。 gaussdb=# GRANT ALL PRIVILEGES TO joe; 使用GRANT命令进行相关权限设置,具体操作请参见GRANT。 关于数据库用户的更多信息请参见用户及权限。 父主题: 操作数据库
  • 原型 PGresult* PQexecPrepared(PGconn* conn, const char* stmtName, int nParams, const char* const* paramValues, const int* paramLengths, const int* paramFormats, int resultFormat);
  • 参数 表1 PQexecPrepared参数 关键字 参数说明 conn 连接句柄。 stmtName stmt名称,可以用""或者NULL来引用未命名语句,否则它必须是一个现有预备语句的名字。 nParams 参数个数。 paramValues 参数的实际值。 paramLengths 参数的实际数据长度。 须知: 下列情况中,参数长度强制使用paramLengths中对应的值: 参数格式为二进制。 参数格式为文本且连接参数force_no_truncation的值为1。 此时paramLengths不允许为空,并且参数长度的正确性须由调用者自行保证。 paramFormats 参数的格式(文本或二进制)。 resultFormat 结果的格式(文本或二进制)。
  • 背景信息 当用户需要频繁查询多张表的特定字段组合时,可通过定义视图来避免重复编写查询语句。视图通过虚拟表抽象底层表结构,简化常用查询操作。 视图是一种逻辑表,与物理存储的基本表不同,其数据不实际驻留于磁盘。数据库仅保存视图的查询定义,实际数据始终保留在关联的基础表中。当基础表数据发生变更时,视图查询结果将动态同步这些变化。视图如同一个实时数据窗口,允许用户访问其关注的数据镜像。每次访问视图时,系统都会重新执行其定义查询以获取最新数据。
  • enable_invisible_indexes 参数说明:设置优化器是否可以使用不可见索引。该参数可在PDB级别设置。 索引在被设置为不可见状态后,可能会对查询语句的性能产生影响。此时若不想变更索引可见性状态,且打算使用不可见索引,可设置enable_invisible_indexes参数为on。 参数类型:布尔型 参数单位:无 取值范围: on:优化器可以使用不可见索引。 off:优化器不可以使用不可见索引。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:使用不可见索引但未开启此参数时,可能导致忽略不可见索引,因此可能有更优计划未被考虑。
  • enable_dynamic_samplesize 参数说明:是否动态调整采样行数。对于超过一百万行的大表,收集统计信息时动态调整采样行数,提高统计信息准确性。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示该功能打开。 off:表示该功能关闭。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭后可能会降低统计信息准确性。 动态调整采样行数的功能仅支持绝对值采样。
  • default_statistic_granularity 参数说明:默认情况下,当未指定PARTITION_MODE时,指定默认收集哪些分区表分区级统计信息。对非分区表不生效。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: all:收集整表、一级分区、二级分区的统计信息。 global:收集整表的统计信息。 partition:收集一级分区的统计信息。 global_and_partition:收集整表、一级分区的统计信息。 subpartition:收集二级分区的统计信息。 all_complete:收集整表、一级分区、二级分区的统计信息。 默认值:all。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。如果需要收集分区级统计信息,可根据实际需要设置,但可能会对ANALYZE的性能产生一定影响。 设置不当的风险与影响:需要在维护开销与统计信息准确性间权衡,设置不当可能导致一方代价过大。
  • enable_fast_numeric_agg 参数说明:该参数控制是否开启针对numeric数据类型的agg优化。多租场景下,该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启numeric数据类型的agg优化。 off:表示不开启numeric数据类型的agg优化。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭后可能会导致对应场景查询性能下降。
  • stats_history_record_limit 参数说明:每个对象(包括表、列、分区、索引)的历史统计信息保留数目上限。每个对象在收集统计信息时会同时存入历史统计信息表中,当历史统计信息表中该对象的统计信息数量达到该阈值,再次收集新的统计信息时,时间较早的统计信息会被清理。 参数类型:整型 参数单位:条 取值范围:0 ~ 100 默认值:10 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,如果需要记录更多历史版本的统计信息可以适当调大该参数,但可能会对analyze的性能产生一定影响。 设置不当的风险与影响:设置过大可能会对analyze的性能产生一定影响。
  • stats_history_retention_time 参数说明:每个对象(包括表、列、分区、索引)的历史统计信息保留时间。每个对象在收集统计信息时会同时存入历史统计信息表中,当历史统计信息表中该对象的统计信息的保留时间超过该阈值后,再次收集新的统计信息时,已经超过保留时间的统计信息会被清理。 参数类型:浮点型 参数单位:d(天) 取值范围:-1、0 ~ 365000,-1表示历史统计信息不因时间而清除。 默认值:31 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,如果需要记录更早时间的历史版本的统计信息可以适当调大该参数,但可能会对analyze的性能产生一定影响。 设置不当的风险与影响:设置过大可能会对analyze的性能产生一定影响。
  • enable_planmgr_cplan_opt 参数说明:该参数用于控制,当优化器使用custom plan时,是否尝试使用自适应计划进行拦截,如果拦截成功,则会使用自适应计划,否则会继续使用该custom plan。 参数类型:布尔型 参数单位:无 取值范围: on:表示不尝试使用自适应计划进行拦截。 off:表示尝试使用自适应计划进行拦截。 默认值:on 设置方式:该参数属于USERSET类型参数,请参考表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:无
  • enable_startwith_debug 参数说明:该参数控制是否显示start with/connect by用于debug的信息,打开该参数可以显示start with/connect by特性所有涉及的尾列相关信息。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启。 off:表示关闭。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,在问题定位时打开。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
  • enable_auto_explain 参数说明:控制是否开启自动打印执行计划,该参数可用来定位慢存储过程或慢查询。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示开启。 off:表示关闭。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,若需要查看执行计划,则开启,但会降低当前系统性能。 设置不当的风险与影响:开启后可能会降低当前系统性能。
  • enable_indexscan_optimization 参数说明:控制是否对astore存储引擎下的btree索引扫描(IndexScan和IndexOnlyScan)进行优化。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭可能会导致对应场景查询性能下降。
  • immediate_analyze_threshold 参数说明:插入数据后自动做analyze的阈值。当一次新增数据量达到原有数据量的immediate_analyze_threshold倍,且原有数据和本次新增数据的总行数超过一百时,会自动触发一次analyze。 参数类型:整型 参数单位:无 取值范围:0 ~ 1000。当取值为0时,该功能关闭。 默认值:0 设置方式:该参数属于SIGHUP类型参数,请参见表1中对应设置方法进行设置。 设置建议:对数据变化较快且需要不断更新统计信息的表设置为较小值,对达到一定量数据后统计信息才产生较大波动的表设置为较大值。 设置不当的风险与影响:设置过大时,可能导致统计信息未能及时更新;设置过小时,可能导致统计信息分析的开销过大。 该功能只支持永久表和非日志表,不支持临时表。 同一表不会在10s内两次被自动触发analyze。
  • auto_explain_level 参数说明:控制自动打印执行计划的日志等级。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围: log:表示在日志中打印执行计划。 notice:表示以提示的形式打印出计划。 默认值:log。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
  • enable_inner_unique_opt 参数说明:控制是否对嵌套循环连接、哈希连接、排序归并连接进行Inner Unique优化,即在连接条件中内表对应的属性满足唯一性约束的情况下,是否减少匹配次数。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示使用。 off:表示不使用。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭可能会导致对应场景查询性能下降。
  • auto_explain_log_min_duration 参数说明:控制自动打印执行计划的耗时阈值,整体耗时大于auto_explain_log_min_duration的执行计划才会被打印。比如该参数设置为0时,所有执行过的执行计划都会输出;设置为3000时,单次语句执行耗时超过3000毫秒的所有执行的执行计划会输出。该参数可在PDB级别设置。 参数类型:整型 参数单位:ms(毫秒) 取值范围:0 ~ 2147483647 默认值:0。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。例如,设置为100,不带单位,表示100ms;设置为2min,带单位,表示2min。取值如果要带单位,必须为ms、s、min、h、d。 设置建议:推荐使用默认值。可根据业务需要调整数值,以输出慢查询语句。 设置不当的风险与影响:设置过小可能会导致输出内容过多。
  • enable_uniq_idx_a_compat 参数说明:控制复合唯一索引针对Null值是否兼容A数据库。多租场景下,该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示兼容。 off:表示不兼容。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:该参数仅在A兼容性的数据库中适用,建议使用默认值。 设置不当的风险与影响:设置不当可能会影响兼容性或导致查询规划开销增加。
  • enable_force_vector_engine 参数说明:对于支持向量化的执行器算子,如果其子节点是非向量化的算子,通过设置此参数为on,强制生成向量化的执行计划。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示可以向量化的算子强制生成向量化。 off:表示由向量化算子优化器决定是否向量化。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,在向量化业务场景下推荐打开。 设置不当的风险与影响:启用该参数可能导致查询性能劣化。
  • query_dop 参数说明:用户自定义的查询并行度。开启SMP功能后,系统会使用设定的并行度执行。该参数可在PDB级别设置。 参数类型:整型 参数单位:无 取值范围:1 ~ 64。1表示关闭并行查询。 默认值:1。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值,在CPU、内存、I/O和网络带宽等资源充足的情况下,并行度越高,性能提升效果越好。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。 在开启并行查询后,请保证系统CPU、内存、网络等资源充足,以达到最佳效果。
  • enable_analyze_check 参数说明:标识在生成计划的时候,对于在pg_class中reltuples和relpages均为0的表,是否允许检查这些表有没有曾进行过统计信息的收集。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示允许检查。 off:表示不允许检查。 默认值:off。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于SUSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。启用检查可能会带来计划生成的开销,但会确保是否进行过统计信息的收集;如果确定大多数在pg_class中reltuples和relpages均为0的表无需额外收集统计信息,可保持关闭。 设置不当的风险与影响:请在充分理解参数含义,并经过测试验证后进行修改。
  • enable_sonic_optspill 参数说明:标识是否对面向列的hash表设计的Hash Join算子进行下盘文件数优化。该参数打开时,在Hash Join算子下盘文件较多的时候,下盘文件数不会显著增加。该参数可在PDB级别设置。 参数类型:布尔型 参数单位:无 取值范围: on:表示优化面向列的hash表设计的Hash Join算子的下盘文件数。 off:表示不优化面向列的hash表设计的Hash Join算子的下盘文件数。 默认值:on。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:推荐使用默认值。 设置不当的风险与影响:关闭可能会导致该场景下查询性能劣化。
  • plan_cache_mode 参数说明:标识在prepare语句中,选择生成执行计划的策略。该参数可在PDB级别设置。 参数类型:枚举类型 参数单位:无 取值范围:auto、force_generic_plan、force_custom_plan auto:表示由优化器自动选择custom plan或者generic plan。 force_generic_plan:表示强制走generic plan(软解析)。generic plan是指对于prepare语句生成计划,该计划策略会在执行execute语句的时候把参数bind到plan中,然后执行计划。这种方案的优点是每次执行可以省去重复的优化器开销;缺点是当bind参数字段上数据存在倾斜时该计划可能不是最优的,部分bind参数场景下执行性能较差。bind会绑定第一次传入的参数类型,如果同一占位符两次传入的参数类型不一致会导致报错。 force_custom_plan:表示强制走custom plan(硬解析)。custom plan是指对于prepare语句,在执行execute的时候,把execute语句中的参数嵌套到语句之后生成的计划。custom plan会根据execute语句中具体的参数生成计划,这种方案的优点是每次都按照具体的参数生成优选计划,执行性能比较好;缺点是每次执行前都需要重新生成计划,存在大量的重复的优化器开销。 此参数只对prepare语句生效,一般用在prepare语句中参数化字段存在比较严重的数据倾斜的场景下。 默认值:auto。在PDB场景内,若未设置该参数,则继承来自全局的设置。 设置方式:该参数属于USERSET类型参数,请参见表1中对应设置方法进行设置。 设置建议:根据实际业务场景进行设置。 设置不当的风险与影响:设置不当可能会导致计划生成开销增加或计划生成质量下降。
共100000条
提示

您即将访问非华为云网站,请注意账号财产安全