构建一个 TiDB Cloud Serverless 集群
本文将引导你以最快的方式开始使用 TiDB Cloud。你将创建一个 TiDB 集群,连接到它,并在其上运行示例应用。
第 1 步:创建一个 TiDB Cloud Serverless 集群
如果你还没有 TiDB Cloud 账号,请点击 这里 注册一个账号。
登录 到你的 TiDB Cloud 账号。
在 Clusters 页面,点击 Create Cluster。
在 Create Cluster 页面,默认已选择 Serverless。如有需要,更新默认的集群名称,然后选择你想要创建集群的区域。
点击 Create 创建一个 TiDB Cloud Serverless 集群。
你的 TiDB Cloud 集群大约会在 30 秒内创建完成。
集群创建完成后,点击你的集群名称进入集群概览页面,然后在右上角点击 Connect。会显示一个连接对话框。
在对话框中,选择你偏好的连接方式和操作系统,以获取相应的连接字符串。本文以 MySQL 客户端为例。
点击 Generate Password 生成一个随机密码。生成的密码不会再次显示,请将密码保存到安全的位置。如果你没有设置 root 密码,将无法连接到集群。
第 2 步:连接到集群
- 如果未安装 MySQL 客户端,请选择你的操作系统,并按照以下步骤安装。
- macOS
- Linux
对于 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 语句。