21.9.6.6. Установка/Конфигурирование

Включает или отключает плагин. Если отключено, расширение не будет включать mysqlnd, чтобы проксировать внутренний mysqlnd C вызовы API.

Если включено, плагин проверки, если узел (сервер) значение параметров какой-либо попытки подключения MySQL, соответствует имя раздела от сменного конфигурационного файла. В противном случае попытка подключения блокируется.

Эта установка не только полезна, чтобы ограничить PHP определенными серверами, но также и отладить проблемы конфигурационного файла. Законность конфигурационного файла проверяется на двух различных этапах. Первая проверка выполняется, когда PHP начинает обрабатывать веб-запрос. В этой точке плагин читает и декодирует конфигурационный файл. Ошибки, брошенные в эту раннюю стадию в жизненном цикле расширений, нельзя показать должным образом пользователю. Таким образом плагин буферизует ошибки, если таковые вообще имеются, и дополнительно выводит на экран их, устанавливая соединение с MySQL. По умолчанию буферизованная ошибка запуска испустит ошибку типа E_WARNING. Если force_config_usage устанавливается, ошибочный используемый тип E_RECOVERABLE_ERROR.

Пожалуйста, см. также примечания отладки конфигурационного файла.

Сменный определенный конфигурационный файл. Эта установка была переименована к mysqlnd_ms.config_file в версии 1.4.0.

Сменный определенный конфигурационный файл. Эта установка суперсемена mysqlnd_ms.ini_file с тех пор 1.4.0.

Включает или отключает набор статистики. Набор статистики отключается по умолчанию по причинам производительности. Статистические данные возвращаются функцией mysqlnd_ms_get_stats.

Включает или отключает поддержку MySQL много основные установки репликации. Пожалуйста, см. также поддерживаемые кластеры.

Включает или отключает встроенное разделение записи чтения.

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

Подсказка SQL MYSQLND_MS_USE_SLAVE не будет распознан. Если найдено, оператор будет перенаправлен ведущему устройству.

Отключение разделения записи чтения воздействует на возвращаемое значение mysqlnd_ms_query_is_select. Функция больше не будет предлагать выполнение запроса на ведомых серверах.

Список главных серверов репликации MySQL. Список любого из JSON type array объявить анонимный список серверов или JSON type object. Пожалуйста, см. выше для примеров.

Установка по крайней мере одного главного сервера обязательна. Плагин выпустит ошибку типа E_ERROR если пользователь был не в состоянии обеспечить список главного сервера для раздела конфигурации. Фатальная ошибка может читать (mysqlnd_ms) Section [master] doesn't exist for host [name_of_a_config_section] in %s on line %d.

Сервер описывается с host, port, socket, db, user, password и connect_flags. Это обязательно, чтобы обеспечить в значении для host. Если какое-либо из других значений не будет дано, то это будет взято от пользовательского API, соединяют вызов, пожалуйста, см. также: использование раздела называет пример.

Таблица ключевых слов конфигурации сервера.

Плагин поддерживает использование только одного главного сервера. Экспериментальная установка существует, чтобы включить мультиосновной поддержке. Детали не документируются. Установка предназначается для разработки только.

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

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

Установка списка ведомых серверов обязательна. Плагин сообщит об ошибке типа E_ERROR если slave не дается для раздела конфигурации. Сообщение о фатальной ошибке может читать (mysqlnd_ms) Section [slave] doesn't exist for host [%s] in %s on line %d. Отметьте, что это допустимо, чтобы использовать пустой ведомый список сервера. Ошибка была представлена, чтобы предотвратить случайно установку никаких ведомых устройств, забывая о slave установка. Установка только для ведущего устройства является все еще возможным использованием пустого ведомого списка сервера.

Если пустой ведомый список конфигурируется, и попытка предпринимается, чтобы выполнить оператор на ведомом устройстве, как которое плагин может испустить предупреждение mysqlnd_ms) Couldn't find the appropriate slave connection. 0 slaves to choose from. после выполнения оператора. Возможно, что другое предупреждение следует за таким как (mysqlnd_ms) No connection selected by the last filter.

Глобальная конфигурация идентификатора транзакции, связанная и с использованием сервера встроенная глобальная функция ID транзакции и с клиентской эмуляцией.

