全部产品
Search
文档中心

云原生数据库 PolarDB:连接数据库

更新时间:Jan 08, 2025

本文将为您介绍如何连接PolarDB MySQL版集群。

准备工作

在连接数据库集群前,您需要进行以下操作:

  • 获取数据库连接地址与端口

    您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在数据库连接中获取数据连接地址。image

    说明
    • 推荐使用集群地址,默认端口号为3306。

    • 请根据您的访问环境选择私网公网

      • 如果您是使用ECS访问PolarDB,并且ECS与PolarDB位于同一VPC内,请选择私网

      • 如果您是在本地环境中访问PolarDB,请选择公网。公网地址单击右侧申请即可。

    • 公网即因特网,通过公网访问将无法实现PolarDB集群的最佳性能。

    • 暂不支持使用虚拟主机和轻量服务器使用私网地址连接PolarDB集群。

    • 更多信息,请参见连接地址(主地址、集群地址和自定义地址)

  • 创建数据库账号

    您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在配置与管理 > 账号管理中创建数据库账号。image

    说明
    • 数据库账号类型分为高权限账号普通账号,这两种账号的权限存在差异。您可以根据实际业务需求选择创建相应的数据库账号。

    • 更多信息,请参见创建和管理数据库账号

  • 设置集群白名单

    您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在配置与管理 > 集群白名单中添加IP白名单或安全组。

    image

    说明
    • 如果您是使用ECS访问PolarDB,并且ECS与PolarDB位于同一VPC内,请忽略当前步骤。系统已将ECS所在的VPC网段添加至default分组中了。

    • 如果您是使用ECS访问PolarDB,但ECS与PolarDB不在同一VPC内,您可以选择将ECS的公网IP地址添加至新的IP白名单分组,或将ECS所在的安全组添加至集群白名单中。

    • 如果您是在本地环境中访问PolarDB,请将您本地环境的公网IP地址添加至新的IP白名单分组中。

      本地环境的公网IP地址获取方法如下:

      • Linux操作系统:打开终端,输入curl ifconfig.me命令后回车。

      • Windows操作系统:打开命令提示符,输入curl ip.me命令后回车。

      • macOS操作系统:打开终端,输入curl ifconfig.me命令后回车。

      若您的本地网络环境存在代理等情况,以上方式获取的IP可能并非您的真实公网IP。您可以将IP段0.0.0.0/0添加至PolarDB集群白名单中,成功连接集群后,执行SHOW PROCESSLIST;命令获取真实公网IP地址,并将其加入到集群白名单中。随后删除白名单中的IP段0.0.0.0/0

      image

    • IP段0.0.0.0/0表示允许所有的访问源访问集群,将其设置在集群白名单中存在极大的风险,如非必要,切勿将其添加至白名单。

    • 更多信息,请参见设置白名单设置安全组

完成准备工作后,您就可以连接数据库集群了。

连接数据库集群

连接数据库集群的方法有很多种,您可以根据实际业务需求来选择适合的连接方式。以下列举了部分连接数据库集群的示例:

使用DMS连接集群

DMS是阿里云提供的图形化的数据管理工具,它是一种集数据管理、结构管理、用户授权、安全审计、数据趋势、数据追踪、BI图表、性能与优化和服务器管理于一体的数据管理服务。您无需借助其他工具,即可直接在DMS上管理您的PolarDB集群。

  1. 前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在页面右上角单击登录数据库image

  2. 在弹出的对话框中,输入PolarDB MySQL版集群中创建的数据库账号数据库密码,单击登录image

  3. 登录后,您可以在左侧导航栏的已登录实例中查看到所登录的PolarDB MySQL版集群,并进行相应的管理操作。image

使用客户端连接集群

您可以使用任何通用的客户端连接PolarDB集群。此处以MySQL Workbench 8.0.29版本为例,其它客户端的操作类似。

  1. 安装MySQL Workbench。官方下载地址请参见MySQL Workbench下载页面

  2. 打开MySQL Workbench,选择Database > Connect to Database

  3. 输入连接信息,单击OK

    连接界面

    参数

    说明

    示例

    Hostname

    数据库连接地址

    pc-2***.rwlb.rds.aliyuncs.com

    Port

    数据库连接地址的端口号,与数据库连接地址相对应。

    说明

    默认端口为3306。

    3306

    Username

    数据库账号

    polardb_mysql_user

    Password

    数据库账号密码。

    Pass***233

使用命令行连接集群

如果您的服务器安装了MySQL客户端,可以通过命令行连接PolarDB MySQL版数据库集群。

语法

mysql -h<连接地址> -P<端口> -u<数据库用户名> -p<数据库用户密码>

示例

mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233

参数

说明

示例

-h

数据库连接地址

pc-2***.rwlb.rds.aliyuncs.com

-P

数据库连接地址的端口号,与数据库连接地址相对应。

说明
  • 默认端口为3306。

  • 如果端口号为默认端口,该参数可以不填写。

3306

-u

数据库账号

