配置

本文档将介绍 SequoiaDB 巨杉数据库中 MySQL 实例的相关配置。

SequoiaDB 引擎配置修改方式

配置参数有以下三种修改方式:

  • 通过工具 sdb_mysql_ctl 修改配置

    $ bin/sdb_mysql_ctl chconf myinst --sdb-auto-partition=OFF
  • 通过实例数据目录下的配置文件 auto.cnf,在[mysqld]一栏添加/更改对应配置项

    sequoiadb_auto_partition=OFF

    Note:

    修改配置文件后需要重新启动 MySQL 服务

  • 通过 MySQL 命令行修改

    mysql> SET GLOBAL sequoiadb_auto_partition=OFF;

    Note:

    通过命令行方式修改的配置为临时有效,当重启 MySQL 服务后配置将失效,若需要配置永久生效则必须通过配置文件的方式修改。

SequoiaDB 引擎配置使用说明

配置 SequoiaDB 连接与鉴权

sequoiadb_conn_addr

该参数可以配置 MySQL 实例所连接的 SequoiaDB 存储集群,可以配置一个或多个协调节点的地址。使用多个时,地址之间要以逗号隔开。如 sdbserver1:11810,sdbserver2:11810。在配置多个地址时,每次连接会从地址中随机选择。在 MySQL 会话数很多时,压力会基本平均地分摊给每个协调节点。

  • 类型:string
  • 默认值:"localhost:11810"
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_user

该参数可以配置 SequoiaDB 集群鉴权的用户。SequoiaDB 鉴权支持明文密码和密码文件两种方式,建议采用密码文件的方式建立连接。

  • 类型:string
  • 默认值:""
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_password

该参数可以配置 SequoiaDB 集群鉴权的明文密码。

  • 类型:string
  • 默认值:""
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_tokensequoiadb_cipherfile

这两个参数可以配置 SequoiaDB 集群鉴权的加密口令和密码文件路径。在配置前,需通过 sdbpassword 工具生成密码文件,具体可参考数据库密码工具章节。

  • 类型:string
  • 默认值:sequoiadb_token:"",sequoiadb_cipherfile:"~/sequoiadb/passwd"
  • 作用范围:Global
  • 是否支持在线修改生效:是

Note:

  • 以上配置在命令行修改后,均在建立新连接时才生效,不影响旧连接。
  • 两种密码都配置的情况下,优先使用明文密码。

配置自动分区功能

sequoiadb_auto_partition

该参数可以配置 MySQL 是否使用自动分区功能。自动分区可以普遍提升 SequoiaDB 的性能。启动时,在 MySQL 上创建表将同步在 SequoiaDB 上创建对应的分区表(散列分区,包含所有复制组)。自动分区时,分区键按顺序优先使用主键字段和唯一索引字段。如果两者都没有,则不做分区。

如果开启自动分区后,部分表不希望被分区,可以在自定义表配置中指定 auto_partition 为 false。

  • 类型:boolean
  • 默认值:ON
  • 作用范围:Global
  • 是否支持在线修改生效:是

Note:

自动分区时,主键或唯一索引只在建表时对应分区键,建表后添加、删除主键或唯一索引都不会更改分区键。

配置默认副本数

sequoiadb_replica_size

该参数可以配置表默认的写操作需同步的副本数,取值范围为[-1,7]。副本数多时,数据一致性强度高,但性能会有所下降;副本数少时,则反之。具体可参考 SequoiaDB 创建集合的 ReplSize 参数

  • 类型:int32
  • 默认值:1
  • 作用范围:Global
  • 是否支持在线修改生效:是

配置批量插入

sequoiadb_use_bulk_insert

该参数可以配置是否开启批量插入功能。批量插入可以提升 SequoiaDB 存储引擎的插入性能。在关闭功能时,MySQL 的批量插入在 SequoiaDB 中是逐条的插入;而开启时,SequoiaDB 存储引擎会把 MySQL 的一个批次分解成若干个 sequoiadb_bulk_insert_size 大小的批次进行插入;例如,MySQL 批量插入 1024 条记录,在 sequoiadb_bulk_insert_size 为 100 时,SequoiaDB 存储引擎会进行 10 次记录数为 100 的批量插入,和 1 次记录数为 24 的批量插入。

  • 类型:boolean
  • 默认值:ON
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_bulk_insert_size

该参数可以配置 SequoiaDB 每次进行批量插入的记录数,取值范围为[1,100000]。在进行插入性能的调优时,可以根据实际适当调整这个值。

  • 类型:int32
  • 默认值:2000
  • 作用范围:Global
  • 是否支持在线修改生效:是

配置性能优化参数

sequoiadb_selector_pushdown_threshold

