配置
自定义表配置
在 MySQL 上创建表时,可以在其表选项 COMMENT 中通过指定关键词 "sequoiadb" ,并紧跟一 json 对象以传入自定义的表配置参数。格式如下:
COMMENT[=]"[string,] sequoiadb:{ table_options:{...}[, auto_partition:] }"
具体配置参数如下表:
参数名类型描述是否必填stringstring用户自定义注释字符串否
table_optionsjson否
auto_partitionbool是否创建分区表。取值 false 则显式创建非分区表。否
Note:
use_partition已弃用,3.2.4版本更名为auto_partition。引擎配置项相应更名为sequoiadb_auto_partition。
示例1:在 SequoiaDB 上创建根据时间进行范围切分的表。
mysql>CREATE TABLE business_log(ts TIMESTAMP,level INT,content TEXT,PRIMARY KEY(ts))
->ENGINE=sequoiadb
->COMMENT="Sharding table for example, sequoiadb:{ table_options: { ShardingKey: { ts: 1 }, ShardingType: 'range' } }";
示例2:在引擎配置项sequoiadb_auto_partition为 ON 时,指定auto_partition为 false 显式创建普通表。
mysql>CREATE TABLE employee(id INT PRIMARY KEY,name VARCHAR(128)UNIQUE KEY)
->ENGINE=sequoiadb
->COMMENT='sequoiadb:{ auto_partition: false }';
引擎配置配置项列表
以下表格列出了所有的 SequoiaDB 存储引擎配置项,及它们的简要描述。详细信息参考后文引擎配置使用说明。
参数名类型默认值动态生效作用范围说明sequoiadb_alter_table_overhead_thresholdlong10000000YesGlobal, Session更改表开销阈值。当表记录数超过这个阈值,需要全表更新的更改操作将被禁止。sequoiadb_auto_partitionboolONYesGlobal是否启用自动分区。sequoiadb_bulk_insert_sizeint2000YesGlobal批量插入时每批的插入记录数。sequoiadb_conn_addrstring"localhost:11810"YesGlobalSequoiaDB 连接地址。sequoiadb_debug_logboolOFFYesGlobal是否打印debug日志。sequoiadb_error_levelenumerrorYesGlobal错误级别控制,为error输出错误信息,为warning输出告警信息。sequoiadb_execute_only_in_mysqlboolOFFYesGlobal, SessionDDL 命令只在 MySQL 执行,不下压到 SequoiaDB 执行。sequoiadb_optimizer_optionsset"direct_count,direct_delete,direct_update"YesGlobal, SessionSequoiaDB 优化选项开关,以决定是否优化计数、更新、删除操作。sequoiadb_passwordstring""YesGlobalSequoiaDB 鉴权密码。sequoiadb_replica_sizeint1YesGlobal写操作需同步的副本数。取值范围为[-1, 7]。sequoiadb_selector_pushdown_thresholdunsigned int30YesGlobal, Session查询字段下压触发阈值,取值范围[0, 100],单位:%。sequoiadb_use_autocommitboolONYesGlobal是否启用自动提交模式(已弃用)。sequoiadb_use_bulk_insertboolONYesGlobal是否启用批量插入。sequoiadb_use_transactionboolONNoGlobal是否开启事务功能。sequoiadb_userstring""YesGlobalSequoiaDB 鉴权用户。
配置修改方式
配置参数有三种修改方式。
使用工具sdb_sql_ctl修改配置
$ bin/sdb_sql_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_conn_addr 可以配置 MySQL 实例所连接的 SequoiaDB 存储集群。可以配置一个或多个协调节点的地址。使用多个时,地址之间要以逗号隔开。如“sdbserver1:11810,sdbserver2:11810”。在配置多个地址时,每次连接会从地址中随机随机选择。在 MySQL 会话数很多时,压力会基本平均地分摊给每个协调节点。
sequoiadb_user 和 sequoiadb_password 则需设置为所连接的 SequoiaDB 集群的鉴权用户和密码。以上的配置在命令行修改后,均在建立新连接时才生效,不影响旧连接。
配置自动分区功能
sequoiadb_auto_partition 配置项决定 MySQL 是否使用自动分区功能。自动分区可以普遍提升 SequoiaDB 的性能。自动分区默认启动,启动时,在 MySQL 上创建表将同步在 SequoiaDB 上创建对应的分区表(hash分区,包含所有分区组)。自动分区时,分区键按顺序优先使用主键字段和唯一索引字段。如果两者都没有,则不做分区。
如果开启自动分区后,部分表不希望被分区,可以在自定义表配置中指定auto_partition为 false。
Note:自动分区时,主键或唯一索引只在建表时对应分区键。建表后添加删除主键或唯一索引都不会更改分区键。
配置默认副本数
sequoiadb_replica_size 配置项可以设置表默认的写操作需同步的副本数。副本数多时,数据一致性强度高,但性能会有所下降。副本数少时,则反之。具体可参考 SequoiaDB 的创建集合的ReplSize参数。
配置批量插入
sequoiadb_use_bulk_insert 配置项决定是否开启批量插入功能。批量插入可以提升 SequoiaDB 存储引擎的插入性能。在关闭功能时,MySQL 的批量插入在 SequoiaDB 中是逐条的插入。而开启时,SequoiaDB 存储引擎会把 MySQL 的 1 个批次分解成若干个 sequoiadb_bulk_insert_size 大小的批次进行插入。例如,MySQL 批量插入 1024 条记录,在 sequoiadb_bulk_insert_size 为 100 时,SequoiaDB 存储引擎会进行 10 次记录数为 100 的批量插入,和 1 次记录数为 24 的批量插入。
sequoiadb_bulk_insert_size 配置项可以配置 SequoiaDB 每次进行批量插入的记录数。在进行插入性能的调优时,可以根据实际适当调整这个值。
性能优化配置
sequoiadb_selector_pushdown_threshold 可以配置查询字段下压的触发阈值。查询字段不下压时,SequoiaDB 集群总是返回完整记录给 MySQL,由 MySQL 过滤有用字段。而在查询字段下压时,SequoiaDB 集群只返回 MySQL 所需字段。在查询字段个数/表总字段个数的百分比小于等于该阈值时,查询字段下压,否则不下压。下压查询字段可以节省了网络传输,但它也会增加 SequoiaDB 工作。可以根据实际适当调整。
sequoiadb_optimizer_options 优化选项开关,以决定是否优化计数、更新、删除操作。direct_count 决定是否开启优化 SELECT COUNT() 行为。未优化时,SELECT COUNT() 会请求 SequoiaDB 返回表中的所有记录,由 MySQL 进行计数。开启优化时,SELECT COUNT(*) 会对接到 SequoiaDB 的SdbCollection.count()方法,由 SequoiaDB 进行计数。direct_delete 、direct_update 开启后,在符合优化的场景下会直接下压 delete、update 语句到 SequoiaDB 执行,而非正常的先 query 后 delete、update 流程,以减少网络 IO。
其它配置
sequoiadb_alter_table_overhead_threshold 配置是更改表开销阈值。当表记录数超过这个阈值,需要全表更新的更改操作将被禁止。这个限制是防止对大表误进行了更改操作。大表的更新可能花费较多的时间。该阈值对添加 DEFAULT NULL 的列、数据类型扩容等无需更新的轻量操作不生效。如确认要对大表结构进行更改,在线上调阈值后,重新执行更改操作即可。
sequoiadb_execute_only_in_mysql 配置开启后,DDL 语句只在 MySQL 侧执行,即只更改 MySQL 侧表元数据信息,而不会下压到 SDB 侧同步表 DDL 操作。
sequoiadb_debug_log 配置开启后,MySQL 日志会打印 SequoiaDB 存储引擎有关 debug 信息。
sequoiadb_error_level 错误级别控制参数。该参数可选的配置项有error(默认值)和warning,用于控制连接器的某些特定错误返回给客户端的方式(报错还是警告)。在sql语句执行出错时,当该参数配置为error时,连接器直接返回错误信息给客户端;当参数配置为warning时,连接器给客户端返回警告信息,用户想要查看详细的错误信息,可根据warning进行查询。注意:该参数并不适用于连接器所有的错误,其适用的错误仅限于:update ignore更新分区键错误。
sequoiadb_use_transaction 用于配置事务功能。默认为 ON。在业务无需事务功能时,可以将它设成 OFF,从而节省不必要的开销。
sequoiadb_use_autocommit 配置项已弃用。请直接使用 MySQL 的autocommit配置项。
MySQL 常用系统配置参数名类型动态生效动态范围默认值说明max_connectionsintYesGlobal151客户端最大连接数
sql_modesetYesGlobal, SessionSTRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTIONSQL 模式。取值意义参考MySQL SQL 模式
character_set_serverstringYesGlobal, Sessionutf8mb4默认字符集
collation_serverstringYesGlobal, Sessionutf8mb4_bin默认校对集
default_storage_enginestringYesGlobal, SessionSequoiaDB默认存储引擎
lower_case_table_namesintNoGlobal0表名大小写策略。取 0 时,大小写敏感。取 1 时,所有表名均以小写存储。取 2 时,表名以原样存储,但以小写进行比较。
Note:在系统最大文件句柄数不足时,max_connections 可能被自动调整。如果发现修改该配置没有生效,请检查系统 limit 设置和 MySQL 日志。
SequoiaDB 不支持大小写敏感的校对集。
在 Linux 平台下,MySQL 默认表名大小写敏感。更改成大小写不敏感后有可能导致匹配不到原表,须谨慎使用。