本文将帮助您快速了解如何使用PolarDB-X 2.0

前提条件

您需要先注册和登录阿里云账号,详情请参见注册和登录阿里云账号

使用流程

通常,从购买PolarDB-X 2.0实例到可以使用,您需要完成下面三个步骤。

步骤一:购买实例

  1. 登录云原生分布式数据库控制台
  2. 在页面左上角选择目标实例所在地域。
  3. 实例列表页,单击PolarDB-X 2.0页签。
    说明 目前PolarDB-X 2.0实例仅支持华东1(杭州)和华北2(北京)地域。
  4. 单击页面右上角创建新实例
  5. 在购买页面,设置如下参数。
    选项 说明
    商品类型 您可以选择商品类型为包年包月按量付费
    说明
    • 包年包月为预付费模式,用于长期生产环境稳定使用,单位价格比按量付费便宜。
    • 按量付费为后付费模式,通常用于测试或学习了解。
    • 若您需要创建按量付费的实例,请确保您的阿里云账户余额大于等于100元。
    地域和可用区 通过选择地域和可用区配置实例所在的物理位置。
    说明 目前PolarDB-X 2.0实例仅支持华东1(杭州)和华北2(北京)地域。
    网络类型 固定为专有网络,不可变更。
    说明 配置专有网络前,您需要提前准备相应地域和可用区内的专有网络和虚拟交换机,详情请参见创建专有网络
    MySQL版本 版本固定为MySQL 5.7,不可变更。
    节点规格 PolarDB-X 2.0 按照节点规格x节点个数的方式售卖,您可以通过选择规格配置实例物理规格CPU核数和内存大小,详情请参见实例规格
    说明 PolarDB-X 2.0里的计算层节点和存储层节点都使用相同的节点规格。
    节点个数 选择目标规格节点的节点个数。
    说明 节点个数取值范围为2~99。
    存储类型 固定为本地SSD盘,不可变更。
    存储费用 每个节点存储空间默认为5TB,您购买时无需选择容量,根据实际使用按小时计费。
    购买时长 选择实例购买的时长。
    说明 仅当商品类型为包年包月时支持该配置。
    购买数量 选择需要购买的实例数量。
  6. 选中服务协议,单击立即购买
  7. 支付页面,确认待支付订单和支付方式,单击支付
  8. 支付成功后,请耐心等待10~15分钟开通服务。之后您可以返回控制台的实例列表页,查看新创建的实例。

步骤二:创建数据库

  1. 登录云原生分布式数据库控制台
  2. 在页面左上角选择目标实例所在地域。
  3. 实例列表页,单击PolarDB-X 2.0页签。
    说明 目前PolarDB-X 2.0实例仅支持华东1(杭州)和华北2(北京)地域。
  4. 找到目标实例,单击实例ID。
  5. 在左侧导航栏中,单击配置与管理 > 数据库管理
  6. 数据库管理页面左上角,单击创建数据库
  7. 在弹出的对话框中,设置如下参数。
    参数 说明
    数据库(DB)名称 填写数据库名称。
    说明 数据库名称需满足如下要求:
    • 由小写字母、数字、下划线(_)或中划线(-)组成,长度需为2~16个字符。
    • 需以字母开头,以字母或数字结尾。
    • 不能和已有的数据库名称重复。
    支持字符集 您可以选择字符集为utf8gbklatin1utf8mb4
    授权账号 选中需要访问本数据库的目标账号。
    说明
    • 可选的授权账号全部为普通账号,因为高权限账号拥有所有数据库的所有权限,不需要授权。
    • 若您还未创建任何账号,可以单击创建新账号进行创建,具体操作步骤请参见创建账号
    账号权限 选择目标账号需要的权限,可选权限范围为读写只读仅DDL只DML只读+索引
    备注说明 备注该数据库的相关信息,便于后续数据库管理。该参数为非必填项,最多支持256个字符。
  8. 单击确定

