搭建一个 TiDB Cloud Serverless 集群
本文档将带你快速上手 TiDB Cloud。你将创建一个 TiDB 集群,连接到该集群,并在其上运行一个示例应用程序。
第 1 步:创建一个 TiDB Cloud Serverless 集群
如果你还没有 TiDB Cloud 账号,请点击这里注册账号。
登录你的 TiDB Cloud 账号。
在 Clusters 页面,点击 Create Cluster。
在 Create Cluster 页面,Starter 默认已选中。如有需要,可修改默认集群名称,并选择你希望创建集群的区域。
点击 Create 创建一个 TiDB Cloud Serverless 集群。
你的 TiDB Cloud 集群将在大约 30 秒内创建完成。
集群创建完成后,点击你的集群名称进入集群概览页面,然后点击右上角的 Connect。此时会弹出连接对话框。
在对话框中,选择你偏好的连接方式和操作系统,以获取对应的连接字符串。本文档以 MySQL 客户端为例。
点击 Generate Password 生成一个随机密码。生成的密码只会显示一次,请妥善保存。如果你没有设置 root 密码,将无法连接到集群。
第 2 步:连接到集群
- 如果未安装 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 步中获取的连接字符串。
mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -D test --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/ssl/cert.pem -p
- 输入密码以登录。
第 3 步:执行 SQL 语句
让我们尝试在 TiDB Cloud 上执行你的第一条 SQL 语句。
SELECT 'Hello TiDB Cloud!';
预期输出:
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
如果你的实际输出与预期输出类似,恭喜你,已经在 TiDB Cloud 上成功执行了一条 SQL 语句。