Список фильтров. Фильтр ответственен, чтобы фильтровать список доступных серверов для того, чтобы выполнить данный оператор. Фильтры могут быть объединены в цепочку. random и roundrobin фильтруйте заменяют pick[] направляющий используемый в предыдущей версии, чтобы выбрать политику выравнивания нагрузки. user фильтруйте заменяет mysqlnd_ms_set_user_pick_server функция.

Фильтры могут принять, что параметры совершенствовали свои действия.

Если никакая политика выравнивания нагрузки не будет установлена, то плагин примет значение по умолчанию к random_once. random_once политика выбирает случайный ведомый сервер, выполняя первый оператор только для чтения. Ведомый сервер будет использоваться для всех операторов только для чтения, пока выполнение Сценария PHP не закончится. Никакая политика выравнивания нагрузки не устанавливается и таким образом, установка по умолчанию имеет место, если ни один random ни roundrobin часть раздела конфигурации.

Если цепочка фильтра конфигурируется так, чтобы фильтр, которые выводят не больше, чем однажды сервер, использовался как входной для фильтра, которому нужно дать больше чем один сервер как входной, плагин может испустить предупреждение после открытия соединения. Предупреждение может читать: (mysqlnd_ms) Error while creating filter '%s' . Non-multi filter '%s' already created. Stopping in %s on line %d. Кроме того, ошибка кода ошибки 2000, состояние sql HY000 и сообщение об ошибке, подобное предупреждению, может быть установлено на дескрипторе соединения.

       {    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "filters": [            "roundrobin",            "random"        ]    }}         

<?php$link = new mysqli("myapp", "root", "", "test");printf("[%d] %s\n", mysqli_connect_errno(), mysqli_connect_error());$link->query("SELECT 1 FROM DUAL");?>         

PHP Warning:  mysqli::mysqli(): (HY000/2000): (mysqlnd_ms) Error while creating filter 'random' . Non-multi filter 'roundrobin' already created. Stopping in filter_warning.php on line 1[2000] (mysqlnd_ms) Error while creating filter 'random' . Non-multi filter 'roundrobin' already created. StoppingPHP Warning:  mysqli::query(): Couldn't fetch mysqli in filter_warning.php on line 3

random фильтр обладает случайным и случайным однажды политики выравнивания нагрузки, установленные через pick[] направляющий в более старых версиях.

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

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

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            },            "slave_1": {                "host": "192.168.78.137",                "port": "3306"            }        },        "filters": [            "random"        ]    }}

Дополнительно, sticky параметр можно передать к фильтру. Если параметр sticky устанавливается в строку 1, фильтр следует за случайным однажды стратегия выравнивания нагрузки.

{    "filters": {        "random": {            "sticky": "1"        }    }}

Оба random и roundrobin поддержка фильтров, устанавливающая приоритет, вес для сервера, начиная с PECL/mysqlnd_ms 1.4.0. Если weight параметр передают к фильтру, он должен присвоить вес для всех серверов. Серверы должны быть поданы имя псевдонима slave соответственно master списки сервера. Псевдоним должен привыкнуть к ссылочным серверам для того, чтобы присвоить приоритет с weight.

[E_RECOVERABLE_ERROR] mysqli_real_connect(): (mysqlnd_ms) Unknown server 'slave3' in 'random' filter configuration. Stopping in %s on line %d

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

Если weight опускается, вес значения по умолчанию всех серверов является тем.

{   "myapp": {       "master": {           "master1":{               "host":"localhost",               "socket":"\/var\/run\/mysql\/mysql.sock"           }       },       "slave": {           "slave1": {               "host":"192.168.2.28",               "port":3306           },           "slave2": {               "host":"192.168.2.29",               "port":3306           },           "slave3": {               "host":"192.0.43.10",               "port":3306           },       },       "filters": {           "random": {               "weights": {                   "slave1":8,                   "slave2":4,                   "slave3":1,                   "master1":1               }           }       }   }}

В среднем числе сервер, присвоенный, вес два будет выбран дважды так часто как сервер, присвоенный вес одного. Различные веса могут быть присвоены отразить по-другому измеренные машины, предпочесть cо-расположенные ведомые устройства, у которых есть низкая сетевая задержка или, чтобы сконфигурировать резервное устройство failover сервер. В последнем случае можно хотеть присвоить резервный сервер очень низкий вес относительно других серверов. Например, учитывая конфигурацию выше slave3 получит только приблизительно восемь процентов запросов в среднем числе. Пока slave1 и slave2 работают, это будет использоваться редко, подобное резервному устройству failover сервер. На отказ slave1 и slave2, использование slave3 увеличения. Пожалуйста, проверьте примечания по failover перед использованием weight этот путь.

