文档

通过客户端、命令行连接RDS MySQL实例

更新时间:

本文介绍如何设置白名单以及通过客户端、命令行连接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代表密码。

    • 连接地址和端口:RDS实例地址和端口。

      场景

      需获取的RDS实例地址

      如何获取

      满足 内网访问条件

      RDS内网地址

      1. 访问RDS实例列表,在上方选择地域,然后单击目标实例ID。
      2. 单击查看连接详情,即可查看RDS实例地址和端口号。查看连接详情

      说明
      • 需要先完成IP白名单设置,才能查看地址信息。

      • 需要点击开通外网地址,才会显示外网地址。

      • 对于集群系列实例,修改主节点地址需要在集群读写连接区域操作,修改备节点地址需要在集群可读连接区域操作。

      从ECS实例访问RDS实例,但不满足内网访问的条件

      RDS外网地址

      从本地设备访问RDS实例

    • 用户名和密码:在RDS 账号管理 页面获取。

    图 2. 命令示例示例

    图 3. 连接成功连接成功

    说明

    如果连接报错,请参见连接失败的常见报错

使用客户端连接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

    连接界面
    • HostnamePort:RDS实例地址和端口。

      场景

      需获取的RDS实例地址

      如何获取

      满足 内网访问条件

      RDS内网地址

      1. 访问RDS实例列表,在上方选择地域,然后单击目标实例ID。
      2. 单击查看连接详情,即可查看RDS实例地址和端口号。查看连接详情

      说明
      • 需要先完成IP白名单设置,才能查看地址信息。

      • 需要点击开通外网地址,才会显示外网地址。

      • 对于集群系列实例,修改主节点地址需要在集群读写连接区域操作,修改备节点地址需要在集群可读连接区域操作。

      从ECS实例访问RDS实例,但不满足内网访问的条件

      RDS外网地址

      从本地设备访问RDS实例

    • UsernamePassword:在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。

您是否连接成功?

相关文档

  • 本页导读 (1)