TiDB Cloud Starterインスタンスを作成する
このドキュメントでは、TiDB を使い始めるための最も簡単な方法を説明します。TiDB TiDB Cloud使用してTiDB Cloud Starterインスタンスを作成し、それに接続して、サンプル アプリケーションを実行します。
ローカル マシンで TiDB を実行する必要がある場合は、 TiDBをローカルで起動するを参照してください。
ステップ1. TiDB Cloud Starterインスタンスを作成します {#step-1-create-a-starter-instance}
TiDB Cloudアカウントをお持ちでない場合は、ここをクリックしてアカウントを作成してください。
TiDB Cloudアカウントにログイン。
私のTiDBページで、 「リソースの作成」をクリックします。
「リソースの作成」ページでは、デフォルトで「Starter」が選択されています。TiDB Cloud Starterインスタンスの名前を入力し、作成先のクラウドプロバイダーとリージョンを選択してください。
「作成」をクリックして、 TiDB Cloud Starterインスタンスを作成します。
TiDB Cloud Starterインスタンスは、約30秒で作成されます。
TiDB Cloud Starterインスタンスが作成されたら、インスタンス名をクリックして概要ページに移動し、右上隅の「接続」をクリックします。接続ダイアログが表示されます。
ダイアログで、希望する接続方法とオペレーティングシステムを選択すると、対応する接続文字列が表示されます。このドキュメントでは、例としてMySQLクライアントを使用します。
「パスワードを生成」をクリックすると、ランダムなパスワードが生成されます。生成されたパスワードは二度と表示されないため、安全な場所に保存してください。ルートパスワードを設定しないと、 TiDB Cloud Starterインスタンスに接続できません。
注記:
TiDB Cloud Starterインスタンスに接続するときは、ユーザー名にインスタンスのプレフィックスを含め、名前を引用符で囲む必要があります。詳細については、 ユーザー名の接頭辞参照してください。
ステップ2. TiDB Cloud Starterインスタンスに接続します {#step-2-connect-to-a-starter-instance}
- MySQLクライアントがインストールされていない場合は、お使いのオペレーティングシステムを選択し、以下の手順に従ってインストールしてください。
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の場合、以下ではUbuntuを例として挙げます。
apt-get install mysql-client
次に、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 Starterインスタンスに接続するときは、 TLS接続を使用する必要があります。
- TiDB Cloud Starterインスタンスへの接続時に問題が発生した場合は、 TiDB Cloud Starterインスタンスへのセキュリティ接続で詳細を確認してください。
- ログインするにはパスワードを入力してください。
ステップ3.SQLステートメントを実行する
TiDB Cloudで最初のSQL文を実行してみましょう。
SELECT 'Hello TiDB Cloud!';
期待される出力:
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
| Hello TiDB Cloud! |
+-------------------+
実際の出力が期待される出力と類似していれば、おめでとうございます。TiDB Cloud上で SQL ステートメントを正常に実行できました。
お困りですか?
- 不和or スラックコミュニティに質問してください。
- TiDB Cloudのサポートチケットを送信してください
- TiDB Self-Managedのサポートチケットを送信してください