Допустимый вес оценивает диапазон от 1 до 65535.

Неизвестные параметры игнорируются фильтром. Никакое предупреждение или ошибка не даются.

Фильтр ожидает один или более серверов как входной. Выводит один сервер. Последовательность фильтра такой как random, roundrobin может заставить предупреждение и сообщение об ошибке быть установленным на дескрипторе соединения, выполняя оператор.

Список параметров фильтра.

Используя roundrobin фильтр, плагин выполняет итерации по списку сконфигурированных ведомых серверов, чтобы выбрать сервер для выполнения оператора. Если плагин достигает конца списка, это повторяется к началу списка и выбирает первый сконфигурированный ведомый сервер.

       {    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "filters": [            "roundrobin"        ]    }}

Ожидает один или более серверов как входной. Выводит один сервер. Последовательность фильтра такой как roundrobin, random может заставить предупреждение и сообщение об ошибке быть установленным на дескрипторе соединения, выполняя оператор.

Список параметров фильтра.

user замены mysqlnd_ms_set_user_pick_server функция, которая была удалена в с 1.1.0 бетами. Фильтр устанавливает обратный вызов для определяемого пользователем разделения чтения-записи и выбора сервера.

Плагины встроенные решения механизма разделения запроса чтения-записи могут быть перезаписаны двумя способами. Самый легкий путь состоит в том, чтобы предварительно ожидать строку запроса с подсказками SQL MYSQLND_MS_MASTER_SWITCH , MYSQLND_MS_SLAVE_SWITCH или MYSQLND_MS_LAST_USED_SWITCH . Используя подсказки SQL можно управлять, например, должен ли запрос быть, передаются к главному серверу репликации MySQL или одному из ведомых серверов. Справкой подсказок SQL не возможно выбрать определенный ведомый сервер для выполнения запроса.

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

Плагин вызовет функцию обратного вызова для того, чтобы выбрать сервер из списков сконфигурированных основных и ведомых серверов. Функция обратного вызова осматривает запрос, чтобы работать и выбирает сервер для выполнения запроса, возвращая URI узлов, как найдено в основном и ведомом списке.

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

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "filters": {            "user": {                "callback": "pick_server"            }        }    }}

Обратный вызов, как предполагается, возвращает узел, чтобы работать на запросе. URI узла должен быть взят от основных и ведомых списков соединения, которые передают к функции обратного вызова. Если обратный вызов возвратит значение, ни найденное в ведущем устройстве, ни в ведомых списках соединения, то плагин испустит ошибку типа E_RECOVERABLE_ERROR Ошибка может читать как (mysqlnd_ms) User filter callback has returned an unknown server. The server 'server that is not in master or slave list' can neither be found in the master list nor in the slave list. Если приложение фиксирует ошибку, чтобы проигнорировать это, развить ошибки, может быть установлен на дескрипторе соединения, например, (mysqlnd_ms) No connection selected by the last filter с кодом ошибки 2000 и sqlstate HY000. Кроме того предупреждение может быть испущено.

Ссылаясь на несуществующую функцию, поскольку обратный вызов приведет к любой ошибке типа E_RECOVERABLE_ERROR всякий раз, когда плагин пробует к функции обратного вызова. Сообщение об ошибке может чтения как: (mysqlnd_ms) Specified callback (pick_server) is not a valid callback. Если приложение фиксирует ошибку, чтобы проигнорировать это, развить ошибки, может быть установлен на дескрипторе соединения, например, (mysqlnd_ms) Specified callback (pick_server) is not a valid callback с кодом ошибки 2000 и sqlstate HY000. Кроме того предупреждение может быть испущено.

Следующие параметры передают от плагина до обратного вызова.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.2.27",                "port": "3306"            },            "slave_1": {                "host": "192.168.78.136",                "port": "3306"            }        },        "filters": {            "user": {                "callback": "pick_server"            }        }    }}         

