Системные переменные TokuDB

На этой странице перечислены системные переменные, связанные с TokuDB.

См. Системные переменные сервера для полного списка системных переменных и инструкций по их настройке, а также Полный список параметров, системных и служебных переменных MariaDB для полного списка всех параметров, служебных и системных переменных в MariaDB.

Системные переменные

tokudb_alter_print_error

• Описание: Вывод ошибок для операций изменения таблиц.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_analyze_time

• Описание: Время в секундах, которое операции ANALYZE тратят на каждый индекс при вычислении кардинальности. Точная кардинальность особенно помогает в производительности сложных запросов. Если анализ не выполняется, кардинальность будет равна 1 для первичных индексов и неизвестна (NULL) для других типов индексов.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 5
• Диапазон: 0 до 4294967295

tokudb_block_size

• Описание: Несжатый размер внутренних узлов фрактального дерева и листьев. Изменение повлияет только на таблицы, созданные после вступления в силу нового параметра. Существующие таблицы сохранят параметр, с которым они были созданы, если только таблица не будет выгружена и перезагружена.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 4194304 (4MB)
• Диапазон: 0 до 18446744073709551615

tokudb_bulk_fetch

• Описание: Если установлено в 1 (по умолчанию), алгоритм пакетной выборки используется для SELECT и DELETE, включая связанные операторы, такие как INSERT INTO.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_cache_size

• Описание: Размер в байтах кэша TokuDB. Эта переменная доступна только для чтения и не может быть изменена динамически. Чтобы изменить значение, установите значение в файле my.cnf перед загрузкой TokuDB или перезапустите MariaDB после изменения конфигурации. Если вы загрузили плагин, но еще не использовали TokuDB, вы можете выгрузить плагин, а затем перезагрузить его, и MariaDB перезагрузит плагин с параметром из файла конфигурации. Рекомендуется установить значение как минимум в половину доступной памяти, хотя если используется directIO вместо буферизованного ввода-вывода (см. tokudb_directio), рекомендуется до 80% доступной памяти. Уменьшите, если другие приложения требуют значительного объема памяти или свопинг снижает производительность.
• Динамическая: Нет
• Тип данных: числовая
• Значение по умолчанию: Половина общей системной памяти

tokudb_check_jemalloc

• Описание: Проверка на наличие связи с jemalloc.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 1
• Допустимые значения: 0 и 1

tokudb_checkpoint_lock

• Описание: Механизм блокировки контрольных точек TokuDB. При установке в 1, контрольные точки TokuDB блокируются. Установка в 0 или отключение клиента снимает блокировку.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_checkpoint_on_flush_logs

• Описание: Контрольная точка TokuDB при очистке журналов.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_checkpointing_period

• Описание: Время в секундах между началом каждой контрольной точки. Рекомендуется оставить это значение по умолчанию, равным 1 минуте.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 60
• Диапазон: 0 до 4294967295

tokudb_cleaner_iterations

• Описание: Количество внутренних узлов, обрабатываемых в каждом периоде потока очистки (см. tokudb_cleaner_period). Установка в 0 отключает потоки очистки.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 5
• Диапазон: 0 до 18446744073709551615

tokudb_cleaner_period

• Описание: Частота в секундах для запуска потока очистки. Установка в 0 отключает потоки очистки.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 1
• Диапазон: 0 до 18446744073709551615

tokudb_commit_sync

• Описание: Необходимо ли очищать журнал транзакций при фиксации транзакции. Очистка имеет незначительное снижение производительности, но ее отключение означает, что зафиксированные транзакции могут не пережить сбой сервера.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_create_index_online

• Описание: Являются ли индексы горячими или нет. Горячие, или онлайн, индексы (по умолчанию) означают, что таблица доступна для вставки и обновления во время создания индекса. Создание горячих индексов происходит медленнее.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_data_dir

• Описание: Каталог, в котором хранятся данные TokuDB. По умолчанию переменная пуста, в этом случае используется обычный datadir.
• Динамическая: Нет
• Тип данных: строка
• Значение по умолчанию: Пусто (используется datadir MariaDB)

tokudb_debug

