📣

TiDB Cloud Serverless 现已更名为
Starter
!此页面由 AI 自动翻译,英文原文请见
此处。

搭建一个 TiDB Cloud Serverless 集群

本文档将带你快速上手 TiDB Cloud。你将创建一个 TiDB 集群,连接到该集群,并在其上运行一个示例应用程序。

第 1 步:创建一个 TiDB Cloud Serverless 集群

  1. 如果你还没有 TiDB Cloud 账号,请点击这里注册账号。

  2. 登录你的 TiDB Cloud 账号。

  3. Clusters 页面,点击 Create Cluster

  4. Create Cluster 页面,Starter 默认已选中。如有需要,可修改默认集群名称,并选择你希望创建集群的区域。

  5. 点击 Create 创建一个 TiDB Cloud Serverless 集群。

    你的 TiDB Cloud 集群将在大约 30 秒内创建完成。

  6. 集群创建完成后,点击你的集群名称进入集群概览页面,然后点击右上角的 Connect。此时会弹出连接对话框。

  7. 在对话框中,选择你偏好的连接方式和操作系统,以获取对应的连接字符串。本文档以 MySQL 客户端为例。

  8. 点击 Generate Password 生成一个随机密码。生成的密码只会显示一次,请妥善保存。如果你没有设置 root 密码,将无法连接到集群。

第 2 步:连接到集群

  1. 如果未安装 MySQL 客户端,请选择你的操作系统并按照以下步骤安装。

    对于 macOS,如果尚未安装 Homebrew,请先安装,然后运行以下命令安装 MySQL 客户端:

    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"

    要将 MySQL 客户端添加到 PATH,请在上述输出中找到以下命令(如果你的输出与本文档不一致,请使用你输出中的对应命令)并运行:

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

    然后,通过 source 命令声明全局环境变量,并验证 MySQL 客户端是否安装成功:

    source ~/.zshrc mysql --version

    预期输出示例:

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

    对于 Linux,这里以 Ubuntu 为例:

    apt-get install mysql-client

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

    mysql --version

    预期输出示例:

    mysql Ver 15.1 Distrib 5.5.68-MariaDB, for Linux (x86_64) using readline 5.1
    1. 运行在第 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 语句。

    需要帮助?

    可以在 DiscordSlack 社区提问,或提交支持工单

    文档内容是否有帮助?