<?phpfunction pick_server($connected, $query, $masters, $slaves, $last_used_connection, $in_transaction){ static $slave_idx = 0; static $num_slaves = NULL; if (is_null($num_slaves))  $num_slaves = count($slaves); /* default: fallback to the plugins build-in logic */ $ret = NULL; printf("User has connected to '%s'...\n", $connected); printf("... deciding where to run '%s'\n", $query); $where = mysqlnd_ms_query_is_select($query); switch ($where) {  case MYSQLND_MS_QUERY_USE_MASTER:   printf("... using master\n");   $ret = $masters[0];   break;  case MYSQLND_MS_QUERY_USE_SLAVE:   /* SELECT or SQL hint for using slave */   if (stristr($query, "FROM table_on_slave_a_only"))   {    /* a table which is only on the first configured slave  */    printf("... access to table available only on slave A detected\n");    $ret = $slaves[0];   }   else   {    /* round robin */    printf("... some read-only query for a slave\n");    $ret = $slaves[$slave_idx++ % $num_slaves];   }   break;  case MYSQLND_MS_QUERY_LAST_USED:   printf("... using last used server\n");   $ret = $last_used_connection;   break; } printf("... ret = '%s'\n", $ret); return $ret;}$mysqli = new mysqli("myapp", "root", "", "test");if (!($res = $mysqli->query("SELECT 1 FROM DUAL"))) printf("[%d] %s\n", $mysqli->errno, $mysqli->error);else $res->close();if (!($res = $mysqli->query("SELECT 2 FROM DUAL"))) printf("[%d] %s\n", $mysqli->errno, $mysqli->error);else $res->close();if (!($res = $mysqli->query("SELECT * FROM table_on_slave_a_only"))) printf("[%d] %s\n", $mysqli->errno, $mysqli->error);else $res->close();$mysqli->close();?>         

User has connected to 'myapp'...... deciding where to run 'SELECT 1 FROM DUAL'... some read-only query for a slave... ret = 'tcp://192.168.2.27:3306'User has connected to 'myapp'...... deciding where to run 'SELECT 2 FROM DUAL'... some read-only query for a slave... ret = 'tcp://192.168.78.136:3306'User has connected to 'myapp'...... deciding where to run 'SELECT * FROM table_on_slave_a_only'... access to table available only on slave A detected... ret = 'tcp://192.168.2.27:3306'

user_multi отличается от user только в одном аспекте. Иначе, их синтаксис идентичен. user фильтр должен выбрать и возвратить точно один узел для выполнения оператора. Цепочка фильтра обычно заканчивается фильтром, который испускает только один узел. Цепочка фильтра должна уменьшить список кандидатов для выполнения оператора вниз одному. Это, только один узел уехал, имеет место после user фильтр был выполнен.

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

Возвращаемое значение набора обратного вызова для user_multi должен быть массив с двумя элементами. Первый элемент содержит список выбранных главных серверов. Второй элемент содержит список выбранных ведомых серверов. Списки должны содержать ключи ведомых и главных серверов как найдено в ведомых и основных списках, которые передают к обратному вызову. Ниже примера возвращает случайные основные и ведомые списки, извлеченные из ввода функций.

<?phpfunction pick_server($connected, $query, $masters, $slaves, $last_used_connection, $in_transaction){  $picked_masters = array()  foreach ($masters as $key => $value) {    if (mt_rand(0, 2) > 1)      $picked_masters[] = $key;  }  $picked_slaves = array()  foreach ($slaves as $key => $value) {    if (mt_rand(0, 2) > 1)      $picked_slaves[] = $key;  }  return array($picked_masters, $picked_slaves);}?>

Плагин выпустит ошибку типа E_RECOVERABLE если обратный вызов не в состоянии возвратить список сервера. Ошибка может читать (mysqlnd_ms) User multi filter callback has not returned a list of servers to use. The callback must return an array in %s on line %d. В случае, если список сервера не пуст, но имеет недопустимый ключ/идентификаторы серверов в этом, ошибку типа E_RECOVERABLE будет брошенный с сообщением об ошибке как (mysqlnd_ms) User multi filter callback has returned an invalid list of servers to use. Server id is negative in %s on line %d, или подобный.

Испускается ли ошибка в случае пустого ведомого или основного списка, зависит от конфигурации. Если пустой основной список возвращается для операции записи, вероятно, что плагин испустит предупреждение, которое может читать (mysqlnd_ms) Couldn't find the appropriate master connection. 0 masters to choose from. Something is wrong in %s on line %d. Обычно развить ошибка типа E_ERROR произойдет. В случае операции чтения и пустой ведомый список поведение зависит от сбоя по конфигурации. Если сбой ведущему устройству включается, никакая ошибка не должна появиться. Если сбой ведущему устройству будет деактивирован, то плагин испустит предупреждение, которое может читать (mysqlnd_ms) Couldn't find the appropriate slave connection. 0 slaves to choose from. Something is wrong in %s on line %d.