该参数可以配置查询字段下压的触发阈值,取值范围为[0,100]。查询字段不下压时,SequoiaDB 集群总是返回完整记录给 MySQL,由 MySQL 过滤有用字段;而在查询字段下压时,SequoiaDB 集群只返回 MySQL 所需字段。在查询字段个数/表总字段个数的百分比小于等于该阈值时查询字段下压,否则不下压。下压查询字段可以节省了网络传输,但同时也会增加 SequoiaDB 工作量,可以根据实际适当调整。

  • 类型:uint32
  • 默认值:30
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_optimizer_options

该参数可以配置是否开启优化操作。可填选项如下:
"direct_count":将 count 语句直接下压到 SeuoiaDB 执行。优化前,SELECT COUNT(*) 会请求 SequoiaDB 返回表中的所有记录,由 MySQL 进行计数;优化后,SELECT COUNT(*) 会对接到 SequoiaDB 的 SdbCollection.count() 方法,由 SequoiaDB 进行计数。
"direct_update":将 update 语句直接下压到 SeuoiaDB 执行。优化前,MySQL 会先查询匹配记录,然后逐条记录地下发更新请求。优化后,在符合条件的场景下,只需下发一次更新请求,从而减少网络 IO。
"direct_delete":将 delete 语句直接下压到 SeuoiaDB 执行。原理与 direct_update 相似,可以减少网络IO。
"direct_sort":将 order by 和 group by 直接下压到 SeuoiaDB 执行。优化前,排序操作在单个 MySQL 实例上完成。优化后,排序操作由 SequoiaDB 完成。得益于 SequoiaDB 多节点并发排序的能力,性能可以得到提升。
"direct_limit":将 limit 和 offset 直接下压到 SequoiaDB 执行。优化前,SequoiaDB 需返回所有匹配记录,limit 和 offset 操作在 MySQL 实例进行。优化后,在符合条件的场景下,SequoiaDB 只需返回 limit 指定的记录数。该选项与 direct_sort 结合使用,可以极大地提升分页查询效率。

  • 类型:set
  • 默认值:"direct_count, direct_delete, direct_update, direct_sort, direct_limit"
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

配置事务功能

sequoiadb_use_transaction

该参数可以配置事务功能。在业务无需事务功能时,可设置为 OFF,从而节省不必要的开销。

  • 类型:boolean
  • 默认值:ON
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_rollback_on_timeout

该参数可以配置记录锁超时是否中断并回滚整个事务。设置为开启后,遇到记录锁超时错误后会中断并且回滚整个事务,否则只会回滚最后一条 SQL 语句。

  • 类型:boolean
  • 默认值:OFF
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_lock_wait_timeout

该参数可以配置事务锁等待超时时间。

  • 类型:int32
  • 默认值:60
  • 取值范围:[0,3600]
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_use_rollback_segments

该参数可以配置事务是否使用回滚段。

  • 类型:boolean
  • 默认值:ON
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

配置统计信息分析

sequoiadb_stats_mode

该参数可以配置分析(ANALYZE TABLE)模式。
取值如下:
1:表示进行抽样分析,生成统计信息
2:表示进行全量数据分析,生成统计信息
3:表示生成默认的统计信息
4:表示加载统计信息到 SequoiaDB 缓存中
5:表示清除 SequoiaDB 缓存的统计信息

  • 类型:int32
  • 默认值:1
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_stats_sample_num

该参数可以指定抽样的记录个数,取值范围为[100,10000],指定 0 表示缺省。该参数不能与 sequoiadb_stats_sample_percent 同时指定。

  • 类型:int32
  • 默认值:200
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_stats_sample_percent

该参数可以指定抽样的比例,取值范围为[0.0,100.0],指定 0.0 表示缺省。表记录数和比例的乘积为抽样的记录数。个数会自动调整在 100~10000 之间(小于 100 调整为 100,大于 10000 调整为 10000)。该参数不能与 sequoiadb_stats_sample_num 同时指定。

  • 类型:double
  • 默认值:0.0
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_stats_cache

该参数可以配置是否加载 SequoiaDB 统计信息到 MySQL 缓存。统计信息缓存可以帮助生成更高效的访问计划,但会有少量的加载开销。关闭时,则使用默认规则生成访问计划,不使用统计信息。

  • 类型:boolean
  • 默认值:ON
  • 作用范围:Global
  • 是否支持在线修改生效:是

配置 SequoiaDB 节点优先级

sequoiadb_preferred_instance

该参数可以配置 MySQL 会话进行读操作时,优先选择的 SequoiaDB 节点,取值规则可参考 PreferedInstance 参数说明。

  • 类型:string
  • 默认值:"M"
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_preferred_instance_mode

该参数可以配置多个节点符合 sequoiadb_preferred_instance 条件时,节点的选择模式,取值可参考 PreferedInstanceMode 参数说明。

  • 类型:string
  • 默认值:"random"
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_preferred_strict

