使用 TiDB Cloud (Serverless Tier) 构建 TiDB 集群

本章节将介绍以最快的方式开始使用 TiDB。你将使用 TiDB Cloud 创建并启动一个免费的 TiDB 集群，使用 TiDB SQL 客户端，插入数据。随后将从示例程序读取出数据。

若你需要在本地计算机上启动 TiDB，请参阅本地启动 TiDB。

第 1 步：创建免费集群

  1. 如果你还未拥有 TiDB Cloud 帐号，请先在此注册。
  2. 使用你的 TiDB Cloud 帐号登录。
  3. 在方案内选择免费的 Serverless Tier 方案，或在 Clusters 页面中点击 Create Cluster 按钮。
  4. 在 Create Cluster 页面设置集群名称、云服务商（Serverless Tier 默认为 AWS）、可用区（建议就近选择）后，点击 Create 按钮创建 Serverless Tier 免费集群。

  5. 在 Security Settings 对话框中，设置密码，并添加允许连接你的集群的 IP 地址，完成后点击 Apply。

    你的 TiDB Cloud 集群将于 30 秒后创建完毕。

  6. 创建完毕后，点击右上角的 Connect 按钮。或点击集群名称，打开集群的详情页，再点击右上角的 Connect 按钮。这将显示一个连接对话框。

  7. 复制连接对话框 Step 2: Connect with a SQL client 中的连接字符串，供后续步骤使用。

    Note:

    需要特别说明的是，在你使用 Serverless Tier clusters 集群时，你需要给你设置的用户名加上前缀（如上图中的 9ATyn6DhCXoo6U1），若使用命令行连接，还需使用单引号包裹用户名。你可以在 TiDB Cloud - 用户名前缀 中获得更多信息。

第 2 步：连接到集群

  1. 若未安装 MySQL 客户端，请选择自己的操作系统，按以下步骤安装。

    对于 macOS 操作系统，如果你没有安装 Homebrew，请参考 Homebrew 官网进行安装。 shell brew install mysql-client 在安装完成的命令行输出中，得到以下信息： mysql-client is keg-only, which means it was not symlinked into /opt/homebrew, because it conflicts with mysql (which contains client libraries). If you need to have mysql-client first in your PATH, run: echo 'export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"' >> ~/.zshrc For compilers to find mysql-client you may need to set: export LDFLAGS="-L/opt/homebrew/opt/mysql-client/lib" export CPPFLAGS="-I/opt/homebrew/opt/mysql-client/include" 请运行其中的此行（命令行输出若与此处文档不一致，请以命令行输出为准）： shell echo 'export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"' >> ~/.zshrc 完成后，生效该配置文件（例如 ~/.zshrc），并验证 MySQL 客户端是否安装成功： shell source ~/.zshrc mysql --version 预期会得到形如以下的输出： mysql Ver 8.0.28 for macos12.0 on arm64 (Homebrew)
    对于 Linux 操作系统，下面以 CentOS 7 为例： shell yum install mysql 完成后，请验证 MySQL 客户端是否安装成功： shell mysql --version 预期会得到形如以下的输出： mysql Ver 15.1 Distrib 5.5.68-MariaDB, for Linux (x86_64) using readline 5.1

  2. 运行第 1 步中得到的连接字符串。

    1.  mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -p

  3. 填写密码，完成登录。

第 3 步：运行示例应用程序

  1. 克隆 tidb-example-java 项目。

    1.  git clone https://github.com/pingcap-inc/tidb-example-java.git

  2. 更改连接参数。

    对于非本地默认集群、TiDB Cloud 或其他远程集群，需要更改 plain-java-jdbc/src/main/java/com/pingcap/JDBCExample.java 内关于 Host、Port、User、Password 的参数：

    1.  mysqlDataSource.setServerName("localhost");
    2.  mysqlDataSource.setPortNumber(4000);
    3.  mysqlDataSource.setDatabaseName("test");
    4.  mysqlDataSource.setUser("<prefix>.root");
    5.  mysqlDataSource.setPassword("");

    若你设定的密码为 123456，而且从 TiDB Cloud 得到的连接字符串为：

    1.  mysql --connect-timeout 15 -u '9ATyn6DhCXoo6U1.root' -h xxx.tidbcloud.com -P 4000 -D test -p

    那么此处应将参数更改为：

    1.  mysqlDataSource.setServerName("tidb.e049234d.d40d1f8b.us-east-1.prod.aws.tidbcloud.com");
    2.  mysqlDataSource.setPortNumber(4000);
    3.  mysqlDataSource.setDatabaseName("test");
    4.  mysqlDataSource.setUser("9ATyn6DhCXoo6U1.root");
    5.  mysqlDataSource.setPassword("123456");

  3. 运行 make plain-java-jdbc。

    输出应如预期所示