TiDB サーバーレスクラスタを構築する

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

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

ステップ 1. TiDB サーバーレスクラスターを作成する

  1. TiDB Cloudアカウントをお持ちでない場合は、 ここをクリックしてアカウントにサインアップしてください。

  2. TiDB Cloudアカウントにログイン

  3. クラスターページで、 「クラスタの作成」をクリックします。

  4. 「クラスタの作成」ページでは、デフォルトでサーバーレスが選択されています。必要に応じてデフォルトのクラスター名を更新し、クラスターを作成するリージョンを選択します。

  5. 「作成」をクリックして、TiDB サーバーレスクラスターを作成します。

    TiDB Cloudクラスターは約 30 秒で作成されます。

  6. TiDB Cloudクラスターが作成されたら、クラスター名をクリックしてクラスターの概要ページに移動し、右上隅にある[接続]をクリックします。接続ダイアログボックスが表示されます。

  7. ダイアログで、希望の接続方法とオペレーティング システムを選択して、対応する接続​​文字列を取得します。このドキュメントでは、例として MySQL クライアントを使用します。

  8. 「パスワードの生成」をクリックして、ランダムなパスワードを生成します。生成されたパスワードは再度表示されないため、パスワードを安全な場所に保存してください。 root パスワードを設定しないと、クラスターに接続できません。

注記:

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

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

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

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)

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 -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 TiDB Cloudで SQL ステートメントが正常に実行されました。

このページは役に立ちましたか?