Hi! 👋 We are doing a big documentation refresh. Help us improve — what's missing or could be better? Let us know! Simply send an email or start a conversation in Google Groups!

Main Runtime

Overview

The ProxySQL Admin interface exposes configuration and runtime tables accessible via either the MySQL or PostgreSQL protocol. There are 50+ configuration and runtime tables across MySQL, PostgreSQL, and system categories.

Configuration Layers

Every configuration item exists in three layers:

LayerTable PrefixDescription
Memory(no prefix)In-memory working copy — edit here
Runtimeruntime_Active configuration used by worker threads
DiskdiskPersisted to SQLite (proxysql.db)

Key Configuration Tables

MySQL/PostgreSQL Common Tables

TableConfigures
mysql_users, pgsql_usersFrontend and Backend MySQL/PostgreSQL Users
mysql_servers, pgsql_serversBackend MySQL/PostgreSQL Servers
mysql_query_rules, pgsql_query_rulesQuery Rules for MySQL/PostgreSQL traffic
mysql_replication_hostgroups, pgsql_replication_hostgroupsMySQL/PostgreSQL replication clusters with servers in RW or RO mode
mysql_query_rules_fast_routing, pgsql_query_rules_fast_routingQuery Rules for MySQL/PostgreSQL traffic specialized in routing
mysql_hostgroup_attributes, pgsql_hostgroup_attributesHostgroup-specific attributes that override global settings

MySQL Specific Tables

TableConfigures
mysql_collationsKnown MySQL charsets and collations
mysql_galera_hostgroupsMySQL clusters using Galera replication
mysql_group_replication_hostgroupsMySQL clusters using Group Replication
mysql_servers_ssl_paramsBackend MySQL Server specific SSL Parameters

System Tables

TableConfigures
global_variablesAll variables
schedulerTasks that the Scheduler can execute
proxysql_serversList of core nodes in ProxySQL Cluster
restapi_routesRESTAPI endpoints

In the following sections you will find a detailed description of all the configuration tables.

Key Table Categories

Server Management

  • mysql_servers / pgsql_servers — Backend database servers organised into hostgroups
  • mysql_replication_hostgroups — Read/write split based on read_only
  • mysql_group_replication_hostgroups — Group Replication topology
  • mysql_galera_hostgroups — Galera Cluster topology
  • mysql_hostgroup_attributes / pgsql_hostgroup_attributes — Per-hostgroup settings

User Authentication

  • mysql_users / pgsql_users — Frontend/backend credentials, default hostgroup, SSL requirements, connection limits

Query Routing

  • mysql_query_rules / pgsql_query_rules — Pattern matching, rewriting, caching, routing, and load balancing
  • mysql_query_rules_fast_routing / pgsql_query_rules_fast_routing — Optimised routing by username, schema, and flags

Other Tables

  • scheduler — Automated task execution
  • global_variables — Key-value configuration store
  • mysql_collations — Character set and collation reference
  • proxysql_servers — ProxySQL cluster node definitions
  • restapi_routes — REST API endpoint configuration

Table Definitions

The following provide detailed information on tables and columns by category.

See Also