Параметры MySQL

Примечание

Параметры можно указывать в нотации snake_case. Переданные параметры автоматически преобразуются в camelCase.

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

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

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

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

vendor

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

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

version

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

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

maxConnections

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

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

maxAllowedPacket

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

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

maxConnectErrors

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

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

innodbBufferPoolSize

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

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

innodbBufferPoolInstances

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

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

innodbLogFileSize

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

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

innodbLogFilesInGroup

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

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

innodbChangeBuffering

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

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	String	inserts none deletes purges changes all	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

innodbIoCapacity

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

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

innodbIoCapacityMax

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

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

innodbPurgeThreads

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

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

innodbThreadConcurrency

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

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

innodbSyncArraySize

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

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

innodbFlushLogAtTrxCommit

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

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

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

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

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

threadCacheSize

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

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

tmpTableSize

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

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

maxHeapTableSize

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

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

tableOpenCache

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

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

transactionIsolation

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

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

waitTimeout

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

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

connectTimeout

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

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

pxcStrictMode

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

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

innodbStrictMode

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

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

gcacheSize

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

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

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	128 МиБ–0,3 * RAM	N/A	N/A

gcsFcLimit

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

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

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

gcsFcFactor

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

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

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

gcsFcMasterSlave

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

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

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

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

gcsFcSinglePrimary

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

Параметр заменяет устаревший параметр gcsFcMasterSlave и применим к 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

monitorBy

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

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

monitoringLabels

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

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

logging

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

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

logTo

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

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

loggingTags

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

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

options

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

Примечание

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

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

galeraOptions

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

Примечание

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

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

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

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

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

host

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

password

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

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

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

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

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

charset

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Поддерживаемые значения: для MariaDB для MySQL и Percona	utf8

collate

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Поддерживаемые значения: для MariaDB для MySQL и Percona	utf8_unicode_ci

backupId

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

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

backupDbName

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

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да, если указан backupId	Нет	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