本文介绍如何设置白名单以及通过客户端、命令行连接RDS MySQL或RDS MySQL Serverless实例。

前提条件

建议

如果您满足 内网访问条件 ，建议使用内网连接地址连接实例，以获取最快的响应时间和最小的延迟。

使用命令行连接RDS实例

本文以Linux系统为例连接RDS MySQL或RDS MySQL Serverless实例，您需要提前安装MySQL。安装方法：
  • CentOS：执行sudo yum install mysql。
  • Ubuntu：执行sudo apt-get update，并执行sudo apt install mysql-server。
  1. 登录到需要连接RDS的服务器，例如ECS服务器或本地服务器。
    说明 登录ECS的操作请参见ECS快速入门里的连接ECS实例部分。
  2. 执行连接命令。
    mysql -h连接地址 -P端口 -u用户名 -p密码
    说明
    • 大写字母P代表端口，小写字母p代表密码。
    • 输入用户名和密码时，需要在-u和-p后面直接输入，不可以有空格。
    • -p后面也可以不用输入密码，执行命令后再输入，以防止密码明文显示。
    • 连接地址和端口：RDS实例地址和端口。
      场景需获取的RDS实例地址如何获取
      满足 内网访问条件 RDS内网地址
      1. 访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
      2. 单击查看连接详情，即可查看RDS实例地址和端口号。查看连接详情
      说明
      • 需要先完成IP白名单设置，才能查看地址信息。
      • 需要点击开通外网地址，才会显示外网地址。
      • 对于集群版实例，修改主节点地址需要在集群读写连接区域操作，修改备节点地址需要在集群可读连接区域操作。
      从ECS实例访问RDS实例，但不满足内网访问的条件RDS外网地址
      从本地设备访问RDS实例
    • 用户名和密码：在RDS 账号管理 页面获取。
    图 1. 命令示例
    示例
    图 2. 连接成功
    连接成功
    说明 如果连接报错，请参见连接失败的常见报错。

使用客户端连接RDS实例

可以使用其他通用的MySQL客户端连接到RDS MySQL或RDS MySQL Serverless实例，本步骤以MySQL Workbench 8.0.29版本为例，其它客户端的操作类似。

  1. 安装MySQL Workbench。官方下载地址请参见MySQL Workbench下载页面。
  2. 打开MySQL Workbench，选择Database > Connect to Database。
  3. 输入连接信息，单击OK。
    连接界面
    • Hostname和Port：RDS实例地址和端口。
      场景需获取的RDS实例地址如何获取
      满足 内网访问条件 RDS内网地址
      1. 访问RDS实例列表，在上方选择地域，然后单击目标实例ID。
      2. 单击查看连接详情，即可查看RDS实例地址和端口号。查看连接详情
      说明
      • 需要先完成IP白名单设置，才能查看地址信息。
      • 需要点击开通外网地址，才会显示外网地址。
      • 对于集群版实例，修改主节点地址需要在集群读写连接区域操作，修改备节点地址需要在集群可读连接区域操作。
      从ECS实例访问RDS实例，但不满足内网访问的条件RDS外网地址
      从本地设备访问RDS实例
    • Username和Password：在RDS 账号管理 页面获取。

连接失败的常见报错

报错原因和解决方法
mysql command not found未安装MySQL。可按照如下方法快速安装：
  • CentOS：执行sudo yum install mysql。
  • Ubuntu：执行sudo apt-get update，并执行sudo apt install mysql-server。
SSL connection error: SSL is required but the server doesn't support it使用部分版本的MySQL Workbench时，Standard TCP/IP连接要求必须有SSL加密，可下载本文中的版本进行常规连接。
Can't connect to MySQL server on 'rm-bp1xxxxxxxxxxxxxx.mysql.rds.aliyuncs.com'(10060)

Cannot Connect to Database Server

Your connection attempt failed for user 'xx" to the MySQL server

  • （多数情况）RDS白名单设置错误，请参见设置IP白名单。
  • （少数情况）不满足 内网互通的条件 ，却使用内网地址连接。
Access denied for user 'xxxxx'@'xxxxx'(using password:YES)输入的账号密码错误。可以在RDS 账号管理 页面管理账号和密码。
Unknown MySQL server host 'xxxxxxxxx'(11001)输入的RDS实例地址错误。正确格式为rm-xxxxxx.mysql.rds.aliyuncs.com。

相关文档