polardb_mysql_user

-p

数据库账号密码。

说明

该参数为必填参数。

  • 如果不填写该参数,在Enter password后会重新要求输入密码。

  • 如果填写该参数,-p与数据库密码之间不能有空格。

Pass***233

使用应用程序连接集群

连接PolarDB MySQL版集群的方式与连接其他MySQL数据库的方式一样,仅需将数据库连接地址、端口、账号及密码等进行替换即可。以下为您列举部分开发语言如何通过应用程序访问PolarDB数据库:

Java

此处以Maven项目为例,使用MySQL JDBC驱动连接PolarDB MySQL版集群。

  1. 首先,您需要在pom.xml文件中添加MySQL JDBC驱动的依赖,代码示例:

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
  2. 连接集群。请将参数<HOST>、端口号、<USER><PASSWORD><DATABASE><YOUR_TABLE_NAME><YOUR_TABLE_COLUMN_NAME>进行替换。

    import java.sql.Connection;
    import java.sql.DriverManager;
    import java.sql.ResultSet;
    import java.sql.Statement;
    
    public class DatabaseConnection {
       public DatabaseConnection() {
       }
    
       public static void main(String[] args) {
          // PolarDB集群连接地址、端口、需要连接的数据库名
          String url = "jdbc:mysql://<HOST>:3306/<DATABASE>?useSSL=false&serverTimezone=UTC";
          // 数据库账号
          String user = "<USER>";
          // 数据库账号的密码
          String password = "<PASSWORD>";
    
          try {
             Class.forName("com.mysql.cj.jdbc.Driver");
             Connection conn = DriverManager.getConnection(url, user, password);
             Statement stmt = conn.createStatement();
             // 需要检索的数据表名
             ResultSet rs = stmt.executeQuery("SELECT * FROM `<YOUR_TABLE_NAME>`");
    
             while(rs.next()) {
                // 需要检索的数据表的列名
                System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>"));
             }
    
             rs.close();
             stmt.close();
             conn.close();
          } catch (Exception var7) {
             var7.printStackTrace();
          }
    
       }
    }

Python

此处以Python3为例,使用PyMySQL库连接PolarDB MySQL版集群。

  1. 首先,您需要安装PyMySQL库。如果您还没有安装,可以通过以下命令进行安装:

    pip3 install PyMySQL
  2. 连接集群。请将参数<HOST>、端口号、<USER><PASSWORD><DATABASE><YOUR_TABLE_NAME>进行替换。

    import pymysql
    
    # 数据库连接参数
    host = '<HOST>'  # PolarDB集群连接地址
    port = 3306  # 默认端口3306
    user = '<USER>'  # 数据库账号
    password = '<PASSWORD>'  # 数据库账号的密码
    database = '<DATABASE>'  # 需要连接的数据库名
    
    try:
        # 创建数据库连接
        connection = pymysql.connect(
            host=host,
            port=port,
            user=user,
            passwd=password,
            db=database
        )
    
        # 获取操作游标
        with connection.cursor() as cursor:
            # 执行 SQL 查询
            sql = "SELECT * FROM `<YOUR_TABLE_NAME>`"  # 需要检索的数据表名
            cursor.execute(sql)
    
            # 获取查询结果
            results = cursor.fetchall()
            for row in results:
                print(row)
    
    finally:
        # 关闭数据库连接
        if 'connection' in locals() and connection.open:
            connection.close()
    

Go

此处以go1.23.0为例,使用database/sql包和go-sql-driver/mysql驱动来连接PolarDB MySQL版集群。

  1. 首先,您需要安装go-sql-driver/mysql驱动。您可以通过以下命令进行安装:

    go get -u github.com/go-sql-driver/mysql
  2. 连接集群。请将参数<HOST>、端口号、<USER><PASSWORD><DATABASE><YOUR_TABLE_NAME>进行替换。

    package main
    
    import (
        "database/sql"
        "fmt"
        "log"
        _ "github.com/go-sql-driver/mysql"
    )
    
    func main() {
        // 数据库连接参数
        dbHost := "<HOST>"       // PolarDB集群连接地址
        dbPort := "3306"         // 默认端口3306
        dbUser := "<USER>"       // 数据库账号
        dbPass := "<PASSWORD>"   // 数据库账号的密码
        dbName := "<DATABASE>"   // 需要连接的数据库名
    
        // 构建 DSN (Data Source Name)
        dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbUser, dbPass, dbHost, dbPort, dbName)
    
        // 打开数据库连接
        db, err := sql.Open("mysql", dsn)
        if err != nil {
            log.Fatalf("Failed to connect to database: %v", err)
        }
        defer db.Close()
    
        // 测试连接
        err = db.Ping()
        if err != nil {
            log.Fatalf("Failed to ping database: %v", err)
        }
    
        // 创建一个操作游标
        var result string
        err = db.QueryRow("SELECT VERSION()").Scan(&result)
        if err != nil {
            log.Fatalf("Failed to execute query: %v", err)
        }
    
        // 输出数据库版本
        fmt.Printf("Connected to database, version: %s\n", result)
    
        // 执行 SQL 查询
        rows, err := db.Query("SELECT * FROM `<YOUR_TABLE_NAME>`") // 需要检索的数据表名
        if err != nil {
            log.Fatalf("Failed to execute query: %v", err)
        }
        defer rows.Close()
    
        // 处理查询结果
        for rows.Next() {
            var id int
            var name string
            if err := rows.Scan(&id, &name); err != nil {
                log.Fatalf("Failed to scan row: %v", err)
            }
            fmt.Printf("ID: %d, Name: %s\n", id, name)
        }
    
        // 检查是否有错误
        if err := rows.Err(); err != nil {
            log.Fatalf("Error during iteration: %v", err)
        }
    }
    

