文档中心

云数据库 MySQL 版

请输入

连接实例

通过命令行连接实例

加 MySQL 实例的 IP 白名单后您可成功连接实例。本文介绍如何通过命令行连接 MySQL 实例的操作步骤。

前提条件

已创建实例且实例处于运行中状态。具体操作，请参见创建实例。

已创建数据库和账号。具体操作，请参见创建数据库和创建账号。

已配置白名单，详情请参见绑定白名单到实例。

若使用 ECS 连接，需要确保 ECS 与 MySQL 实例所属同一私有网络和子网。

（可选）若数据库账号的验证方式为 IAM 验证，需创建 IAM 身份验证策略。

操作步骤

登录到需要连接 MySQL 的服务器，比如 ECS 服务器或本地服务器。

说明

关于如何登录 ECS ，详情请参见登录 ECS 实例。

安装 MySQL。以 Linux 系统为例，安装方法如下：

CentOS：执行 yum install mysql。

Ubuntu：执行 apt-get update，并执行 apt install mysql-server。

执行命令行连接。

数据库账号的验证方式为 IAM 验证

数据库账号的验证方式为密码

语法

mysql -h<连接地址> -P<端口> --enable-cleartext-plugin -u<数据库账号> -p'<临时 Token>'​

警告

请注意区分端口使用大写（-P），密码使用小写（-p）。

参数说明

选项	说明	示例
-h	MySQL 实例的私网或公网连接地址。关于如何获取私网或公网连接地址，请参见通过私网连接实例和申请或释放公网地址。	rds-mysql-hb3c8a96e9119***.rds.ivolces.com
-P	MySQL 实例的端口号。若使用私网连接，需输入 MySQL 实例的私网端口。若使用公网连接，需输入 MySQL 实例的公网端口， P 需要大写，默认端口为 3306 。如果端口号为默认端口，该参数可以不填。	3306
-u	MySQL 实例的数据库账号名称。	testuser
-p	数据库账号的临时 Token。获取临时 Token 的方法，请参见生成临时 Token。由于生成的临时 Token 中包含 & 符号，为避免解析失败，必须使用英文单引号（''）将 Token 内容括起来。	Action=ConnectDatabase&DBUser=yzh&InstanceId=mysql-41186f538XXXX

示例

mysql -hrds-mysql-hb3c8a96e9119****.rds.ivolces.com -P3306 --enable-cleartext-plugin -utestuser -p'Action=ConnectDatabase&DBUser=yzh&InstanceId=mysql-41186f538XXXX'​

常见问题

为什么无法连接数据库？

若您出现无法连接数据库的问题，请根据如下建议进行排查：

确认 MySQL 实例是否为运行中的状态。

是否已为实例创建账号。

是否已配置 IP 白名单分组。

若通过私网连接，请确认 ECS 实例和数据库实例在同一个 VPC 下。

若排查之后仍无法连接 MySQL 实例，您可以提交工单联系技术支持。

API	描述
DescribeDBInstanceEndpoints	调用 DescribeDBInstanceEndpoints 接口查询实例的连接地址列表。