PostgreSQL 확장은 @pgsql 채팅 참가자(Visual Studio Code 전용), 에이전트 모드 도구 및 PostgreSQL 도구 MCP 서버 공급자의 세 가지 표면을 통해 AI 도우미와 통합됩니다. 이 페이지는 올바른 진입점을 선택하고 세 가지 모두에 적용되는 공유 구성을 이해하는 데 도움이 됩니다.
확장은 Visual Studio Code(GitHub Copilot 포함) 및 커서(기본 제공 AI 포함) 모두에서 실행됩니다. 대부분의 기능은 두 편집기에서 동일한 방식으로 작동합니다. 이 문서 전체에서 적은 수의 편집기 관련 동작이 호출됩니다.
사전 요구 사항
AI 지원 기능을 사용하기 전에 다음 요구 사항이 충족되는지 확인합니다.
- PostgreSQL 확장이 설치되고 하나 이상의 데이터베이스 연결이 구성되어 있습니다.
- AI 도우미는 편집기에서 사용할 수 있습니다.
- Visual Studio Code: GitHub Copilot 또는 GitHub Copilot Chat를 설치하고 활성 구독이 있는 계정으로 로그인합니다.
- 커서: 추가 설치 없음; 기본 제공 AI는 자동으로 사용됩니다.
메모
Copilot 기능은 기본적으로 사용하도록 설정되어 있습니다(pgsql.copilot.enable은true). 이를 false설정하면 @pgsql 채팅 참가자(Visual Studio Code만 해당), AI 쿼리 작업 편집기 하위 메뉴, 에이전트 모드 도구 및 MCP 서버 공급자가 모두 숨겨집니다.
Tip
AI 지원은 활성 데이터베이스 연결이 이미 있는 경우에 가장 적합합니다. 아직 연결하지 않은 경우 연결 및 ID로 시작합니다.
올바른 진입점 선택
| 하고 싶다면... | 여기에서 시작 | Availability | 더 알아보세요 |
|---|---|---|---|
| 데이터베이스에 대한 스키마 인식 질문하기 | @pgsql 채팅 참가자 | Visual Studio Code 전용 | @pgsql 채팅 참가자 |
| 특정 데이터베이스가 이미 범위에 있는 에이전트 모드 시작 | Connect AI를 Connections 트리의 데이터베이스 노드에서 연결 | Visual Studio Code 및 커서 | 에이전트 모드 |
| 편집기에서 SQL 설명, 다시 작성 또는 분석 | 편집기 상황에 맞는 메뉴의 AI 쿼리 작업 하위 메뉴 | Visual Studio Code 및 커서 | 편집기 작업 |
| 다단계 데이터베이스 작업 자동화 | 데이터베이스 노드에서 AI를 연결하여 에이전트 모드 시작 | Visual Studio Code 및 커서 | 에이전트 모드 |
| MCP 호환 호스트에 PostgreSQL 도구 노출 | PostgreSQL 도구 MCP 서버 공급자 | Visual Studio Code 및 커서 | MCP 서버 |
스키마 인식 채팅에 사용 @pgsql
메모
@pgsql 채팅 참가자는 Visual Studio Code에서만 등록되며, 여기서 GitHub Copilot Chat에 통합됩니다. 커서에서 연결 트리의 데이터베이스 노드에서 CONNECT AI를 사용하여 동일한 스키마 컨텍스트로 에이전트 모드를 시작하거나 커서의 네이티브 채팅 화면에서 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 도구에 액세스할 수 있도록 하여 연결, 스키마 검사, 쿼리 실행, 스크립트 열기 및 한 대화에서 다단계 작업을 수행할 수 있습니다. 연결 트리에서 데이터베이스 노드를 마우스 오른쪽 단추로 클릭하고 AI 연결을 선택하여 에이전트 모드 세션을 시작합니다.
도구 패밀리, 예제 워크플로 및 문제 해결의 경우 에이전트 모드로 계속 진행합니다.
지원되는 호스트에서 MCP 서버 사용
확장은 모델 컨텍스트 프로토콜을 통해 동일한 PostgreSQL 도구 화면을 노출하는 PostgreSQL 도구 MCP 서버 공급자 (ID: pgsql-tools-mcp-server-provider)를 등록합니다. MCP 호환 호스트는 기본 제공 채팅 워크플로를 사용하지 않고도 이러한 도구를 검색하고 호출할 수 있습니다.
지원되는 호스트, 자동 등록 동작 및 MCP를 통해 노출되는 도구 패밀리의 경우 MCP 서버로 계속 진행합니다.
액세스 모드 구성
이 설정은 pgsql.copilot.accessMode AI 도우미가 에이전트 모드 및 MCP 도구에서 받는 데이터베이스 액세스의 양을 제어합니다. 기본값은 읽기/쓰기 (rw)입니다.
| 설정값 | UI 레이블 | AI 도우미가 수행할 수 있는 일 |
|---|---|---|
ro |
읽기 전용 | 읽기 전용 작업: SELECT, SHOW, EXPLAIN스키마 검사 |
rw |
읽기/쓰기 | 명시적 확인이 있는 읽기 작업과 데이터 수정 문 및 DDL |
연결별 재정의
개별 연결에서 액세스 모드를 설정할 수도 있습니다. 연결 대화 상자에서 Copilot 섹션(커서의 AI)을 확장하고 Copilot 액세스 모드(커서의 AI 액세스 모드)를 다음 중 하나로 설정합니다.
| Option | 작동 방식 |
|---|---|
| 전역 설정 사용 | 전역 pgsql.copilot.accessMode 값(기본값)으로 대체됩니다 |
| 읽기 전용 | 전역 설정에 관계없이 이 연결에 대한 읽기 전용 액세스를 강제합니다. |
| 읽기/쓰기 | 전역 설정에 관계없이 이 연결에 대한 읽기/쓰기 권한 강제 |
확장은 다음 폴백 체인에 따라 유효한 액세스 모드를 결정합니다: 연결별 값 → 전역 pgsql.copilot.accessMode 설정 → 기본값(rw).
Caution
AI 도우미를 통해 의도적으로 스키마 또는 데이터 변경 내용을 사용할 수 있기를 원하지 않는 한 프로덕션 데이터베이스에 읽기 전용 을 사용합니다.
추가 설정 구성
| 설정 | 제어하는 내용 | 기본값 |
|---|---|---|
pgsql.copilot.enable |
확장의 모든 AI 통합을 사용하거나 사용하지 않도록 설정 | true |
pgsql.copilot.accessMode |
전역 AI 액세스 모드(읽기 전용 또는 읽기/쓰기) | rw |
pgsql.copilot.autoAttachQuery |
AI를 사용하여 계획을 분석할 때 SQL 쿼리 텍스트가 포함되는지 여부: 매번 요청, 항상 포함 또는 포함 안 됨 | ask |
pgsql.copilot.modelOptions |
확장의 AI 워크플로에 대한 고급 모델 튜닝(최대 토큰, 온도, top_p) | - |
설정 ID는 이전 버전과의 호환성을 위해, 사용자에게 표시되는 레이블에 "AI"라고 표시되더라도 두 편집기 모두에서 pgsql.copilot.* 접두사를 유지합니다.
기능별 AI 통합
몇 가지 기능에는 전용 AI 통합 지점이 포함됩니다.
| 특징 | AI 기능 |
|---|---|
| 쿼리 계획 시각화 도우미 | Copilot으로 분석(또는 Cursor에서는 AI로 분석)하여 실행 계획 데이터를 분석 |
| 서버 대시보드 | Queries, Waits, Sessions 및 메트릭 차트 패널의 Copilot에게 질문하기 버튼(Cursor에서는 Ask AI)에서 채팅 세션 열기 |
| 스키마 시각화 도우미 | 에이전트 모드 워크플로에서 스키마 관계 시각화 |