华为云用户手册

云数据库 GAUSSDB-gs_ktool:功能介绍

功能介绍 gs_ktool为客户端提供CMK明文，以保证其能够对CEK的进行加解密；与此同时，gs_ktool还为用户提供人机交互接口，以支持以下功能：支持管理CMK：创建、删除、查询、导入和导出CMK。其中，查询功能不支持查询CMK的明文或者密文。目前，gs_ktool不支持更新CMK，用户仅能通过删除旧的密钥，并创建新的密钥以达到同等的效果. 全密态当前仅支持华为云KMS，gs_ktool不具备自动备份密钥能力，一旦密钥丢失，则数据无法恢复，建议gs_ktool仅作为验证与调试使用。如果用户需要将gs_ktool中密钥进行备份，请手工执行密钥导出命令。并请注意，在进行密钥导入时，会覆盖当前gs_ktool中保存的所有密钥，请谨慎使用。支持管理RK：查询、更新RK. 支持查询操作日志：针对上述对密钥进行管理的操作，gs_ktool均会记录相关的操作日志，用户可查看日志文件。

云数据库 GAUSSDB 客户端工具
云数据库 GEMINIDB-查询GeminiDB Influx数据库慢日志:请求示例

请求示例查询2023-07-06 10:41:14~2023-07-10 10:41:14的100条select慢日志。 POST https://{Endpoint}/v3/2900b7b8d03e4619b8db8d43bc6234ee/influxdb/instances/4466bd981011413cb98514e1cc20fdb0in13/slow-logs { "start_time" : "2023-07-06T10:41:14+0800", "end_time" : "2023-07-10T10:41:14+0800", "limit" : 100, "line_num" : "1595659490239433658", "operate_type" : "SELECT", "node_id" : "8b76c35e91eb4c9d82fe25417d750cb5no13", "max_cost_time" : 100, "min_cost_time" : 50, "database" : "dbname" , "retention_policy" : "monitor" }

云数据库 GEMINIDB 日志管理
云数据库 GEMINIDB-查询GeminiDB Influx数据库慢日志:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 slow_logs Array of objects GeminiDB Influx慢日志列表。详情请参考表5。表5 InfluxdbSlowLogDetail 参数参数类型描述 node_id String 节点ID。 node_name String 节点名称。 whole_message String 执行语句。 operate_type String 语句类型。 cost_time String 执行时间。单位：ms。 log_time String 日志产生时间，UTC时间。格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 database String 数据库名称。 retention_policy String 保留策略。 line_num String 日志单行序列号。

云数据库 GEMINIDB 日志管理
云数据库 GEMINIDB-查询GeminiDB Influx数据库慢日志:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。表3 请求Body参数参数是否必选参数类型描述 start_time 是 String 开始时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。注：开始时间不得早于当前时间30天。 end_time 是 String 结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。注：结束时间不能晚于当前时间。 limit 是 Integer 表示每次查询的日志条数，最大限制100条。 line_num 否 String 日志单行序列号，第一次查询时不需要此参数，下一次查询时需要使用，可从上一次查询的返回信息中获取。说明：当次查询从line_num的下一条日志开始查询，不包含当前line_num日志。 operate_type 否 String 语句类型，取空值，表示查询所有语句类型。枚举值： SELECT DELETE SHOW DROP CREATE ALTER node_id 否 String 节点ID，取空值，表示查询实例下所有允许查询的节点。具体取值请参考表10中的“id”。 keywords 否 String 根据多个关键字搜索日志全文，表示同时匹配所有关键字。最多支持10个关键字，每个关键字最大长度不超过512个字符。 max_cost_time 否 Integer 支持根据最大执行时间范围查找日志。单位：ms。 min_cost_time 否 Integer 支持根据最小执行时间范围查找日志。单位：ms。 database 否 String 数据库名称。 retention_policy 否 String 保留策略。

云数据库 GEMINIDB 日志管理
云数据库 GAUSSDB-优化器方法配置:enable_nodegroup_debug

enable_nodegroup_debug 参数说明：控制优化器在多Node Group环境下，是否使用强制弹性计算。Node Group目前为内部用机制，用户无需设置。该参数只在expected_computing_nodegroup被设置为具体Node Group时生效。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示强制将计算弹性到expected_computing_nodegroup所指定的Node Group进行计算。 off表示不强制使用某个Node Group进行计算。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:enable_default_index_deduplication

enable_default_index_deduplication 参数说明：设置btree索引默认情况下是否对键值重复的元组进行去重压缩。去重压缩功能对主键索引和唯一索引不生效。在重复键值的索引较多时，去重压缩功能可以有效降低索引占用空间。非唯一索引且索引键值重复度很低或者唯一的场景，去重压缩功能会使索引插入性能小幅度劣化。若创建索引时带有with (deduplication=on/off)语法时，优先根据deduplication参数决定该索引是否使用去重压缩功能。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 off：为默认取值，表示btree索引默认关闭索引去重压缩功能。 on：表示btree索引默认开启索引去重压缩功能。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:enable_expr_fusion

