PingKai Logo下载
搜索

构建平凯数据库云服务 Starter 集群

本文档将带你快速上手平凯数据库云服务。你将创建一个 TiDB 集群，连接到它，并在其上运行一个示例应用程序。

第 1 步. 创建平凯数据库云服务 Starter 集群

  1. 如果你还没有平凯数据库云服务账号，请点击这里注册账号。

  2. 登录你的平凯数据库云服务账号。

  3. 在 Clusters 页面，点击 Create Cluster。

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

  5. 点击 Create 创建平凯数据库云服务 Starter 集群。

    你的平凯数据库云服务集群将在大约 30 秒内创建完成。

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

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

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

注意

对于 平凯数据库云服务 Starter 集群，连接集群时，必须在用户名中包含集群的前缀，并用引号包裹用户名。更多信息请参见 用户名前缀。

第 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)

  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 语句

让我们尝试在平凯数据库云服务上执行你的第一条 SQL 语句。

SELECT 'Hello 平凯数据库云服务!';

预期输出：

+-------------------+
| Hello 平凯数据库云服务! |
+-------------------+
| Hello 平凯数据库云服务! |
+-------------------+

如果你的实际输出与预期输出类似，恭喜你，已经在平凯数据库云服务上成功执行了一条 SQL 语句。

需要帮助？

欢迎在 Discord 或 Slack 社区提问，或提交支持工单。