node_groups фильтр позволяет Вам групповые узлы кластера и запрос выбранные группы, например, чтобы поддерживать разделение данных. Разделение данных может требоваться для руководства sharding, основная копия базируемые кластеры, выполняющие многократные ведущие устройства, или избегать горячих точек в обновлении всюду кластеры, у которых нет никакого встроенного разделения. Фильтр является много фильтром, который возвращает нуль, один или многократный из его входных серверов. Таким образом это должно сопровождаться другими фильтрами, чтобы сократить количество кандидатов вниз одному для выполнения оператора.

 {  "myapp": {       "master": {            "master_0": {                "host": "localhost",                "socket": "\/tmp\/mysql.sock"            }        },        "slave": {            "slave_0": {                "host": "192.168.2.28",                "port": 3306            },            "slave_1": {                "host": "127.0.0.1",                "port": 3311            }        },        "filters": {            "node_groups": {                "Partition_A" : {                    "master": ["master_0"],                    "slave": ["slave_0"]                }            },           "roundrobin": []        }    }}

quality_of_service идентифицирует узлы кластера, способные к поставке определенного качества службы. Это - много фильтр, который возвращает нуль, один или многократный из его входных серверов. Таким образом это должно сопровождаться другими фильтрами, чтобы сократить количество кандидатов вниз одному для выполнения оператора.

quality_of_service фильтр был представлен в с 1.2.0 альфами. В 1.2 рядах фокус фильтров находится на аспекте непротиворечивости качества обслуживания. Различные типы кластеров предлагают различную непротиворечивость данных значения по умолчанию. Например, асинхронное ведомое устройство репликации MySQL предлагает возможную непротиворечивость. Ведомое устройство, возможно, не в состоянии поставить запрошенные данные, потому что это не тиражировало запись, это может служить устарелой базе данных, потому что ее отставание или это могут служить текущей информации. Часто, это является приемлемым. В некоторых случаях более высокие уровни непротиворечивости необходимы для корректного рвения. В тех случаях, quality_of_service может отфильтровать узлы кластера, которые не могут поставить необходимое качество службы.

quality_of_service фильтр может быть заменен или создан во времени выполнения. Успешный вызов к mysqlnd_ms_set_qos удаляет всех существующих qos записи фильтра от списка фильтра и установки новый в самом начале. Все настройки, которые могут быть сделаны через mysqlnd_ms_set_qos может также быть в конфигурационном файле плагинов. Однако, использование функции является безусловно случаем наиболее популярного способа использования. Вместо того, чтобы установить непротиворечивость сеанса и уровни обслуживания непротиворечивости strong в конфигурационном файле плагинов рекомендуется определить только ведущие устройства и никакие ведомые устройства. Оба уровня обслуживания вызовут использование ведущих устройств только. Используя пустой ведомый список сокращает конфигурационный файл, таким образом улучшая удобочитаемость. Единственный уровень обслуживания, для которого есть случай определения в конфигурационном файле плагинов, является комбинацией возможной непротиворечивости и максимальной ведомой задержки.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.2.27",                "port": "3306"            },            "slave_1": {                "host": "192.168.78.136",                "port": "3306"            }        },        "filters": {            "quality_of_service": {                "eventual_consistency": {                    "age":123                }            }        }    }}

Политика Failover. Поддерживаемые политики: disabled (значение по умолчанию), master, loop_before_master (Начиная с 1.4.0).

Если никакая failover политика не будет установлена, то плагин не будет делать никакого автоматического failover (failover=disabled). Всякий раз, когда плагин не в состоянии соединить сервер, он испустит предупреждение и установит код ошибки соединений и сообщение. После того это до приложения, чтобы обработать ошибку и, например, снова послало последний оператор, чтобы инициировать выбор другого сервера.

Пожалуйста, отметьте, автоматическая failover логика применяется когда вводные соединения только. Как только соединение было открыто, никакие автоматические попытки не предпринимаются, чтобы вновь открыть его в случае ошибки. Если, например, сервер, с которым соединяется соединение, будет выключен, и пользователь пытается выполнить оператор на соединении, то никакой автоматический failover не попробуют. Вместо этого об ошибке сообщат.

Используя failover=master плагин будет неявно failover ведущему устройству при наличии. Пожалуйста, проверьте документацию понятий, чтобы узнать о потенциальных ловушках и рисках использования failover=master.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "failover": "master"    }}

