Параметры MySQL

Параметры создания сервиса

Эти параметры указываются в качестве parameters в методе CreateService.

При создании нового сервиса нужно обязательно указать параметры, отмеченные как Необходимые.

Если выбранная версия MySQL поддерживает другие параметры, то их можно задать внутри параметра options.

vendor

Вендор подсистемы хранения СУБД MySQL.

Необходимо	Тип данных	Допустимые значения
Да	String	mariadb percona mysql

version

Версия подсистемы хранения СУБД. Версия зависит от вендора.

Необходимо	Тип данных	Допустимые значения
Да	String	mariadb: 10.2, 10.3, 10.4, 10.5, 10.6, 10.7; percona: 5.7, 8.0; mysql: 5.7, 8.0

max_connections

Максимально допустимое количество одновременных подключений, которые может принять узел MySQL.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–100000	151	МиБ RAM/32, min 151

max_allowed_packet

Максимальный размер одного пакета, любой сгенерированной/промежуточной строки или любого параметра, который был отправлен функцией mysql_stmt_send_long_data().

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Да	Integer	1024–1073741824	16 МиБ (MariaDB) 64 МиБ (Percona)	N/A

max_connect_errors

Максимальное количество ошибок соединения, при котором дальнейшие подключения к узлу блокируются.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1– 18446744073709551615	100	N/A

innodb_buffer_pool_size

Размер буфера InnoDB в байтах, который используется для кеширования данных таблиц и их индексов. Буфер большого размера позволяет снизить количество операций ввода/вывода при многократном обращении к одним и тем же данным.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	5242880– 9223372036854775807	128 МиБ	50% RAM, если ≤ 4 ГиБ 75% RAM, если ≥ 4 ГиБ

innodb_buffer_pool_instances

Количество частей, на которые будет разделён innodb_buffer_pool_size, если innodb_buffer_pool_size > 1 ГиБ. Деление позволяет более эффективно использовать буфер. Параметр применим к Percona 5.7, 8.0 и MariaDB 10.2, 10.3, 10.4.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–64	8 или 1, если innodb_buffer_pool_size < 1 ГиБ	Количество целых ГиБ в innodb_buffer_pool_size, если значение параметра > 1 ГиБ

innodb_log_file_size

Размер одного файла в байтах в системном журнале redo. Чем больше значение, тем меньше операций сброса контрольных точек требуется в буферном пуле, что экономит/сокращает дисковый ввод/вывод.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	4 МиБ–512 ГиБ	96 МиБ (для MariaDB 10.5 и старше) 48 МиБ (для MariaDB 10.4 и младше) 48 МиБ (для Percona 8)	(innodb_buffer_pool_size × 25%)/2, но не более 4 ГиБ

innodb_log_files_in_group

Количество файлов системного журнала в группе журналов.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	2–100	2	N/A

innodb_change_buffering

Этот параметр управляет кешируемыми данными, оптимизируя задержки операций записи вторичного индекса так, чтобы операции ввода/вывода могли быть выполнены последовательно.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	String	inserts none deletes purges changes all none	none: ≥ MariaDB 10.5.15, 10.6.7, 10.7.3, 10.8.2; all: ≤ MariaDB 10.5.14, 10.6.6, 10.7.2, 10.8.1; Percona 8	N/A

innodb_io_capacity

Количество операций ввода/вывода в секунду (IOPS), которое доступно фоновым задачам InnoDB.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	100– 18446744073709551615	200	N/A

innodb_io_capacity_max

Максимальное количество операций ввода/вывода в секунду (IOPS), выполняемых фоновыми задачами InnoDB.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	100– 18446744073709551615	max(innodb_io_capacity × 2, 2000)	N/A

innodb_purge_threads

Количество потоков ввода/вывода InnoDB, используемых для операций очистки (purge). Увеличение параметра повышает эффективность систем, где операции с данными выполняются над несколькими таблицами.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–32	4	N/A

innodb_thread_concurrency

Максимальное число потоков, которые можно запустить внутри InnoDB. Параметр применим к Percona 5.7, 8.0 и MariaDB 10.2, 10.3, 10.4.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–1000	0	N/A

innodb_sync_array_size

Размер массива ожидания mutex/lock. Увеличение параметра повышает уровень параллелизма при большом количестве ожидающих потоков. Параметр применим к Percona 5.7, 8.0 и MariaDB 10.2, 10.3, 10.4, 10.5.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–1024	1	N/A

innodb_flush_log_at_trx_commit

Определяет поведение MySQL для операций подтверждения транзакций.

