TokuDB变量¶

和所有存储引擎一样，TokuDB具有优化性能和控制行为的变量。分形树算法是为接近最佳性能而设计的，TokuDB的默认设置在大多数情况下都能很好地工作，在大多数情况下无需进行复杂和耗时的调优。

TokuDB服务器变量¶

tokudb_alter_print_error¶

当设置为在过程中将错误打印到客户端ALTER TABLE上的操作TokuDB表。

tokudb_analyze_delete_fraction¶

此变量控制是否将分形树中已删除的行报告给客户端和MySQL错误日志。分析表操作TokuDB表格当设置为1，没有任何报道。当设置为0．1至少10%的行被扫描分析被删除的行还没有被垃圾收集，一个报告返回给客户端和MySQL错误日志。

tokudb_backup_allowed_prefix¶

这个系统级变量限制备份所在的目标目录的位置。尝试备份到该变量指向的目录或其子目录之外的位置将导致错误。

默认值为NULL，备份没有限制位置。方法中设置此只读变量my.cnf配置文件，并显示显示变量加载Percona Tok雷竞技下载官网uBackup插件时执行命令。

mysql>显示变量就像“tokudb_backup_allowed_prefix”；

输出可以是:

+------------------------------+-----------+ | Variable_name |值  | +------------------------------+-----------+ | tokudb_backup_allowed_prefix | / dumpdir  | +------------------------------+-----------+

tokudb_backup_dir¶

启用此会话级别变量时，该会话级别变量有两个用途:指向将转储备份的目标目录，以及在设置该会话级别变量后立即启动备份。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_backup_exclude¶

使用此变量可设置正则表达式，该正则表达式定义不包含备份的源文件。例如，排除所有发现了+目录，使用以下命令:

mysql>集tokudb_backup_exclude＝' /丢失\ \ +发现($ | /)'；

有关更多信息，请参阅雷竞技下载官网Percona TokuBackup．

tokudb_backup_last_error¶

此会话变量将包含上次备份的错误编号。0表示成功。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_backup_last_error_string¶

这个会话变量将包含上次备份的错误字符串。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_backup_plugin_version¶

类的版本TokuBackup插件。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_backup_throttle¶

此变量指定热备份进程的复印机每秒将消耗的最大字节数。降低该值会增加热备操作的时间，减少服务器上的I/O消耗。默认值为18446744073709551615这意味着没有节流。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_backup_version¶

这个只读服务器变量记录热备份库的版本。有关更多信息，请参阅Percona TokuBac雷竞技下载官网kup。

tokudb_block_size¶

在必须刷新消息或必须分割节点之前，此变量控制内存中节点的最大大小。

更改tokudb_block_size的值只会影响随后创建的表和索引。如果不进行转储和重新加载，则不能为现有表/索引更改此变量的值。

tokudb_bulk_fetch¶

此变量决定是否将我们的批量获取算法用于选择语句。选择语句包括pure选择……语句，以及INSERT INTO table name…选择……，创建表选择……，替换成表名…选择……，INSERT IGNORE INTO table name…选择……,INSERT INTO table name…选择……关于重复密钥更新．

tokudb_cache_size¶

属性的字节大小TokuDB缓存表。默认的缓存表大小是物理内存的½。雷竞技下载官网Percona强烈建议如果使用缓冲I/O，则使用默认设置;如果使用直接I/O，则考虑将该参数设置为可用内存的80%。

如果过度交换会导致性能问题，可以考虑减少tokudb_cache_size。当运行多个时，可能会发生交换MySQL服务器实例或其他正在运行的应用程序是否使用大量物理内存。

tokudb_cachetable_pool_threads¶

这个变量定义了可缓存工作线程池的线程数。此池用于执行节点预取，并在缓存表清除期间序列化、压缩和写入节点。默认值0计算池大小为num_cpu_threads * 2。

tokudb_check_jemalloc¶

这个变量启用/禁用启动检查jemalloc是否被链接和正确的版本，以及透明的大页面是否被禁用。仅用于测试。

tokudb_checkpoint_lock¶

当为true时禁用检查点。会话变量，但作为一个全局，任何会话禁用检查点禁用全局。如果一个会话设置了这个锁，并且由于任何原因断开连接或终止，锁将不会被释放。只用于特殊目的不在您的应用程序中使用它。

tokudb_checkpoint_on_flush_logs¶

当启用时，如果从服务器获得flush日志命令，则强制检查点。

tokudb_checkpoint_pool_threads¶

这定义了检查点工作线程池的线程数。该池用于序列化、压缩和写入检查点期间克隆的节点。默认的0使用旧算法将池大小设置为num_cpu_threads / 4．

