使用 TiDB Cloud (DevTier) 构建 TiDB 集群

本章节将介绍以最快的方式开始使用 TiDB。你将使用 TiDB Cloud 创建并启动一个免费的 TiDB 集群,使用 TiDB SQL 客户端,插入数据。随后将从示例程序读取出数据。

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

第 1 步:创建免费集群

  1. 如果你还未拥有 TiDB Cloud 帐号,请先在此注册
  2. 使用你的 TiDB Cloud 帐号登录
  3. 方案内选择一年内免费的 Developer Tier 方案,或直接点击创建 Dev Tier 集群,进入 Create a Cluster (Dev Tier) 页面。
  4. 请在 Create a Cluster (Dev Tier) 页面填写集群名称/密码/云服务商(暂时仅可选择 AWS)/ 可用区(建议就近选择)后,点击 Create 按钮创建集群。
  5. 稍作等待,在 5~15 分钟后,将创建完毕,可在 Active Clusters 查看创建进度。
  6. 创建完毕后,在 Active Clusters 页面,点击集群名称,进入该集群控制面板。 active clusters
  7. 点击 Connect,创建流量过滤器(允许连接的客户端 IP 列表)。 connect
  8. 在弹出框内点击 Add Your Current IP Address,此项将由 TiDB Cloud 解析你当前的网络 IP 填入。点击 Create Filter,进行流量过滤器的创建。
  9. 复制弹出框 Step 2: Connect with a SQL client 中的连接字符串,供后续步骤使用。

SQL string

第 2 步:连接到集群

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

    如果你没有安装 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)
    

    以 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
    
  2. 运行第 1 步中得到的连接字符串。

    mysql --connect-timeout 15 -u root -h <host> -P 4000 -p
    
  3. 填写密码,完成登录。

第 3 步:运行示例应用程序

  1. 克隆 tidb-example-java 项目。

    git clone https://github.com/pingcap-inc/tidb-example-java.git
    
  2. 更改连接参数。

    无需更改。

    更改 plain-java-jdbc/src/main/java/com/pingcap/JDBCExample.java 内关于 Host、Port、User、Password 的参数:

    mysqlDataSource.setServerName("localhost");
    mysqlDataSource.setPortNumber(4000);
    mysqlDataSource.setDatabaseName("test");
    mysqlDataSource.setUser("root");
    mysqlDataSource.setPassword("");
    

    若你设定的密码为 123456,而且从 TiDB Cloud 得到的连接字符串为:

    mysql --connect-timeout 15 -u root -h xxx.tidbcloud.com -P 4000 -p
    

    那么此处应将参数更改为:

    mysqlDataSource.setServerName("xxx.tidbcloud.com");
    mysqlDataSource.setPortNumber(4000);
    mysqlDataSource.setDatabaseName("test");
    mysqlDataSource.setUser("root");
    mysqlDataSource.setPassword("123456");
    
  3. 运行 make plain-java-jdbc

    输出应如预期所示

文档内容是否有帮助?