TiDB Cloud(Serverless Tier) で TiDBクラスタを構築する
このドキュメントでは、TiDB を使い始める最も簡単な方法について説明します。 TiDB Cloudを使用してServerless Tierクラスターを作成し、それに接続して、サンプル アプリケーションを実行します。
ローカル マシンで TiDB を実行する必要がある場合は、 TiDB をローカルで起動するを参照してください。
ステップ 1.Serverless Tierクラスターを作成する
TiDB Cloudアカウントを持っていない場合は、 ここクリックしてアカウントにサインアップします。
ログインをTiDB Cloudアカウントに追加します。
デフォルトではクラスターリスト ページが表示されます。
新しいサインアップ ユーザーの場合、 TiDB Cloud はデフォルトのServerless Tierクラスター
Cluster0を自動的に作成します。以降の手順でこのデフォルト クラスタを使用するか、独自に新しいServerless Tierクラスタを作成することができます。自分で新しいServerless Tierクラスターを作成するには、次の操作を行います。
- [クラスタの作成]をクリックします。
- [クラスタの作成]ページでは、サーバーレスがデフォルトで選択されています。クラスターのターゲット リージョンを選択し、必要に応じて既定のクラスター名を更新して、 [作成]をクリックします。 Serverless Tierクラスタは約 30 秒で作成されます。
クラスターの概要ページで、右上隅にある[接続]をクリックします。接続ダイアログボックスが表示されます。
ダイアログで、希望する接続方法とオペレーティング システムを選択して、対応する接続文字列を取得します。このドキュメントでは、MySQL クライアントを例として使用します。
[パスワードの作成]をクリックして、ランダムなパスワードを生成します。生成されたパスワードは二度と表示されないため、パスワードを安全な場所に保存してください。 root パスワードを設定しないと、クラスターに接続できません。
ノート：
Serverless Tierクラスターの場合、クラスターに接続するときに、ユーザー名にクラスターのプレフィックスを含め、名前を引用符で囲む必要があります。詳細については、 ユーザー名のプレフィックスを参照してください。
ステップ 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
ノート：
- Serverless Tierクラスターに接続する場合は、 TLS 接続を使用する .
- Serverless Tierクラスターへの接続時に問題が発生した場合は、詳細についてServerless Tierクラスターへのセキュリティ接続を参照してください。
- パスワードを入力してサインインします。
ステップ 3. SQL ステートメントを実行する
TiDB Cloudで最初の SQL ステートメントを実行してみましょう。
SELECT 'Hello TiDB Cloud!';
期待される出力:
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
実際の出力が予想される出力と似ている場合は、おめでとう、 TiDB Cloudで SQL ステートメントを正常に実行したことになります。