tokudb_checkpointing_period¶

这个变量指定了从一个检查点开始到下一个检查点开始的时间(以秒为单位)。之间的默认时间TokuDB检查点是60秒。我们建议保持这个变量不变。

tokudb_cleaner_iterations¶

这个变量指定在每个tokudb_cleaner_period周期内处理多少内部节点。默认值为5．将此变量设置为0关闭清洁线程。

tokudb_cleaner_period¶

此变量指定清理线程运行的频率(以秒为单位)。默认值为1．将此变量设置为0关闭清洁线程。

tokudb_client_pool_threads¶

这个变量定义了客户端操作线程池的线程数。此池用于对过大/过小的节点执行节点维护，例如沿着树刷新消息、节点拆分和节点合并。默认的0使用旧算法将池大小设置为1 \* num_cpu_threads．

tokudb_commit_sync¶

会话变量tokudb_commit_sync控制事务提交时是否刷新事务日志。默认行为是由提交刷新事务日志。刷新事务日志需要磁盘写入，可能会对应用程序的性能产生不利影响。

要禁用事务日志的同步刷新，请禁用tokudb_commit_sync会话变量，如下所示:

集tokudb_commit_sync＝从；

禁用此变量可能会使系统运行得更快。然而，自最后一个检查点以来提交的事务不能保证在崩溃中幸存。

tokudb_compress_buffers_before_eviction¶

当启用该变量时，它允许驱逐程序压缩未使用的内部节点分区，以减少内存需求，作为部分驱逐的第一步，然后完全驱逐分区，最终驱逐整个节点。

tokudb_create_index_online¶

属性是否创建索引创建索引命令是热的(如果启用)，或离线的(如果禁用)。热索引创建意味着在创建索引时，表可以用于插入和查询。离线索引创建意味着在创建索引时，表不能用于插入和查询。

tokudb_data_dir¶

属性所在的目录名TokuDB存储表。默认值为零哪个使用的位置MySQL数据目录。有关更多信息，请检查TokuDB文件和文件类型以及TokuDB文件管理。

tokudb_debug¶

这个变量允许mysqld调试打印到STDERR为TokuDB．产生大量的输出，几乎是无用的任何人，但一个TokuDB开发器，不建议用于任何生产用途。是一个掩码值ULONG：

#define TOKUDB_DEBUG_INIT (1<<0) #define TOKUDB_DEBUG_OPEN (1<<1) #define TOKUDB_DEBUG_RETURN (1<<3) #define TOKUDB_DEBUG_ERROR (1<<4) #define TOKUDB_DEBUG_TXN (1<<5) #define tokudb_debug_index_n (1<<6) #define TOKUDB_DEBUG_INDEX_KEY (1<<7) #define tokudb_debug_index_lock (1<<8) #define TOKUDB_DEBUG_CHECK_KEY (1<<9) #define TOKUDB_DEBUG_ALTER_TABLE (1<<11) #define TOKUDB_DEBUG_UPSERT(1<<12) #定义TOKUDB_DEBUG_CHECK (1<<13) #define TOKUDB_DEBUG_ANALYZE (1<<14) #define TOKUDB_DEBUG_XA (1<<15) #define TOKUDB_DEBUG_SHARE (1<<16)

tokudb_dir_per_db¶

当此变量设置为时在所有新的表和索引都将放在tokudb_data_dir或system datadir中相应的数据库目录中。现有表文件不会自动重新定位到相应的数据库目录。如果在启用此变量时重命名表，则雷竞技下载官网Percona英尺目录文件将被更新，磁盘上的文件将被重命名，以反映新的表名。有关更多信息，请检查TokuDB文件和文件类型以及TokuDB文件管理。

tokudb_directio¶

启用后，TokuDB使用直接I/O而不是缓冲I/O进行写操作。当使用Direct I/O时，考虑将tokudb_cache_size从默认的½物理内存增加。

tokudb_disable_hot_alter¶

此变量专门用于测试或在出现错误时禁用热更改。不用于生产。

tokudb_disable_prefetching¶

TokuDB尝试主动预取额外的行块，这对大多数范围查询很有帮助，但可能会为范围查询创建不必要的I/O限制条款。预取是在默认情况下，值为0时，可将此变量设置为禁用1．

tokudb_disable_slow_alter¶

此变量专门用于测试或在出现错误时禁用热更改。不用于生产。它控制是否允许慢速修改表。例如，下面的命令很慢，因为HCADER不允许混合添加、删除或展开列:

改变表格表格添加列column_aINT，下降列column_b；

