You can use a cluster endpoint or the primary endpoint of a PolarDB cluster to connect to the cluster. This topic describes how to apply for and manage cluster endpoints or primary endpoints.
View the endpoint and port number
Log on to the PolarDB console.
In the upper-left corner of the console, select the region in which the cluster that you want to manage is deployed.
Find the cluster and click its ID.
In the Database Connections section of the Basic Information page, move the pointer over the endpoint to view the Network Information in the dialog box that appears, including the endpoint and port number.
If you use a domain name to connect to a database, you can click Bind Private Domain Name to bind the domain name to a private endpoint. This allows you to retain the original database domain name after the database is migrated to the cloud. Only Private endpoints can be bound to private domain names. For more information, see Private domain names.
The default port number of an endpoint that is used by a PolarDB cluster is 3306. You can change the port number. For more information, see Change the endpoint of a cluster.
Apply for a public cluster endpoint or a primary endpoint
Log on to the PolarDB console.
In the upper-left corner, select the region where the cluster to which you want to connect is deployed.
Find the cluster and click its ID.
In the Database Connections section of the Basic Information page, find the endpoint and click Apply on the right of Public.
NoteYou can apply only for Public endpoints. After you create a cluster, a default Private endpoint is generated. You do not need to apply for this endpoint.
In the dialog box that appears, specify a prefix for the endpoint and click OK.
NoteThe prefix of the endpoint must meet the following requirements:
It must be 6 to 40 characters in length and can contain lowercase letters, digits, and hyphens (-).
It must start with a lowercase letter and end with a digit or letter.
After an application for the cluster endpoint is approved, all features that can be provided by PolarProxy are supported. You can modify the parameter settings of the features provided by PolarProxy based on your business requirements. For more information, see Configure PolarProxy.
Create a custom cluster endpoint
In the Database Connections section of the Basic Information page, click Create Custom Cluster Endpoint. In the dialog box that appears, create a custom cluster endpoint and configure the features provided by PolarProxy for the custom cluster endpoint. For more information, see Configure PolarProxy.
PolarDB for MySQL Cluster Edition allows you to specify a VPC and a vSwitch when you create an endpoint. For more information, see Change the VPC and vSwitch for a PolarDB for MySQL cluster.
Change the endpoint of a cluster
In the Database Connections section of the Basic Information page, find the endpoint and click > Edit on the right of Private or Public to modify the endpoint.
The prefix of the endpoint must meet the following requirements:
It must be 6 to 40 characters in length and can contain lowercase letters, digits, and hyphens (-).
It must start with a lowercase letter and end with a digit or letter.
The port number ranges from 3000 to 5999.
If SSL is enabled for the endpoint, the cluster restarts after you modify the endpoint.
If SSL is enabled for the endpoint, the total length of the new endpoint cannot exceed 64 characters.
PolarDB for MySQL Cluster Edition allows you to change the VPC and vSwitch of a single endpoint. For more information, see Change the VPC and vSwitch for a PolarDB for MySQL cluster.
Delete an endpoint
Before you delete an endpoint, make sure that your application is connected to the cluster by using another endpoint.
The deleted endpoint cannot be restored. You can click Apply next to the required endpoint type in the console to apply for a new endpoint.
The default cluster endpoint can be modified but cannot be deleted. Custom cluster endpoints can be deleted.
In the Database Connections section of the Basic Information page, find the endpoint and click > Release on the right of Public to release the endpoint.
Only Public endpoints can be released.
What to do next
Related API operations
API | Description |
Queries the endpoints of a PolarDB cluster. | |
Creates a public endpoint for a PolarDB cluster. | |
Modifies the endpoints of a PolarDB cluster. | |
Deletes the public endpoints of a PolarDB cluster. |