快速入门

使用流程

通常，从购买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 1.0 私有定制RDS与计算资源DRDS配合更加紧密，可以获得更优秀的性能表现和更稳定的服务链路，推荐您选择 RDS MySQL存储类型。
   实例系列	您可以选择不同系列对应不同业务场景，生产环境在线业务建议选择标准版或企业版，详情请参见实例规格。
   实例规格	通过选择规格配置实例物理规格CPU核数和内存大小，详情请参见实例规格。
   购买数量	选择需要购买的实例数量。
   购买时长	选择实例购买的时长。 说明 仅当付费方式为 包年包月支持该配置。

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

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

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

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

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

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

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

   参数	说明
   拆分模式	选择垂直拆分。 说明 您可以批量导入不同私有定制RDS实例上已有的多个数据库，利用PolarDB-X 1.0实例级账号进行统一授权管理，通过一个PolarDB-X 1.0链接即可完成横跨多个私有定制RDS实例数据库间的联合查询及事务写入操作。 使用垂直拆分前，请确保您已通过配置水平拆分完成私有定制RDS实例的购买。
   存储类型	此处的存储类型默认与创建PolarDB-X 1.0计算资源DRDS实例时选择的存储类型保持一致。例如您在创建PolarDB-X 1.0计算资源DRDS实例时选择了RDS MySQL，则此处的存储类型即固定为RDS 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连接池连接 PolarDB-X 1.0，关于Druid的详细信息请参见 Druid Github资源。