enable_expr_fusion 参数说明：控制SRF、表达式展平、取消集中式Seq Scan投影、共享聚合函数的转移状态和Step步数优化特性的开关。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 off：为默认取值，表示关闭本功能。 on：表示同时启用SRF、表达式展平、取消集中式Seq Scan投影、共享聚合函数的转移状态和Step步数优化特性。默认值：off 只支持query_dop=1的场景。

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:try_vector_engine_strategy

try_vector_engine_strategy 参数说明：设置行存表走向量化执行引擎的策略。通过设置该参数，可以使包含行存表的查询可以转换为向量化的执行计划执行计算，从而提升类AP场景的复杂查询的执行性能。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：枚举型 off，为默认取值，表示关闭本功能，即行存表不会转换为向量的执行计划执行。 force，表示只要查询中不包含向量化引擎不支持的类型或者表达式，则不论查询的基表为行存表、列存表，还是行列混合存储的，强制将查询转换为向量化的执行计划执行计算。在这种情况下，针对不同的查询场景可能出现性能下降。 optimal，表示在force的基础上，由优化器根据查询的复杂度进行选择是否将查询语句转换为向量化的执行计划，尽可能避免转换为向量化的执行计划后出现性能下降。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:expected_computing_nodegroup

expected_computing_nodegroup 参数说明：标识选定的计算Node Group模式或目标计算Node Group。Node Group目前为内部用机制，用户无需设置。共4种计算Node Group模式，用于关联操作和聚集操作时选定计算Node Group。在每一种模式中，优化器有针对性地选定几个候选计算Node Group，然后根据代价，从中为当前算子挑选最佳计算Node Group。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串 optimal：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前用户具有COMPUTE权限的所有Node Group包含的所有DN构成的Node Group query：候选计算Node Group列表包含算子操作对象所在的Node Group和由当前查询涉及的所有基表所在Node Group包含的所有DN构成的Node Group Node Group名（enable_nodegroup_debug被设置为off）：候选计算Node Group列表包含算子操作对象所在的Node Group和该指定的Node Group Node Group名（enable_nodegroup_debug被设置为on）：候选计算Node Group为指定的Node Group 默认值：query

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:qrw_inlist2join_optmode

qrw_inlist2join_optmode 参数说明：控制是否使用inlist-to-join查询重写。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串 disable：关闭inlist2join查询重写。 cost_base：基于代价的inlist2join查询重写。 rule_base：基于规则的inlist2join查询重写，即强制使用inlist2join查询重写。任意正整数：inlist2join查询重写阈值，即list内元素个数大于该阈值，进行inlist2join查询重写。默认值：cost_base

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:enable_stream_operator

enable_stream_operator 参数说明：控制优化器对stream的使用。当enable_stream_operator参数关闭时，会有大量关于计划不能下推的日志记录到日志文件中。如果用户不需要这些日志内容，建议用户在enable_stream_operator参数关闭时，也同时关闭enable_unshipping_log参数。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示使用。 off表示不使用。默认值：独立部署：off

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:best_agg_plan

best_agg_plan 参数说明：对于stream下的Agg操作，优化器会生成三种计划： hashagg+gather(redistribute)+hashagg。 redistribute+hashagg(+gather)。 hashagg+redistribute+hashagg(+gather)。本参数用于控制优化器生成哪种hashagg的计划。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：0，1，2，3 取值为1时，强制生成第一种计划。取值为2时，如果group by列可以重分布，强制生成第二种计划，否则生成第一种计划。取值为3时，如果group by列可以重分布，强制生成第三种计划，否则生成第一种计划。取值为0时，优化器会根据以上三种计划的估算cost选择最优的一种计划生成。默认值：0

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:enable_stream_concurrent_update

enable_stream_concurrent_update 参数说明：控制优化器在并发更新场景下对stream的使用，该参数受限于enable_stream_operator参数。如果出现并发update冲突，有一定可能会出现报错，可以通过本参数控制。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示允许优化器对update语句生成stream计划。 off表示优化器对update语句仅能生成非stream计划。默认值：on

云数据库 GAUSSDB
云数据库 GAUSSDB-优化器方法配置:agg_redistribute_enhancement

agg_redistribute_enhancement 参数说明：当进行Agg操作时，如果包含多个group by列且均不为分布列，进行重分布时会选择某一group by列进行重分布。本参数控制选择重分布列的策略。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on表示会选择估算distinct值最多的一个可重分布列作为重分布列。 off表示会选择第一个可重分布列为重分布列。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-cm_server参数:datastorage_threshold_value_check

