This is a read-only copy of the MariaDB Knowledgebase generated on 2024-11-14. For the latest, interactive version please visit https://mariadb.com/kb/.

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

Просмотр переменных

Для того чтобы посмотреть все настройки переменных для Galera Cluster, необходимо выполнить команду SHOW VARIABLES:

SHOW VARIABLES LIKE 'wsrep%';

Читайте также полный список системных и статусных опций MariaDB

Описание переменных

wsrep_auto_increment_control

  • Описание: If set to 1 (the default), will automatically adjust the auto_increment_increment и auto_increment_offset variables according to the size of the cluster, and when the cluster size changes. This avoids replication conflicts due to auto_increment. In a master-slave environment, can be set to OFF.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: ON

wsrep_causal_reads

  • Описание: If set to ON (OFF is default), enforces read-committed characteristics across the cluster. In the case that a master applies an event more quickly than a slave, the two could briefly be out-of-sync. With this variable set to ON, the slave will wait for the event to be applied before processing further queries. Setting to ON also results in larger read latencies. Deprecated by wsrep_sync_wait=1.
  • Область: Global, Session
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_certify_nonPK

  • Описание: When set to ON (по умолчанию), primary keys will be automatically generated for rows without one. This is required for parallel applying, and strongly recommended for all tables.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: ON

wsrep_cluster_address

  • Описание: Адреса узлов кластера к которым необходимо подключаться при запуске, например: gcomm://192.168.0.1:1234?gmcast.listen_addr=0.0.0.0:2345. Хорошей практикой является указание всех возможных узлов кластера по формуле: gcomm://<узел_1 или ip:port>,<узел_2 или ip2:port>,<узел_3 или ip3:port>. Указание пустого ip (gcomm://) приведет к тому, что узел запустит новый кластер (что не следует делать в файле my.cnf, так как после каждого перезапуска сервер не вернется в текущий кластер). Переменная может быть изменена во время выполнения в некоторых конфигурациях и приведет к тому, что узел закроет соединение с любым текущим кластером и подключится к новому узлу. Также можно указать порт узла, обратите внимание что порт Galera не должен совпадать с MariaDB.
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: String

wsrep_cluster_name

  • Описание: Имя кластера. Узлы не могут подключаться с разными именами, поэтому они должны быть одинаковыми для всех узлов в одном кластере.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: my_wsrep_cluster

wsrep_convert_LOCK_to_trx

  • Описание: Converts LOCK/UNLOCK TABLES statements to BEGIN and COMMIT. Used mainly for getting older applications to work with a multi-master setup, use carefully, as can result in extremely large writesets.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_data_home_dir

  • Описание: Каталог где wsper провайдер будет хранить свои файлы.
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: String
  • Значение по умолчанию: The datadir variable value.

wsrep_dbug_option

  • Описание: Используется для передачи DBUG опции wsrep провайдеру.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String

wsrep_debug

  • Описание: Когда установлен в ON (OFF по умолчанию), сообщения отладки будут записываться в журнал лога error log.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_desync

  • Описание: Когда установлен в ON (OFF по умолчанию), the node will be desynced from the cluster. The same effect can be achieved with a /*! WSREP_DESYNC */ query comment.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_dirty_reads

  • Описание: By default, when not synchronized with the group (wsrep_ready=OFF) a Нетde will reject all queries other than SET and SHOW. If wsrep_dirty_reads is set to 1, queries which do Нетt change data, like SELECT queries (dirty reads), creating of prepare statement, etc. will be accepted by the Нетde.
  • Область: Глобальный, Сессия
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF
  • Допустимые значения: ON, OFF
  • Введен: MariaDB Galera 5.5.42 MariaDB Galera 10.0.16 MariaDB 10.1.3

wsrep_drupal_282555_workaround

  • Описание: If set to ON, a workaround for Drupal/MySQL/InnoDB bug #282555 is enabled. This is a bug where, in some cases, when inserting a DEFAULT value into an AUTO_INCREMENT column, a duplicate key error may be returned.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_forced_binlog_format

  • Описание: A binary log format that will override any session binlog format settings.
  • Scope: Глобальный
  • Динамический: Да
  • Значение по умолчанию: NONE
  • Тип данных: Enum
  • Допустимые значения: STATEMENT, ROW, MIXED или NONE (which resets the forced binlog format state).

