This topic describes how to use Data Management (DMS) or a MySQL client to connect to a PolarDB for MySQL cluster.
Prerequisites
A privileged account or a standard account is created for the cluster. For more information, see Create and manage a database account.
The cluster endpoint is obtained. For more information, see Manage the endpoints of a cluster.
NoteFor information about the differences between the primary endpoint and a cluster endpoint, see Primary endpoints, cluster endpoints, and custom endpoints.
Connect to a cluster.
Use DMS to connect to a cluster
DMS is a visualized data management service provided by Alibaba Cloud. DMS provides various management services such as data management, schema management, access control, business intelligence (BI) charts, data trends, data tracking, performance optimization, and server management. You can use DMS to manage relational databases such as MySQL, SQL Server, and PostgreSQL databases and NoSQL databases such as MongoDB and Redis databases. You can also use DMS to manage Linux servers.
- Log on to the PolarDB console.
- In the upper-left corner of the console, select the region where the cluster resides.
- Find the cluster, and then click the cluster ID.
In the upper-right corner of the Basic Information page, click Log on to Database.
In the dialog box that appears, enter the Database Account and Database Password that you created for the PolarDB for MySQL cluster, and click Login.
NoteThe logon account must be granted management permissions on the database. Otherwise, you cannot find the database in the left-side navigation pane of the DMS console. For information about how to modify the permissions granted to an account, see Manage database accounts for a cluster.
After you log on to DMS, refresh the page. In the left-side navigation pane, click Instances Connected.
In the Instances Connected list, click the cluster name, find the database, and then double-click the database name. Then, you can manage the database.
Use a client to connect to a cluster
You can use a MySQL client to connect to a PolarDB cluster. The client used in the following example is HeidiSQL.
Start HeidiSQL.
In the lower-left corner of the session manager, click New.
Specify the information about the PolarDB cluster to which you want to connect. The following table describes the parameters.
Parameter
Description
Network Type
The network protocol type that is used to connect to the database. Select MariaDB or MySQL (TCP/IP).
Hostname / IP
Enter a public or private endpoint of the PolarDB cluster.
If the client runs on an Elastic Compute Service (ECS) instance that is deployed in the same region and has the same network type as the PolarDB cluster, use a private endpoint. For example, if the ECS instance and the PolarDB cluster are deployed in a virtual private cloud (VPC) in the China (Hangzhou) region, you can use a private endpoint to establish a secure and fast connection.
In other scenarios, use a public endpoint.
For more information about how to view the endpoint of a PolarDB cluster, see Manage the endpoints of a cluster.
Users
The name of the account that is used to connect to the PolarDB cluster.
Password
The password of the account.
Port
The port number in the public or private endpoint that is used to connect to the PolarDB cluster. The default port number is 3306.
Click Open. If the connection information is valid, the client is connected to the cluster.
Use the CLI to connect to a cluster
If MySQL is installed on your server, you can run the following command in the CLI to connect to a PolarDB for MySQL cluster:
mysql -h<Endpoint> -P<Port> -u<Username> -p<Password>
Example:
mysql -hpc-bp1867z0z*****kjd.rwlb.rds.aliyuncs.com -P3306 -uroot12 -pPass*****33
Parameter | Description | Example |
-h | The public or private endpoint of the PolarDB cluster. For more information about how to view the endpoint of a PolarDB cluster, see Manage the endpoints of a cluster. |
|
-P | The port number that is used to connect to the PolarDB cluster.
Note
|
|
-u | The name of the database account that you want to use to access the PolarDB cluster. |
|
-p | The logon password of the database account. Note This parameter is required.
|
|