MySQL Proxy. A powerful, flexible MySQL toolbox.

MySQL Proxy
A powerful, flexible MySQL toolbox
Miguel Araújo
Software Developer @
MySQL Enterprise Tools
3 April 2014

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.3
Agenda
1. What is MySQL Proxy?
2. Overview / Concepts
3. Architecture
1. Usage
2. Plugins
4. Scenarios
1. Examples / Demo!
5. How can we improve?
6. Q/A

What is MySQL Proxy?
Do you know it?

What is MySQL Proxy?
●
Stands between the client and the server
●
“Speaks” MySQL
●
Can analyze, block, inject, rewrite, route queries...
●
A good MitM!
Do you know it?

Overview / Concepts
 Transparent to the client
 Supports all major platforms
 GPLv2 license
 Plugins layer
 Customized with Lua scripts

Overview / Concepts
Use-cases
 Query analysis
 Query manipulation
 Load balancing
 Fail over
 Sharding
 R/W splitting
 Pooling

Architecture
4 Layers
Chassis
La
scripting

Architecture
4 Layers
Chassis
Network Core

Architecture
4 Layers
Chassis
Network Core
Plugins

Architecture
4 Layers
Chassis
Network Core
Plugins
Lua
scripting

Architecture
Detail

 How do I start proxy?
 Which are the command-line options?
 Can I have a configuration file?
 How does it look like?
Architecture
Usage

Demo!
Architecture
Usage

Architecture
Plugins: Proxy plugin
 MySQL Proxy “is” actually, the Proxy plugin
 Accepts connections on its “--proxy-address”
 Forwards data to the “--proxy-backend-addresses”
 We can provide a Lua script with “--proxy-lua-script”
 Exposes hooks to the scripting layer:
➔
connect_server()
➔
read_query()
➔
read_query_result()
➔
...

Demo!
Architecture
Plugins: Proxy plugin

Architecture
Plugins: Admin plugin
 Administration interface
 Only authenticated users can use it
➔
--admin-username
➔
--admin-password
 Provides information about the proxy server
 We must use a Lua script...
➔
--admin-lua-script
 … to access the internal components of mysql-proxy

Demo!
Architecture
Plugins: Admin plugin

Scenarios
Query manipulation
Let's intercept some
user queries and
rewrite them...

Scenarios
Query manipulation
Let's intercept some
user queries and
rewrite them...
rewrite.lua
function read_query (packet)
if packet:byte() == proxy.COM_QUERY then
...
if string.match(string.upper(query),
'foo') then
proxy.queries:append(1,
string.char(proxy.COM_QUERY) .. "bar")
return proxy.PROXY_SEND_QUERY
end
end
end

Demo!
Scenarios
Query manipulation

Scenarios
Query injection
Let's inject some
useful SQL for certain
queries...

Scenarios
Query injection
Let's inject some
useful SQL for certain
queries...
inject.lua
...
proxy.queries:append(2,
string.char(proxy.COM_QUERY) .. "SELECT
CURRENT_USER()", {resultset_is_needed = true})
...
end
function read_query_result(inj)
...
if (inj.id == 2) then
for row in inj.resultset.rows do
...
end
return proxy.PROXY_IGNORE_RESULT
end
end

Demo!
Scenarios
Query injection

Scenarios
Load balancing

Scenarios
Load balancing
ro-pooling.lua
function connect_server (packet)
--get a connection to a backend...
...
end
function read_auth_result (auth)
--successful connection? Put it on the pool
...
end
--get the first idle server and choose it
for backend connection
...
end
function read_query_result (inj)
--manage backends use
end
function disconnect_client ()
--manage disconnected clients
end

Scenarios
R/W splitting

Scenarios
R/W splitting
rw-splitting.lua
function connect_server (packet)
--get a connection to a backend...
...
end
function read_auth_result (auth)
--successful connection? Put it on the pool
...
end
--use the tokenizer to check if query is a
SELECT. If so pick an idle slave if not pick
the master
...
end
function read_query_result (inj)
--manage backends use
end
function disconnect_client ()
--manage disconnected clients
end

Demo!
Scenarios
R/W splitting


Used worldwide

Used in production
Scenarios

How can we improve?
Problems / Solutions
Performance issues due to global plugin lock
Plugins loaded at start
Scripting restricted to Lua
Admin plugin limited
Code can be optimized
0.8.4 Next... (0.9.0)

Any questions?
Download from: http://dev.mysql.com/downloads/mysql-proxy/
Code @ launchpad.net/mysql-proxy
mailto: miguel.araujo@oracle.com; jan.kneschke@oracle.com;
mark.leith@oracle.com
IRC: miguelaraujo / weigon / leithal in #mysql-proxy on irc.freenode.net
Thanks!

MySQL Proxy. A powerful, flexible MySQL toolbox.

More Related Content

What's hot (20)

Viewers also liked (20)

Similar to MySQL Proxy. A powerful, flexible MySQL toolbox. (20)

More from Miguel Araújo (13)

Recently uploaded (20)

MySQL Proxy. A powerful, flexible MySQL toolbox.