wsrep_gtid_domain_id

  • Описание: When wsrep_gtid_mode is set, this value is used as gtid_domain_id for galera transactions and also copied to the joiner Нетdes during state transfer. It is igНетred, otherwise.
  • Командная строка: --wsrep-gtid-domain-id=#
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: numeric
  • Значение по умолчанию: 0
  • Диапазон: 0 - 4294967295
  • Введен: MariaDB 10.1.4

wsrep_gtid_mode

  • Описание: Automatically update the (joiner) node's wsrep_gtid_domain_id value with that of doНетr's (received during state transfer) and use it in place of gtid_domain_id for all galera transactions. When OFF (по умолчанию), wsrep_gtid_domain_id is simply ignored (backward compatibility).
  • Командная строка: --wsrep-gtid-mode[={0|1}]
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: boolean
  • Значение по умолчанию: OFF
  • Введен: MariaDB 10.1.4

wsrep_load_data_splitting

  • Описание: Если установлен ON (по умолчанию), LOAD DATA INFILE поддерживает большие файлы данных за счет разбиения транзакций
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: ON
  • Введен: MariaDB Galera 5.5.32, MariaDB Galera 10.0.7, MariaDB 10.1.3

wsrep_log_conflicts

  • Описание: If set to ON (OFF по умолчанию), details of conflicting MDL as well as InnoDB locks in the cluster will be logged.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_max_ws_rows


wsrep_max_ws_size

  • Описание: Maximum permitted size in bytes per writeset. Writesets exceeding this will be rejected. Нетte that versions from and before MariaDB 10.1.17 and MariaDB Galera 10.0.27 permitted the maximum to be set beyond 2GB, which was rejected by Galera.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Число
  • Значение по умолчанию:
  • Диапазон: 1024 - 2147483647

wsrep_mysql_replication_bundle

  • Описание: Determines the number of replication events that are grouped together. Experimental implementation aimed to assist with bottlenecks when a single slave faces a large commit time delay. If set to 0 (по умолчанию), there is no grouping.
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Число
  • Значение по умолчанию: 0
  • Диапазон: 0 - 1000

wsrep_node_address

  • Описание: Указывается сетевой адрес узла в формате ip адрес[:порт]. Используется в ситуации, когда автоопределение не является надежным. По состоянию MariaDB 10.1.8 поддерживает IPv6
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Строка
  • Значение по умолчанию: Первичный сетевой адрес используемый eth0 с портом по умолчанию 4567

wsrep_node_incoming_address

  • Описание: Указывается адрес с которого узел прослушивает клиентские соединения. Если адрес не указан или установлено значение AUTO (по умолчанию), mysqld использует либо --bind-address или --wsrep-node-address, или пытается получить один из списка доступных сетевых в том же порядке
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Строка
  • Значение по умолчанию: AUTO

wsrep_node_name

  • Описание: Имя узла. Это имя может быть использовано в wsrep_sst_donor в качестве предпочтительного донора. Обратите внимание, что несколько узлов в кластере могут иметь одинаковое имя.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: Имя сервера (hostname).

wsrep_notify_cmd

  • Описание: Command to be executed each time the node state or the cluster membership changes. Can be used for raising an alarm, configuring load balancers and so on. Читайте Codership notification Script page чтобы получить больше информации
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Строка
  • Значение по умолчанию: Пустой

wsrep_on

  • Описание: Включение или отключение wsrep репликации. Если установлено OFF (по умолчанию с MariaDB 10.1), то никакие транзакции с этого узла не будут реплицироваться на другие узлы кластера. Эта переменная не влияет на членство в других узлах, и следовательно, не зависимо от ее значения, узел будет продолжать получать обновления с других узлов кластера. До MariaDB 10.1, эта переменная по умолчанию установлена в ON, но ее значение настраивается автоматически в зависимости от того, указаны ли обязательная конфигурация для включения репликации Galera. Начиная с MariaDB 10.1, по умолчанию установлено в OFF и должен был включен, чтобы Galera репликация начала работать.
  • Область: Global, Session
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF (>= MariaDB 10.1), ON (<= MariaDB Galera Cluster 10.0),
  • Допустимые значения: ON, OFF

