PostgreSQL 拡張機能は、@pgsql チャット参加者 (Visual Studio Codeのみ)、エージェント モード ツール、PostgreSQL Tools MCP サーバー プロバイダーの 3 つのサーフェスを介して AI アシスタントと統合されます。 このページは、適切なエントリ ポイントを選択し、3 つすべてに適用される共有構成を理解するのに役立ちます。
拡張機能は、Visual Studio Code (GitHub Copilot) と Cursor (組み込みの AI) の両方で実行されます。 ほとんどの機能は、両方のエディターで同じように動作します。この記事では、少数のエディター固有の動作について説明します。
前提条件
AI 支援機能を使用する前に、次の要件が満たされていることを確認してください。
- PostgreSQL 拡張機能がインストールされ、少なくとも 1 つのデータベース接続が構成されています。
- AI アシスタントはエディターで使用できます。
- Visual Studio Code: GitHub CopilotまたはGitHub Copilotチャットをインストールし、アクティブなサブスクリプションでサインインします。
- カーソル: 追加インストールなし。組み込みの AI が自動的に使用されます。
Note
Copilot機能は既定で有効になっています (pgsql.copilot.enableはtrue)。 これを false に設定すると、@pgsqlチャット参加者 (Visual Studio Codeのみ)、AI クエリ アクション エディターサブメニュー、エージェント モード ツール、MCP サーバー プロバイダーがすべて非表示になります。
Tip
AI アシスタンスは、アクティブなデータベース接続が既にある場合に最適です。 まだ接続していない場合は、 接続と ID から始めます。
適切なエントリ ポイントを選択する
| もし望むなら... | ここから始める | 可用性 | 詳細情報 |
|---|---|---|---|
| データベースに関するスキーマ対応の質問をする | @pgsql チャット参加者 | Visual Studio Codeのみ | @pgsql チャット参加者 |
| 特定のデータベースが既にスコープ内にある状態でエージェント モードを開始する | 接続 ツリーのデータベース ノードから AI を 接続 する | Visual Studio Codeとカーソル | エージェント モード |
| エディターからの SQL の説明、書き換え、または分析 | エディターのコンテキスト メニューの [AI クエリ アクション] サブメニュー | Visual Studio Codeとカーソル | エディターアクション |
| 複数ステップのデータベース タスクを自動化する | データベース ノードで AI を接続してエージェント モードを開始する | Visual Studio Codeとカーソル | エージェント モード |
| PostgreSQL ツールを MCP 互換ホストに公開する | PostgreSQL Tools MCP サーバー プロバイダー | Visual Studio Codeとカーソル | MCP サーバー |
スキーマ対応チャットに @pgsql を使用する
Note
@pgsqlチャット参加者はVisual Studio Codeにのみ登録され、GitHub Copilot Chatに接続されます。 Cursor では、接続ツリーのデータベース ノードから Connect AI を使用して、同じスキーマ コンテキストでエージェント モードを開始するか、Cursor のネイティブ チャット画面の MCP サーバーに依存します。
拡張機能は、GitHub Copilot Chat でスキーマ対応の会話用に@pgsqlチャット参加者 (ID: vscode-postgresql.chat-agent) を登録します。
@pgsql入力し、その後に質問を入力し、接続されたデータベースのライブ スキーマ コンテキストを使用して参加者の回答を入力します。
既にスコープ内のデータベースを使用してツール駆動型ワークフローを開始するには、[ 接続] ツリーでデータベース ノードを右クリックし、[ AI の接続] を選択します。
エンドユーザー向けの案内、プロンプト例、トラブルシューティングについては、@pgsql chat participant に進んでください。
クエリに重点を置いたヘルプにエディター アクションを使用する
クエリ エディターで SQL を開いたら、右クリックして [AI クエリ アクション] サブメニューを見つけます。 これには、次のアクションが含まれています。
| アクション | Description |
|---|---|
| クエリの説明 | クエリの動作に関するプレーン言語の説明を返します。 |
| クエリの書き換え | 意図した結果を保持しながら、クエリの代替バージョンを提案します。 |
| クエリのパフォーマンスの分析 | 接続されているデータベースに対して EXPLAIN ANALYZE 実行し、分析のために実行プランを AI に送信します。 |
また、エディター ツール バーから [ このクエリについて AI に質問 する] を選択して、現在のエディターのコンテンツで開始されたチャット会話を開くこともできます。
プラン分析で記憶されたクエリ包含の選択肢をリセットするには、コマンド パレットから AI 分析のクエリ包含設定のクリア を実行します。
ツール駆動型ワークフローにエージェント モードを使用する
エージェント モードでは、AI アシスタントが PostgreSQL ツールにアクセスできるため、接続、スキーマの検査、クエリの実行、スクリプトの開き、1 回の会話でのマルチステップ タスクの実行が可能になります。 [接続] ツリーでデータベース ノードを右クリックし、[AI の接続] を選択してエージェント モード セッションを開始します。
ツール ファミリ、ワークフロー例、トラブルシューティングの場合は、 エージェント モードに進みます。
サポートされているホストで MCP サーバーを使用する
この拡張機能は、モデル コンテキスト プロトコルを介して同じ PostgreSQL ツール サーフェスを公開する PostgreSQL Tools MCP サーバー プロバイダー (ID: pgsql-tools-mcp-server-provider) を登録します。 MCP と互換性のあるホストは、組み込みのチャット ワークフローを使用せずに、これらのツールを検出して呼び出すことができます。
サポートされているホスト、自動登録動作、および MCP を介して公開されるツール ファミリについては、 MCP サーバーに進みます。
アクセス モードの構成
pgsql.copilot.accessMode設定では、エージェント モードと MCP ツール間で AI アシスタントが受け取るデータベース アクセスの量を制御します。 既定値は 読み取り/書き込み (rw)。
| 値を設定する | UI ラベル | AI アシスタントでできること |
|---|---|---|
ro |
読み取り専用 | 読み取り専用操作: SELECT、 SHOW、 EXPLAIN、スキーマ検査 |
rw |
読み取り/書き込み | 明示的な確認を伴う読み取り操作、データ変更文、およびDDL |
接続ごとのオーバーライド
個々の接続でアクセス モードを設定することもできます。 接続ダイアログで、Copilot セクション (カーソル内の AI) を展開し、Copilotアクセス モード (カーソル内の AI アクセス モード) を次のいずれかに設定します。
| Option | Behavior |
|---|---|
| グローバル設定を使用する | グローバル pgsql.copilot.accessMode 値にフォールバックする (既定値) |
| 読み取り専用 | グローバル設定に関係なく、この接続の読み取り専用アクセスを強制します |
| 読み取り/書き込み | グローバル設定に関係なく、この接続の読み取り/書き込みアクセスを強制する |
拡張機能は、このフォールバック チェーンを使用して有効なアクセス モードを解決します。接続ごとの値→グローバル pgsql.copilot.accessMode 設定→既定値 (rw)。
Caution
AI アシスタントを通じてスキーマやデータの変更を可能にしたい場合を除き、本番データベースでは 読み取り専用 を使用してください。
追加設定を構成する
| Setting | 制御する内容 | デフォルト |
|---|---|---|
pgsql.copilot.enable |
拡張機能内のすべての AI 統合を有効または無効にします | true |
pgsql.copilot.accessMode |
グローバル AI アクセス モード (読み取り専用 または 読み取り/書き込み) | rw |
pgsql.copilot.autoAttachQuery |
AI を使用してプランを分析するときに SQL クエリ テキストを含めるかどうか: 毎回確認する、 常に含める、または 含めない | ask |
pgsql.copilot.modelOptions |
拡張機能の AI ワークフローの高度なモデル チューニング (最大トークン、温度、top_p) | - |
ID を設定すると、下位互換性のために両方のエディターで pgsql.copilot.* プレフィックスが保持されます。ユーザーに表示されるラベルに "AI" と表示されている場合でもです。
機能固有の AI 統合
専用の AI 統合ポイントなど、いくつかの機能があります。
| 特徴 | AI 機能 |
|---|---|
| クエリ プラン ビジュアライザー | Copilotで分析（Cursor では AIで分析）で実行プランデータを分析する |
| サーバー ダッシュボード | [クエリ]、[待機]、[セッション]、[メトリック グラフ] パネルの Copilot に質問 ボタン (カーソルで AI に質問) からチャット セッションを開く |
| スキーマ ビジュアライザー | エージェント モード ワークフローからのスキーマ リレーションシップを視覚化する |