community.proxysql.proxysql_query_rules_fast_routing 模块 – 使用 proxysql 管理界面修改快速路由策略的查询规则

注意

此模块是 community.proxysql 集合（版本 1.6.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。 它不包含在 ansible-core 中。 要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.proxysql。 您需要进一步的要求才能使用此模块，有关详细信息，请参阅 要求。

要在 playbook 中使用它，请指定：community.proxysql.proxysql_query_rules_fast_routing。

community.proxysql 1.1.0 中的新增功能

概要

要求

执行此模块的主机需要以下要求。

  • PyMySQL

  • mysqlclient

参数

参数

注释

comment

string

自由格式文本字段，可用于查询规则的描述性注释。

默认值： ""

config_file

path

指定一个配置文件，从中读取 login_user 和 login_password。

默认值： ""

destination_hostgroup

integer / 必需

将匹配的查询路由到此主机组。 除非存在已启动的事务且登录用户将 transaction_persistent 设置为 True（请参阅 community.proxysql.proxysql_mysql_users），否则会发生这种情况。

flagIN

integer

以与 mysql_query_rules 中 flagIN 相同的方式进行评估，并与 mysql_query_rules 表中指定的 flagOUT/apply 相关联。（请参阅 community.proxysql.proxysql_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 ← (默认)

schemaname

string / 必需

匹配 schemaname 的过滤条件，只有当连接使用 schemaname 作为其默认模式时，查询才会匹配。

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_query_rules_fast_routing:
    login_user: admin
    login_password: admin
    username: 'user_ro'
    schemaname: 'default'
    destination_hostgroup: 1
    comment: 'fast route user_ro to default schema'
    state: present
    save_to_disk: true
    load_to_runtime: true

返回值

常见返回值已在此处记录 这里，以下是此模块特有的字段

键

描述

stdout

字典

从 proxysql 修改或删除的 mysql 用户。

返回: 在创建/更新时，将返回新修改的规则，在所有其他情况下，将返回与提供的条件匹配的规则列表。

示例: {"changed": true, "msg": "添加到 mysql_query_rules_fast_routing 的规则", "rules": [{"comment": "", "destination_hostgroup": 1, "flagIN": "0", "schemaname": "default", "username": "user_ro"}], "state": "present"}

作者

  • Akim Lindberg (@akimrx)