Visual Studio Code용 PostgreSQL 확장

Visual Studio Code()용 PostgreSQL 확장은ms-ossdata.vscode-pgsql 데이터베이스 개발 도구를 편집기에 직접 제공합니다. VS Code를 종료하지 않고 로컬, 온-프레미스 또는 클라우드 제공 PostgreSQL 서버에 연결하고, IntelliSense를 사용하여 쿼리를 작성하고, 데이터베이스 개체를 탐색하고, 쿼리 계획 및 스키마를 시각화하고, Azure Database for PostgreSQL 유연한 서버 리소스를 관리할 수 있습니다. 또한 이 확장은 AI 지원 쿼리 작성, 분석 및 에이전트 기반 워크플로를 위한 AI 도우미와 통합됩니다.

Get started

확장을 접하는 경우 다음 가이드 중 하나로 시작합니다.

익스텐션 설치

1. Visual Studio 코드를 엽니다.
2. 확장 보기(Ctrl+Shift+X또는 Cmd+Shift+X macOS)를 엽니다.
3. postgresql을 검색합니다.
4. Microsoft PostgreSQL을 선택한 다음 설치를 선택합니다.

주요 기능

다음 섹션에서는 각 주요 기능 영역을 요약합니다. 전체 문서의 각 섹션 끝에 있는 링크를 선택합니다.

연결 대화 상자

연결 대화 상자는 Microsoft Entra ID 및 AWS IAM(RDS/Aurora)에 대한 통합 인증 지원을 통해 로컬, 온-프레미스 및 클라우드 제공 PostgreSQL 서버에 연결합니다. 연결 매개 변수를 개별적으로 입력하거나, 연결 문자열 붙여넣거나, Azure 구독을 찾아 Azure Database for PostgreSQL 유연한 서버 및 Azure HorizonDB(미리 보기) 클러스터를 검색합니다.

• 세 가지 입력 모드: 호스트, 포트, 데이터베이스, 사용자 이름과 같은 개별 값에 대한 매개 변수, 전체 연결 문자열에 대한 연결 문자열, 또는 Azure 찾아보기를 통해 Azure 자산을 탐색하여 PostgreSQL 엔드포인트가 있는 리소스를 선택합니다.
• 저장된 연결 및 최근 연결: 빠른 재사용을 위해 연결 목록에 저장된 프로필이 표시됩니다. 최근에 사용한 연결은 항상 사용할 수 있습니다.
• 서버 그룹: 연결 트리에서 연결을 빠르게 식별하도록 색 코딩을 사용하여 명명된 그룹으로 연결을 구성 합니다 .

자세한 내용은 연결 및 ID 및고급 연결 옵션을 참조하세요.

개체 탐색기

개체 탐색기는 연결된 PostgreSQL 서버의 탐색 가능한 트리 뷰를 제공합니다. 서버, 데이터베이스 및 스키마를 확장하여 테이블, 뷰, 함수, 시퀀스, 형식, 확장, 역할, 테이블스페이스 및 이벤트 트리거를 검사합니다.

• 검색: 기본 제공 검색을 사용하여 지원되는 모든 개체 형식에서 이름으로 개체를 찾습니다.
• 스크립팅: 개체를 마우스 오른쪽 단추로 클릭하여 쿼리 편집기에서 열리는 SELECT, CREATE, ALTER, DROP 또는 EXECUTE 스크립트를 생성합니다.
• 심층 새로 고침: 노드를 새로 고쳐서 확장된 모든 하위 항목을 재귀적으로 업데이트하고, 연결 끊기 없이 스키마 변경 내용을 반영합니다.

자세한 내용은 개체 탐색기를 참조하세요.

쿼리 편집기 및 IntelliSense

쿼리 편집기에서는 PostgreSQL SQL에 대한 풍부한 편집 화면을 제공합니다. IntelliSense는 테이블 이름, 열 이름, 함수, 스키마, 키워드 및 조인 절에 대한 컨텍스트 인식 완성을 제공합니다.

