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".