datastorage_threshold_value_check 参数说明：设置数据库只读模式的磁盘占用阈值，当数据目录所在磁盘占用超过这个阈值，自动将数据库设置为只读模式。调整该参数时，建议同步调整dn的max_size_for_xlog_retention参数，避免因备份操作触发集群只读阈值。取值范围：整型，1 ~ 99，表示百分比。修改后可以reload生效，参数修改请参考表2进行设置。默认值：85

云数据库 GAUSSDB
云数据库 GAUSSDB-cm_server参数:enable_transaction_read_only

enable_transaction_read_only 参数说明：控制是否打开cm_server磁盘自动阈值检测功能，该功能打开后，当磁盘使用率大于datastorage_threshold_value_check值时，cm_server会自动将数据库设置为只读模式。取值范围：布尔型，有效值有on，off，true，false，yes，no，1，0。修改后可以reload生效，参数修改请参考表2进行设置。默认值：on

云数据库 GAUSSDB
云数据库 GAUSSDB-cm_server参数:ddb_log_level

ddb_log_level 参数说明：设置ddb日志级别。关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。开启日志：“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”日志级别可以从上述字符串中选取字符串并使用竖线组合使用，不能配置空串。取值范围：字符串，RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。修改后可以reload生效，参数修改请参考表2进行设置。默认值：RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE

云数据库 GAUSSDB
云数据库 GAUSSDB-cm_server参数:cm_krb_server_keyfile

