📣

TiDB Cloud Serverless が
Starter
に変わりました!このページは自動翻訳されたものです。
原文はこちらからご覧ください。

Visual Studio Code で TiDB に接続する

TiDBはMySQL互換のデータベースであり、 ビジュアルスタジオコード(VSコード)軽量ながらも強力なソースコードエディタです。このチュートリアルでは、TiDBを公式ドライバーとしてサポートするSQLツール拡張機能を使用します。

このチュートリアルでは、Visual Studio Code を使用して TiDB クラスターに接続する方法を学習します。

注記:

前提条件

このチュートリアルを完了するには、次のものが必要です。

  • ビジュアルスタジオコード 1.72.0以降のバージョン。
  • Visual Studio Code のSQLツール MySQL/MariaDB/TiDB拡張機能。インストールするには、以下のいずれかの方法があります。
    • このリンクをクリックして VS Code を起動し、拡張機能を直接インストールします。
    • VS Code マーケットプレイスに移動して、 [インストール]をクリックします。
    • VS Code の拡張機能タブで、 mtxr.sqltools-driver-mysql検索してSQLTools MySQL/MariaDB/TiDB拡張機能を取得し、インストールをクリックします。
  • TiDB クラスター。

TiDB クラスターがない場合は、次のように作成できます。

TiDBに接続する

