Outdated Version
You are viewing an older version of this section. View current production version.
REPLICATE DATABASE
Start or continue replicating a database from a remote host to a local database.
Syntax
REPLICATE DATABASE db_name FROM master_user[:'master_password']@master_host[:master_port][/master_db_name]
Remarks
db_name
is the name of the target database on the secondary MemSQL instance.REPLICATE DATABASE
will always attempt to create a new database nameddb_name
. The database name on the secondary does not need to match the name of its corresponding remote primary database.master_user
andmaster_password
must grant access to the primary database. The password is assumed to be blank ifmaster_password
is not specified explicitly. If you specify a password, enclose it in single quotes.master_host
is the host name or IPv4/IPv6 pointing to the remote database. It can be quoted to allow special characters (e.g. “-", among others).master_db_name
is the name of the remote, primary database. If it is not specified explicitly, MemSQL attempts to replicate fromdb_name
on the master MemSQL instance.- While replicating, the database is in the
replicating
state (see Database States). - The long form of
CONTINUE REPLICATING
can be used to re-point a replica from one master to another.
Examples
Basic Usage
memsql> REPLICATE DATABASE ExampleDatabase FROM root@master-host:3306;
Query OK, 1 row affected (0.32 sec)
With Password
REPLICATE DATABASE ExampleDatabase FROM master_user:'master_password'@master-host:3306/MasterExampleDatabase;