快速入门

使用流程

通常，从购买PolarDB-X 1.0实例到可以使用，您需要完成如下操作。

• 步骤一：购买PolarDB-X 1.0计算层资源创建实例
• 步骤二：在私有定制RDS实例之上构建PolarDB-X 1.0数据库
• 步骤三：连接PolarDB-X 1.0数据库并进行SQL操作

步骤一：购买PolarDB-X 1.0计算层资源创建实例

1. 登录阿里云主页。
2. 将鼠标依次移动到产品分类>数据库，单击云原生分布式数据库PolarDB-X（原DRDS升级版）进入产品主页。
3. 在产品主页上，单击新用户首购99元。
   
4. 在购买页面，设置如下参数。

   选项	说明
   商品类型	您可以选择商品类型为包年包月或按量付费。 说明 按量付费为后付费模式，通常用于测试或学习了解。 包年包月为预付费模式，用于长期生产环境稳定使用，单位价格比按量付费便宜。
   地域和可用区	通过选择地域和可用区配置实例所在的物理位置。
   实例类型	固定为专享实例，不可变更。
   实例网络类型	您可以选择网络类型为经典网络或专有网络。 说明 若您选择配置专有网络，您需要提前准备相应地域和可用区内的专有网络和虚拟交换机，详情请参见创建专有网络。
   MySQL版本	您可以选择MySQL 8版本（与 MySQL 8.0 完全兼容）或MySQL 5版本（与MySQL 5.x完全兼容）。 说明 实例创建后，如需变更MySQL版本，可提交工单联系售后服务进行变更。
   存储类型	存储类型包括RDS MySQL（即私有定制RDS）或POLARDB（即PolarDB MySQL）。 说明 PolarDB-X私有定制RDS与计算资源DRDS配合更加紧密，可以获得更优秀的性能表现和更稳定的服务链路，推荐您选择RDS MySQL存储类型。
   实例系列	您可以选择不同系列对应不同业务场景，生产环境在线业务建议选择标准版或企业版，详情请参见实例规格。
   实例规格	通过选择规格配置实例物理规格CPU核数和内存大小，详情请参见实例规格。
   购买数量	选择需要购买的实例数量。
   购买时长	选择实例购买的时长。 说明 仅当付费方式为包年包月支持该配置。

5. 单击立即购买。
6. 在确认订单页面，确认实例配置参数和服务协议后，单击去支付。
7. 在支付页面确认待支付订单，单击订购。
8. 支付成功后，一般需要1~5分钟开通服务。之后您可以返回控制台的实例列表页查看新创建的实例。

步骤二：在私有定制RDS实例之上构建PolarDB-X 1.0数据库

