使用 TiDB Serverless 构建 TiDB 集群
本文将介绍如何以最快的方式开始使用 TiDB。你将创建并启动一个 TiDB Serverless 集群,使用 TiDB SQL 客户端,插入数据。随后将从示例程序读取出数据。
若你需要在本地计算机上启动 TiDB,请参阅本地启动 TiDB。
第 1 步:创建 TiDB Serverless 集群
如果你还未拥有 TiDB Cloud 账号,请先在此注册。
使用你的 TiDB Cloud 账号登录。
登录后,默认进入 Clusters 页面。
对于新注册的用户,TiDB Cloud 会自动为你创建一个 TiDB Serverless 集群
Cluster0
。你可以使用这个默认集群进行后续操作,也可以自行创建一个新的 TiDB Serverless 集群。如果你想创建一个新的 TiDB Serverless 集群,请进行以下操作:
- 点击 Create Cluster。
- Create Cluster 页面默认选择 Serverless。你可以根据需要修改集群名称、选择可用区,然后点击 Create。你的 TiDB Serverless 集群将于 30 秒后创建完毕。
点击目标集群名称,进入集群概览页面,然后点击右上角的 Connect 按钮,弹出连接对话框。
在对话框中,选择你需要的连接方式和操作系统并保存对应的连接字符串。下面连接到集群的步骤将以 MySQL 客户端为例。
点击 Generate Password 生成随机密码。生成的密码不会再次显示,因此请将密码妥善保存。如果没有设置 root 密码,你将无法连接到集群。
第 2 步:连接到集群
若未安装 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运行第 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 语句。