選択した TiDB デプロイメント オプションに応じて、TiDB クラスターに接続します。

    1. クラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。

    2. 右上隅の「接続」をクリックします。接続ダイアログが表示されます。

    3. 接続ダイアログの構成が動作環境と一致していることを確認します。

      • 接続タイプPublicに設定されています。

      • ブランチmainに設定されています。

      • Connect With がVS Codeに設定されています。

      • オペレーティング システムは環境に適合します。

      ヒント:

      VS Code をリモート開発環境で実行している場合は、リストからリモートオペレーティングシステムを選択してください。例えば、Windows Subsystem for Linux (WSL) を使用している場合は、対応する Linux ディストリビューションに切り替えてください。GitHub Codespaces を使用している場合は、この操作は不要です。

    4. ランダムなパスワードを作成するには、 「パスワードの生成」をクリックします。

      ヒント:

      以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードのリセット」をクリックして新しいパスワードを生成することができます。

    5. VS Codeを起動し、ナビゲーションペインでSQLTools拡張機能を選択します。 「接続」セクションで「新しい接続の追加」をクリックし、データベースドライバーとしてTiDBを選択します。

      VS Code SQLTools: add new connection

    6. 設定ペインで、次の接続パラメータを構成します。

      • 接続名: この接続に意味のある名前を付けます。

      • 接続グループ: (オプション) この接続グループに分かりやすい名前を付けます。同じグループ名の接続はグループ化されます。

      • 接続方法:サーバーおよびポートを選択します。

      • サーバー アドレス: TiDB Cloud接続ダイアログからHOSTパラメータを入力します。

      • ポート: TiDB Cloud接続ダイアログからPORTパラメータを入力します。

      • データベース: 接続するデータベースを入力します。

      • ユーザー名: TiDB Cloud接続ダイアログからUSERNAMEパラメータを入力します。

      • パスワード モード: SQLToolsDriver資格情報を選択します。

      • MySQL ドライバー固有のオプション領域で、次のパラメータを設定します。

        • 認証プロトコル:デフォルトを選択します。

        • SSL有効を選択します。TiDB Cloud Serverless は安全な接続を必要とします。 「SSLオプション(node.TLSSocket)」領域で、 「証明機関(CA)証明書ファイル」フィールドをTiDB Cloud接続ダイアログのCAパラメータとして設定します。

          注記:

          WindowsまたはGitHub Codespacesで実行している場合は、 SSLを空白のままにすることができます。SQLToolsはデフォルトでLet's Encryptが管理する既知のCAを信頼します。詳細については、 TiDB Cloud Serverless ルート証明書管理ご覧ください。

      VS Code SQLTools: configure connection settings for TiDB Cloud Serverless

    7. 「テスト接続」をクリックして、TiDB Cloud Serverless クラスターへの接続を検証します。

      1. ポップアップウィンドウで、 [許可]をクリックします。

      2. SQLToolsDriver資格情報ダイアログで、手順 4 で作成したパスワードを入力します。

        VS Code SQLTools: enter password to connect to TiDB Cloud Serverless

    8. 接続テストが成功すると、「正常に接続されました!」というメッセージが表示されます。 「接続を保存」をクリックして接続設定を保存します。

    1. クラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。

    2. 右上隅の「接続」をクリックします。接続ダイアログが表示されます。

    3. 接続ダイアログで、 [接続タイプ]ドロップダウン リストから[パブリック]を選択し、 [CA 証明書]をクリックして CA 証明書をダウンロードします。

      IP アクセス リストをまだ設定していない場合は、 「IP アクセス リストの設定」をクリックするか、手順IPアクセスリストを設定するに従って、最初の接続の前に設定してください。

      TiDB Cloud Dedicatedは、パブリック接続タイプに加えて、プライベートエンドポイントVPCピアリング接続タイプもサポートしています。詳細については、 TiDB Cloud専用クラスタに接続するご覧ください。

    4. VS Codeを起動し、ナビゲーションペインでSQLTools拡張機能を選択します。 「接続」セクションで「新しい接続の追加」をクリックし、データベースドライバーとしてTiDBを選択します。

      VS Code SQLTools: add new connection

    5. 設定ペインで、次の接続パラメータを構成します。

      • 接続名: この接続に意味のある名前を付けます。

      • 接続グループ: (オプション) この接続グループに分かりやすい名前を付けます。同じグループ名の接続はグループ化されます。

      • 接続方法:サーバーおよびポートを選択します。

      • サーバー アドレス: TiDB Cloud接続ダイアログからhostパラメータを入力します。

      • ポート: TiDB Cloud接続ダイアログからportパラメータを入力します。

      • データベース: 接続するデータベースを入力します。

      • ユーザー名: TiDB Cloud接続ダイアログからuserパラメータを入力します。

      • パスワード モード: SQLToolsDriver資格情報を選択します。

      • MySQL ドライバー固有のオプション領域で、次のパラメータを設定します。

        • 認証プロトコル:デフォルトを選択します。
        • SSL : 「無効」を選択します。

      VS Code SQLTools: configure connection settings for TiDB Cloud Dedicated

    6. 「テスト接続」をクリックして、 TiDB Cloud Dedicated クラスターへの接続を検証します。

      1. ポップアップウィンドウで、 [許可]をクリックします。
      2. SQLToolsDriver資格情報ダイアログで、 TiDB Cloud Dedicated クラスターのパスワードを入力します。

      VS Code SQLTools: enter password to connect to TiDB Cloud Dedicated

    7. 接続テストが成功すると、「正常に接続されました!」というメッセージが表示されます。 「接続を保存」をクリックして接続設定を保存します。

    1. VS Codeを起動し、ナビゲーションペインでSQLTools拡張機能を選択します。 「接続」セクションで「新しい接続の追加」をクリックし、データベースドライバーとしてTiDBを選択します。

      VS Code SQLTools: add new connection

    2. 設定ペインで、次の接続パラメータを構成します。

      • 接続名: この接続に意味のある名前を付けます。

      • 接続グループ: (オプション) この接続グループに分かりやすい名前を付けます。同じグループ名の接続はグループ化されます。

      • 接続方法:サーバーおよびポートを選択します。

      • サーバー アドレス: TiDB セルフマネージド クラスターの IP アドレスまたはドメイン名を入力します。

      • ポート: TiDB セルフマネージド クラスターのポート番号を入力します。

      • データベース: 接続するデータベースを入力します。

      • ユーザー名: TiDB セルフマネージド クラスターに接続するために使用するユーザー名を入力します。

      • パスワードモード:

        • パスワードが空の場合は、 「空のパスワードを使用する」を選択します。
        • それ以外の場合は、 SQLToolsDriver資格情報を選択します。
      • MySQL ドライバー固有のオプション領域で、次のパラメータを設定します。

        • 認証プロトコル:デフォルトを選択します。
        • SSL : 「無効」を選択します。

      VS Code SQLTools: configure connection settings for TiDB Self-Managed

    3. [テスト接続]をクリックして、TiDB セルフマネージド クラスターへの接続を検証します。

      パスワードが空でない場合は、ポップアップ ウィンドウで[許可]をクリックし、TiDB セルフマネージド クラスターのパスワードを入力します。

      VS Code SQLTools: enter password to connect to TiDB Self-Managed

    4. 接続テストが成功すると、「正常に接続されました!」というメッセージが表示されます。 「接続を保存」をクリックして接続設定を保存します。

    次のステップ

    ヘルプが必要ですか?

    不和またはスラック 、あるいはサポートチケットを送信するについてコミュニティに質問してください。

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