步骤三:连接数据库

  1. 登录云原生分布式数据库控制台
  2. 在页面左上角选择目标实例所在地域。
  3. 实例列表页,单击PolarDB-X 2.0页签。
    说明 目前PolarDB-X 2.0实例仅支持华东1(杭州)和华北2(北京)地域。
  4. 找到目标实例,单击实例ID。
  5. 基本信息页的连接信息区域,找到内外网地址和端口信息。
    说明 如果您需要通外网地址进行访问试用,请使用外网地址外网端口进行连接。为确保数据库安全,建议您正式访问时使用内网连接地址。
  6. 获取连接信息后,您可以通过如下任意一种方式连接数据库:
    • 如果您的服务器安装了MySQL客户端,您可以通过如下MySQL命令行进行连接:
      mysql -h<连接地址> -P<端口> -u<用户名> -p -D<数据库名称>
      选项 说明 示例
      -h PolarDB-X 2.0实例的内网连接地址或外网连接地址。 pxc-******************.public.polarx.rds.aliyuncs.com
      -P PolarDB-X 2.0实例的端口号。
      • 若使用内网连接,需输入PolarDB-X 2.0实例的内网端口。
      • 若使用外网连接,需输入PolarDB-X 2.0实例的外网端口。
      说明
      • 此处-P为大写字母。
      • 默认端口为3306。
      3306
      -u PolarDB-X 2.0实例中的账号名称。关于如何创建账号,请参见创建账号 testuser
      -p 以上账号的密码。
      说明
      • 为保障密码安全,-p后请不要填写密码,会在执行整行命令后提示您输入密码,输入后按回车即可登录。
      • 如果填写该参数,-p与密码之间不能有空格。
      passWord123
      -D 需要登录的数据库名称。
      说明
      • 该参数非必填参数。
      • 可以不输入-D仅输入数据库名称。
      mysql
    • PolarDB-X 2.0支持通过如下第三方客户端进行连接,您可以去对应的官方网站下载客户端。
      • MySQL Workbench(推荐)
      • SQLyog
      • Sequel Pro
      • Navicat for MySQL
      说明 第三方GUI客户端可执行基础的数据库操作,包括数据的增删改查和DDL操作,对于工具高级特性,PolarDB-X 2.0可能并不支持。
    • PolarDB-X 2.0支持通过如下符合MySQL官方交互协议的第三方程序代码进行连接:
      • JDBC Driver for MySQL (Connector/J)
      • Python Driver for MySQL (Connector/Python)
      • C++ Driver for MySQL (Connector/C++)
      • C Driver for MySQL (Connector/C)
      • ADO.NET Driver for MySQL (Connector/NET)
      • ODBC Driver for MySQL (Connector/ODBC)
      • PHP Drivers for MySQL (mysqli, ext/mysqli, PDO_MYSQL, PHP_MYSQLND)
      • Perl Driver for MySQL (DBD::mysql)
      • Ruby Driver for MySQL (ruby-mysql)

连接示例

  • JDBC Driver for MySQL (Connector/J)程序代码示例。
    //JDBC
    Class.forName("com.mysql.jdbc.Driver"); 
    Connection conn = DriverManager.getConnection("jdbc:mysql://pxc-******************.public.polarx.rds.aliyuncs.com:3306/doc_test","doc_test","doc_test_password");
    //...
    conn.close();    
  • 应用端连接池配置示例。
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> 
    <property name="url" value="jdbc:mysql://pxc-******************.public.polarx.rds.aliyuncs.com:3306/doc_test" />
    <property name="username" value="doc_test" />
    <property name="password" value="doc_test_password" />
    <property name="filters" value="stat" />
    <property name="maxActive" value="100" />
    <property name="initialSize" value="20" />
    <property name="maxWait" value="60000" />
    <property name="minIdle" value="1" />
    <property name="timeBetweenEvictionRunsMillis" value="60000" />
    <property name="minEvictableIdleTimeMillis" value="300000" />
    <property name="testWhileIdle" value="true" />
    <property name="testOnBorrow" value="false" />
    <property name="testOnReturn" value="false" />
    <property name="poolPreparedStatements" value="true" />
    <property name="maxOpenPreparedStatements" value="20" />
    <property name="asyncInit" value="true" />
    </bean>
    说明 推荐使用Druid连接池连接PolarDB-X 2.0,关于Druid的详细信息请参见Druid Github资源