📣
TiDB Cloud Essential はパブリックプレビュー中です。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者向け
ベストプラクティス
API

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 Editorは、AWS上でホストされているTiDB Cloud Starterインスタンスでのみ利用可能です。TiDB TiDB Cloud DedicatedクラスターでSQL EditorおよびChat2Queryを使用するには、 TiDB Cloudサポートにお問い合わせください。

Access SQL エディター

  1. 私のTiDBページにアクセスします。

    ヒント：

    複数の組織に所属している場合は、左上隅のコンボボックスを使用して、まず目的の組織に切り替えてください。

  2. TiDB Cloud StarterインスタンスまたはTiDB Cloud Dedicatedクラスタの名前をクリックし、左側のナビゲーションペインで「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とAmazon Bedrockがお客様のコードスニペットを使用してサービスを調査および改善することを許可するかどうかを尋ねるダイアログが表示されます。

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

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

  • AIを有効にするには、Chat2Queryの右上隅にある「データ探索のためのAI機能を有効にする」をクリックしてください。
  • AIを無効にするには、 TiDB Cloudコンソールの左下隅にあるをクリックします。アカウント設定をクリックし、 AIとプライバシーのタブをクリックして、 AIによるデータ探索オプションを無効にします。

SQLクエリを作成して実行する

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

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

      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の場合：

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

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

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

        WindowsまたはLinuxの場合：

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

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

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

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

      注記：

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

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

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

      1. カーソルを使って、書き換えたいSQLクエリの行を選択してください。

      2. お使いのオペレーティングシステムに対応したキーボードショートカットを使用して、Chat2Queryを起動して書き換えを実行してください。

        • ⌘ + I (macOS)
        • WindowsまたはLinuxでCtrl + I

        指示を入力したら、 Enterキーを押してください。AIが書き換え処理を行います。

      3. Chat2Queryを起動すると、提案された書き換え内容と以下のオプションが表示されます。

        • 承認：ここをクリックすると、提案された書き換え案を承認して編集を続行できます。
        • 破棄：提案された書き換え内容がご期待に沿わない場合は、こちらをクリックしてください。
        • 再生成：ここをクリックすると、フィードバックや追加の指示に基づいて、Chat2Queryによる再書き換えをリクエストできます。

      注記：

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

      SQL ファイルを管理する

      SQLエディタでは、SQLクエリを複数のSQLファイルに保存し、以下のようにSQLファイルを管理できます。

      • SQLファイルを追加するには、 「SQLファイル」タブの「+」をクリックします。
      • SQL ファイルの名前を変更するには、ファイル名にカーソルを合わせ、ファイル名の横にある...をクリックして、 [名前の変更]を選択します。
      • SQL ファイルを削除するには、ファイル名にカーソルを合わせ、ファイル名の横にある「...」をクリックしてから、 「削除」を選択します。なお、 「SQL ファイル」タブに SQL ファイルが 1 つしかない場合は、削除できません。

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

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

      Chat2Queryでは、以下の手順でChat2Queryデータアプリにアクセスしたり作成したりできます。

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

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

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

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

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

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

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

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

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

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

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

      設定を変更するには、以下の手順に従ってください。

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

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