wsrep_OSU_method

  • Описание: Online schema upgrade method.
    • TOI: Total Order Isolation. In each cluster Нетde, DDL is processed in the same order regarding other transactions, guaranteeing data consistency. However, affected parts of the database will be locked for the whole cluster.
    • RSU: Rolling Schema Upgrade. DDL processing is only done locally on the Нетde, and the user needs perform the changes manually on each Нетde. The Нетde is desynced from the rest of the cluster while the processing takes place to avoid the blocking other Нетdes. Schema changes must be backwards compatible to avoid breaking replication when the DDL processing is complete on the single Нетde, and replication recommences.
  • Область: Глобальный, Сессия (с MariaDB Galera 10.0.19)
  • Динамический: Да
  • Тип данных: Enum
  • Значение по умолчанию: TOI
  • Допустимые значения: TOI, RSU

wsrep_patch_version

  • Описание: Версия патча Wsrep, пример: wsrep_25.10.
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: String
  • Значение по умолчанию: none
  • Введен: MariaDB 10.1.5

wsrep_provider

  • Описание: Расположение библиотеки wsrep
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: none

wsrep_provider_options

  • Описание: Разделитель точка с запятой (;) для списка опций wsrep (Смотрите wsrep_provider_options)
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Строка
  • Значение по умолчанию: Пустой

wsrep_recover

  • Описание: Used for recovering the Global Transaction ID. If set to ON when the server starts, Galera will search for the Global Transaction ID in the log and output it to stderr, usually the error log.
  • Командная строка: --wsrep-recover
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_replicate_myisam

  • Описание: Whether or not DML updates for MyISAM tables will be replicated. This functionality is still experimental and should Нетt be relied upon in production systems.
  • Область: Глобальный
  • Динамический: Да
  • Значение по умолчанию: OFF
  • Тип данных: Boolean
  • Допустимые значения: ON, OFF

wsrep_restart_slave

  • Описание: Если установлено в ON, автоматически перезагружает вторичные репликации, когда узел присоединяется к кластеру.
  • Область: Глобальный
  • Динамический: Да
  • Значение по умолчанию: OFF
  • Тип данных: Boolean
  • Введен: MariaDB Galera 5.5.39, MariaDB Galera 10.0.10

wsrep_retry_autocommit

  • Описание: Number of times autocommited queries will be retried due to cluster-wide conflicts before returning an error to the client. If set to 0, Нет retries will be attempted, while a value of 1 (the default) or more specifies the number of retries attempted. Can be useful to assist applications using autocommit to avoid deadlocks.
  • Область: Глобальный
  • Динамический: Нет
  • Тип данных: Numeric
  • Значение по умолчанию: 1
  • Диапазон: 0 - 10000

wsrep_slave_fk_checks

  • Описание: Если установлено в ON (по умолчанию), the applier slave thread performs foreign key constraint checks.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: ON
  • Введен: MariaDB Galera 5.5.39, MariaDB Galera 10.0.12

wsrep_slave_threads

  • Описание: Number of threads used for applying slave writesets in parallel. Galera parallel replication is only applied to transactions when safe to do so. If changed from the default (1), as a rough guideline consider using twice the number of CPU cores, and a quarter the number of writing clients used by other connections. This can be particularly useful when the Нетde's state is JOINED, because it makes the catchup process faster. Нетte however that, if consistency problems frequently occur, setting the value to 1 will probably fix the problem.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Numeric
  • Значение по умолчанию: 1
  • Диапазон: 1 - 512

wsrep_slave_uk_checks

  • Описание: If set to ON, the applier slave thread performs secondary index uniqueness checks.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF
  • Введен: MariaDB Galera 5.5.39, MariaDB Galera 10.0.12

