Модуль community.proxysql.proxysql_pgsql_query_rules_fast_routing — изменяет правила запросов для политик быстрой маршрутизации с помощью интерфейса администрирования proxysql

Примечание

Этот модуль входит в коллекцию community.proxysql (версия 1.8.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.proxysql. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: community.proxysql.proxysql_pgsql_query_rules_fast_routing.

Добавлено в community.proxysql 1.8.0

Краткое описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Модуль community.proxysql.proxysql_pgsql_query_rules_fast_routing изменяет правила запросов для политик быстрой маршрутизации и атрибуты с помощью интерфейса администрирования proxysql.

Требования

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

PyMySQL
mysqlclient

Параметры

Параметр	Комментарии
comment string	Поле свободного формата для описательного комментария к правилу запроса. По умолчанию: `""`
config_file path	Указывает файл конфигурации, из которого следует считывать login_user и login_password. По умолчанию: `""`
database string / обязательный	Критерий фильтрации по базе данных: запрос будет соответствовать правилу, только если соединение использует эту базу данных в качестве базы данных по умолчанию.
destination_hostgroup integer / обязательный	Перенаправляет соответствующие запросы в эту группу хостов. Это происходит, если только не начата транзакция и для вошедшего в систему пользователя не задано значение `True` для параметра transaction_persistent (см. community.proxysql.proxysql_pgsql_users).
flagIN integer	Обрабатывается так же, как flagIN в pgsql_query_rules, и соответствует указанным в таблице pgsql_query_rules значениям flagOUT/apply (см. community.proxysql.proxysql_pgsql_query_rules). По умолчанию: `0`
force_delete boolean	По умолчанию за один пакет мы удаляем не более одного правила запроса. Однако, если вам нужно изменить это поведение и вас не беспокоит, какие именно правила запросов будут удалены, задайте для force_delete значение `True`. Варианты: `false` ← (по умолчанию) `true`
load_to_runtime boolean	Динамически загружает конфигурацию в память среды выполнения. Варианты: `false` `true` ← (по умолчанию)
login_host string	Узел, используемый для подключения к интерфейсу администрирования ProxySQL. По умолчанию: `"127.0.0.1"`
login_password string	Пароль для аутентификации в интерфейсе администрирования ProxySQL.
login_port integer	Порт, используемый для подключения к интерфейсу администрирования ProxySQL. По умолчанию: `6032`
login_unix_socket string	Сокет, используемый для подключения к интерфейсу администрирования ProxySQL.
login_user string	Имя пользователя для аутентификации в интерфейсе администрирования ProxySQL.
save_to_disk boolean	Сохраняет конфигурацию в базу данных sqlite на диске, чтобы обеспечить ее сохранность. Варианты: `false` `true` ← (по умолчанию)
state string	Если задано значение `present`, добавляет правило. Если задано значение `absent`, удаляет правило. Варианты: `"present"` ← (по умолчанию) `"absent"`
username string / обязательный	Критерий фильтрации по имени пользователя: запрос будет соответствовать правилу, только если соединение установлено с правильным именем пользователя.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Не вносить изменения в память, на диск или в среду выполнения.

Примеры

---
# This example adds a rule for fast routing
- name: Add a rule
  community.proxysql.proxysql_pgsql_query_rules_fast_routing:
    login_user: admin
    login_password: admin
    username: 'user_ro'
    database: 'default'
    destination_hostgroup: 1
    comment: 'fast route user_ro to default database to hostgroup 1'
    state: present
    save_to_disk: true
    load_to_runtime: true

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
stdout dictionary	Пользователь pgsql, измененный или удаленный из proxysql. Возвращается: При создании или обновлении возвращается измененное правило; во всех остальных случаях возвращается список правил, соответствующих указанным критериям. Пример: `{"changed": true, "msg": "Added rule to pgsql_query_rules_fast_routing", "rules": [{"comment": "", "database": "default", "destination_hostgroup": 1, "flagIN": "0", "username": "user_ro"}], "state": "present"}`

Ключ

Описание

stdout

dictionary

Пользователь pgsql, измененный или удаленный из proxysql.

Возвращается: При создании или обновлении возвращается измененное правило; во всех остальных случаях возвращается список правил, соответствующих указанным критериям.

Пример: {"changed": true, "msg": "Added rule to pgsql_query_rules_fast_routing", "rules": [{"comment": "", "database": "default", "destination_hostgroup": 1, "flagIN": "0", "username": "user_ro"}], "state": "present"}

Авторы

Janos Ruszo (@jruszo)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/proxysql/proxysql_pgsql_query_rules_fast_routing_module.html