AI を活用した Chat2Query (ベータ版) でデータを探索する
TiDB CloudはAI を活用しています。 TiDB Cloudコンソールの AI を活用した SQL エディターである Chat2Query (ベータ版) を使用すると、データの価値を最大化できます。
Chat2Query では、 --
入力してから AI に SQL クエリを自動的に生成させる指示を入力するか、SQL クエリを手動で作成して、ターミナルを使用せずにデータベースに対して SQL クエリを実行することができます。クエリ結果をテーブルで直感的に見つけたり、クエリログを簡単に確認したりできます。
制限事項
- AI によって生成された SQL クエリは 100% 正確ではない可能性があり、調整が必要になる場合があります。
- Chat2Query は、v6.5.0 以降で AWS でホストされている TiDB クラスターでのみサポートされます。
- Chat2Query とChat2Query APIデフォルトでTiDB サーバーレスのクラスターで使用できます。 TiDB専用クラスターで Chat2Query または Chat2Query API を使用するには、 TiDB Cloudのサポートにお問い合わせください。
ユースケース
Chat2Query の推奨される使用例は次のとおりです。
- Chat2Query の AI 機能を使用すると、複雑な SQL クエリを即座に生成できます。
- TiDB の MySQL 互換性をすぐにテストします。
- TiDB SQL の機能を簡単に探索できます。
Chat2Query にアクセスする
プロジェクトのクラスターページに移動します。
ヒント:
複数のプロジェクトがある場合は、
左下隅の をクリックして、別のプロジェクトに切り替えます。 クラスター名をクリックし、左側のナビゲーション ウィンドウで[Chat2Query]をクリックします。
注記:
次の場合、 Chat2Queryエントリは灰色で表示され、クリックできません。
- TiDB 専用クラスターは v6.5.0 より前です。 Chat2Query を使用するには、クラスターをアップグレードするためにTiDB Cloudのサポートを契約する必要があります。
- TiDB 専用クラスターが作成されたばかりで、Chat2Query の実行環境はまだ準備中です。この場合、数分待つと Chat2Query が使用可能になります。
- TiDB 専用クラスターは一時停止したです。
AI による SQL クエリの生成を有効または無効にする
PingCAP は、ユーザーのデータのプライバシーとセキュリティを最優先事項としています。 Chat2Query の AI 機能は、データ自体ではなく、データベース スキーマにアクセスして SQL クエリを生成することのみが必要です。詳細については、 Chat2Query のプライバシーに関するFAQを参照してください。
初めて Chat2Query にアクセスすると、PingCAP と OpenAI がコード スニペットを使用してサービスを調査および改善することを許可するかどうかを尋ねるダイアログが表示されます。
- AI が SQL クエリを生成できるようにするには、チェックボックスを選択し、 [保存して開始]をクリックします。
- AI による SQL クエリの生成を無効にするには、このダイアログを直接閉じます。
初回アクセス後も、次のように AI 設定を変更できます。
- AI を有効にするには、Chat2Query の右上隅にある[データ探索のための AI パワーを有効にする]をクリックします。
- AI を無効にするには、
TiDB Cloudコンソールの左下隅にある[アカウント設定]をクリックし、 [プライバシー]タブをクリックして、 AI を利用したデータ探索オプションを無効にします。
SQL クエリを作成して実行する
Chat2Query では、独自のデータセットを使用して SQL クエリを作成および実行できます。
SQL クエリを作成します。
AI が有効な場合は、
--
を入力してから AI に SQL クエリを自動的に生成させるか、SQL クエリを手動で作成するかの指示を入力するだけです。AI によって生成された SQL クエリの場合は、 Tab キーを押して受け入れ、必要に応じてさらに編集するか、 Esc キーを押して拒否することができます。
AI が無効になっている場合は、SQL クエリを手動で作成します。
SQL クエリを実行します。
- macOS
- Windows/Linux
macOS の場合:
エディターにクエリが 1 つしかない場合、それを実行するには、 ⌘ + Enter キーを押すか、 走る。
エディターに複数のクエリがある場合、1 つまたは複数のクエリを順番に実行するには、カーソルでターゲット クエリの行を選択し、 ⌘ + Enterを押すか、 [実行]をクリックします。
エディターですべてのクエリを順番に実行するには、 ⇧ + ⌘ + Enter を押すか、カーソルですべてのクエリの行を選択し、 Runをクリックします。
Windows または Linux の場合:
エディターにクエリが 1 つしかない場合、それを実行するには、 Ctrl + Enter を押すか、 走る。
エディターに複数のクエリがある場合、1 つまたは複数のクエリを順番に実行するには、カーソルでターゲット クエリの行を選択し、 Ctrl + Enterを押すか、 [**実行]**をクリックします。
エディターですべてのクエリを順番に実行するには、 Shift + Ctrl + Enter を押すか、カーソルですべてのクエリの行を選択し、 [実行]をクリックします。
クエリを実行すると、ページの下部にクエリのログと結果がすぐに表示されます。
SQLファイルを管理する
Chat2Query では、SQL クエリをさまざまな SQL ファイルに保存し、次のように SQL ファイルを管理できます。
- SQL ファイルを追加するには、 [SQL ファイル]タブで[+]をクリックします。
- SQL ファイルの名前を変更するには、ファイル名の上にカーソルを移動し、ファイル名の横にある[...]をクリックして、 [名前の変更]を選択します。
- SQL ファイルを削除するには、ファイル名の上にカーソルを移動し、ファイル名の横にある[...]をクリックして、 [削除]を選択します。 [SQL ファイル]タブに SQL ファイルが 1 つしかない場合は、削除できないことに注意してください。
API経由でChat2Queryにアクセス
Chat2Query には UI 経由でアクセスするだけでなく、API 経由でアクセスすることもできます。これを行うには、まず Chat2Query データ アプリを作成する必要があります。
Chat2Query では、次のように Chat2Query データ アプリにアクセスしたり、Chat2Query データ アプリを作成したりできます。
右上隅の[...]をクリックし、 [API 経由で Chat2Query にアクセス] をクリックします。
表示されたダイアログで、次のいずれかを実行します。
- 新しい Chat2Query データ アプリを作成するには、 [新しい Chat2Query データ アプリ]をクリックします。
- 既存の Chat2Query データ アプリにアクセスするには、ターゲット データ アプリの名前をクリックします。
詳細については、 Chat2Query API を使ってみるを参照してください。
SQL ファイルからエンドポイントを生成する
TiDB クラスターの場合、 TiDB Cloud は、カスタム API エンドポイントを使用して HTTPS リクエスト経由でTiDB Cloudデータにアクセスできるようにするデータサービス(ベータ版)機能を提供します。 Chat2Query では、次の手順を実行して SQL ファイルから Data Service (ベータ版) のエンドポイントを生成できます。
- ファイル名の上にカーソルを移動し、ファイル名の横にある[...]をクリックして、 [エンドポイントの生成]を選択します。
- [エンドポイントの生成]ダイアログ ボックスで、エンドポイントを生成するデータ アプリを選択し、エンドポイント名を入力します。
- 「生成」をクリックします。エンドポイントが生成され、その詳細ページが表示されます。
詳細については、 エンドポイントを管理するを参照してください。
Chat2Query 設定を管理する
Chat2Query では、次の設定を変更できます。
- クエリ結果の最大行数
- [スキーマ]タブにシステム データベース スキーマを表示するかどうか
設定を変更するには、次の手順を実行します。
- Chat2Query の右上隅で[...]をクリックし、 [設定]を選択します。
- 必要に応じて設定を変更してください。
- 「保存」をクリックします。