默认情况下，tokudb_disable_slow_alter是禁用的，并且引擎向MySQL报告这是不支持的，结果是以下输出:

错误1112(42000):表'test_slow'使用的扩展名在这个MySQL版本中不存在

tokudb_empty_scan¶

定义用于执行表扫描以检查散装装载程序的空表的方向。

tokudb_enable_fast_update¶

控件的快速更新功能开关更新声明。快速更新涉及查询优化，以避免在执行期间随机读取。

tokudb_enable_fast_upsert¶

控件的快速更新功能开关插入声明。快速更新涉及查询优化，以避免在执行期间随机读取。

tokudb_enable_partial_eviction¶

此变量用于控制是否启用或禁用部分节点移除。

tokudb_fanout¶

这个变量控制分形树扇出。扇出定义每个内部树节点的枢轴键或子节点的数量。更改tokudb_fanout的值只会影响随后创建的表和索引。如果不进行转储和重新加载，则不能为现有表/索引更改此变量的值。

tokudb_fs_reserve_percent¶

该变量控制允许插入的文件系统的可用百分比。默认情况下，设置为5．我们建议这个储备至少是物理内存大小的一半。有关更多信息，请参阅Full Disks。

tokudb_fsync_log_period¶

该变量控制的频率(以毫秒为单位)fsync ()操作。如果设置为0然后fsync ()行为仅由tokudb_commit_sync控制，可以为在或从．

tokudb_hide_default_row_format¶

此变量用于隐藏ROW_FORMAT在显示创建表．如果zlib使用压缩，行格式将显示为默认的．

tokudb_killed_time¶

此变量用于指定锁等待检查锁是否被杀死的频率(以毫秒为单位)。

tokudb_last_lock_timeout¶

此变量包含一个JSON文档，该文档描述当前线程看到的最后一次锁冲突MySQL客户端。当阻塞的锁请求超时或检测到锁死锁时设置该参数。

tokudb_lock_timeout_debug会话变量必须有位0为此行为设置，否则此会话变量将为空。

tokudb_load_save_space¶

这个会话变量改变了大容量加载器的行为。当它被禁用时，大容量加载器使用未压缩的文件存储中间数据(这会消耗额外的CPU)，而在压缩中间文件。

如果一个加载数据文件语句失败，出现错误消息错误1030 (HY000):得到错误1从存储引擎，那么可能没有足够的磁盘空间用于优化的加载器，因此禁用tokudb_prelock_empty，然后重试。更多信息可参见已知问题。

tokudb_loader_memory_size¶

此变量限制控件所使用的内存量(以字节为单位)TokuDB大容量加载程序将用于每个加载程序实例。当加载带有多个二级索引的超大表时，增加这个值可以提高性能。

tokudb_lock_timeout¶

此变量控制一个事务等待另一个事务持有的锁释放的时间。如果发生冲突的事务没有在锁超时内释放锁，则等待锁的事务将得到一个锁超时错误。单位是毫秒。值为0禁用锁等待。缺省值是4000(4秒)。

如果你的申请得到锁定等待超时错误(-30994)，那么您可能会发现增加tokudb_lock_timeout可能会有所帮助。如果你的申请得到发现死锁错误(-30995)，那么您需要中止当前事务并重试它。

tokudb_lock_timeout_debug¶

取值范围如下:

• 0:没有锁超时和锁死锁。

• 1:描述锁冲突的JSON文档存储在tokudb_last_lock_timeout会话变量中

• 2:将描述锁冲突的JSON文档打印到MySQL错误日志中。

除了描述锁冲突的JSON文档外，还将以下几行打印到MySQL错误日志中:

包含阻塞线程id和阻塞SQL的行。

• 3.:描述锁冲突的JSON文档存储在tokudb_last_lock_timeout会话变量中，并打印到MySQL错误日志中。

除了描述锁冲突的JSON文档外，还将以下几行打印到MySQL错误日志中:

包含阻塞线程id和阻塞SQL的行。

tokudb_log_dir¶

属性所在的目录TokuDB存储日志文件。默认值为零哪个使用的位置MySQL数据目录。配置单独的日志目录有些复杂。请联系Percona支持以获得雷竞技下载官网更多详细信息。有关更多信息，请检查TokuDB文件和文件类型以及TokuDB文件管理。

tokudb_max_lock_memory¶

这个变量指定PerconaFT锁表的最大内存量。雷竞技下载官网

tokudb_optimize_index_fraction¶

对于树左侧有许多删除的模式(id或日期值不断增加的常见模式)，删除树的某个百分比可能会有用。在这种情况下，可以从左侧开始优化分形树的一个子集。tokudb_optimize_index_fraction会话变量控制子树的大小。有效值范围为[0.0,1.0]，默认值为1.0(优化整个树)。

