TiDB Cloud(開発者層) で TiDBクラスタを構築する

このドキュメントでは、TiDB を使い始める最も簡単な方法について説明します。 TiDB Cloudを使用して、無料の TiDB クラスターを作成し、それに接続して、サンプル アプリケーションを実行します。

ローカル マシンで TiDB を実行する必要がある場合は、 TiDB をローカルで起動するを参照してください。

このドキュメントでは、 TiDB Cloudを開始するための最も簡単な方法について説明します。無料の TiDB クラスターを作成して接続し、サンプル アプリケーションを実行します。

ステップ 1.無料のクラスターを作成する

  1. TiDB Cloudアカウントを持っていない場合は、 TiDB Cloudをクリックしてアカウントにサインアップします。

  2. ログインをTiDB Cloudアカウントで。

  3. Developer Tier クラスターを 1 年間無料で作成するには、 プランページページでDeveloper Tierプランを選択するか、 アクティブなクラスターページで [クラスタの作成] をクリックします。

  4. [**クラスタの作成]**ページで、クラスター名、クラウド プロバイダー (現時点では、開発者層で使用できるのは AWS のみ)、およびリージョン (近くのリージョンをお勧めします) を設定します。次に、[作成] をクリックしてクラスターを作成します。

    クラスターの作成プロセスが開始され、 [セキュリティの設定] ダイアログ ボックスが表示されます。

  5. [セキュリティ設定] ダイアログ ボックスで、ルート パスワードと許可された IP アドレスを設定してクラスターに接続し、[適用] をクリックします。

    TiDB Cloudクラスターは、約 5 ~ 15 分で作成されます。

  6. クラスターを作成したら、右上隅にある [接続] をクリックします。接続ダイアログボックスが表示されます。

    ヒント:

    または、新しく作成したクラスターの名前をクリックしてクラスターの詳細ページに移動し、右上隅にある [接続] をクリックすることもできます。

  7. ダイアログ ボックスで、 [ステップ 2: SQL クライアントに接続する] を探し、文字列をコピーして SQL クライアントに接続し、後で使用できるようにします。

    SQL string

    ノート:

    開発者層のクラスターの場合、クラスターに接続するときに、ユーザー名にクラスターのプレフィックスを含め、名前を引用符で囲む必要があります。詳細については、 ユーザー名のプレフィックスを参照してください。

    ノート:

    開発者層のクラスターの場合、クラスターに接続するときに、ユーザー名にクラスターのプレフィックスを含め、名前を引用符で囲む必要があります。詳細については、 ユーザー名のプレフィックスを参照してください。

ステップ 2. クラスターに接続する

  1. MySQL クライアントがインストールされていない場合は、オペレーティング システムを選択し、以下の手順に従ってインストールします。
  • macOS
  • Linux

macOS の場合、 自作がない場合はインストールしてから、次のコマンドを実行して 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)

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. ステップ1で取得した接続文字列を実行します。

    mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -p
    
  2. パスワードを入力してサインインします。

ステップ 3. サンプル アプリケーションを実行する

  1. tidb-example-javaのプロジェクトを複製します。
git clone https://github.com/pingcap-inc/tidb-example-java.git
  1. 接続パラメーターを変更します。

    plain-java-jdbc/src/main/java/com/pingcap/JDBCExample.javaで、ホスト、ポート、ユーザー、およびパスワードのパラメーターを変更します。

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

    設定したパスワードが123456で、 TiDB Cloudから取得した接続文字列が次のとおりであるとします。

    mysql --connect-timeout 15 -u '4JC1i9KroBMFRwW.root' -h xxx.tidbcloud.com -P 4000 -D test -p
    

    この場合、次のようにパラメータを変更できます。

    mysqlDataSource.setServerName("xxx.tidbcloud.com");
    mysqlDataSource.setPortNumber(4000);
    mysqlDataSource.setDatabaseName("test");
    mysqlDataSource.setUser("4JC1i9KroBMFRwW.root");
    mysqlDataSource.setPassword("123456");
    
  2. make plain-java-jdbcを実行します。

期待される出力の例を次に示します。

エコシステム
TiDB
TiKV
TiSpark
Chaos Mesh
© 2022 PingCAP. All Rights Reserved.