通过公共端点连接平凯云 Starter 或 Essential

本文档介绍了如何通过公共端点，使用你电脑上的 SQL 客户端连接到平凯云 Starter 或平凯云 Essential 实例，以及如何禁用公共端点。

选择端点模型

根据你的平凯数据库云服务计划，选择合适的端点模型：

对于平凯云 Starter 实例，或在 2026 年 7 月 1 日之前创建的平凯云 Essential 实例，请使用端点共享模型。在此模型中，同一 Region 中的多个平凯云 Starter 和 Essential 实例可以共享一个公共端点。
对于从 2026 年 7 月 1 日开始创建的平凯云 Essential 实例，请使用端点独占模型。在此模型中，每个平凯云 Essential 实例都使用自己的独立公共端点。此模型无需在连接时包含账户前缀，但你需要为每个平凯云 Essential 实例重复执行设置步骤。

通过公共端点连接（端点共享模型）

要通过公共端点连接到平凯云 Starter 或平凯云 Essential 实例，请按照以下步骤操作：

进入集群列表页面，然后点击目标平凯云 Starter 或 Essential 实例的名称，进入其概览页面。
点击右上角的 Connect。此时会弹出连接对话框。
在对话框中，保持连接类型的默认设置为 Public，并选择你偏好的连接方式和操作系统，以获取对应的连接字符串。
i
注意
- 保持连接类型为 Public，表示通过标准 TLS 连接进行连接。更多信息，请参见平凯云的 TLS 连接。
- 如果你在 Connection Type 下拉列表中选择 Private Endpoint，则表示通过私有端点进行连接。更多信息，请参见以下文档：
  - 通过阿里云私有 endpoint 连接平凯云
  - 腾讯云私有连接支持请以平凯数据库云服务控制台为准。
平凯数据库云服务支持为你的平凯云 Starter 或平凯云 Essential 实例创建 branches。创建分支后，你可以通过 Branch 下拉列表选择连接到某个分支。main 代表平凯云 Starter 或 Essential 实例本身。
如果你还没有设置密码，请点击 Generate Password 生成一个随机密码。生成的密码只会显示一次，请妥善保存。
使用连接字符串连接到你的平凯云 Starter 或 Essential 实例。

注意

连接平凯云 Starter 或平凯云 Essential 实例时，必须在用户名中包含平凯云 Starter 或 Essential 实例的前缀，并用引号包裹。更多信息，请参见 User name prefix。你的客户端 IP 必须在平凯云 Starter 或 Essential 实例公共端点的允许 IP 规则中。更多信息，请参见配置平凯云 Starter 或 Essential 公共端点的防火墙规则。

禁用公共端点

如果你不需要使用平凯云 Starter 或平凯云 Essential 实例的公共端点，可以将其禁用，以防止来自互联网的连接：

进入集群列表页面，然后点击目标平凯云 Starter 或 Essential 实例的名称，进入其概览页面。
在左侧导航栏，点击 Settings > Networking。
在 Networking 页面，点击 Public Endpoint 对应的 Disable。此时会弹出确认对话框。
在确认对话框中点击 Disable。

禁用公共端点后，连接对话框的 Connection Type 下拉列表中的 Public 选项会被禁用。如果用户仍尝试通过公共端点访问平凯云 Starter 或 Essential 实例，将会收到错误提示。

注意

禁用公共端点不会影响已有的连接，只会阻止新的互联网连接。

你可以在禁用后重新启用公共端点：

进入集群列表页面，然后点击目标平凯云 Starter 或 Essential 实例的名称，进入其概览页面。
在左侧导航栏，点击 Settings > Networking。
在 Networking 页面，点击 Enable。

后续操作

成功连接到平凯云 Starter 或 Essential 实例后，你可以使用 TiDB 探索 SQL 语句。