PostgreSQL 拡張機能は、GitHub Copilot Chat に@pgsql チャット参加者を登録します。 オブジェクトの検出、クエリの下書き、クエリの説明、次の手順の提案など、拡張機能で既に使用しているデータベースに関するスキーマ対応のヘルプが必要な場合に使用します。
参加者は、そのデータベースのライブ スキーマ コンテキストを使用できるため、既にアクティブな接続がある場合に最適です。
Important
@pgsqlチャット参加者は、Visual Studio Codeでのみ使用できます。 GitHub Copilot Chatにプラグインされます。これは Cursor やその他のフォークでは使用できません。
Cursor で、接続ツリーのデータベース ノードから Connect AI を使用して、同じスキーマ コンテキストでエージェント モードを開始するか、MCP サーバーを介して Cursor のネイティブ チャットから拡張機能の PostgreSQL ツールを直接呼び出します。
前提条件
開始する前に、以下を用意してください。
- GitHub CopilotまたはGitHub Copilot チャットがインストールされ、Visual Studio Codeでアクティブになっています。
- PostgreSQL 拡張機能がインストールされている。
- 拡張機能で有効になっているCopilot/AI 機能 (
pgsql.copilot.enableはtrue)。 - 拡張機能で構成された PostgreSQL 接続。
Note
アクティブな接続がない @pgsql 質問をする場合でも、PostgreSQL の一般的な質問に答えることができますが、実際のスキーマ、テーブル、または列を参照することはできません。
スキーマ対応チャットを開始する
- PostgreSQL 拡張機能でターゲット データベースに接続します。
- GitHub Copilot Chat を開きます。
-
@pgsqlに続けて質問を入力してください。 - 回答を確認し、 エージェント モードでフォローアップの質問、クエリの下書き、またはより深いワークフローが必要かどうかを決定します。
データベース コンテキストをエージェント モードにする
使用するデータベースが既にわかっている場合は、[ 接続 ] ツリーのデータベース ノードから開始し、[AI の 接続 ] を選択して、データベース コンテキストが既にスコープ内にあるエージェント モードを開きます。 このパスは、Visual Studio Codeと Cursor の両方で機能します。
AI アシスタントが接続し、スキーマを検査し、次のようなタスクを処理する場合は、そのパスを使用します。
- "このデータベース内のテーブルは何ですか?
- "顧客と注文に関連するテーブルはどれですか?
- "上位 10 件の顧客を注文数別に表示するクエリを作成します。"
@pgsql でうまく機能するように質問する
@pgsqlチャット参加者は、次の種類のタスクに特に役立ちます。
| ゴール | プロンプトの例 |
|---|---|
| スキーマを調べる | @pgsql What tables are in the public schema? |
| リレーションシップを理解する | @pgsql Which tables connect orders to customers? |
| SQL の下書き | @pgsql Write a query that shows monthly revenue by region. |
| 既存の SQL について説明する | @pgsql Explain what this query is doing and where it might be slow. |
| 次の手順を計画する | @pgsql I need to add a customer status field. What should I review before I change the schema? |
最も明確な結果が必要な場合は、一度に 1 つの決定を求めます。 接続、スキーマの検査、クエリの実行、結果の 1 回の会話での結果の返しを行うマルチステップ ワークフローが必要な場合は、 エージェント モードに移行します。
応答を確認して使用する
@pgsql応答は、未確認の最終出力ではなく、作業ガイダンスとして使用します。
- 生成された SQL を実行する前に確認します。
- クエリを手動でテストまたは絞り込む場合は、クエリ エディターを使用します。
- 接続ツリーまたはスキーマ ビジュアライザーを使用して、参加者がメンションするオブジェクトを確認します。
- AI アシスタントが応答だけでなくアクションを実行する場合は、エージェント モードを使用します。
Tip
大規模なクエリの書き換えを要求する前に、スキーマ検出の質問から始めます。 参加者がデータベース コンテキストを理解しやすくなるほど、次の回答は良くなる傾向があります。
@pgsql回答のトラブルシューティング
答えはあまりにも一般的です
適切なデータベースに接続していることを確認し、PostgreSQL に関する広範な質問ではなく、スキーマ固有の質問をします。
参加者が適切なオブジェクトを見つけることができません
最初に 接続 ツリーでオブジェクト名を確認してから、プロンプトにスキーマ名またはテーブル名を直接含めます。
Cursorで@pgsqlが表示されません
チャット参加者は、Visual Studio Codeにのみ登録されます。 Cursor では、接続ツリーから Connect AI を使用してエージェント モードを開始するか、MCP サーバーに依存して同じツールを Cursor のネイティブ チャットに公開します。
AI に答え以上のことをしてほしい
AI で接続、スキーマ検査、クエリ、スクリプト、またはデータ操作を 1 つのワークフローに組み合わせる場合は、 エージェント モード を使用します。