Есть много внутренних структур в пределах элемента сценариев MySQL Proxy. Основная структура proxy и это обеспечивает интерфейс для многих общих структур, используемых всюду по сценарию, таких как списки соединения и сконфигурированные серверы бэкэнда. Другие структуры, такие как входящий пакет от клиента и наборов результатов только доступны в пределах контекста одной из функций scriptable.

Следующая таблица описывает общие атрибуты MySQL proxy сценарии элемента.

proxy.connection

proxy.connection объект только для чтения, и предоставляет информацию о текущем соединении, и разделяется на a client и server таблицы. Это позволяет Вам исследовать информацию об обоих входящие клиентские соединения с прокси (client), и к серверам бэкэнда (server).

Следующая таблица описывает атрибуты клиента и сервера proxy.connection объект.

proxy.global.backends

proxy.global.backends таблица частично перезаписываема и содержит массив всех сконфигурированных серверов бэкэнда и метаданных сервера (IP-адрес, состояние, и т.д.). Можно решить, что массив индексирует текущего использования соединения proxy.connection["backend_ndx"] который является индексированием в эту таблицу сервера бэкэнда, используемого активным соединением.

Атрибуты для каждой записи в пределах proxy.global.backends таблицу показывают в следующей таблице.

proxy.queries

proxy.queries объект является очередью, представляющей список запросов, которые будут отправлены серверу. Очередь не заполняется автоматически, но если Вы явно не заполняете очередь, запросы передаются серверу бэкэнда дословно. Кроме того, если Вы не заполняете очередь запроса вручную, read_query_result() функция не инициирована.

Следующие функции поддерживаются для того, чтобы заполнить proxy.queries объект.

Например, Вы могли добавить пакет запроса к proxy.queries очередь при использовании append():

proxy.queries:append(1,packet)

Дополнительный третий параметр append() должен содержать опции для пакета. Иметь доступ к набору результатов через read_query_result() функция, набор resultset_is_needed флаг к true:

proxy.queries:append( 1, packet, { resultset_is_needed = true } )

Если тот флаг false (значение по умолчанию), прокси будет:

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

Чтобы выполнить любой вид манипулирования на возвращенных данных, следует установить флаг в true, который будет:

proxy.response

proxy.response структура используется, когда Вы хотите возвратить свой собственный ответ MySQL, вместо того, чтобы передать пакет, что Вы получили сервер бэкэнда. Структура содержит информацию о типе ответа, дополнительное сообщение об ошибке, и набор результатов (строки/столбцы), чтобы возвратиться.

Следующая таблица описывает атрибуты proxy.response структура.

При использовании proxy.response Вы любой набор proxy.response.type к proxy.MYSQLD_PACKET_OK и затем создайте resultset содержать результаты возвратить, или установить proxy.response.type к proxy.MYSQLD_PACKET_ERR и набор proxy.response.errmsg к строке с сообщением об ошибке. Чтобы отправить завершенный набор результатов или сообщение об ошибке, следует возвратиться proxy.PROXY_SEND_RESULT инициировать возврат информации о пакете.

Пример этого может быть замечен в tutorial-resultset.lua сценарий в пределах пакета MySQL Proxy:

if string.lower(command) == "show" and string.lower(option) == "querycounter" then        ---        -- proxy.PROXY_SEND_RESULT requires        --        -- proxy.response.type to be either        -- * proxy.MYSQLD_PACKET_OK or        -- * proxy.MYSQLD_PACKET_ERR        --        -- for proxy.MYSQLD_PACKET_OK you need a resultset        -- * fields        -- * rows        --        -- for proxy.MYSQLD_PACKET_ERR        -- * errmsg        proxy.response.type = proxy.MYSQLD_PACKET_OK        proxy.response.resultset = {                fields = {                        { type = proxy.MYSQL_TYPE_LONG, name = "global_query_counter", },                        { type = proxy.MYSQL_TYPE_LONG, name = "query_counter", },                },                rows = {                        { proxy.global.query_counter, query_counter }                }        }        -- we have our result, send it back        return proxy.PROXY_SEND_RESULTelseif string.lower(command) == "show" and string.lower(option) == "myerror" then        proxy.response.type = proxy.MYSQLD_PACKET_ERR        proxy.response.errmsg = "my first error"        return proxy.PROXY_SEND_RESULT

proxy.response.resultset

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

Следующая таблица описывает атрибуты proxy.response.resultset структура.

Для примера, показывающего, как использовать эту структуру, см. proxy.response.

Константы государства Возврата прокси

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

Как константы, эти объекты доступны без квалификации в сценариях Lua. Например, в конце read_query_result() Вы могли бы возвратиться PROXY_IGNORE_RESULT:

return proxy.PROXY_IGNORE_RESULT

Пакетные Константы государства

Следующие состояния описывают состояние сетевого пакета. Эти элементы являются записями в пределах основного proxy таблица.

Константы государства/Типа бэкэнда

Следующие константы используются или чтобы определить состояние или тип сервера MySQL бэкэнда, с которым соединяется прокси. Эти элементы являются записями в пределах основного proxy таблица.

Константы Команды сервера

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

MySQL Type Constants

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