TiDB Cloud
TiDB Self-Managed
Learning Center
お問い合わせ

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

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

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

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

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

  2. ログインをTiDB Cloudアカウントに追加します。

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

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

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

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

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

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

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

注記：

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

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