大网数据广告活动
数据库部署与 SQL 参考

创建 {{{ .starter }}} 实例

· 52CE 我爱测

本文将介绍如何以最快的方式开始使用 TiDB。你将创建并启动一个 {{{ .starter }}} 实例,使用 TiDB SQL 客户端,插入数据。随后将从示例程序读取出数据。

创建 {{{ .starter }}} 实例

本文将介绍如何以最快的方式开始使用 TiDB。你将创建并启动一个 {{{ .starter }}} 实例,使用 TiDB SQL 客户端,插入数据。随后将从示例程序读取出数据。

若你需要在本地计算机上启动 TiDB,请参阅本地启动 TiDB。

第 1 步:创建 {{{ .starter }}} 实例 {#step-1-create-a-starter-instance}

  1. 如果你没有 TiDB Cloud 账户,请点击此处注册。

  2. 登录你的 TiDB Cloud 账户。

  3. 在 My TiDB 页面,点击 Create Resource。

  4. 在 Create Resource* 页面,Starter 为默认选项。为你的 {{{ .starter }}} 实例输入一个名称,选择云服务提供商,然后选择一个可用区。

  5. 点击 Create 以创建 {{{ .starter }}} 实例。

    你的 {{{ .starter }}} 实例将在约 30 秒内创建完成。

  6. 在你的 {{{ .starter }}} 实例创建完成后,点击实例名称进入其概览页面,然后点击右上角的 Connect。此时会显示一个连接对话框。

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

  8. 点击 Generate Password 生成随机密码。生成的密码不会再次显示,因此请将密码妥善保存。如果没有设置 root 密码,你将无法连接到 {{{ .starter }}} 实例。

注意:

当连接到 {{{ .starter }}} 实例时,必须在用户名前加上前缀并使用单引号包裹用户名。你可以在 {{{ .starter }}} 用户名前缀中获得更多信息。

第 2 步:连接到 {{{ .starter }}} 实例 {#step-2-connect-to-a-starter-instance}

  1. 若未安装 MySQL 客户端,请选择自己的操作系统,按以下步骤安装。

    对于 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:
    

    请运行其中的此行(命令行输出若与此处文档不一致,请以命令行输出为准):

    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 操作系统,下面以 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
    
  2. 运行第 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

尝试运行一下你在 TiDB Cloud 上的第一个 SQL 吧:

SELECT 'Hello TiDB Cloud!';

你将看到这样的输出:

+-------------------+
| Hello TiDB Cloud! |
+-------------------+
| Hello TiDB Cloud! |
+-------------------+

如果你的实际输出与预期输出一致,表示你已经在 TiDB Cloud 上成功地运行了 SQL 语句。

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。