我的书签
添加书签
移除书签使用 TiDB Cloud (Serverless Tier) 构建 TiDB 集群
本章节将介绍以最快的方式开始使用 TiDB。你将使用 TiDB Cloud 创建并启动一个免费的 TiDB 集群，使用 TiDB SQL 客户端，插入数据。随后将从示例程序读取出数据。
若你需要在本地计算机上启动 TiDB，请参阅本地启动 TiDB。
第 1 步：创建免费集群
- 如果你还未拥有 TiDB Cloud 帐号，请先在此注册。
- 使用你的 TiDB Cloud 帐号登录。
- 在方案内选择免费的 Serverless Tier 方案，或在 Clusters 页面中点击 Create Cluster 按钮。
- 在 Create Cluster 页面设置集群名称、云服务商（Serverless Tier 默认为 AWS）、可用区（建议就近选择）后，点击 Create 按钮创建 Serverless Tier 免费集群。
- 在 Security Settings 对话框中，设置密码，并添加允许连接你的集群的 IP 地址，完成后点击 Apply。
你的 TiDB Cloud 集群将于 30 秒后创建完毕。 6. 创建完毕后，点击右上角的 Connect 按钮。或点击集群名称，打开集群的详情页，再点击右上角的 Connect 按钮。这将显示一个连接对话框。 7. 复制连接对话框 Step 2: Connect with a SQL client 中的连接字符串，供后续步骤使用。
Note:
需要特别说明的是，在你使用 Serverless Tier clusters 集群时，你需要给你设置的用户名加上前缀（如上图中的
9ATyn6DhCXoo6U1），若使用命令行连接，还需使用单引号包裹用户名。你可以在 TiDB Cloud - 用户名前缀 中获得更多信息。
第 2 步：连接到集群
- 若未安装 MySQL 客户端，请选择自己的操作系统，按以下步骤安装。
对于 macOS 操作系统，如果你没有安装 Homebrew，请参考 Homebrew 官网进行安装。
shell
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"
请运行其中的此行（命令行输出若与此处文档不一致，请以命令行输出为准）：
shell
echo 'export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"' >> ~/.zshrc
完成后，生效该配置文件（例如 ~/.zshrc），并验证 MySQL 客户端是否安装成功：
shell
source ~/.zshrc
mysql --version
预期会得到形如以下的输出：
mysql Ver 8.0.28 for macos12.0 on arm64 (Homebrew)
对于 Linux 操作系统，下面以 CentOS 7 为例：
shell
yum install mysql
完成后，请验证 MySQL 客户端是否安装成功：
shell
mysql --version
预期会得到形如以下的输出：
mysql Ver 15.1 Distrib 5.5.68-MariaDB, for Linux (x86_64) using readline 5.1
2. 运行第 1 步中得到的连接字符串。
1. mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -p
3. 填写密码，完成登录。
第 3 步：运行示例应用程序
- 克隆 tidb-example-java 项目。
1. git clone https://github.com/pingcap-inc/tidb-example-java.git
2. 更改连接参数。
对于非本地默认集群、TiDB Cloud 或其他远程集群，需要更改 plain-java-jdbc/src/main/java/com/pingcap/JDBCExample.java 内关于 Host、Port、User、Password 的参数：
1. mysqlDataSource.setServerName("localhost");
2. mysqlDataSource.setPortNumber(4000);
3. mysqlDataSource.setDatabaseName("test");
4. mysqlDataSource.setUser("<prefix>.root");
5. mysqlDataSource.setPassword("");
若你设定的密码为 123456，而且从 TiDB Cloud 得到的连接字符串为：
1. mysql --connect-timeout 15 -u '9ATyn6DhCXoo6U1.root' -h xxx.tidbcloud.com -P 4000 -D test -p
那么此处应将参数更改为：
1. mysqlDataSource.setServerName("tidb.e049234d.d40d1f8b.us-east-1.prod.aws.tidbcloud.com");
2. mysqlDataSource.setPortNumber(4000);
3. mysqlDataSource.setDatabaseName("test");
4. mysqlDataSource.setUser("9ATyn6DhCXoo6U1.root");
5. mysqlDataSource.setPassword("123456");
3. 运行 make plain-java-jdbc。
输出应如预期所示