• 쿼리 실행 및 현재 문 실행: 전체 편집기 내용을 실행하거나 커서에서 문만 실행합니다.
• 코드 조각: 일반적인 SQL 패턴(예: CREATE TABLE, INSERT및 SELECT)을 삽입합니다.
• 쿼리 기록: 명령 팔레트에서 이전에 실행한 쿼리에 액세스하여 쿼리를 다시 실행하거나 수정합니다.

자세한 내용은 쿼리 편집기 및 IntelliSense를 참조하세요.

쿼리 결과

결과는 편집기 아래의 PostgreSQL 쿼리 결과 패널에 표시됩니다. 결과 표는 정렬, 필터링 및 열 크기 조정을 지원합니다.

• 내보내기: CSV, JSON 또는 Excel 결과를 저장합니다.
• 차트 시각화: 결과를 꺾은선형, 가로 막대형, 원형 또는 분산형 차트로 시각화합니다.
• 그래프 보기: Apache AGE 그래프 쿼리 결과는 노드 및 에지 보기로 자동으로 전환됩니다.
• 메시지 탭: 행 수, 실행 시간 및 서버 메시지를 검토합니다.

자세한 내용은 쿼리 편집기 및 IntelliSense를 참조하세요.

쿼리 계획 시각화 도우미

쿼리 계획 시각화 도우미는 성능 병목 상태를 식별할 수 있도록 여러 대화형 형식의 출력을 제공합니다 EXPLAIN .

• 네 가지 보기: 트리 보기, 아이시클 보기, 테이블 보기, 소스 보기.
• 메트릭: 노드당 비용 예측, 실제 행 수, 실행 시간 및 버퍼 사용량을 검사합니다.
• 계획 가져오기: 라이브 데이터베이스 연결 없이 저장된 계획 파일 또는 편집기 콘텐츠를 시각화합니다.
• Copilot 분석: 계획에 대한 AI 생성 설명을 보려면 Copilot 사용하여 분석(또는 커서에서 AI로 분석)을 선택합니다.

자세한 내용은 쿼리 계획 시각화 도우미를 참조하세요.

스키마 시각화 도우미

스키마 시각화 도우미는 대화형 엔터티 관계 다이어그램을 생성합니다. 테이블은 내부에 열이 나열되어 있는 드래그 가능한 노드로 표시되며, 외래 키 관계는 연결선으로 표시됩니다.

• 색으로 구분된 스키마: 각 스키마는 빠른 식별을 위해 고유한 색을 받습니다.
• 범례 토글: 스키마 범례를 표시하거나 숨겨 다이어그램 공간을 최대화합니다.

자세한 내용은 스키마 시각화 도우미를 참조하세요.

서버 대시보드

서버 대시보드에는 연결된 서버에 대한 연결 속성, 서버 버전 및 SSL 상태가 표시됩니다. Azure Database for PostgreSQL 유연한 서버의 경우 Azure Monitor 메트릭도 표시합니다. 조사 탭을 사용하면 서버 활동의 특정 영역을 자세히 살펴볼 수 있습니다.

• 개요: CPU, 메모리, 스토리지, 연결, IOPS 및 범주별로 그룹화된 기타 메트릭을 모니터링합니다.
• 쿼리: 개별 쿼리 세부 정보로 드릴다운하여 실행 시간, 호출 수 또는 기타 메트릭별로 순위가 지정된 상위 SQL 문을 봅니다.
• 대기: 순위가 지정된 테이블 및 초과 시간 차트를 사용하여 대기 이벤트를 분석합니다.
• 세션: 활성 세션, 차단 트리 및 잠금 활동을 확인합니다.
• 도구 모음 작업: 연결, 연결 끊기, 새 쿼리 편집기 열기, 스키마 시각화 도우미 시작, AI 채팅 열기 또는 대시보드 도구 모음에서 Azure 관리 작업을 시작합니다.

자세한 내용은 서버 대시보드를 참조하세요.

Azure 서버 관리

VS Code를 종료하지 않고 Azure Database for PostgreSQL 유연한 서버 리소스를 관리합니다.

• 시작, 중지 및 다시 시작: 연결 트리 또는 대시보드에서 서버 수명 주기를 제어 합니다 .
• 방화벽 규칙: 네트워크 액세스 규칙 보기 및 업데이트
• 매개 변수: 매개 변수 찾아보기 및 수정
• 서버 복제: 기존 서버 구성을 복제합니다.

