TiDB Cloudサーバーレスクラスタを構築する
このドキュメントでは、TiDB を使い始めるための最も簡単な方法を説明します。1 TiDB Cloud使用してTiDB Cloud Serverless クラスターを作成し、それに接続し、その上でサンプル アプリケーションを実行します。
ローカルマシンで TiDB を実行する必要がある場合は、 ローカルで TiDB を起動する参照してください。
ステップ1. TiDB Cloud Serverlessクラスターを作成する
TiDB Cloudアカウントをお持ちでない場合は、 ここクリックしてアカウントを登録してください。
ログインをTiDB Cloudアカウントに追加します。
クラスターページで、 [クラスタの作成] をクリックします。
[クラスタの作成]ページでは、デフォルトでServerlessが選択されています。必要に応じてデフォルトのクラスター名を更新し、 クラスタープランを選択します。
「作成」をクリックして、 TiDB Cloud Serverless クラスターを作成します。
TiDB Cloudクラスターは約 30 秒で作成されます。
TiDB Cloudクラスターが作成されたら、クラスター名をクリックしてクラスターの概要ページに移動し、右上隅の[接続]をクリックします。接続ダイアログ ボックスが表示されます。
ダイアログで、希望する接続方法とオペレーティング システムを選択して、対応する接続文字列を取得します。このドキュメントでは、例として MySQL クライアントを使用します。
「パスワードの生成」をクリックすると、ランダムなパスワードが生成されます。生成されたパスワードは再度表示されないため、パスワードは安全な場所に保存してください。ルート パスワードを設定しないと、クラスターに接続できません。
注記:
TiDB Cloudサーバーレスクラスターの場合、クラスターに接続するときは、ユーザー名にクラスターのプレフィックスを含め、名前を引用符で囲む必要があります。詳細については、 ユーザー名プレフィックスを参照してください。
ステップ2. クラスターに接続する
- 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で取得した接続文字列を実行します。
mysql --connect-timeout 15 -u '<prefix>.root' -h <host> -P 4000 -D test --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/ssl/cert.pem -p
注記:
- TiDB Cloud Serverless クラスターに接続する場合は、 TLS接続を使用する実行する必要があります。
- TiDB Cloud Serverless クラスターへの接続時に問題が発生した場合は、詳細についてはTiDB Cloudサーバーレス クラスターへのセキュリティ接続を参照してください。
- パスワードを入力してサインインしてください。
ステップ3. SQL文を実行する
TiDB Cloudで最初の SQL ステートメントを実行してみましょう。
SELECT 'Hello TiDB Cloud!';
期待される出力:
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
実際の出力が期待された出力と似ている場合は、おめでとうございます。TiDB TiDB Cloudで SQL ステートメントが正常に実行されました。
ヘルプが必要ですか?
TiDB コミュニティ 、またはサポートチケットを作成するについて質問します。