tokudb_optimize_index_name¶

此变量可用于优化表中的单个索引，也可设置为按名称选择索引。

tokudb_optimize_throttle¶

默认情况下，表优化将使用所有可用资源运行。为了限制资源的数量，可以限制表优化的速度。这决定了每秒优化多少个分形树叶节点的上限。默认的0没有限制。

tokudb_pk_insert_mode¶

tokudb_prelock_empty¶

默认情况下TokuDB抢占空表上的整个表锁。如果一个事务正在进行加载，例如当用户将一个表加载到一个空表中时，这个默认值提供了相当大的加速。

但是，如果多个事务试图对一个空表进行并发操作，那么除了一个事务外，其他事务都将被锁定。禁用tokudb_prelock_empty可以通过关闭抢占式预锁定来优化这种多事务情况。

tokudb_read_block_size¶

分形树的叶子被细分为读块，以加快点查询。这个变量控制读块的目标未压缩大小。单位为字节，默认为64kb。相对于大范围扫描和高压缩，较小的值有利于点扫描和小范围扫描的读取性能。这个变量的最小值是4096 (4KB)。

更改tokudb_read_block_size的值只会影响随后创建的表。如果不进行转储和重新加载，则不能为现有表更改此变量的值。

tokudb_read_buf_size¶

此变量控制用于存储作为大范围查询的一部分进行批量获取的值的缓冲区的大小。默认值为131,072 (128kb)，单位为字节。

值为0关闭批量抓取。每个客户端都有一个这样大小的线程，所以如果有大量客户端同时查询一个表，线程的大小应该减小。

tokudb_read_status_frequency¶

此变量控制进度测量显示的读取次数显示PROCESSLIST．读取被定义为选择查询。

对于速度较慢的查询，将这个变量和tokudb_write_status_frequency设置为会很有帮助1，然后运行显示PROCESSLIST几次，以了解正在取得的进展。

tokudb_row_format¶

它控制用于压缩数据的默认压缩算法。有关压缩算法的更多信息，请参阅压缩详细信息。

tokudb_rpl_check_readonly¶

的TokuDB当副本处于只读模式时，复制代码将使用Read Free replication从二进制日志中运行行事件。对象中的副本只读检查TokuDB复制代码。

这允许在副本非只读时运行Read-Free-Replication。默认情况下，tokudb_rpl_check_readonly是启用的(检查副本是否只读)。做不更改此值，除非您完全理解其含义!

tokudb_rpl_lookup_rows¶

当禁用,TokuDB的复制副本跳过行查找删除行记录事件和更新行日志事件，消除所有与这些操作相关的读I/O。

tokudb_rpl_lookup_rows_delay¶

这个变量允许通过在行查找查询之前休眠给定微秒数来模拟长磁盘读取，为了进行测试，应该只将它设置为非零值。

tokudb_rpl_unique_checks¶

当禁用,TokuDB复制副本跳过插入和更新的唯一性检查，这消除了这些操作的所有相关读I/O。

tokudb_rpl_unique_checks_delay¶

这个变量允许通过在行查找查询之前休眠给定微秒数来模拟长磁盘读取，为了进行测试，应该只将它设置为非零值。

tokudb_strip_frm_data¶

当此变量设置为时在在启动期间，服务器将检查所有的状态文件并删除嵌入的.frm元数据。此变量可用于辅助TokuDB数据恢复。

tokudb_support_xa¶

此变量定义XA事务的准备阶段是否执行fsync ()．

tokudb_tmp_dir¶

属性所在的目录TokuDB批量加载器存储临时文件。批量加载程序在加载表时可以创建大的临时文件，因此将这些临时文件放在与数据目录分开的磁盘上是很有用的。

例如，为数据目录使用高性能磁盘，而为临时目录使用非常便宜的磁盘是有意义的。TokuDB临时文件的默认位置是MySQL数据目录。

Tokudb_load_save_space决定数据是否被压缩。错误消息ERROR 1030 (HY000):从存储引擎得到错误1可能表示磁盘已耗尽空间。

有关更多信息，请检查TokuDB文件和文件类型以及TokuDB文件管理。

tokudb_version¶

类的版本TokuDB存储引擎。

tokudb_write_status_frequency¶

此变量控制度量进度显示的写入次数显示PROCESSLIST．写入被定义为插入，更新而且删除查询。

对于速度较慢的查询，将这个变量和tokudb_read_status_frequency设置为1，然后运行会很有帮助显示PROCESSLIST几次，以了解正在取得的进展。