• Описание: Установка ненулевого значения включает различные трассировки отладки TokuDB.
• Область видимости: Глобальная
• Динамическая: Да
• Тип данных: числовая
• Значение по умолчанию: 0
• Диапазон: 0 до 18446744073709551615

tokudb_directio

• Описание: При установке в ON, TokuDB использует Direct IO вместо Buffered IO. tokudb_cache_size следует настроить при использовании DirectIO.
• Динамическая: Нет
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_disable_hot_alter

• Описание: Если установлено в ON (OFF по умолчанию), горячее изменение таблицы отключено.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_disable_prefetching

• Описание: Если предварительная выборка не отключена (по умолчанию), запросы диапазона обычно выигрывают от агрессивной предварительной выборки блоков строк. Для запросов диапазона с предложениями LIMIT это может привести к ненужному вводу-выводу, поэтому предварительную выборку можно отключить, если они составляют большинство запросов диапазона.
• Область видимости: Глобальная, сеанса
• Динамическая: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_disable_slow_alter

• Описание: Обычно TokuDB позволяет добавлять, удалять, расширять и переименовывать столбцы с минимальной блокировкой и очень быстро. Эта переменная определяет, разрешены ли некоторые медленные операторы [alter|ALTER]] таблицы, которые не могут воспользоваться этой функцией. Медленными операторами являются те, которые включают комбинацию добавления, удаления или расширения столбцов, например, ALTER TABLE t1 ADD COLUMN c1 int, DROP COLUMN c2.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: OFF

tokudb_empty_scan

• Описание: Алгоритм TokuDB для проверки, пуста ли таблица при открытии. Установка на disabled позволит уменьшить эти накладные расходы.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: enum
• Значение по умолчанию: rl
• Допустимые значения: lr, rl, disabled

tokudb_fs_reserve_percent

• Описание: Если этот процент файловой системы не свободен, вставки будут запрещены. Рекомендуемое значение составляет половину размера доступной памяти. После отключения вставки будут повторно включены, когда будет доступно в два раза больше резерва. TokuDB полностью заблокируется, если диск станет полностью заполненным.
• Область действия: Глобальная
• Динамическое: Нет
• Тип данных: числовой
• Значение по умолчанию: 5

tokudb_fsync_log_period

• Описание: Частота операций fsync() в миллисекундах. Если установлено значение 0, по умолчанию, параметр tokudb_commit_sync управляет поведением fsync().
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 0
• Диапазон: 0 до 18446744073709551615

tokudb_hide_default_row_format

• Описание: Скрыть стандартный формат строки.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_killed_time

• Описание: Управление частотой обратного вызова kill для дерева блокировок.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 4000
• Диапазон: 0 до 18446744073709551615
• Введено: TokuDB 7.1.5

tokudb_last_lock_timeout

• Описание: По умолчанию пусто, при обнаружении тупика блокировки или истечении времени ожидания запроса блокировки, устанавливается на JSON-документ, описывающий последний конфликт блокировки. Устанавливается только при установке первого бита tokudb_lock_timeout_debug.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: текст
• Значение по умолчанию: Пусто

tokudb_load_save_space

• Описание: Если установлено на 1, по умолчанию, промежуточные данные массового загрузчика сжимаются, в противном случае — нет. Также см. tokudb_tmp_dir.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_loader_memory_size

• Описание: Предельное значение памяти для каждого экземпляра загрузчика, используемого массовым загрузчиком TokuDB. Память берется из кэша TokuDB (tokudb_cache_size), поэтому текущие данные кэша могут потребоваться очистить для начала работы загрузчика. Увеличьте, если таблицы очень большие, с несколькими вторичными индексами.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 100000000 (100М)
• Диапазон: 0 до 18446744073709551615

tokudb_lock_timeout

• Описание: Время в миллисекундах, которое транзакция будет ждать, пока блокировка, удерживаемая другой транзакцией, не будет освобождена, прежде чем истечет время ожидания с ошибкой lock wait timeout (-30994). Установка на 0 отключает ожидания блокировок.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 4000 (4 секунды)
• Диапазон: 0 до 18446744073709551615

tokudb_lock_timeout_debug