Начиная с PECL/mysqlnd_ms 1.4.0 failover ключевое слово конфигурации обращается к объекту.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "failover": {"strategy": "master" }    }}

Установка failover к любому другому значению, но disabled, master или loop_before_master не будет испускать предупреждения или ошибки.

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

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

Ленивые соединения, пустые риск, если Вы делаете интенсивное использование из действий, которые изменяют состояние соединения. Плагин не диспетчеризирует все действия изменения состояния всем соединениям от пула соединения. Немногим диспетчеризированным действиям уже применяются к открытые соединения только. На ленивые соединения, открытые в будущем, не влияют. Только некоторые настройки "помнят" и применяются, когда ленивые соединения открываются.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "lazy_connections": 0    }}

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

Установка была представлена в 1.4.0. Рекомендуется установить это, используя ленивые соединения.

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

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

Приложение, используя ленивые соединения может попытаться выйти из строки прежде, чем отправить оператор. Фактически, это должно быть общим падежом, поскольку строка оператора может содержать строку, которой нужно оставить. Однако, из-за ленивой функции соединения никакое соединение еще не было открыто и выходящие сбои. Плагин может сообщить об ошибке типа E_WARNING и сообщение как (mysqlnd_ms) string escaping doesn't work without established connection. Possible solution is to add server_charset to your configuration сообщать Вам о ловушке.

Установка server_charset заставляет плагин использовать данный набор символов для строкового выхода, сделанного на ленивых дескрипторах соединения прежде, чем установить сетевое соединение с MySQL. Кроме того плагин осуществит использование набора символов, когда соединение будет установлено.

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

Плагин не мешает пользователю изменить набор символов в любое время, используя set_charset вызовите или соответствующие SQL-операторы. Пожалуйста, отметьте, что использование SQL не рекомендуется, поскольку это не может контролироваться плагином. Пользователь может, например, изменить набор символов на ленивом дескрипторе соединения после выхода из строки и прежде, чем фактическое соединение будет открыто. Набор символов, установленный пользователем, будет использоваться для любого последующего выхода прежде, чем соединение будет установлено. Соединение будет установлено, используя сконфигурированный набор символов, независимо от того что набор символов сервера или что пользователь установил прежде. Как только соединение было открыто, set_charset не имеет значения больше.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "lazy_connections": 1,        "server_charset" : "utf8"    }}        

<?php$mysqli = new mysqli("myapp", "username", "password", "database");$mysqli->real_escape("this will be escaped using the server_charset setting - utf8");$mysqli->set_charset("latin1");$mysqli->real_escape("this will be escaped using latin1");/* server_charset implicitly set - utf8 connection */$mysqli->query("SELECT 'This connection will be set to server_charset upon establishing' AS _msg FROM DUAL");/* latin1 used from now on */$mysqli->set_charset("latin1");?>

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

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

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "master_on_write": 1    }}

Пожалуйста, отметьте quality_of_service фильтр, представленный в версии, с 1.2.0 альфами. Это дает более прекрасный контроль, например, для того, чтобы достигнуть "читает Ваши записи" и, это предлагает дополнительную функциональность, представляющую уровни обслуживания.

Все настройки неподвижности транзакции, включая trx_stickiness=on, отвергаются master_on_write=1.

Политика неподвижности транзакции. Поддерживаемые политики: disabled (значение по умолчанию), master.

Установка требует 5.4.0 или более новый. Если использующийся с PHP, более старым чем 5.4.0, плагин испустит предупреждение как (mysqlnd_ms) trx_stickiness strategy is not supported before PHP 5.3.99.

Если никакая политика неподвижности транзакции не устанавливается или, устанавливая trx_stickiness=disabled, плагин не является знающей транзакцией. Таким образом плагин может загрузить соединения баланса и переключить соединения в середине транзакции. Плагин не является безопасной транзакцией. Подсказки SQL должны использоваться, избегают переключателей соединения во время транзакции.

С PHP 5.4.0 mysqlnd библиотека позволяет плагину контролировать autocommit режим, установленный звонками в библиотеки set_autocommit() функция. Устанавливая set_stickiness=master и autocommit отключается расширением MySQL PHP, вызывающим mysqlnd библиотека внутренний вызов функции set_autocommit(), плагин делается знающий о начинании транзакции. Затем, плагин останавливает выравнивание нагрузки и не направляет все операторы к главному серверу до autocommit включается. Таким образом никакие подсказки SQL не требуются.