1. 登录云原生分布式数据库控制台。
2. 在页面左上角选择目标实例所在地域。
3. 在左侧导航栏中，单击实例列表。
4. 找到目标实例，单击实例ID，进入目标实例基本信息页。
5. 在实例基本信息页，单击右上角创建数据库。
6. 在弹出的对话框中，根据您的需要选择拆分模式并设置相应参数。
   • 若您选择拆分模式为水平拆分，请参见如下步骤。
     1. 在填写基本信息页，设置如下参数后，单击下一步。

        参数	说明
        拆分模式	选择水平拆分。 说明 DRDS可以将数据按照拆分规则分拆到多个库表中。通过水平拆分，实现数据库的横向扩展，可线性提升数据库整体的存储容量以及并发吞吐。
        存储类型	固定为RDS for MySQL ，不可变更。
        数据库名	输入数据库名称。 说明 数据库名称需满足如下要求： 由小写字母、数字和下划线（_）组成。 以字母开头，且长度不超过24字符。
        字符集	您可以选择字符集为uft8、gbk、latin1或uft8mb4。
        链接密码	输入数据库链接密码。 说明 链接密码需满足如下要求： 密码长度需为8~30个字符。 需至少包含大写字母、小写字母、数字、下划线（_）中的任意三种。
        确认密码	再次输入数据库链接密码进行确认。

     2. 在选择RDS页，设置如下参数。
        • 若您还未购买任何私有定制RDS，请单击购买新私有定制RDS并参见如下步骤完成购买。
          1. 选择购买PolarDB-X存储层-私有定制RDS（包年包月）或PolarDB-X存储层-私有定制RDS（按量付费），并设置如下参数：

             选项	说明
             地域和可用区	通过选择地域和可用区配置实例所在的物理位置。 说明 其中地域取值固定为华东1（杭州），无需选择。
             MySQL版本	固定为MySQL 8版本，无需选择。
             系列	您可以选择高可用或三节点企业版。
             存储类型	固定为本地SSD盘，无需选择。
             网络类型	固定为经典网络，无需选择。
             规格	通过选择规格配置实例物理规格CPU核数和内存大小。
             存储空间	选择需要购买的存储空间大小。
             购买数量	选择需要购买的实例数量。
             购买时长	选择实例购买的时长以及是否开启自动续费。 说明 仅当选择购买PolarDB-X存储层-私有定制RDS（包年包月）时，支持该参数。

          2. 单击立即购买。
          3. 在确认订单页面，确认商品信息并选中服务协议，单击去开通。
          4. 开通成功后页面会自动跳转至预检页面。
        • 若您已经购买了私有定制RDS，您可以参考如下步骤。
          1. 单击使用已购私有定制RDS。
          2. 选中目标RDS实例，单击图标将其从左侧待选框移动到右侧已选框中。
          3. 单击下一步，进入预检页面。
   • 若您选择拆分模式为垂直拆分，请设置如下参数后，单击下一步。

   参数	说明
   拆分模式	选择垂直拆分。 说明 您可以批量导入不同RDS MySQL实例上已有的多个数据库，利用DRDS实例级账号进行统一授权管理，通过一个DRDS链接即可完成横跨多个RDS实例数据库间的联合查询及事务写入操作。 使用垂直拆分前，请确保您已通过配置水平拆分完成私有定制RDS实例的购买。
   存储类型	固定为RDS for MySQL ，不可变更。
   添加数据库	在RDS实例待选框中选中目标RDS实例。 从目标RDS实例已有的数据库中选中目标数据库，单击将其移动到右边已选框。
   字符集	您可以选择字符集为uft8、gbk、latin1或uft8mb4。
   账号类型	您可以创建新账号或选择已有账号。
   数据库账号	输入需要创建的新账号名称。 说明 仅当账号类型选择创建新账号时支持该参数。
   链接密码	输入数据库链接密码。 说明 链接密码需满足如下要求： 密码长度需为8~30个字符。 需至少包含大写字母、小写字母、数字、下划线（_）中的任意三种。
   确认密码	再次输入数据库链接密码进行确认。 说明 仅当选择账号类型为创建新账号时支持该参数。

7. 在预检页面，等待预检结果显示为成功，单击下一步。
8. 在建库预览页面确认建库信息，单击下一步完成数据库创建。
   说明 PolarDB-X 1.0默认会在每个存储RDS实例上创建8个物理库，总物理分库数量为选择的RDS实例数量的8倍。
9. 创建完成之后，在数据库管理页面，您可以查看已添加的数据库，您还可以在账号管理中看到垂直拆分时新建的账号。

步骤三：连接PolarDB-X 1.0数据库并进行SQL操作

1. 登录云原生分布式数据库控制台。
2. 在页面左上角选择目标实例所在地域。
3. 在左侧导航栏中，单击实例列表。
4. 找到目标实例，单击实例ID。
5. 在左侧导航栏中，单击数据库管理。
6. 在数据库列表页，找到目标数据库，单击数据库ID，进入数据库基本信息页。
7. 在内网地址区域，找到命令行链接地址，获取由ip(domain)、port、dbname和user组成的连接信息。
   

   说明 如果您需要通过临时开通公网地址进行访问试用，请参见外网访问。为确保数据库安全，建议您正式访问时关闭公网连接地址。
8. 获取连接信息后，您可以通过如下方式进行连接。
   • 如果您的服务器安装了MySQL，您可以通过如下MySQL命令行连接PolarDB-X 1.0数据库。

     //MySQL 命令行连接
     mysql -h${DRDS_IP_ADDRESS} -P${DRDS_PORT} -u${user} -p${password} -D${DRDS_DBNAME}

   • PolarDB-X 1.0支持通过如下第三方客户端进行连接，您可以去对应的官方网站下载客户端。
     • MySQL Workbench（推荐）
     • SQLyog
     • Sequel Pro
     • Navicat for MySQL
     说明 第三方GUI客户端可执行基础的数据库操作，包括数据的增删改查和DDL操作，对于工具高级特性，PolarDB-X 1.0可能并不支持。
   • PolarDB-X 1.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://drdsxxxxx.drds.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://drdsxxxxx.drds.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连接池连接，关于Druid的详细信息请参考Druid Github资源。