• Описание: При установке бита ноль (по умолчанию 1), JSON-документ, описывающий последний конфликт блокировки, сообщается в tokudb_last_lock_timeout. При установке на 0, конфликты блокировки не сообщаются. При установке бита один, JSON-документ выводится в журнал ошибок.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 1

tokudb_log_dir

• Описание: Каталог, в котором хранятся файлы журнала TokuDB. По умолчанию переменная пустая, в этом случае используется обычный каталог datadir.
• Динамическое: Нет
• Тип данных: строка
• Значение по умолчанию: Пусто (используется каталог данных MariaDB)

tokudb_max_lock_memory

• Описание: Максимальный объём памяти для блокировок.
• Область действия: Глобальная, Сеансовая
• Динамическое: Нет
• Тип данных: числовой
• Значение по умолчанию: 130653952

tokudb_optimize_index_fraction

• Описание: При удалении процента дерева (полезно, когда на левой части дерева много удалений, например, последовательность с возрастающими ID или датами), можно оптимизировать подмножество фрактального дерева, как определено значением этой переменной, которое варьируется от 0.0 до 1.0 (указывая всё дерево).
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 1.000000
• Диапазон: 0.0 до 1.0
• Введено: TokuDB 7.5.5

tokudb_optimize_index_name

• Описание: Если задано имя индекса, будет оптимизирован только этот индекс в таблице. По умолчанию пусто.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: строка
• Значение по умолчанию: Нет
• Введено: TokuDB 7.5.5

tokudb_optimize_throttle

• Описание: Оптимизация таблиц по умолчанию использует все доступные ресурсы. Эта переменная позволяет ограничить скорость оптимизации таблиц, чтобы уменьшить использование ресурсов в целом. Ограничение устанавливает верхнюю границу количества оптимизированных узлов листа фрактального дерева в секунду. 0, по умолчанию, не накладывает ограничений.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 0
• Диапазон: 0 до 18446744073709551615
• Введено: TokuDB 7.5.5

tokudb_pk_insert_mode

• Описание: Режим вставки первичного ключа, используя либо REPLACE INTO, либо INSERT IGNORE в таблицах без вторичных индексов или где все столбцы вторичного индекса находятся в первичном ключе. Например, PRIMARY KEY (a,b,c), key (b,c)
  • 0: Быстрые вставки. Триггеры могут не работать, и репликация на основе строк не будет работать
  • 1: Быстрые вставки, если триггеры не определены, в противном случае вставки могут быть медленными. Репликация на основе строк не будет работать.
  • 2: Медленные вставки. Триггеры и репликация на основе строк работают нормально.
• Область действия: Глобальная, Сеансовая
• Динамическое: Да
• Тип данных: перечисление
• Значение по умолчанию: 1
• Допустимые значения: 0, 1, 2

tokudb_prelock_empty

• Описание: Если установлено значение 0 (по умолчанию 1), быстрая массовая загрузка будет выключена. Обычно TokuDB получает блокировку таблицы на пустых таблицах. Если, как обычно, только одна транзакция загружает таблицу, это ускоряет вставки. Однако, если много транзакций загружают таблицу, только одна может иметь доступ за раз, поэтому установка этого значения на 0, избегая блокировки, ускорит вставки в этой ситуации.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_read_block_size

• Описание: Несжатый размер в байтах блоков чтения листьев дерева фрагментации. Изменение повлияет только на таблицы, созданные после вступления в силу нового значения. Существующие таблицы сохранят значение, с которым они были созданы, пока таблица не будет экспортирована и перезагружена. Более высокие значения лучше подходят для больших диапазонных сканирований и более высоких степеней сжатия, а более низкие значения лучше подходят для точечных и малых диапазонных сканирований.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 65536 (64 КБ)
• Диапазон: 4096 до 4294967295

tokudb_read_buf_size

• Описание: Размер буфера на клиента в байтах, используемый для хранения массивных извлечённых значений в рамках запроса с большим диапазоном. Уменьшите, если есть много одновременных клиентов. Установка значения на 0 отключает массовое извлечение.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 131072 (128 КБ)
• Диапазон: 0 до 1048576

tokudb_read_status_frequency