자세한 내용은 Azure 서버 관리를 참조하세요.

서버 만들기

VS Code에서 직접 새 PostgreSQL 서버를 프로비전합니다.

• Docker: 개발 및 테스트를 위해 Docker 컨테이너에 로컬 PostgreSQL 서버를 만듭니다.
• Azure Database for PostgreSQL 유연한 서버: 지역, 컴퓨팅 계층, 스토리지 및 인증을 구성하는 단계별 설정을 안내합니다.
• Azure HorizonDB(미리 보기): 구성 가능한 vCore 및 선택적 AI 기능을 사용하여 클라우드 네이티브의 확장성이 뛰어난 PostgreSQL 클러스터를 프로비전합니다.

자세한 내용은 PostgreSQL 서버 만들기를 참조하세요.

코파일럿 통합

확장은 채팅, 편집기 작업 및 다단계 도구 워크플로에서 AI 도우미와 통합됩니다.

• @pgsql 채팅 참가자: 데이터베이스에 대한 자연어 질문을 하거나, 쿼리를 생성하거나, GitHub Copilot Chat 패널에서 PostgreSQL 개념에 대한 도움을 받으세요. Visual Studio Code 전용. 자세한 내용은 @pgsql 채팅 참가자를 참조하세요.
• 편집기 작업: 편집기에서 SQL을 마우스 오른쪽 단추로 클릭하여 쿼리를 설명하거나, 최적화를 위해 다시 작성하거나, AI 쿼리 작업 하위 메뉴에서 실행 계획을 분석합니다. Visual Studio Code와 Cursor 모두에서 사용할 수 있습니다.
• 에이전트 모드: AI 에이전트는 라이브 데이터베이스 작업과 AI 추론을 결합하여 PostgreSQL 도구를 직접 호출합니다. Visual Studio Code와 Cursor 모두에서 사용할 수 있습니다. 자세한 내용은 에이전트 모드를 참조하세요.

모든 AI 기능에 대한 개요는 Copilot 통합을 참조하세요.

MCP 서버

확장은 지원되는 AI 지원 호스트에 연결 관리, 스키마 탐색, 쿼리 실행 및 쿼리 계획 시각화를 포함한 PostgreSQL 도구를 노출하는 MCP(모델 컨텍스트 프로토콜) 서버를 등록합니다. 외부 AI 도구는 이 등록을 통해 프로그래밍 방식으로 PostgreSQL 연결과 상호 작용할 수 있습니다.

자세한 내용은 MCP 서버를 참조하세요.

터미널에서 psql 사용

psql Connections 트리의 데이터베이스에 연결된 터미널 세션을 열거나, 편집기 컨텍스트 메뉴에서 직접 .sql 파일을 psql 통해 실행합니다. 이렇게 하면 \ 메타 명령, COPY, 대화형 스크립팅과 같은 기본 psql 기능에 완전히 액세스할 수 있습니다.

자세한 내용은 터미널에서 psql 사용을 참조하세요.

Oracle에서 PostgreSQL로 마이그레이션

AI 지원 마이그레이션 워크플로를 사용하면 Oracle 데이터베이스 스키마 및 개체를 PostgreSQL 호환 SQL로 변환할 수 있습니다.

• 마이그레이션 안내: Oracle 원본에 연결하고, 마이그레이션할 개체를 선택하고, 변환된 출력을 검토합니다.
• AI 지원 변환: Microsoft Foundry 모델은 Oracle 관련 구문, 데이터 형식 및 절차 코드를 PostgreSQL 등가물로 변환합니다.

자세한 내용은 Oracle에서 PostgreSQL로 마이그레이션을 참조하세요.

지원되는 운영 체제

피드백 및 지원

버그를 보고하거나 기능을 요청하려면 vscode-pgsql GitHub 리포지토리에 문제를 제출합니다.

관련 콘텐츠

• 빠른 시작: PostgreSQL 연결 및 쿼리
• 연결 및 자격 증명
• 쿼리 편집기 및 IntelliSense
• Copilot 통합