Creating a database read-replica

This recipe will show you how to create an RDS read-replica. You can use read-replicas in order to increase the performance of your application by off-loading database reads to a separate database instance. You can provision up to five read-replicas per source DB.

Read-only database slaves

Getting ready

You will need an RDS DB deployed with backup retention enabled. We are going to build upon the DB deployed in the previous Creating a database with automatic failover recipe.

You're going to need the following values:

• The identifier for your source RDS instance, for example, eexocwv5k5kv5z
• A unique identifier for the read-replicate we're going to create, for example, read-replica-1

How to do it...

In the AWS CLI, type this command:

aws rds create-db-instance-read-replica \
  --source-db-instance-identifier <source-db-identifier> \
  --db-instance-identifier <unique-identifier-for-replica>

How it works...

RDS will now go ahead and create a new read-replica...