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サポートお問い合わせください。

Access SQL エディター

プロジェクトのクラスターページに移動します。
ヒント：
複数のプロジェクトがある場合は、左下隅にあるをクリックして、別のプロジェクトに切り替えます。
クラスター名をクリックし、左側のナビゲーションペインで[SQL エディター] をクリックします。
注記：
次の場合、 SQL エディターのエントリは灰色で表示され、クリックできません。
- TiDB Cloud Dedicated クラスターはバージョン 6.5.0 より前のバージョンです。SQL エディターを使用するには、クラスターをアップグレードするために契約番号TiDB Cloudサポート必要です。
- TiDB Cloud Dedicated クラスターは作成されたばかりで、SQL エディタの実行環境はまだ準備中です。この場合は、数分お待ちいただくと Chat2Query が利用可能になります。
- TiDB Cloud Dedicated クラスターは一時停止です。

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

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

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

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

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

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

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

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

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 クエリを手動で記述します。
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 クエリを書き換え、パフォーマンスを最適化したり、エラーを修正したり、その他の特定の要件を満たしたりすることができます。

カーソルを使用して、書き換えたい SQL クエリの行を選択します。
オペレーティングシステムのキーボードショートカットを使用して、書き換え用の Chat2Query を呼び出します。
- macOSでは⌘ + I
- Windows または Linux ではCtrl + I
指示を入力した後、 Enter キーを押して AI に書き換えを処理させます。
Chat2Query を呼び出すと、提案された書き換えと次のオプションが表示されます。
- 承認: これをクリックすると、提案された書き換えを承認して編集を続行します。
- 破棄: 提案された書き換えが期待どおりでない場合は、これをクリックします。
- 再生成: フィードバックまたは追加の指示に基づいて Chat2Query に別の書き換えを要求するには、これをクリックします。

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

SQL ファイルの管理

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

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

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

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

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

右上隅の[...]をクリックし、 [API 経由で Chat2Query にアクセス]をクリックします。
表示されたダイアログで、次のいずれかを実行します。
- 新しい Chat2Query データアプリを作成するには、 [新しい Chat2Query データアプリ]をクリックします。
- 既存の Chat2Query データアプリにアクセスするには、対象のデータアプリの名前をクリックします。

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

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

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

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

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

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

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

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

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

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