wsrep_sst_auth

  • Описание: Логин и пароль пользователя используемый при репликации. Не используется если wsrep_sst_method установлено значение rsync, однако для остальных случаев параметр должен иметь формат <user>:<password>. Содержимое параметра маскируется в логах и при запросе параметра через SHOW VARIABLES.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию:

wsrep_sst_donor

  • Описание: Comma-separated list (from 5.5.33) or name (as per wsrep_node_name) of the servers as donors, or the source of the state transfer, in order of preference. The donor-selection algorithm, in general, prefers a donor capable of transferring only the missing transactions (IST) to the joiner node, instead of the complete state (SST). Thus, it starts by looking for an IST-capable node in the given donor list followed by rest of the nodes in the cluster. In case multiple candidate nodes are found outside the specified doНетr list, the node in the same segment (gmcast.segment) as the joiner is preferred. If none of the existing nodes in the cluster can serve the missing transactions through IST, the algorithm moves on to look for a suitable node to transfer the entire state (SST). It first looks at the nodes specified in the donor list (irrespective of their segment). If no suitable donor is still found, the rest of the doНетr Нетdes are checked for suitability only if the donor list has a "terminating-comma". note that a stateless node (the Galera arbitrator) can never be a donor.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию:

wsrep_sst_donor_rejects_queries

  • Описание: Если установлено ON (OFF по умолчанию), то узел-донор будет отклонять входящие запросы, возвращая код ошибки UNKNOWN COMMAND. Can be used for informing load balancers that a node is unavailable.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: Boolean
  • Значение по умолчанию: OFF

wsrep_sst_method

  • Описание: Method used for taking the state snapshot transfer (sst). The command wsrep_sst_<wsrep_sst_method> will then be called, so a custom script can be written for this purpose. See Codership Scriptable State Snapshop page for details. Existing valid values include rsync (the default), mysqldump, xtrabackup and xtrabackup-v2, which use those respective methods to perform the state snapshop transfer, or skip. skip skips the transfer and should only be used temporarily, for example when starting the cluster and manually restoring data. See also the mysqldump and Xtrabackup articles. Нетte that the rsync and mysqldump SST methods support GTID. However, the xtrabackup-v2 and xtrabackup SST methods currently do Нетt support GTID. The xtrabackup-v2 sst method was introduced in MariaDB Galera 5.5.37 and 10.0.10.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: rsync
  • Допустимые значения: rsync, mysqldump, xtrabackup, xtrabackup-v2

wsrep_sst_receive_address

  • Описание: This is the address where other nodes (donor) in the cluster connect to in order to send the state-transfer updates. If an address is Нетt specified or its set to AUTO (default), mysqld uses --wsrep_Нетde_address's value as the receiving address. However, if --wsrep_Нетde_address is Нетt set, it uses address from either --bind-address or tries to get one from the list of available network interfaces, in the same order. Нетte: setting it to localhost will make it impossible for Нетdes running on other hosts to reach this Нетde.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: AUTO

wsrep_start_position

  • Описание: UUID последовательность чисел.
  • Область: Глобальный
  • Динамический: Да
  • Тип данных: String
  • Значение по умолчанию: 00000000-0000-0000-0000-000000000000:-1

wsrep_sync_wait

  • Описание: Setting it ensures synchronous read view before executing an operation of the type specified by the bitmask. Please Нетte when wsrep_dirty_reads is ON, values of wsrep_sync_wait becomes irrelevant. Bitmask:
    • 0 - Отключен
    • 1 - READ (SELECT, SHOW & BEGIN/START TRANSACTION); тоже самое что и wsrep_causal_reads=1
    • 2 - UPDATE и DELETE;
    • 3 - READ, UPDATE и DELETE;
    • 4 - INSERT и REPLACE;
  • Область: Глобальный, Сессия
  • Динамический: Да
  • Тип данных: Numeric
  • Значение по умолчанию: 0
  • Диапазон: 0 - 7
  • Введен: MariaDB Galera 5.5.39, MariaDB Galera 10.0.13

Content reproduced on this site is the property of its respective owners, and this content is not reviewed in advance by MariaDB. The views, information and opinions expressed by this content do not necessarily represent those of MariaDB or any other party.