|
Spec-Zone .ru
спецификации, руководства, описания, API
|
Чтобы запустить MySQL Proxy, можно выполнить это непосредственно из командной строки:
shell> mysql-proxy
Для большинства ситуаций Вы определяете, по крайней мере, имя хоста или адрес и номер порта сервера MySQL бэкэнда, к которому MySQL Proxy должен передать запросы.
Можно определить опции, чтобы mysql-проксировать или на командной строке, или при
использовании конфигурационного файла и --defaults-file параметр командной строки, чтобы определить расположение
файла.
Если Вы используете конфигурационный файл, форматируете его следующим образом:
Определите опции в пределах a [mysql-proxy] группа
конфигурации. Например:
[mysql-proxy]admin-address =host:port
Определите все параметры конфигурации в форме имени конфигурации и значения, чтобы установить.
Для опций, которые являются простым переключателем на командной строке (например,
--proxy-skip-profiling),
используйте true или false. Например,
следующее недопустимо:
[mysql-proxy]proxy-skip-profiling
Но это допустимо:
[mysql-proxy]proxy-skip-profiling = true
Дайте полномочия Unix конфигурационного файла 0660
(читаемый и перезаписываемый пользователем и группой, никаким доступом для других).
Отказ придерживаться любого из этих требований заставляет mysql-прокси генерировать ошибку во время запуска.
Следующие таблицы приводят поддерживаемый конфигурационный файл и параметры командной строки.
Таблица 15.4. mysql-проксируйте Опции Справки
| Формат | Файл опции | Описание |
|---|---|---|
| - справка | Покажите варианты справки | |
| - администратор справки | Покажите администраторские варианты модуля | |
| - справка - все | Покажите все варианты справки | |
| - прокси справки | Покажите варианты модуля прокси |
Таблица 15.5. mysql-прокси AdminOptions
| Формат | Файл опции | Описание |
|---|---|---|
| - admin-address=host:port | admin-address=host:port | Администраторский модуль, слушая узел и порт |
| - admin-lua-script=file_name | admin-lua-script=file_name | Сценарий, чтобы выполниться администраторским модулем |
| - admin-password=password | admin-password=password | Пароль аутентификации для администраторского модуля |
| - admin-username=user_name | admin-username=user_name | Имя пользователя аутентификации для администраторского модуля |
| - proxy-address=host:port | proxy-address=host:port | Узел прокси-сервера слушания и порт |
Таблица 15.6. mysql-прокси ProxyOptions
| Формат | Файл опции | Описание | Удаленный |
|---|---|---|---|
| - без прокси | без прокси | Не запускайте модуль прокси | |
| - proxy-backend-addresses=host:port | proxy-backend-addresses=host:port | Узел сервера MySQL и порт | |
| - proxy-fix-bug-25371 | proxy-fix-bug-25371 | Включите фиксации для Ошибки #25371 для более старых libmysql версий | 0.8.1 |
| - proxy-lua-script=file_name | proxy-lua-script=file_name | Имя файла для сценария Lua для операций прокси | |
| - "прокси не объединяет пользователя изменения в пул" | "прокси не объединяет пользователя изменения в пул" | Не используйте протокол команда CHANGE_USER, чтобы сбросить соединение, происходя из пула соединения | |
| --proxy-read-only-backend-addresses=host:port | proxy-read-only-backend-addresses=host:port | Узел сервера MySQL и порт (только для чтения) | |
| - профилирование пропуска прокси | профилирование пропуска прокси | Отключите профилирование запроса |
Таблица 15.7. mysql-прокси ApplicationsOptions
| Формат | Файл опции | Описание |
|---|---|---|
| - basedir=dir_name | basedir=dir_name | Основной каталог снабжает префиксом для путей в конфигурации |
| - демон | демон | Запустите в режиме демона |
| - defaults-file=file_name | Конфигурационный файл, чтобы использовать | |
| - event-threads=count | event-threads=count | Число потоков обработки событий |
| - keepalive | keepalive | Попытайтесь перезапустить прокси, если катастрофический отказ происходит |
| - "зарегистрируйте след на катастрофическом отказе" | "зарегистрируйте след на катастрофическом отказе" | Попытайтесь вызвать отладчик и генерировать след на катастрофическом отказе |
| - log-file=file_name | log-file=file_name | Файл, где сообщения об ошибках регистрируются |
| - log-level=level | log-level=level | Уровень журналирования |
| - log-use-syslog | log-use-syslog | Ошибки журнала к syslog |
| - lua-cpath=dir_name | lua-cpath=dir_name | Установите LUA_CPATH |
| - lua-path=dir_name | lua-path=dir_name | Установите LUA_PATH |
| - max-open-files=count | max-open-files=count | Максимальное количество открытых файлов, чтобы поддерживать |
| - pid-file=file_name | pid-file=file_name | Файл, в котором можно сохранить ID процесса |
| - plugin-dir=dir_name | plugin-dir=dir_name | Каталог, содержащий сменные файлы |
| - plugins=plugin... | plugins=plugin... | Список плагинов, чтобы загрузиться |
| - user=user_name | user=user_name | Пользователь, чтобы использовать, выполняя mysql-прокси |
| - версия | Покажите информацию о версии |
За исключением отмеченного в следующих деталях, все опции могут использоваться в пределах конфигурационного файла, предоставляя опцию и соответствующее значение. Например:
[mysql-proxy]log-file = /var/log/mysql-proxy.loglog-level = message
--help, -h
| Формат командной строки | --help |
||
-h |
|||
Покажите доступные варианты справки.
| Формат командной строки | --help-admin |
||
Покажите варианты для администраторского модуля.
| Формат командной строки | --help-all |
||
Покажите все варианты справки.
| Формат командной строки | --help-proxy |
||
Покажите варианты для модуля прокси.
| Формат командной строки | --admin-address=host:port |
||
| Формат файла опции | admin-address=host:port |
||
| Разрешенные Значения | |||
| Ввести | string |
||
| Значение по умолчанию | :4041 |
||
Имя хоста (или IP-адрес) и порт для порта администрирования. Значение по умолчанию localhost:4041.
| Формат командной строки | --admin-lua-script=file_name |
||
| Формат файла опции | admin-lua-script=file_name |
||
| Разрешенные Значения | |||
| Ввести | file name |
||
| Значение по умолчанию | |
||
Сценарий, чтобы использовать для модуля администрирования прокси.
| Формат командной строки | --admin-password=password |
||
| Формат файла опции | admin-password=password |
||
| Разрешенные Значения | |||
| Ввести | string |
||
| Значение по умолчанию | |
||
Пароль, чтобы использовать, чтобы аутентифицировать пользователей, желающих соединяться с модулем администрирования MySQL Proxy. Этот модуль использует протокол MySQL, чтобы запросить имя пользователя и пароль для соединений.
| Формат командной строки | --admin-username=user_name |
||
| Формат файла опции | admin-username=user_name |
||
| Разрешенные Значения | |||
| Ввести | string |
||
| Значение по умолчанию | root |
||
Имя пользователя, чтобы использовать, чтобы аутентифицировать пользователей, желающих соединяться с
модулем администрирования MySQL Proxy. Этот модуль использует протокол MySQL, чтобы запросить имя
пользователя и пароль для соединений. Имя пользователя значения по умолчанию root.
| Формат командной строки | --basedir=dir_name |
||
| Формат файла опции | basedir=dir_name |
||
| Разрешенные Значения | |||
| Ввести | directory name |
||
Основной каталог, чтобы использовать в качестве префикса для всех других параметров конфигурации имени файла. Базовое имя должно быть абсолютом (не родственник) каталог. Если Вы определяете относительный каталог, mysql-прокси генерирует ошибку во время запуска.
| Формат командной строки | --daemon |
||
| Формат файла опции | daemon |
||
Запускает прокси в режиме демона.
| Формат командной строки | --defaults-file=file_name |
||
Файл, чтобы читать для параметров конфигурации. Если не определенный, MySQL Proxy берет опции только из командной строки.
| Формат командной строки | --event-threads=count |
||
| Формат файла опции | event-threads=count |
||
| Разрешенные Значения | |||
| Ввести | numeric |
||
| Значение по умолчанию | 1 |
||
Число события распараллеливает, чтобы зарезервировать, чтобы обработать входящие запросы.
| Формат командной строки | --keepalive |
||
| Формат файла опции | keepalive |
||
Создайте процесс, окружающий основной процесс mysql-прокси, который пытается перезапустить основной процесс mysql-прокси в случае катастрофического отказа или другого отказа.
--keepalive опция не доступна на Microsoft Windows. Работая как
сервис, mysql-прокси автоматически перезапускает.
| Формат командной строки | --log-backtrace-on-crash |
||
| Формат файла опции | log-backtrace-on-crash |
||
Зарегистрируйте след к журналу ошибок и попытайтесь инициализировать отладчик в случае отказа.
| Формат командной строки | --log-file=file_name |
||
| Формат файла опции | log-file=file_name |
||
| Разрешенные Значения | |||
| Ввести | file name |
||
Файл, чтобы использовать, чтобы записать информацию о журнале. Если эта опция не дается, журналы mysql-прокси к стандартному выводу ошибок.
| Формат командной строки | --log-level=level |
||
| Формат файла опции | log-level=level |
||
| Разрешенные Значения | |||
| Ввести | enumeration |
||
| Допустимые Значения | error |
||
warning |
|||
info |
|||
message |
|||
debug |
|||
Уровень журнала, чтобы использовать, выводя сообщения об ошибках. Сообщения с тем уровнем (или ниже)
выводятся. Например, message уровень также выводы обменивается
сообщениями с info, warning, и error уровни.
| Формат командной строки | --log-use-syslog |
||
| Формат файла опции | log-use-syslog |
||
Ошибки журнала к syslog (Unix/Linux только).
| Формат командной строки | --lua-cpath=dir_name |
||
| Формат файла опции | lua-cpath=dir_name |
||
| Разрешенные Значения | |||
| Ввести | directory name |
||
LUA_CPATH использовать когда загрузка скомпилированные модули или
библиотеки для сценариев Lua.
| Формат командной строки | --lua-path=dir_name |
||
| Формат файла опции | lua-path=dir_name |
||
| Разрешенные Значения | |||
| Ввести | directory name |
||
LUA_CPATH использовать, загружая модули для Lua.
| Формат командной строки | --max-open-files=count |
||
| Формат файла опции | max-open-files=count |
||
| Разрешенные Значения | |||
| Ввести | numeric |
||
Максимальное количество открытых файлов и сокетов поддерживается процессом mysql-прокси. Определенные сценарии могли бы потребовать более высокого значения.
| Формат командной строки | --no-proxy |
||
| Формат файла опции | no-proxy |
||
Отключите модуль прокси.
| Формат командной строки | --plugin-dir=dir_name |
||
| Формат файла опции | plugin-dir=dir_name |
||
| Разрешенные Значения | |||
| Ввести | directory name |
||
Каталог, чтобы использовать, загружая плагины для mysql-прокси.
| Формат командной строки | --plugins=plugin,... |
||
| Формат файла опции | plugins=plugin,... |
||
| Разрешенные Значения | |||
| Ввести | string |
||
Загружает плагин.
При использовании этой опции на командной строке можно определить опцию многократно, чтобы определить многократные плагины. Например:
shell> mysql-proxy --plugins=proxy
--plugins=admin
При использовании опции в пределах конфигурационного файла следует разделить многократные плагины запятыми. Эквивалент предыдущего примера был бы:
...plugins=proxy,admin
--proxy-address=, host:port-P host:port
| Формат командной строки | --proxy-address=host:port |
||
-P host:port |
|||
| Формат файла опции | proxy-address=host:port |
||
| Разрешенные Значения | |||
| Ввести | string |
||
| Значение по умолчанию | :4040 |
||
Имя хоста слушания (или IP-адрес) и порт прокси-сервера. Значение по умолчанию :4040 (все IP на порту 4040).
--proxy-read-only-backend-addresses=,
host:port-r
host:port
| Формат командной строки | --proxy-read-only-backend-addresses=host:port
|
||
-r host:port |
|||
| Формат файла опции | proxy-read-only-backend-addresses=host:port
|
||
| Разрешенные Значения | |||
| Ввести | string |
||
Имя хоста слушания (или IP-адрес) и порт прокси-сервера для соединений только для чтения. Значение по умолчанию для этой информации, которая не будет установлена.
Установка этого значения только конфигурирует серверы в пределах соответствующей
внутренней структуры (см. proxy.global.backends). Можно определить тип бэкэнда,
проверяя type поле для каждого соединения.
Следует поэтому только использовать эту опцию в комбинации со сценарием, разработанным, чтобы использовать различные типы бэкэнда.
При использовании этой опции на командной строке можно определить опцию и сервер многократно, чтобы определить многократные бэкэнды. Например:
shell> mysql-proxy
--proxy-read-only-backend-addresses=192.168.0.1:3306
--proxy-read-only-backend-addresses=192.168.0.2:3306
При использовании опции в пределах конфигурационного файла следует разделить многократные серверы запятыми. Эквивалент предыдущего примера был бы:
...proxy-read-only-backend-addresses = 192.168.0.1:3306,192.168.0.2:3306
--proxy-backend-addresses=, host:port-b host:port
| Формат командной строки | --proxy-backend-addresses=host:port |
||
-b host:port |
|||
| Формат файла опции | proxy-backend-addresses=host:port |
||
| Разрешенные Значения | |||
| Ввести | string |
||
| Значение по умолчанию | 127.0.0.1:3306 |
||
Имя хоста (или IP-адрес) и порт сервера MySQL, чтобы соединиться с. Можно определить многократные серверы бэкэнда, предоставляя многократные опции. Клиенты соединяются с каждым сервером бэкэнда круговым способом. Например, если Вы определите два сервера A и B, то первое клиентское соединение пойдет в сервер A; второе клиентское соединение с сервером B и третье клиентское соединение с сервером A.
При использовании этой опции на командной строке можно определить опцию и сервер многократно, чтобы определить многократные бэкэнды. Например:
shell> mysql-proxy
--proxy-backend-addresses 192.168.0.1:3306 --proxy-backend-addresses
192.168.0.2:3306
При использовании опции в пределах конфигурационного файла следует разделить многократные серверы запятыми. Эквивалент предыдущего примера был бы:
...proxy-backend-addresses = 192.168.0.1:3306,192.168.0.2:3306
| Формат командной строки | --proxy-pool-no-change-user |
||
| Формат файла опции | proxy-pool-no-change-user |
||
Отключите использование протокола MySQL CHANGE_USER команда, снова
используя соединение от пула соединений, определенных proxy-backend-addresses список.
| Формат командной строки | --proxy-skip-profiling |
||
| Формат файла опции | proxy-skip-profiling |
||
Отключите профилирование запроса (время статистики, отслеживая). Значение по умолчанию для того, чтобы отследить, чтобы быть включенным.
| Удаленный | 0.8.1 | ||
| Формат командной строки | --proxy-fix-bug-25371 |
||
| Формат файла опции | proxy-fix-bug-25371 |
||
Включите обходному решению для проблемы, соединяясь с сервером MySQL позже чем 5.1.12 при использовании клиентской библиотеки MySQL любой более ранней версии.
Эта опция была удалена в mysql-прокси 0.8.1. Теперь, mysql-прокси возвращает сообщение об ошибке на
уровне протокола, если это видит a COM_CHANGE_USER будучи отправленным
серверу, у которого есть версия от 5.1.14 до 5.1.17.
--proxy-lua-script=,
file_name-s file_name
| Формат командной строки | --proxy-lua-script=file_name |
||
-s file_name |
|||
| Формат файла опции | proxy-lua-script=file_name |
||
| Разрешенные Значения | |||
| Ввести | file name |
||
Файл сценария Lua, который будет загружен. Отметьте, что файл сценария физически не загружается и анализируется, пока соединение не делается. Также отметьте, что указанный сценарий Lua перезагружается для каждого соединения; если контент сценария Lua изменяется, в то время как mysql-прокси работает, обновленный контент автоматически используется, когда новое соединение делается.
| Формат командной строки | --pid-file=file_name |
||
| Формат файла опции | pid-file=file_name |
||
| Разрешенные Значения | |||
| Ввести | file name |
||
Имя файла, в котором можно сохранить ID процесса.
| Формат командной строки | --user=user_name |
||
| Формат файла опции | user=user_name |
||
| Разрешенные Значения | |||
| Ввести | string |
||
Выполненный mysql-прокси как указанное user.
--version, -V
| Формат командной строки | --version |
||
-V |
|||
Покажите номер версии.
Наиболее распространенное использование как простая служба прокси (то есть, без дополнительных сценариев). Для
основной работы прокси следует определить по крайней мере один proxy-backend-addresses опция, чтобы определить сервер MySQL, чтобы соединиться с
по умолчанию:
shell> mysql-proxy
--proxy-backend-addresses=MySQL.example.com:3306
Порт прокси значения по умолчанию 4040, таким образом, можно соединиться со своим
сервером MySQL через прокси, определяя детали порта и имя хоста:
shell> mysql --host=localhost
--port=4040
Если Ваш сервер запросит информацию аутентификации, то через это пройдет исходно без изменения mysql-прокси, таким образом, следует также определить запрошенную информацию аутентификации:
shell>mysql --host=localhost --port=4040 \--user=user_name --password=password
Можно также соединиться с портом только для чтения (который отфильтровывает UPDATE и INSERT
запросы), соединяясь с портом только для чтения. По умолчанию имя хоста является значением по умолчанию, и порт
4042, но можно изменить информацию об узле/порте при использовании --proxy-read-only-backend-addresses параметр командной строки.
Для более подробной информации о том, как использовать эти параметры командной строки, и mysql-прокси вообще в комбинации со сценариями Lua, см. Раздел 15.7.5, "Используя MySQL Proxy".