Пример API-функции MySQL PHP, вызывая mysqlnd библиотека внутренний вызов функции set_autocommit() mysqli_autocommit.

Хотя устанавливая trx_stickiness=master, плагин не может быть сделан знающий autocommit изменения режима, вызванные SQL-операторами такой как SET AUTOCOMMIT=0 или BEGIN.

С PHP 5.5.0, mysqlnd функции библиотеки дополнительные вызовы API C контрольных сделок. Уровень управления соответствует тот, предлагаемый SQL-операторами. mysqli API был изменен, чтобы использовать эти вызовы. Начиная с версии 1.5.0 PECL/mysqlnd_ms может контролировать не только mysqli_autocommit, но также и mysqli_begin, mysqli_commit и mysqli_rollback обнаружить границы транзакции и остановить выравнивание нагрузки для продолжительности транзакции.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }        },        "trx_stickiness": "master"    }}

Начиная с версии 1.5.0 автоматический и тихий failover отключается для продолжительности транзакции. Если границы транзакции были должным образом обнаружены, неподвижность транзакции включается, и сервер перестал работать, плагин не будет пытаться перестать работать к следующему серверу, если таковые вообще имеются, независимо от failover сконфигурированной политики. Пользователь должен обработать ошибку вручную. В зависимости от конфигурации плагин может испустить ошибку типа E_WARNING чтение как (mysqlnd_ms) Automatic failover is not permitted in the middle of a transaction. Эта ошибка может тогда быть перезаписана, развивают ошибки такой как (mysqlnd_ms) No connection selected by the last filter. Те ошибки будут сгенерированы функцией запроса сбоя.

<?php/* assumption: automatic failover configured */$mysqli = new mysqli("myapp", "username", "password", "database");/* sets plugin internal state in_trx = 1 */$mysqli->autocommit(false);/* assumption: server fails */if (!($res = $mysqli->query("SELECT 'Assume this query fails' AS _msg FROM DUAL"))) { /* handle failure of transaction, plugin internal state is still in_trx = 1 */ printf("[%d] %s", $mysqli->errno, $mysqli->error); /*  If using autocommit() based transaction detection it is a  MUST to call autocommit(true). Otherwise the plugin assumes  the current transaction continues and connection  changes remain forbidden. */ $mysqli->autocommit(true); /* Likewise, you'll want to start a new transaction */ $mysqli->autocommit(false);}/* latin1 used from now on */$mysqli->set_charset("latin1");?>

Если сервер перестал работать в середине транзакции, плагин продолжает отказываться переключить соединения, пока текущая транзакция не была закончена. Вспомните, что плагин контролирует вызовы API, чтобы обнаружить границы транзакции. Таким образом необходимо, например, позволить автоматическому режиму фиксации закончить текущую транзакцию прежде, чем плагин будет продолжать выравнивание нагрузки и будет переключать сервер. Аналогично, Вы будете хотеть запустить новую транзакцию сразу после того и отключить автоматический режим фиксации снова.

Не обработка отказавших запросов и не окончание отказавшей транзакции, используя вызовы API могут вызвать весь после команд, испускают ошибки такой как Commands out of sync; you can't run this command now. Таким образом важно обработать все ошибки.

Установка была представлена в 1.6.0.

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

PECL/mysqlnd_ms может выполнить цикл повторной попытки от имени приложения. Конфигурируя transient_error плагин может быть проинструктирован, чтобы повторить операции, переставшие работать с определенным кодом ошибки для определенного максимального количества времен с паузой между повторениями. Если случайная ошибка исчезает во время выполнения цикла, она скрывается от приложения. Иначе, ошибка передается приложению к концу цикла.

{    "myapp": {        "master": {            "master_0": {                "host": "localhost"            }        },        "slave": {            "slave_0": {                "host": "192.168.78.136",                "port": "3306"            }       },       "transient_error": {          "mysql_error_codes": [            1297          ],          "max_retries": 2,          "usleep_retry": 100       }    }}

URI главного сервера репликации MySQL. URI следует за синтаксисом hostname[:port|unix_domain_socket].

Плагин поддерживает использование только одного главного сервера.

Установка главного сервера обязательна. Плагин сообщит, что предупреждение на соединяется, если пользователь был не в состоянии обеспечить главный сервер для раздела конфигурации. Предупреждение может читать (mysqlnd_ms) Cannot find master section in config. Кроме того плагин может установить код ошибки для дескриптора соединения такой как HY000/2000 (CR_UNKNOWN_ERROR). Соответствующее сообщение об ошибке зависит от Ваших настроек языка.

