proxysql_query_rules – Модифицирует правила запросов с помощью интерфейса администрирования proxysql
Описание
- Модуль proxysql_query_rules модифицирует правила запросов с помощью интерфейса администрирования proxysql.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- PyMySQL (Python 2.7 и Python 3.X), или
- MySQLdb (Python 2.x)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| active boolean |
| Правило с active, установленным в False, будет отслеживаться в базе данных, но никогда не загружаться в структуры данных в памяти. |
| apply boolean |
| Используется в сочетании с flagIN и flagOUT для создания цепочек правил. Установка apply в True означает последнее применяемое правило. |
| cache_ttl - | Количество миллисекунд, в течение которых результаты запроса будут кэшироваться. Обратите внимание, что в ProxySQL 1.1 cache_ttl измерялось в секундах. | |
| client_addr - | Сопоставление трафика из определенного источника. | |
| comment - | Поле для свободного текста, используемое для описательного комментария к правилу запроса. | |
| config_file path | Значение по умолчанию: "" | Укажите файл конфигурации, из которого будут считываться login_user и login_password. |
| delay - | Количество миллисекунд задержки выполнения запроса. Это, по сути, механизм ограничения скорости и качества обслуживания (QoS), позволяющий назначать приоритет запросам по сравнению с другими. Это значение добавляется к глобальной переменной mysql-default_query_delay, которая применяется ко всем запросам. | |
| destination_hostgroup - | Направлять сопоставленные запросы в этот хостгруппу. Это происходит, если нет запущенной транзакции и у вошедшего пользователя установлено transaction_persistent в значение True (см. proxysql_mysql_users). | |
| digest - | Сопоставление запросов со специфическим дайджестом, как возвращается stats_mysql_query_digest.digest. | |
| error_msg - | Запрос будет заблокирован, и указанное error_msg будет возвращено клиенту. | |
| flagIN - | Используется в сочетании с flagOUT и apply для создания цепочек правил. | |
| flagOUT - | Используется в сочетании с flagIN и apply для создания цепочек правил. При установке, flagOUT указывает flagIN, который следует использовать в следующей цепочке правил. | |
| force_delete boolean |
| По умолчанию мы избегаем удаления более одного расписания в одной группе, однако, если вам требуется это поведение и вы не беспокоитесь о удалённых расписаниях, вы можете установить force_delete в значение True. |
| load_to_runtime boolean |
| Динамически загрузить конфигурацию в оперативную память. |
| log boolean |
| Запрос будет записан в журнал. |
| login_host string | Значение по умолчанию: "127.0.0.1" | Хост, используемый для подключения к интерфейсу администрирования ProxySQL. |
| login_password string | Пароль, используемый для аутентификации в интерфейсе администрирования ProxySQL. | |
| login_port integer | Значение по умолчанию: 6032 | Порт, используемый для подключения к интерфейсу администрирования ProxySQL. |
| login_user string | Имя пользователя, используемое для аутентификации в интерфейсе администрирования ProxySQL. | |
| match_digest - | Регулярное выражение, которое соответствует дайджесту запроса. Используемый диалект регулярных выражений — re2 — https://github.com/google/re2 | |
| match_pattern - | Регулярное выражение, которое соответствует тексту запроса. Используемый диалект регулярных выражений — re2 — https://github.com/google/re2 | |
| mirror_flagOUT - | Включает зеркалирование запросов. При установке mirror_flagOUT может использоваться для оценки зеркального запроса по заданной цепочке правил. | |
| mirror_hostgroup - | Включает зеркалирование запросов. При установке mirror_hostgroup может использоваться для зеркалирования запросов в ту же или другую хостгруппу. | |
| negate_match_pattern boolean |
| Если negate_match_pattern установлено в значение True, только запросы, не соответствующие тексту запроса, будут рассматриваться как совпадения. Это действует как оператор NOT перед регулярным выражением, сопоставляющим match_pattern. |
| proxy_addr - | Сопоставление входящего трафика по определенному локальному IP-адресу. | |
| proxy_port - | Сопоставление входящего трафика по определенному локальному порту. | |
| replace_pattern - | Это шаблон, который следует заменить на совпадающий шаблон. Обратите внимание, что это необязательно, и при его отсутствии процессор запросов будет только кэшировать, маршрутизировать или устанавливать другие параметры без переписывания. | |
| retries - | Максимальное количество попыток повторного выполнения запроса в случае обнаружения сбоя во время выполнения запроса. Если retries не указан, применяется глобальная переменная mysql-query_retries_on_failure. | |
| rule_id - | Уникальный идентификатор правила. Правила обрабатываются в порядке rule_id. | |
| save_to_disk boolean |
| Сохранить конфигурацию в базу данных SQLite на диске для сохранения конфигурации. |
| schemaname - | Критерии фильтрации, соответствующие schemaname. Если schemaname не NULL, запрос будет соответствовать только в том случае, если подключение использует schemaname в качестве своего схемы по умолчанию. | |
| state - |
| При present - добавляет правило, при absent - удаляет правило. |
| timeout - | Максимальная задержка в миллисекундах, с которой сопоставленный или переписанный запрос должен быть выполнен. Если запрос выполняется дольше, чем указанный порог, запрос автоматически прерывается. Если timeout не указан, применяется глобальная переменная mysql-default_query_timeout. | |
| username - | Критерии фильтрации, соответствующие username. Если username не NULL, запрос будет соответствовать только если подключение выполнено с правильным именем пользователя. |
Примеры
---
# This example adds a rule to redirect queries from a specific user to another
# hostgroup, it saves the mysql query rule config to disk, but avoids loading
# the mysql query config config to runtime (this might be because several
# rules are being added and the user wants to push the config to runtime in a
# single batch using the M(proxysql_manage_config) module). It uses supplied
# credentials to connect to the proxysql admin interface.
- proxysql_query_rules:
login_user: admin
login_password: admin
username: 'guest_ro'
match_pattern: "^SELECT.*"
destination_hostgroup: 1
active: 1
retries: 3
state: present
load_to_runtime: False
# This example removes all rules that use the username 'guest_ro', saves the
# mysql query rule config to disk, and dynamically loads the mysql query rule
# config to runtime. It uses credentials in a supplied config file to connect
# to the proxysql admin interface.
- proxysql_query_rules:
config_file: '~/proxysql.cnf'
username: 'guest_ro'
state: absent
force_delete: true
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| stdout словарь | При создании/обновлении возвращает изменённое правило, в остальных случаях — список правил, соответствующих заданным критериям. | Информация о пользователе mysql, изменённом или удалённом из proxysql Пример: {'changed': True, 'msg': 'Добавление правила в mysql_query_rules', 'rules': [{'active': '0', 'apply': '0', 'cache_ttl': None, 'client_addr': None, 'comment': None, 'delay': None, 'destination_hostgroup': 1, 'digest': None, 'error_msg': None, 'flagIN': '0', 'flagOUT': None, 'log': None, 'match_digest': None, 'match_pattern': None, 'mirror_flagOUT': None, 'mirror_hostgroup': None, 'negate_match_pattern': '0', 'proxy_addr': None, 'proxy_port': None, 'reconnect': None, 'replace_pattern': None, 'retries': None, 'rule_id': '1', 'schemaname': None, 'timeout': None, 'username': 'guest_ro'}], 'state': 'present'} |
Статус
- В дальнейшем изменения интерфейса модуля будут гарантированно совместимы с предыдущими версиями. [stableinterface]
- Данный модуль поддерживается сообществом Ansible. [community]
Авторы
- Ben Mildren (@bmildren)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/proxysql_query_rules_module.html