本文将帮助您快速了解如何使用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个字符。
    • 需以字母开头，以字母或数字结尾。
    • 不能和已有的数据库名称重复。
    支持字符集 您可以选择字符集为utf8、gbk、latin1或utf8mb4。
    授权账号 选中需要访问本数据库的目标账号。
    说明
    • 可选的授权账号全部为普通账号，因为高权限账号拥有所有数据库的所有权限，不需要授权。
    • 若您还未创建任何账号，可以单击创建新账号进行创建，具体操作步骤请参见创建账号。
    账号权限 选择目标账号需要的权限，可选权限范围为读写、只读、仅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资源。