URI одного или более ведомых серверов репликации MySQL. URI следует за синтаксисом hostname[:port|unix_domain_socket].

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

Установка ведомого сервера обязательна. Плагин сообщит, что предупреждение на соединяется, если пользователь был не в состоянии обеспечить по крайней мере один ведомый сервер для раздела конфигурации. Предупреждение может читать (mysqlnd_ms) Cannot find slaves section in config. Кроме того плагин может установить код ошибки для дескриптора соединения такой как HY000/2000 (CR_UNKNOWN_ERROR). Соответствующее сообщение об ошибке зависит от Ваших настроек языка.

Выравнивание нагрузки (выбор сервера) политика. Поддерживаемые политики: random, random_once (значение по умолчанию), roundrobin, user.

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

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

Используя roundrobin плагин выполняет итерации по списку сконфигурированных ведомых серверов, чтобы выбрать сервер для выполнения оператора. Если плагин достигает конца списка, это повторяется к началу списка и выбирает первый сконфигурированный ведомый сервер.

Установка больше чем одной политики выравнивания нагрузки для раздела конфигурации имеет только смысл в соединении с user и mysqlnd_ms_set_user_pick_server. Если определяемый пользователем обратный вызов не в состоянии выбрать сервер, плагин отступает к второй сконфигурированной политике выравнивания нагрузки.

Политика Failover. Поддерживаемые политики: disabled (значение по умолчанию), master.

Если никакая failover политика не будет установлена, то плагин не будет делать никакого автоматического failover (failover=disabled). Всякий раз, когда плагин не в состоянии соединить сервер, он испустит предупреждение и установит код ошибки соединений и сообщение. После того это до приложения, чтобы обработать ошибку и, например, снова послало последний оператор, чтобы инициировать выбор другого сервера.

Используя failover=master плагин будет неявно failover к ведомому устройству при наличии. Пожалуйста, проверьте документацию понятий, чтобы узнать о потенциальных ловушках и рисках использования failover=master.

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

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

Ленивые соединения, пустые риск, если Вы делаете интенсивное использование из действий, которые изменяют состояние соединения. Плагин не диспетчеризирует все действия изменения состояния всем соединениям от пула соединения. Немногим диспетчеризированным действиям уже применяются к открытые соединения только. На ленивые соединения, открытые в будущем, не влияют. Если, например, набор символов соединения будет изменен, используя вызов API MySQL PHP, то плагин изменит набор символов всего в настоящий момент открытого соединения. Это не будет помнить, что набор символов изменяется, чтобы применить это на ленивых соединениях, открытых в будущем. В результате внутренний пул соединения содержал бы соединения, используя различные наборы символов. Это не требуется. Помните, что наборы символов принимаются во внимание для того, чтобы выйти.

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

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

Политика неподвижности транзакции. Поддерживаемые политики: disabled (значение по умолчанию), master.

Экспериментальная функция.

Установка требует 5.4.0 или более новый. Если использующийся с PHP, более старым чем 5.4.0, плагин испустит предупреждение как (mysqlnd_ms) trx_stickiness strategy is not supported before PHP 5.3.99.

Если никакая политика неподвижности транзакции не устанавливается или, устанавливая trx_stickiness=disabled, плагин не является знающей транзакцией. Таким образом плагин может загрузить соединения баланса и переключить соединения в середине транзакции. Плагин не является безопасной транзакцией. Подсказки SQL должны использоваться, избегают переключателей соединения во время транзакции.

С PHP 5.4.0 mysqlnd библиотека позволяет плагину контролировать autocommit режим, установленный звонками в библиотеки trx_autocommit() функция. Устанавливая trx_stickiness=master и autocommit отключается расширением MySQL PHP, вызывающим mysqlnd библиотека внутренний вызов функции trx_autocommit(), плагин делается знающий о начинании транзакции. Затем, плагин останавливает выравнивание нагрузки и не направляет все операторы к главному серверу до autocommit включается. Таким образом никакие подсказки SQL не требуются.

Пример API-функции MySQL PHP, вызывая mysqlnd библиотека внутренний вызов функции trx_autocommit() mysqli_autocommit.

Хотя устанавливая trx_stickiness=master, плагин не может быть сделан знающий autocommit изменения режима, вызванные SQL-операторами такой как SET AUTOCOMMIT=0.