Skip to content

Files

Latest commit

6af3fdc · Jun 18, 2025

History

History

readyset-mysql

README.md

Noria MySQL adapter

This crate contains the MySQL/MariaDB protocol adapter for Noria. The adapter allows legacy applications that use parameterized MySQL queries to directly start using Noria, with no or minimal source code changes.

Running the adapter

To run the adapter and listen on the default MySQL port (3306), simply type:

$ cargo run --release -- --deployment $DEPLOYMENT

DEPLOYMENT is the same deployment ID you used when starting the Noria server.

If you would like to use a different port (e.g., because you're also running a MySQL server), pass -a <IP>:<PORT> making sure to specify the desired bind ip as well.

Connecting to Noria

The MySQL adapter uses Consul to find the Noria server. To specify the Consul server location, pass the -z argument:

$ cargo run --release -- --deployment $DEPLOYMENT --authority-address 172.16.0.19:8500

... for a Consul server listening on port 8500 at IP 172.16.0.19.