1.ProxySQL的Admin管理介面 當ProxySQL啟動後,將監聽兩個埠: (1).admin管理介面,預設埠為6032。該埠用於查看、配置ProxySQL。 (2).接收SQL語句的介面,預設埠為6033,這個介面類似於MySQL的3306埠。 ProxySQL的admin管理接 ...
1.ProxySQL的Admin管理介面
當ProxySQL啟動後,將監聽兩個埠:
- (1).admin管理介面,預設埠為6032。該埠用於查看、配置ProxySQL。
- (2).接收SQL語句的介面,預設埠為6033,這個介面類似於MySQL的3306埠。
ProxySQL的admin管理介面是一個使用MySQL協議的介面,所以,可以直接使用mysql客戶端、navicat等工具去連接這個管理介面。
例如,使用mysql客戶端去連接ProxySQL的管理介面。下麵使用的是管理介面的預設用戶名和密碼admin:admin
。
mysql -uadmin -padmin -h127.0.0.1 -P6032 --prompt 'admin> '
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 30
Server version: 5.5.30 (ProxySQL Admin Module)
Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
admin>
由於ProxySQL的配置全部保存在幾個自帶的庫中,所以通過管理介面,可以非常方便地通過發送一些SQL命令去修改ProxySQL的配置。ProxySQL會解析通過該介面發送的某些對ProxySQL有效的特定命令,並將其合理轉換後發送給內嵌的SQLite3資料庫引擎去運行。
例如,查看庫、庫中的表。
admin> show databases;
+-----+---------------+-------------------------------------+
| seq | name | file |
+-----+---------------+-------------------------------------+
| 0 | main | |
| 2 | disk | /var/lib/proxysql/proxysql.db |
| 3 | stats | |
| 4 | monitor | |
| 5 | stats_history | /var/lib/proxysql/proxysql_stats.db |
+-----+---------------+-------------------------------------+
admin> show tables from disk;
+------------------------------------+
| tables |
+------------------------------------+
| global_variables |
| mysql_collations |
| mysql_group_replication_hostgroups |
| mysql_query_rules |
| mysql_query_rules_fast_routing |
| mysql_replication_hostgroups |
| mysql_servers |
| mysql_users |
| proxysql_servers |
| scheduler |
+------------------------------------+
請註意,SQLite3和MySQL使用的SQL語法有所不同,因此能在MySQL上正常運行的命令不一定能在SQLite3上運行。例如,儘管admin管理介面接收USE命令,但不會切換預設的schema,因為SQLite3不支持USE功能。
ProxySQL會儘量將MySQL語法自動調整為對應的SQLite3的語法,例如show databases;
會轉換為SQLite3上等價的語句。
ProxySQL的配置幾乎都是通過管理介面來操作的,通過Admin管理介面,可以線上修改幾乎所有的配置並使其生效。只有兩個變數的配置是必須重啟ProxySQL才能生效的,它們是:mysql-threads
和mysql-stacksize
。
2.和admin管理介面相關的變數
一般來說,admin介面基本不需要額外的配置,最有可能配置的是admin介面的管理員用戶名、密碼。
2.1 admin-admin_credentials
該變數控制的是admin管理介面的管理員賬戶。預設的管理員賬戶和密碼為admin:admin
,但是這個預設的用戶只能在本地使用。如果想要遠程連接到ProxySQL,例如用windows上的navicat連接Linux上的ProxySQL管理介面,必須自定義一個管理員賬戶。
例如,添加一個myuser:myuser
的用戶密碼對。
admin> select @@admin-admin_credentials; # 當前用戶名和密碼
+---------------------------+
| @@admin-admin_credentials |
+---------------------------+
| admin:admin |
+---------------------------+
admin> set admin-admin_credentials='admin:admin;myuser:myuser';
admin> select @@admin-admin_credentials;
+---------------------------+
| @@admin-admin_credentials |
+---------------------------+
| admin:admin;myuser:myuser |
+---------------------------+
admin> load admin variables to runtime; # 使修改立即生效
admin> save admin variables to disk; # 使修改永久保存到磁碟
修改後,就可以使用該用戶名和密碼連接管理介面。
mysql -umyuser -pmyuser -P6032 -h127.0.0.1 --prompt 'admin> '
所有的配置操作都是在修改main庫中對應的表。
select * from global_variables
where variable_name='admin-admin_credentials';
+-------------------------+---------------------------+
| variable_name | variable_value |
+-------------------------+---------------------------+
| admin-admin_credentials | admin:admin;myuser:myuser |
+-------------------------+---------------------------+
所以,前面的set
語句和下麵的update語句是等價的:
update global_variables set variable_value='admin:admin;myuser:myuser'
where variable_name='admin-admin_credentials';
必須要區分admin管理介面的用戶名和mysql_users中的用戶名。
- admin管理介面的用戶是連接到管理介面(預設埠6032)上用來管理、配置ProxySQL的。
- mysql_users表中的用戶名是應用程式連接ProxySQL(預設埠6033),以及ProxySQL連接後端MySQL Servers使用的用戶。它的作用是發送、路由SQL語句,類似於MySQL Server的3306埠。所以,這個表中的用戶必須已經在後端MySQL Server上存在且授權了。
目前ProxySQL的mysql_users中的用戶既負責ProxySQL前端,又負責ProxySQL後端的連接,(作者說)未來版本中可能會將這兩段連接的用戶系統分開,讓ProxySQL更加安全。
admin管理介面的用戶必須不能存在於mysql_users中,這是出於安全的考慮,防止通過admin管理介面用戶猜出mysql_users中的用戶。
2.2 admin-stats_credentials
該變數控制admin管理介面的普通用戶,這個變數中的用戶沒有超級管理員許可權,只能查看monitor庫和main庫中關於統計的數據,其它庫都是不可見的,且沒有任何寫許可權。
預設的普通用戶名和密碼為stats:stats
。
mysql> select @@admin-stats_credentials;
+---------------------------+
| @@admin-stats_credentials |
+---------------------------+
| stats:stats |
+---------------------------+
mysql> set admin-stats_credentials='stats:stats;mystats:mystats';
[root@s1 ~]# mysql -ustats -pstats -P6032 -h127.0.0.1
mysql> show databases;
+-----+---------------+-------------------------------------+
| seq | name | file |
+-----+---------------+-------------------------------------+
| 0 | main | |
| 2 | monitor | |
| 3 | stats_history | /var/lib/proxysql/proxysql_stats.db |
+-----+---------------+-------------------------------------+
mysql> show tables from main;
+--------------------------------------+
| tables |
+--------------------------------------+
| global_variables |
| stats_memory_metrics |
| stats_mysql_commands_counters |
| stats_mysql_connection_pool |
| stats_mysql_connection_pool_reset |
| stats_mysql_global |
| stats_mysql_prepared_statements_info |
| stats_mysql_processlist |
| stats_mysql_query_digest |
| stats_mysql_query_digest_reset |
| stats_mysql_query_rules |
| stats_mysql_users |
| stats_proxysql_servers_checksums |
| stats_proxysql_servers_metrics |
| stats_proxysql_servers_status |
+--------------------------------------+
同樣,這個變數中的用戶必須不能存在於mysql_users表中。
2.3 admin-mysql_ifaces
該變數指定admin介面的監聽地址,格式為分號分隔的hostname:port
列表。預設監聽在0.0.0.0:6032
。
註意,允許使用UNIX的domain socket進行監聽,這樣本主機內的應用程式就可以直接被處理。
例如:
SET admin-mysql_ifaces='127.0.0.1:6032;/tmp/proxysql_admin.sock'