MySQL InnoDB Cluster Userguide  /  MySQL InnoDB Cluster  /  Introducing InnoDB Cluster

Beta Draft: 2017-02-18

1.1 Introducing InnoDB Cluster

InnoDB cluster provides a new way to create a group of MySQL Servers providing high availability and read-out scalability. The group of servers has a single master, called the primary, which acts as the writable master. Multiple slave servers, called secondaries, are replicas of the master. In the event of a failure of the primary, a secondary is promoted to the role of primary. The secondaries are read-only replicas of the primary that can be used for read-out scalability. To achieve this the following MySQL technologies work together:

  • MySQL InnoDB cluster enables you to distribute your data across a set of MySQL Server instances.

  • MySQL Router 2.1 with InnoDB cluster Metadata Schema support, which caches the metadata of the InnoDB cluster and performs high availability routing to the MySQL Server instances which make up the cluster.

  • MySQL Shell with the AdminAPI implementation, which enables you to create and administer an InnoDB cluster, using either JavaScript and Python.


The supplied MySQL labs versions of MySQL Shell and MySQL Router differ from the release versions. This documentation covers the functionality provided by the labs versions which is not covered in the existing documentation.

For more information about the current release versions of MySQL Shell and MySQL Router see:

For information about the AdminAPI available in the MySQL Shell 1.0.x labs release, see the JavaScript reference documentation.

For more background information see Using MySQL as a Document Store.

User Comments
Sign Up Login You must be logged in to post a comment.