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

AI 支援 SQL エディターでデータを探索

TiDB Cloudコンソールに組み込まれた AI 支援 SQL エディターを使用して、データの価値を最大化できます。

SQL エディターでは、SQL クエリを手動で記述するか、macOS では⌘ + I (Windows または Linux ではControl + I ) を押してChat2Query (ベータ版) SQL クエリを自動的に生成するように指示することができます。これにより、ローカル SQL クライアントを使用せずにデータベースに対して SQL クエリを実行できます。クエリ結果をテーブルやグラフで直感的に表示し、クエリ ログを簡単に確認できます。

ユースケース

SQL エディターの推奨される使用例は次のとおりです。

  • Chat2Query の AI 機能を活用して、複雑な SQL クエリを即座に生成、デバッグ、または書き換えます。
  • TiDB の MySQL 互換性をすばやくテストします。
  • 独自のデータセットを使用して、TiDB の SQL 機能を簡単に探索できます。

制限事項

  • AI によって生成された SQL クエリは 100% 正確ではない可能性があり、それを改良する必要がある場合があります。
  • SQL エディターは、AWS でホストされている v6.5.0 以降の TiDB クラスターでのみサポートされます。
  • SQL エディターは、デフォルトでTiDB Cloudサーバーレスクラスターで使用できます。SQL エディターと Chat2Query をTiDB Cloud専用クラスターで使用するには、 TiDB Cloudサポートお問い合わせください。

SQL エディターにアクセスする

  1. プロジェクトのクラスターページに移動します。

    ヒント：

    複数のプロジェクトがある場合は、左下隅にある をクリックして、別のプロジェクトに切り替えます。

  2. クラスター名をクリックし、左側のナビゲーション ペインで[SQL エディター]をクリックします。

    注記：

    次の場合、 SQL エディターのエントリは灰色で表示され、クリックできません。

    • TiDB Cloud Dedicated クラスターは v6.5.0 より前のバージョンです。SQL エディターを使用するには、契約TiDB Cloudサポート結んでクラスターをアップグレードする必要があります。
    • TiDB Cloud Dedicated クラスターが作成されたばかりで、SQL エディターの実行環境はまだ準備中です。この場合は、数分待つと Chat2Query が利用可能になります。
    • TiDB Cloud Dedicated クラスターは一時停止です。

AI による SQL クエリの生成を有効または無効にする

PingCAP は、ユーザーデータのプライバシーとセキュリティを最優先に考えています。SQL エディターの Chat2Query の AI 機能は、SQL クエリを生成するためにデータベース スキーマにアクセスするだけでよく、データ自体にアクセスする必要はありません。詳細については、 Chat2Query プライバシーFAQ参照してください。

Chat2Query に初めてアクセスすると、PingCAP と OpenAI がコード スニペットを使用してサービスを調査および改善することを許可するかどうかを尋ねるダイアログが表示されます。

  • AI が SQL クエリを生成できるようにするには、チェックボックスをオンにして、 「保存して開始」をクリックします。
  • AI による SQL クエリの生成を無効にするには、このダイアログを直接閉じます。

初回アクセス後も、次のように AI 設定を変更できます。

  • AI を有効にするには、Chat2Query の右上隅にある「データ探索のための AI パワーを有効にする」をクリックします。
  • AIを無効にするには、 TiDB Cloudコンソールの左下隅にある[アカウント設定]をクリックし、 [プライバシー]タブをクリックして、 [AI を活用したデータ探索]オプションを無効にします。

SQLクエリを記述して実行する

SQL エディターでは、独自のデータセットを使用して SQL クエリを記述および実行できます。

  1. SQL クエリを記述します。

    • macOS
    • Windows/Linux

    macOSの場合:

    • AI が有効になっている場合は、 ⌘ + Iを押して指示に従い、 Enter キーを押すだけで、AI が SQL クエリを自動的に生成します。

      Chat2Query によって生成された SQL クエリの場合、 「承認」をクリックしてクエリを承認し、編集を続行します。クエリが要件を満たしていない場合は、 「破棄」をクリックして拒否します。または、 「再生成」をクリックして Chat2Query から新しいクエリを要求します。

    • AI が無効になっている場合は、SQL クエリを手動で記述します。

    Windows または Linux の場合:

    • AI が有効になっている場合は、 Ctrl + Iを押して指示に従い、 Enter キーを押すだけで、AI が SQL クエリを自動的に生成します。

      Chat2Query によって生成された SQL クエリの場合、 「承認」をクリックしてクエリを承認し、編集を続行します。クエリが要件を満たしていない場合は、 「破棄」をクリックして拒否します。または、 「再生成」をクリックして Chat2Query から新しいクエリを要求します。

    • AI が無効になっている場合は、SQL クエリを手動で記述します。

  2. SQL クエリを実行します。

    • macOS
    • Windows/Linux

    macOSの場合:

    • エディタにクエリが1つしかない場合は、それを実行するには⌘ + Enterを押すか、 走る。

    • エディターに複数のクエリがある場合、そのうちの 1 つまたは複数のクエリを順番に実行するには、カーソルで対象クエリの行を選択し、 ⌘ + Enterキーを押すか、 [実行]をクリックします。

    • エディター内のすべてのクエリを順番に実行するには、 ⇧ + ⌘ + Enterを押すか、カーソルですべてのクエリの行を選択して「実行」をクリックします。

    Windows または Linux の場合:

    • エディタにクエリが1つしかない場合は、それを実行するにはCtrl + Enterを押すか、 走る。

    • エディターに複数のクエリがある場合、そのうちの 1 つまたは複数のクエリを順番に実行するには、カーソルで対象クエリの行を選択し、 Ctrl + Enterキーを押すか、 [実行]をクリックします。

    • エディター内のすべてのクエリを順番に実行するには、 Shift + Ctrl + Enterを押すか、カーソルですべてのクエリの行を選択して「実行」をクリックします。