• 0 — Запись и сброс на диск выполняются раз в секунду. В случае сбоя данные транзакций за последнюю секунду могут быть утеряны.

• 1 (по умолчанию) — Обеспечивается максимальный уровень отказоустойчивости. Запись в файл журнала повторного выполнения InnoDB и сброс на диск выполняются после каждой транзакции.

• 2 — Запись в журнал повторного выполнения InnoDB выполняется после каждой фиксации, но очистка происходит раз в секунду. Отключение ОС или электричества может привести к потере транзакций за последнюю секунду.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0 1 2	1	N/A

thread_cache_size

Количество потоков, которые кешируются для установления новых сетевых соединений.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–16384	-1 (autosizing)	N/A

tmp_table_size

Максимальный размер временных таблиц в памяти (в байтах). Этот параметр не влияет на MEMORY-таблицы, созданные пользователем.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1024–4294967295	16 МиБ	N/A

max_heap_table_size

Максимальный размер в байтах, которого могут достигать созданные MEMORY-таблицы. Значение параметра используется для вычисления значений MAX_ROWS MEMORY-таблицы.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	16384–4294966272	16 МиБ	N/A

table_open_cache

Количество открытых таблиц для всех потоков. Чем больше значения этого параметра, тем больше количество файловых дескрипторов для mysqld.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–1048576	MariaDB: 2000 Percona 5.7: 2000 Percona 8: 4000	N/A

transaction_isolation

Уровень изоляции транзакции. Подробнее в документации MySQL.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	String	REPEATABLE-READ READ-UNCOMMITTED READ-COMMITTED SERIALIZABLE	REPEATABLE-READ	N/A

wait_timeout

Количество секунд, в течение которых сервер ожидает активности в неинтерактивном соединении, прежде чем закрыть его.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Numeric	1–31536000	28800	N/A

connect_timeout

Количество секунд, в течение которых сервер mysqld ожидает пакет подключения, прежде чем ответить Bad handshake.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Numeric	2–31536000	10	N/A

pxc_strict_mode

Режим PXC. Поддерживаемые режимы подробно описаны в документации Percona. Применим только в отказоустойчивой конфигурации и только к percona.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Да, если выбраны режим Отказоустойчивый сервис и вендор percona.	String	DISABLED PERMISSIVE ENFORCING MASTER	ENFORCING	DISABLED

innodb_strict_mode

Режимы работы MySQL. Поддерживаемые режимы подробно описаны в документации MySQL.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Да	String	ON OFF	ON	OFF

gcache_size

Размер хранилища кольцевого буфера Gcache (пространство, которое узел использует для кеширования наборов записей), предварительно выделяемого при запуске.

Параметр Galera. Применим только для отказоустойчивого сервиса.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	134217728–RAM/10	N/A	N/A

gcs_fc_limit

Если длина очереди recv больше, чем количество наборов записей, репликация приостанавливается. Количество наборов записей может значительно увеличиваться в конфигурациях ведущий-ведомый. Репликация возобновится в соответствии с настройкой gcs_fc_factor.

Параметр Galera. Применим только для отказоустойчивого сервиса.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–2147483647	N/A	N/A

gcs_fc_factor

Доля gcs_fc_limit, при которой возобновляется репликация, когда длина очереди recv становится меньше этого значения.

Параметр Galera. Применим только для отказоустойчивого сервиса.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Float	0.0–1.0	N/A	N/A

gcs_fc_master_slave

Эта переменная указывает, есть ли в кластере только один исходный узел. От этого зависит, пересчитывается ли параметр gcs_fc_limit динамически (когда false) или нет (когда true).

Устаревший параметр. Применим к Percona 5.7, MySQL 5.7 и MariaDB 10.2 и 10.3.

Параметр Galera. Применим только для отказоустойчивого сервиса.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Boolean	true false	N/A	N/A

gcs_fc_single_primary

Указывает на наличие более одного источника репликации. С ростом количества узлов в кластере динамически увеличивается значение gcs_fc_limit. В то же время увеличивается и количество операций записи с узлов. Когда этот параметр имеет значение false (ведущих узлов несколько), параметр gcs_fc_limit динамически изменяется. Это даёт каждому узлу дополнительный запас, чтобы он мог применять операции записи с некоторой задержкой. Параметр gcs_fc_limit изменяется как квадратный корень от размера кластера, т.е. в кластере из четырёх узлов он в два раза выше базового значения. Это сделано для компенсации помех при увеличении частоты репликации.