cm_krb_server_keyfile 参数说明：kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态取值范围：字符串类型，修改后可以reload生效，参数修改请参考表2进行设置。默认值：${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示

云数据库 GAUSSDB
云数据库 GAUSSDB-cm_server参数:alarm_component

alarm_component 参数说明：设置用于处理告警内容的告警组件的位置。取值范围：字符串。修改后可以reload生效，参数修改请参考表2进行设置。若前置脚本gs_preinstall中的--alarm-type参数设置为5时，表示未对接第三方组件，告警写入system_alarm日志，此时GUC参数alarm_component的取值为：/opt/huawei/snas/bin/snas_cm_cmd。若前置脚本gs_preinstall中的--alarm-type参数设置为1时，表示对接第三方组件，此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。默认值：/opt/huawei/snas/bin/snas_cm_cmd

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:enable_gpi_auto_update

enable_gpi_auto_update 参数说明：控制在分区DDL命令中是否默认更新Global索引。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。该参数必须在CN和DN设置为相同值，否则可能会导致Global索引功能异常。取值范围：布尔型 on表示默认更新Global索引，此时分区DDL无论带不带UPDATE GLOBAL INDEX子句，都会更新Global索引。 off表示默认不更新Global索引，此时只有当分区DDL带UPDATE GLOBAL INDEX子句，才会更新Global索引。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:change_cluster_mode

change_cluster_mode 参数说明：用于表示集群是否处于模式切换过程中，其中“模式切换”是指：一主两备集群切换为一主一备一日志集群，或一主一备一日志集群切换为一主两备集群，或一主一备一日志集群中备DN和日志DN互切。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~2147483647 0表示不处于集群模式切换过程中。 1表示处于集群模式切换过程中。其他值无实际意义，效果等同于设置为0。默认值：0 该参数用于控制“分布式备机读”功能是否正常可用。当设置为1时，“分布式备机读”功能将无法使用，请谨慎设置该参数。

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:transparent_encrypt_kms_url

transparent_encrypt_kms_url 参数说明：该参数已废弃。它存储的是透明加密的数据库密钥获取地址，内容要求不可出现RFC3986标准外的字符，最大长度2047字节。格式为“kms://协议@KMS主机名1;KMS主机名2:KMS端口号/kms”，例如kms://https@linux175:29800/。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串默认值：空

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:enable_upgrade_merge_lock_mode

enable_upgrade_merge_lock_mode 参数说明：当该参数设置为on时，通过提升deltamerge内部实现的锁级别，避免和update/delete并发操作时的报错。该参数属于USERSET类型参数，请参考表1中对应设置方法进行设置。取值范围：布尔型 on，提升deltamerge内部实现的锁级别，并发执行deltamerge和update/delete操作时，一个操作先执行，另一个操作被阻塞，在前一个操作完成后，后一个操作再执行。 off，在对表的delta table的同一行并发执行deltamerge和update/delete操作时，后一个对同一行数据更新的操作会报错退出。默认值：off

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:server_version

server_version 参数说明：报告服务器版本号(字符串形式)。该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version版本，无实际含义，为保持北向对外工具接口的生态兼容性(工具连接时查询)，保留该参数。该参数不建议使用，可通过函数opengauss_version()获取内核版本信息。取值范围：字符串默认值：9.2.4

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:transparent_encrypted_string

transparent_encrypted_string 参数说明：该参数已废弃。它存储的是透明加密的一个样本串，使用数据库加密密钥加密固定串“TRANS_ENCRYPT_SAMPLE_STRING”后的密文，用来校验二次启动时获取的DEK是否正确。如果校验失败，那么CN、DN将拒绝启动。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，设置为空表示整个集群为加密。默认值：空请勿手动设置该参数，设置不当将导致集群不可用。

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:server_version_num

server_version_num 参数说明：报告服务器版本号(整数形式)。该参数属于INTERNAL类型参数，为固定参数，用户无法修改此参数，只能查看。该参数继承自PostgreSQL内核，表示当前数据库内核兼容PostgreSQL对应的server_version_num版本，无实际含义，为保持北向对外工具接口的生态兼容性(工具连接时查询)，保留该参数。取值范围：整型默认值：90204

云数据库 GAUSSDB
云数据库 GAUSSDB-其它选项:max_concurrent_autonomous_transactions

max_concurrent_autonomous_transactions 参数说明：自治事务最大连接数，同一时间自治事务执行的最大并发数。当设置为0时，将无法执行自治事务。该参数属于POSTMASTER类型参数，请参考表表1中对应设置方法进行设置。取值范围：0-10000，理论最大值为10000，实际最大值为动态值，计算公式为“262143 - job_queue_processes - autovacuum_max_workers - max_inner_tool_connections - max_connections - AUXILIARY_BACKENDS - AV_LAUNCHER_PROCS”，job_queue_processes、autovacuum_max_workers、max_inner_tool_connections和max_connections的值取决于对应GUC参数的设置，AUXILIARY_BACKENDS为预留辅助线程数固定为20，AV_LAUNCHER_PROCS为预留autovacuum的launcher线程数固定为2。默认值：独立部署：80（60核CPU/480G内存）；40（32核CPU/256G内存）；20（16核CPU/128G内存）；10（8核CPU/64G内存，4核CPU/32G内存，4核CPU/16G内存）设置建议：根据实际业务需要和硬件配置设置此参数，建议不超过max_connections的1/10。若仅调大此参数，未同比例调整内存参数，业务压力大时，容易出现内存不足，报错提示“memory is temporarily unavailable”。若升级过程中涉及此参数范围变更，并且在commit前修改了此参数，则如果执行升级回滚，需要将此参数调整至升级前允许的范围，否则可能导致数据库无法启动。

云数据库 GAUSSDB
云数据库 GAUSSDB-日志回放:redo_bind_cpu_attr

redo_bind_cpu_attr 参数说明：用于控制回放线程的绑核操作，仅sysadmin用户可以访问。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：字符串，长度大于0 可选择的配置方式有：1. 'nobind' ，线程不做绑核；2. 'nodebind: 1, 2'，利用NUMA组1,2中的CPU core进行绑核；3. 'cpubind: 0-30'，利用0-30号CPU core进行绑核。该参数不区分大小写。默认值：'nobind' 本参数主要用于arm环境下的绑核操作。推荐将所有的回放线程绑定到一个numa组内，性能会更好。

云数据库 GAUSSDB 预写式日志
云数据库 GAUSSDB-日志回放:recovery_time_target

recovery_time_target 参数说明：设置recovery_time_target秒能够让备机完成日志写入和回放。该参数属于SIGHUP类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，0~3600（秒） 0是指不开启日志流控，1~3600是指备机能够在recovery_time_target时间内完成日志的写入和回放，可以保证主机与备机切换时能够在recovery_time_target秒完成日志写入和回放，保证备机能够快速升主机。recovery_time_target设置时间过小会影响主机的性能，设置过大会失去流控效果。默认值：60

云数据库 GAUSSDB 预写式日志
云数据库 GAUSSDB-日志回放:recovery_redo_workers

recovery_redo_workers 参数说明：是极致RTO特性中每个ParseRedoRecord线程对应的PageRedoWorker数量。该参数属于POSTMASTER类型参数，请参考表1中对应设置方法进行设置。取值范围：整型，1~8 需要配合recovery_parse_workers使用。在配合recovery_parse_workers使用时，只有recovery_parse_workers大于1，recovery_redo_workers参数才生效。默认值：1 从V500R001C00版本升级到V500R001C10及其后续版本后，建议根据环境的CPU个数进行参数设置，并重启DN。CPU个数小于16个，建议设置成2；大于16小于32个，建议设置成4；大于32个，建议设置成8。

云数据库 GAUSSDB 预写式日志

共100000条

undefined

意见反馈

0/200

提交取消

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

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线