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

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

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

第 1 步:创建 Serverless Tier 集群

  1. 如果你还未拥有 TiDB Cloud 帐号,请先在此注册

  2. 使用你的 TiDB Cloud 帐号登录

  3. Clusters 页面中点击 Create Cluster 按钮。

  4. Create Cluster 页面默认选择 Serverless Tier。你可以根据需要修改集群名称并选择可用区。

  5. 点击 Create 创建 Serverless Tier 集群。

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

  6. 集群创建完毕后,点击右上角的 ... 按钮,在下拉框中选择 Security Settings。在对话框中设置连接集群的 root 密码,完成后点击 Apply。如果没有设置 root 密码,你将无法连接集群。

  7. 点击 Connect 按钮,在连接对话框中选择你需要的连接方式和操作系统并保存对应的连接字符串。下面连接到集群的步骤将以 MySQL 客户端为例。

第 2 步:连接到集群

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

    • macOS
    • Linux

    对于 macOS 操作系统,如果你没有安装 Homebrew,请参考 Homebrew 官网进行安装。

    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"

    请运行其中的此行(命令行输出若与此处文档不一致,请以命令行输出为准):

    echo 'export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"' >> ~/.zshrc

    完成后,生效该配置文件(例如 ~/.zshrc),并验证 MySQL 客户端是否安装成功:

    source ~/.zshrc mysql --version

    预期会得到形如以下的输出:

    mysql Ver 8.0.28 for macos12.0 on arm64 (Homebrew)

    对于 Linux 操作系统,下面以 CentOS 7 为例:

    yum install mysql

    完成后,请验证 MySQL 客户端是否安装成功:

    mysql --version

    预期会得到形如以下的输出:

    mysql Ver 15.1 Distrib 5.5.68-MariaDB, for Linux (x86_64) using readline 5.1
  2. 运行第 1 步中得到的连接字符串。

    mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -D test --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/ssl/cert.pem -p
  1. 填写密码,完成登录。

第 3 步:运行 SQL

尝试运行一下你在 TiDB Cloud 上的的第一个 SQL 吧:

SELECT 'Hello TiDB Cloud!';

你将看到这样的输出:

+-------------------+ | Hello TiDB Cloud! | +-------------------+ | Hello TiDB Cloud! | +-------------------+

如果你的实际输出与预期输出一致,表示你已经在 TiDB Cloud 上成功地运行了 SQL 语句。