常见问题

ECS无法连接PolarDB集群

请您按以下步骤进行排查:

  1. 检查PolarDB集群的运行状态是否为运行中

  2. 检查数据库连接地址、端口、账号及密码是否正确。更多信息,请参见获取数据库连接地址

  3. 检查网络因素,您可以在ECS内执行ping 数据库连接地址telnet 数据库连接地址 端口来测试网络连通性。

  4. 若您使用的是私网地址:

    1. 检查ECS与PolarDB集群是否位于同一VPC下。若不在同一VPC下,则无法使用私网地址。您可以使用以下任意一种解决方法使ECS与PolarDB集群位于同一VPC下:

      • 切换ECS所在的VPC。

      • PolarDB集群使用的是默认VPC,可以切换PolarDB集群所在的VPC。更多信息,请参见修改默认VPC和交换机

      • 使用云企业网实现VPC之间的互通。更多信息,请参见同地域VPC互通

    2. 检查ECS的私网IP地址、IP段或安全组是否已添加至PolarDB集群的白名单中。更多信息,请参见设置集群白名单

  5. 若您使用的是公网地址,检查ECS的公网IP地址或安全组是否已添加至PolarDB集群的白名单中。更多信息,请参见设置集群白名单

说明

暂不支持使用虚拟主机和轻量服务器使用私网地址连接PolarDB集群。

本地环境无法连接PolarDB集群

请您按以下步骤进行排查:

  1. 检查PolarDB集群的运行状态是否为运行中

  2. 检查数据库连接地址、端口、账号及密码是否正确。更多信息,请参见获取数据库连接地址

    说明

    数据库连接地址需为公网地址。若您使用的是ECS并与PolarDB集群位于同一VPC下,可以使用私网地址。

  3. 检查网络因素,您可以在本地环境执行ping <数据库连接地址>telnet <数据库连接地址> <端口>来测试网络连通性。

  4. 检查本地环境的公网IP地址或IP段是否已添加至PolarDB集群的白名单中。更多信息,请参见设置集群白名单

    本地环境的公网IP地址获取方法如下:

    • Linux操作系统:打开终端,输入curl ifconfig.me命令后回车。

    • Windows操作系统:打开命令提示符,输入curl ip.me命令后回车。

    • macOS操作系统:打开终端,输入curl ifconfig.me命令后回车。

    若您的本地网络环境存在代理等情况,以上方式获取的IP可能并非您的真实公网IP。您可以将IP段0.0.0.0/0添加至PolarDB集群白名单中,成功连接集群后,执行SHOW PROCESSLIST;命令获取真实公网IP地址,并将其加入到集群白名单中。随后删除白名单中的IP段0.0.0.0/0

    image

无法连接PolarDB集群,报错:Access denied for user 'xxx'@'xxx' (using password: YES)

数据库账号或密码错误,请检查您是否输入正确。您可以前往PolarDB控制台,在配置与管理 > 账号管理中管理数据库账号和密码。

无法连接PolarDB集群,报错:Unknown MySQL server host 'xxx'

数据库连接地址错误,请检查您是否输入正确,正确格式为pc-xxxxxx.rwlb.rds.aliyuncs.com。您可以前往PolarDB控制台,在基本信息 > 数据库连接中管理您的数据库连接地址。

无法连接PolarDB集群,报错:Can't connect to MySQL server on 'xxx'或Connection timed out

可能是您当前环境的公网IP地址或IP段未被添加至PolarDB集群的白名单中,或您填写的公网IP地址或IP段存在错误。

本地环境的公网IP地址获取方法如下:

  • Linux操作系统:打开终端,输入curl ifconfig.me命令后回车。

  • Windows操作系统:打开命令提示符,输入curl ip.me命令后回车。

  • macOS操作系统:打开终端,输入curl ifconfig.me命令后回车。

若您的本地网络环境存在代理等情况,以上方式获取的IP可能并非您的真实公网IP。您可以将IP段0.0.0.0/0添加至PolarDB集群白名单中,成功连接集群后,执行SHOW PROCESSLIST;命令获取真实公网IP地址,并将其加入到集群白名单中。随后删除白名单中的IP段0.0.0.0/0

image

相关文档