クエリを実行すると、ページの下部にクエリ ログと結果がすぐに表示されます。

注記：

返される結果のサイズ制限は 8 MiB です。

Chat2Query を使用して SQL クエリを書き換える

SQL エディターでは、Chat2Query を使用して既存の SQL クエリを書き換え、パフォーマンスを最適化したり、エラーを修正したり、その他の特定の要件を満たしたりできます。

  1. カーソルを使用して、書き換えたい SQL クエリの行を選択します。

  2. オペレーティング システムのキーボード ショートカットを使用して、書き換え用の Chat2Query を呼び出します。

    • macOSでは⌘ + I
    • Windows または Linux ではControl + I

    指示を入力した後、 Enter キーを押して、AI に書き換えを処理させます。

  3. Chat2Query を呼び出すと、提案された書き換えと次のオプションが表示されます。

    • 承認: これをクリックすると、提案された書き換えを承認して編集を続行します。
    • 破棄: 提案された書き換えが期待どおりでない場合は、これをクリックします。
    • 再生成: フィードバックまたは追加の指示に基づいて Chat2Query に別の書き換えを要求するには、これをクリックします。

注記：

Chat2Query は AI アルゴリズムを使用して最適化と修正を提案します。クエリを確定する前に、これらの提案を慎重に確認することをお勧めします。

SQL ファイルの管理

SQL エディターでは、SQL クエリをさまざまな SQL ファイルに保存し、次のように SQL ファイルを管理できます。

  • SQL ファイルを追加するには、 「SQL ファイル」タブで+ をクリックします。
  • SQL ファイルの名前を変更するには、ファイル名の上にカーソルを移動し、ファイル名の横にある[...]をクリックして、 [名前の変更]を選択します。
  • SQL ファイルを削除するには、カーソルをファイル名の上に移動し、ファイル名の横にある[...]をクリックして、 [削除] を選択します。 [SQL ファイル] タブに SQL ファイルが 1 つしかない場合は、削除できないことに注意してください。

API経由でChat2Queryにアクセスする

UI 経由で Chat2Query にアクセスするだけでなく、API 経由で Chat2Query にアクセスすることもできます。そのためには、まず Chat2Query データ アプリを作成する必要があります。

Chat2Query では、次のように Chat2Query データ アプリにアクセスしたり、作成したりできます。

  1. 右上隅の「...」をクリックし、 「API 経由で Chat2Query にアクセス」をクリックします。

  2. 表示されたダイアログで、次のいずれかを実行します。

    • 新しい Chat2Query データ アプリを作成するには、 [新しい Chat2Query データ アプリ]をクリックします。
    • 既存の Chat2Query データ アプリにアクセスするには、対象のデータ アプリの名前をクリックします。

詳細についてはChat2Query APIを使い始める参照してください。

SQL ファイルからエンドポイントを生成する

TiDB クラスターの場合、 TiDB Cloud は、カスタム API エンドポイントを使用して HTTPS リクエスト経由でTiDB Cloudデータにアクセスできるデータ サービス (ベータ版)機能を提供します。SQL エディターでは、次の手順を実行して、SQL ファイルからデータ サービス (ベータ) のエンドポイントを生成できます。

  1. カーソルをファイル名の上に移動し、ファイル名の横にある[...]をクリックして、 [エンドポイントの生成]を選択します。
  2. [エンドポイントの生成]ダイアログ ボックスで、エンドポイントを生成するデータ アプリを選択し、エンドポイント名を入力します。
  3. 「生成」をクリックします。エンドポイントが生成され、その詳細ページが表示されます。

詳細についてはエンドポイントを管理する参照してください。

SQLエディタの設定を管理する

SQL エディターでは、次の設定を変更できます。

  • クエリ結果の最大行数
  • スキーマタブにシステムデータベーススキーマを表示するかどうか

設定を変更するには、次の手順を実行します。

  1. SQL エディターの右上隅で、 [...]をクリックし、 [設定]を選択します。
  2. 必要に応じて設定を変更してください。
  3. 「保存」をクリックします。

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