Параметр заменяет устаревший параметр gcs_fc_master_slave и применим к Percona 8.0, MySQL 8.0 и MariaDB 10.4, 10.5, 10.6 и 10.7.

Параметр Galera. Применим только для отказоустойчивого сервиса.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Boolean	true false	N/A	N/A

monitoring

Подключение к сервису мониторинга.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Для всех сервисов, кроме Prometheus	Есть	Boolean	true false	false

monitor_by

Идентификатор сервиса мониторинга. Указанный сервис должен быть развёрнут в том же проекте, что и текущий сервис.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения
Да, если передан параметр monitoring = true. Если monitoring = false, передача параметра невозможна	Есть	String	ID сервиса мониторинга, расположенного в том же VPC, что и текущий сервис

monitoring_labels

Метки, которые будут назначены метрикам мониторируемого сервиса в сервисе мониторинга.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения
Нет. Если monitoring = false, передача параметра невозможна	Есть	Dict	Имя метки может содержать цифры, латинские буквы, символ подчёркивания. Значение метки может содержать любые ASCII-символы.

logging

Подключение к сервису логирования.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Для всех сервисов, кроме ELK и Prometheus	Есть	Boolean	true false	false

log_to

Идентификатор сервиса логирования. Логируемый сервис должен быть развёрнут в том же проекте, что и текущий сервис.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да, если передан параметр logging = true. Если logging = false, передача параметра невозможна	Есть	String	ID сервиса мониторинга, расположенного в том же VPC, что и текущий сервис

logging_tags

Теги, которые будут назначены записям журнала текущего сервиса в сервисе логирования.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет. Если logging = false, передача параметра невозможна	Есть	List of strings	Строка не более 256 символов

options

Контейнер для других параметров MySQL.

Примечание

Если имя параметра включает точку, то его нельзя передать в контейнере для дополнительных параметров. Свяжитесь с технической поддержкой, если вам необходимо использовать такой параметр.

Необходимо	Тип данных	Допустимые значения
Нет	Dict	N/A

galera_options

Контейнер для других параметров Galera.

Примечание

Если имя параметра включает точку, то его нельзя передать в контейнере для дополнительных параметров. Свяжитесь с технической поддержкой, если вам необходимо использовать такой параметр.

Необходимо	Тип данных	Допустимые значения
Нет	Dict	N/A

Параметры создания пользователя

Эти параметры указываются в поле parameters объекта User при передаче последнего в параметре users метода ModifyService.

Свойство Возможность редактирования указывает, возможно ли изменение значения параметра после создания пользователя.

host

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Имя хоста длиной до 60 символов, либо IP-адрес	%

password

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да	Есть	String	Не должен содержать символы ', ", ` и \	N/A

Параметры создания базы данных

Эти параметры указываются в поле parameters объекта Database при передаче последнего в параметре databases метода ModifyService.

Свойство Возможность редактирования указывает, возможно ли изменение значения параметра после создания базы данных.

С помощью параметров backup_id и backup_db_name осуществляется восстановление базы данных из имеющейся резервной копии. Информацию об имеющихся резервных копиях можно получить с помощью метода ListBackups.

charset

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Поддерживаемые значения: Для MariaDB: https://mariadb.com/kb/en/supported-character-sets-and-collations/ Для MySQL и Percona: https://dev.mysql.com/doc/refman/8.0/en/charset-charsets.html	utf8

collate

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Поддерживаемые значения: Для MariaDB: https://mariadb.com/kb/en/supported-character-sets-and-collations/ Для MySQL и Percona: https://dev.mysql.com/doc/refman/8.0/en/charset-charsets.html	utf8_unicode_ci

backup_id

Идентификатор резервной копии базы данных.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Идентификатор существующей резервной копии базы данных	N/A

backup_db_name

Имя базы данных из резервной копии, указанной в параметре backup_id.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да, если указан backup_id	Нет	String	Имя базы данных, содержащейся в резервной копии	N/A

Параметры пользователя при создании базы данных

Эти параметры указываются в поле parameters объекта User, который вложен в поле users объекта Database при передаче последнего в параметре databases метода ModifyService.

Свойство Возможность редактирования указывает, возможно ли изменение значения параметра после создания базы данных.

privileges

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Есть	Array of strings	ALL ALTER ALTER ROUTINE CREATE CREATE ROUTINE CREATE TEMPORARY TABLES CREATE VIEW DELETE DROP EVENT EXECUTE INDEX INSERT LOCK TABLES SELECT SHOW VIEW TRIGGER UPDATE	ALL

options

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Есть	Array of strings	GRANT NONE	N/A