本文将为您详细介绍如何快速使用PolarDB MySQL版,包括创建集群、配置白名单、创建数据库账号以及连接数据库等相关操作。
使用教程
若您在以下任何步骤中存在疑问,请点击相应步骤以查看详细说明。
1. 创建集群
您可以前往PolarDB的快速购买页面,通过少量配置即可快速创建PolarDB MySQL版集群。配置参数如下,其他设置可保持默认。详细创建集群过程,请参见购买企业版集群或购买标准版集群。
配置项 | 说明 |
计费类型 | 选择集群的计费类型。更多信息,请参见计费类型。
|
地域 | 选择集群的所在地域。 说明 请确保PolarDB与需要连接的ECS位于同一个地域,否则它们内网无法直接互通。 |
数据库引擎 | 选择集群的数据库引擎。
说明 快速购买仅支持购买MySQL 8.0版本。若您需要购买其他MySQL版本,请在左上角选择自定义购买页签。 |
产品版本 | 选择集群的产品版本。
说明
|
网络类型 | 配置集群的VPC网络和交换机。 说明
|
部署模式(可选) | 选择集群的节点个数以及高可用模式。更多信息,请参见高可用模式(热备集群)。
说明 仅当计费类型为包年包月或按量付费时,才需选择集群的高可用模式。 |
节点规格 | 选择集群的计算节点规格。您可以根据实际需求选择,若您需要购买其他规格,请在左上角选择自定义购买页签。 |
存储空间(可选) | 配置集群的存储空间大小。 说明 仅当计费类型为包年包月或按量付费,且产品版本为标准版时,才需配置集群的存储空间大小。 |
2. 配置白名单
您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在配置与管理 > 集群白名单中添加IP白名单或安全组。更多信息,请参见设置白名单与设置安全组。
如果您是使用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
。IP段
0.0.0.0/0
表示允许所有的访问源访问集群,将其设置在集群白名单中存在极大的风险,如非必要,切勿将其添加至白名单。
3. 创建数据库账号
您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在配置与管理 > 账号管理中创建数据库账号。更多信息,请参见创建和管理数据库账号。
数据库账号类型分为高权限账号和普通账号,这两种账号的权限存在差异。您可以根据实际业务需求选择创建相应的数据库账号。更多信息,请参见账号权限。
4. 获取集群地址
您可以前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在数据库连接中获取数据连接地址。更多信息,请参见管理连接地址。
推荐使用集群地址,默认端口号为3306。
请根据您的访问环境选择私网或公网。
如果您是使用ECS访问PolarDB,并且ECS与PolarDB位于同一VPC内,请选择私网。
如果您是在本地环境中访问PolarDB,请选择公网。公网地址单击右侧申请即可。
公网即因特网,通过公网访问将无法实现PolarDB集群的最佳性能。
暂不支持使用虚拟主机和轻量服务器使用私网地址连接PolarDB集群。
5. 连接数据库
连接数据库集群的方法有很多种,您可以根据实际业务需求来选择适合的连接方式。以下列举了部分连接数据库集群的示例:
使用DMS连接集群
DMS是阿里云提供的图形化的数据管理工具,它是一种集数据管理、结构管理、用户授权、安全审计、数据趋势、数据追踪、BI图表、性能与优化和服务器管理于一体的数据管理服务。您无需借助其他工具,即可直接在DMS上管理您的PolarDB集群。
前往PolarDB控制台,在集群列表中单击目标集群ID进入集群详情页。在页面右上角单击登录数据库。
在弹出的对话框中,输入PolarDB MySQL版集群中创建的数据库账号和数据库密码,单击登录。
登录后,您可以在左侧导航栏的已登录实例中查看到所登录的PolarDB MySQL版集群,并进行相应的管理操作。
使用客户端连接集群
您可以使用任何通用的客户端连接PolarDB集群。此处以MySQL Workbench 8.0.29版本为例,其它客户端的操作类似。
安装MySQL Workbench。官方下载地址请参见MySQL Workbench下载页面。
打开MySQL Workbench,选择Database > Connect to Database。
输入连接信息,单击OK。
使用命令行连接集群
如果您的服务器安装了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 |
-u | polardb_mysql_user | |
-p | 数据库账号密码。 说明 该参数为必填参数。
| Pass***233 |
使用应用程序连接集群
连接PolarDB MySQL版集群的方式与连接其他MySQL数据库的方式一样,仅需将数据库连接地址、端口、账号及密码等进行替换即可。以下为您列举部分开发语言如何通过应用程序访问PolarDB数据库:
Java
此处以Maven项目为例,使用MySQL JDBC驱动连接PolarDB MySQL版集群。
首先,您需要在pom.xml文件中添加MySQL JDBC驱动的依赖,代码示例:
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency>
连接集群。请将参数
<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版集群。
首先,您需要安装PyMySQL库。如果您还没有安装,可以通过以下命令进行安装:
pip3 install PyMySQL
连接集群。请将参数
<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版集群。
首先,您需要安装
go-sql-driver/mysql
驱动。您可以通过以下命令进行安装:go get -u github.com/go-sql-driver/mysql
连接集群。请将参数
<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) } }