该参数可以配置节点选取是否为严格模式。当为严格模式时,节点只能从 sequoiadb_preferred_instance 指定的规则中选取。

  • 类型:boolean
  • 默认值:OFF
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_preferred_period

该参数可以配置优先节点的有效周期,单位为秒。如果上一次选择的节点在有效周期内,读请求仍使用该节点进行查询;有效周期之后,将根据 sequoiadb_preferred_instance 重新选择。

  • 类型:int32
  • 默认值:60
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

Note:

事务模式下,所有操作均在主节点进行。因此上述配置需在无事务模式下修改,否则无效。

其它配置

sequoiadb_alter_table_overhead_threshold

该参数可以配置表开销阈值。当表记录数超过这个阈值,需要全表更新的更改操作将被禁止。这个限制是为了防止对大表误进行更改操作,因为大表的更新会花费较多的时间。该阈值对添加 DEFAULT NULL 的列、数据类型扩容等无需更新的轻量操作不生效。如确认要对大表结构进行更改,在线上调阈值后,重新执行更改操作即可。

  • 类型:int64
  • 默认值:10000000
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_execute_only_in_mysql

该参数可以配置 DQL/DML/DDL 语句只在 MySQL 执行,不会下压到 SequoiaDB 执行。即 DDL 只会变更 MySQL 的表元数据信息,而不会变更 SequoiaDB 相应表元数据;DQL/DML 所有查询和变更都为空操作,不会实际查询和修改 SequoiaDB 相应表的数据。

  • 类型:boolean
  • 默认值:OFF
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_debug_log

该参数可以配置 MySQL 日志是否会打印 SequoiaDB 存储引擎有关 debug 信息。

  • 类型:boolean
  • 默认值:OFF
  • 作用范围:Global,Session
  • 是否支持在线修改生效:是

sequoiadb_error_level

该参数可以配置错误级别,可选的配置项有 error 和 warning,用于控制连接器的某些错误返回的方式(报错或警告)。当 SQL 语句执行出错时,若该参数配置为 error,则连接器直接返回错误信息给客户端;若该参数配置为 warning,则连接器返回警告信息给客户端。用户可根据 warning 查询详细的错误信息。该参数仅适用于 update ignore 更新分区键失败时的错误信息。

  • 类型:enum
  • 默认值:error
  • 作用范围:Global
  • 是否支持在线修改生效:是

sequoiadb_support_mode

该参数可以配置 MySQL 实例的行为模式,目前支持的模式如下:

"strict_on_table":表级别的强校验模式。该模式仅支持创建 utf8_bin 或 utf8mb4_bin 校对集的表,且不支持创建外键。如果不指定该模式,则支持创建所有校对集的表,同时忽略创建外键的相关定义。不指定该模式时,MySQL 不保证相关语句执行的正确性。

  • 类型:set
  • 默认值:strict_on_table
  • 作用范围: Global,Session
  • 是否支持在线修改生效:是

MySQL 常用系统配置

参数名 类型 动态生效 动态范围 默认值 说明
max_connections int32 Yes Global 1024 客户端最大连接数
max_prepared_stmt_count int32 Yes Global 128000 最大预编译语句数
sql_mode set Yes Global,Session STRICT_TRANS_TABLES,
ERROR_FOR_DIVISION_BY_ZERO,
NO_AUTO_CREATE_USER,
NO_ENGINE_SUBSTITUTION
SQL 模式,取值意义可参考 MySQL SQL 模式
character_set_server string Yes Global,Session utf8mb4 默认字符集
collation_server string Yes Global,Session utf8mb4_bin 默认校对集
default_storage_engine string Yes Global,Session SequoiaDB 默认存储引擎
lower_case_table_names int32 No Global 1 表名大小写策略,取值如下:
0:表名以原格式存储,比较时区分大小写
1:表名以小写格式存储,比较时不区分大小写
2:表名以原格式存储,以小写进行比较
optimizer_switch flagset Yes Global,Session index_merge_intersection=off 优化器开关,取值意义可参考 MySQL 优化器开关
transaction_isolation enum Yes Global,Session REPEATABLE-READ 事务隔离级别,取值可参考 MySQL 事务隔离级别配置
SequoiaDB v3.2.x/v3.4.x 版本不支持 RR 隔离级别,因此将 MySQL 实例的隔离级别配置为 REPEATABLE-READ 并连接至 SequoiaDB 时,隔离级别会自动降级为 READ-COMMITTED

Note:

  • 在系统最大文件句柄数不足时,max_connections 可能被自动调整。如果发现修改该配置没有生效,可检查系统 limit 设置和 MySQL 日志。
  • SequoiaDB 不支持大小写敏感的校对集。
  • 在 Linux 平台下,需谨慎变更配置 lower_case_table_names。如果随意变更该配置,可能导致匹配不到原表。
回到顶部