• Описание: Прогресс измеряется каждые столько чтений для отображения в SHOW PROCESSLIST. Полезно установить значение на 1 для проверки медленных запросов.
• Область действия: Глобальная,
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 10000
• Диапазон: 0 до 4294967295

tokudb_row_format

• Описание: Алгоритм сжатия, используемый по умолчанию для сжатия данных. Может быть переопределён форматом строки, указанным в инструкции CREATE TABLE. обратите внимание, что библиотека может быть указана напрямую, или может быть использован псевдоним, отображение которого может измениться в будущем. Обратите внимание, что в MariaDB 5.5, и до MariaDB 10.0.10, тип сжатия не был установлен по умолчанию в это значение. См. TokuDB Differences.
  • tokudb_default, tokudb_zlib: Используйте библиотеку zlib,
  • tokudb_fast, tokudb_quicklz: Используйте библиотеку quicklz, самый лёгкий метод сжатия с низким использованием ЦП,
  • tokudb_small, tokudb_lzma: Используйте библиотеку lzma. Наибольшее сжатие и наибольшее использование ЦП
  • tokudb_uncompressed: Сжатие не используется.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: перечисление
• Значение по умолчанию: tokudb_zlib
• Допустимые значения: tokudb_default, tokudb_fast, tokudb_small, tokudb_zlib, tokudb_quicklz, tokudb_lzma, tokudb_uncompressed

tokudb_rpl_check_readonly

• Описание: По умолчанию, когда раб находится в режиме только для чтения, события строк будут выполняться из двоичного журнала с использованием репликации без чтения TokuDB (RFR). Установка этой переменной на OFF выключает проверку режима только для чтения раба, позволяя RFR работать, когда раб не находится в режиме только для чтения. Будьте внимательны, понимая последствия настройки этой переменной.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_rpl_lookup_rows

• Описание: Если установлено значение OFF (по умолчанию ON), и binlog_format установлено на ROW и read_only на ON, реплицирующие рабы TokuDB не будут выполнять поиск строк для обновлений или удалений событий журнала строк, исключая необходимость соответствующей операции ввода-вывода.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_rpl_lookup_rows_delay

• Описание: Может использоваться для имитации длительных чтений с диска путём ожидания указанного времени в микросекундах перед запросом поиска строки. Полезно использовать только в тестовой среде.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 0

tokudb_rpl_unique_checks

• Описание: Если установлено значение OFF (по умолчанию ON), и binlog_format установлено на ROW и read_only на ON, реплицирующие рабы TokuDB пропустят проверки уникальности при вставках и обновлениях, исключая необходимость соответствующей операции ввода-вывода.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_rpl_unique_checks_delay

• Описание: Может использоваться для имитации длительных чтений с диска путём ожидания указанного времени в микросекундах перед запросом поиска строки. Полезно использовать только в тестовой среде.
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: числовой
• Значение по умолчанию: 0

tokudb_support_xa

• Описание: Определяет, выполняет ли фаза подготовки транзакции XA операцию fsync().
• Область действия: Глобальная, Сеанс
• Динамическое: Да
• Тип данных: boolean
• Значение по умолчанию: ON

tokudb_tmp_dir

• Описание: Директория, в которой хранятся временные файлы TokuDB массовых загрузчиков. Может быть очень большой и полезна для размещения на отдельном диске. По умолчанию переменная пуста, в этом случае используется обычная директория datadir. tokudb_load_save_space определяет, сжимаются ли данные или нет. Сообщение об ошибке ERROR 1030 (HY000): Got error 1 from storage engine может указывать на то, что на диске закончилось место.
• Динамическое: Нет
• Тип данных: directory name
• Значение по умолчанию: Пусто (используется директория данных MariaDB)

tokudb_version

• Описание: Версия TokuDB плагина, включённого в MariaDB.
• Динамическое: Нет
• Тип данных: string

tokudb_write_status_frequency

• Описание: Прогресс измеряется каждые столько записей для отображения в SHOW PROCESSLIST. Полезно установить значение на 1 для проверки медленных запросов.
• Область действия: Глобальная,
• Динамическое: Да
• Тип данных: numeric
• Значение по умолчанию: 1000
• Диапазон: 0 до 4294967295