다음을 통해 공유

빠른 시작: Visual Studio Code용 PostgreSQL 확장을 사용하여 데이터베이스 연결 및 쿼리

Visual Studio Code용 PostgreSQL 확장은 PostgreSQL 데이터베이스의 개발 및 관리를 간소화하도록 설계된 강력한 도구입니다. 이 가이드에서는 PostgreSQL 데이터베이스에 연결하고 Visual Studio Code 환경 내에서 쿼리를 실행하는 방법을 안내합니다.

Prerequisites

시작하기 전에 적절한 도구와 리소스를 다운로드하여 설치했는지 확인합니다.

이러한 도구와 리소스는 이 문서를 따르고 Visual Studio Code의 PostgreSQL 확장에 대한 GitHub Copilot 통합을 최대한 활용하는 데 도움이 됩니다.

PostgreSQL 확장 설치

PostgreSQL 확장을 설치하려면 다음을 수행합니다.

  1. Visual Studio Code를 열고 작업 표시줄에서 확장 아이콘을 선택하거나 보기: 확장 명령을 사용하여 확장 보기로 이동합니다.
  2. 확장 마켓플레이스에서 PostgreSQL 을 검색합니다.
  3. Microsoft에서 작성한 PostgreSQL 확장을 선택하고 설치를 선택합니다.

확장이 설치되면 코끼리 아이콘으로 표시되는 PostgreSQL 페이지가 Visual Studio Code 사이드바에 표시됩니다.

PostgreSQL에 연결 추가

로컬 또는 원격 서버에서 호스트되는지에 관계없이 PostgreSQL 데이터베이스에 연결하는 것은 데이터를 관리하고 상호 작용하는 기본적인 단계입니다. 이 프로세스에는 클라이언트 애플리케이션과 데이터베이스 간에 보안 링크를 설정하기 위해 서버 주소, 포트 및 인증 자격 증명과 같은 필요한 연결 세부 정보를 제공하는 작업이 포함됩니다. Visual Studio Code용 PostgreSQL 확장을 사용하면 데이터베이스에 원활하게 연결하고 강력한 도구를 사용하여 데이터를 효율적으로 쿼리, 관리 및 탐색할 수 있습니다.

  1. 사이드바에서 코끼리 아이콘을 선택하여 PostgreSQL 확장 페이지를 엽니다.

  2. 연결 추가 단추를 선택합니다.

  3. 연결 세부 정보를 수동으로 입력하거나 연결 문자열 형식을 사용합니다.

      psql -h <server>.postgres.database.azure.com -p 5432 -U

  4. Azure를 사용하는 경우 Azure 계정에 로그인하고 데이터베이스 인스턴스를 찾습니다. 구독, 리소스 그룹, 서버 및 데이터베이스 이름을 필터링합니다.

Authentication

확장은 다음 두 가지 인증 방법을 지원합니다.

  • 사용자 이름/암호: 연결 필드에 직접 데이터베이스 자격 증명을 입력합니다.
  • Microsoft Entra ID 인증: Azure 호스팅 데이터베이스에 대한 Microsoft Entra ID 계정을 추가합니다.

Visual Studio Code 연결 대화 상자의 PostgreSQL 확장 스크린샷

연결 테스트 및 저장

  1. 연결 테스트를 선택하여 연결 세부 정보를 확인합니다.
  2. 테스트에 성공하면 테스트 상자에 확인 표시가 표시됩니다.
  3. 연결을 설정하려면 연결을 선택합니다.
  4. 연결이 자동으로 저장되고 연결 창에 표시됩니다.

데이터베이스 개체 검색

개체 탐색기는 데이터베이스 개체의 계층적 보기를 제공합니다.

  • 데이터베이스 항목을 확장하여 스키마, 테이블, 뷰, 함수 및 저장 프로시저를 봅니다.
  • 데이터베이스를 마우스 오른쪽 단추로 클릭하여 다음 옵션을 확인합니다.
    • 새 쿼리 시작
    • 이 데이터베이스와 채팅(pgsql 채팅 환경 시작)
    • PSQL로 연결하여 psql 터미널 연결 시작
  • 테이블을 마우스 오른쪽 단추로 클릭하고 상위 1000개 선택 항목을 선택하여 해당 데이터를 봅니다. 쿼리가 쿼리 편집기에서 열리고 결과는 결과 뷰어 탭에 표시됩니다.

쿼리 실행

쿼리 편집기를 사용하여 SQL 쿼리 초안을 작성하고 실행합니다.

  • 컨텍스트 인식 IntelliSense를 활용하여 SQL 키워드 및 개체 이름을 자동으로 완성합니다.
  • 가독성과 정확도를 높이기 위해 구문 강조 표시 및 자동 서식을 사용합니다.
  • 쿼리 기록 창을 통해 이전에 실행한 쿼리에 액세스합니다.

쿼리 결과 검토

결과 뷰어는 쿼리 결과와 상호 작용하는 고급 기능을 제공합니다.

  • 추가 분석을 위해 결과를 CSV, JSON 또는 Excel 형식으로 내보냅니다.
  • 검색, 필터링 및 정렬 옵션을 사용하여 데이터를 구체화합니다.
  • 영구 데이터 뷰는 탭 간에 전환하는 동안 컨텍스트를 유지 관리합니다.

고급 지원을 위해 GitHub Copilot 사용

GitHub Copilot 통합은 AI 기반 코드 제안, 쿼리 최적화 팁 및 대화형 데이터베이스 지원을 제공하여 PostgreSQL 개발 환경을 향상시킵니다. 이 기능을 사용하면 워크플로를 간소화하고, 개발 시간을 줄이고, 데이터베이스 작업에 대한 심층적인 인사이트를 얻을 수 있습니다. 이 섹션에서는 Visual Studio Code용 PostgreSQL 확장 내에서 Copilot를 활성화하고 사용하는 단계를 안내합니다.

GitHub Copilot 및 Copilot 채팅 확장이 설치되어 있는지 확인합니다.

GitHub 계정에 로그인하고 확장 설정에서 Copilot 채팅 에이전트를 사용하도록 설정합니다 @pgsql .

대화형 데이터베이스 프롬프트

데이터베이스를 마우스 오른쪽 단추로 클릭하고 이 데이터베이스와의 채팅 을 선택하여 Copilot와 상호 작용합니다.

자세한 인사이트 및 제안을 받으려면 다음 예제와 같은 프롬프트를 작성합니다.

@pgsql tell me about the tables in the HR schema

자세한 내용은 GitHub Copilot 구성을 참조하세요.

Visual Studio Code를 사용하여 Azure Database for PostgreSQL에 연결

다음 단계에 따라 Visual Studio Code를 사용하여 Azure Database for PostgreSQL 유연한 서버 인스턴스에 연결합니다.

  1. Azure Portal에 로그인하고 Azure Database for PostgreSQL 유연한 서버 인스턴스를 찾습니다.
  2. 서버 인스턴스의 개요 페이지로 이동합니다.

Visual Studio Code를 사용하여 연결

Azure Portal의 "Visual Studio Code로 연결" 옵션을 사용하면 Azure Database for PostgreSQL 유연한 서버 인스턴스에 대한 연결이 간소화됩니다. 이 기능은 필요한 필수 구성 요소를 안내하고 연결 세부 정보를 자동으로 구성하여 설정을 간소화합니다. 이 통합을 사용하면 신속하게 연결을 설정하고 Visual Studio Code 환경 내에서 직접 데이터베이스를 관리할 수 있습니다.

  • 개요 페이지에서 Visual Studio Code를 사용하여 눈에 띄는 연결 단추를 선택합니다.
  • Visual Studio Code를 사용하여 연결하기 위한 요구 사항을 나열하는 측면 창이 나타납니다.

Visual Studio Code로 연결 단추가 있는 Azure Database for PostgreSQL 인스턴스를 보여 주는 Azure Portal의 스크린샷

요구 사항 확인

  • 측면 창에서 적절한 확인란을 선택하여 모든 필수 구성 요소(Visual Studio Code 및 PostgreSQL 확장)가 충족되는지 확인합니다.

  • 필요한 경우 측면 창의 링크를 사용하여 Visual Studio Code 및 확장을 다운로드합니다.

  • 필요에 따라 기본 데이터베이스 이름, 인증 방법 및 연결 풀링과 같은 연결 매개 변수를 입력합니다.

    Visual Studio Code로 연결 패널이 있는 Azure Database for PostgreSQL 인스턴스를 보여 주는 Azure Portal의 스크린샷 Visual Studio Code에서 열기 단추가 강조 표시됩니다.

Visual Studio Code에서 열기

  • 측면 창 에서 Visual Studio Code에서 열기 단추를 선택합니다.
  • Visual Studio Code 및 확장을 여는 데 40초 이상이 걸리면 Visual Studio Code에서 다시 시도 열기 단추가 측면 창에 나타납니다.

Visual Studio Code 시작

  • Visual Studio Code가 설치되고 실행되면 PostgreSQL 확장의 연결 대화 상자가 자동으로 시작됩니다.
  • Visual Studio Code가 설치되어 있지만 열리지 않으면 약 40초 내에 시작되고 연결 대화 상자가 나타납니다.

연결 세부 정보 자동 채우기

PostgreSQL 확장의 연결 대화 상자가 열리고 서버 이름 필드가 서버 엔드포인트를 자동으로 채웁니다.

서버 이름 세부 정보가 미리 채워진 Visual Studio Code 연결 대화 상자의 PostgreSQL 확장 스크린샷

인증 세부 정보 제공

기본 인증 방법을 선택합니다.

  • 암호 인증: 사용자 이름 및 암호를 수동으로 입력합니다.
  • Entra 인증: Azure 계정 자격 증명을 입력합니다.

프로필 이름, 데이터베이스 이름(선택 사항), 서버 그룹 및 포트 번호와 같은 다른 연결 세부 정보를 지정합니다.

저장 및 연결

연결 저장 및 연결 단추를 선택하여 연결을 설정합니다. 연결되면 개체 탐색기 트리에서 서버를 확장하여 데이터베이스, 스키마 및 테이블을 보거나 기본 제공 쿼리 도구를 사용하여 데이터베이스 개체를 관리합니다.

Troubleshoot

연결 프로세스 중에 문제가 발생하는 경우:

  • Visual Studio Code 및 PostgreSQL 확장이 설치되고 사용하도록 설정되어 있는지 확인합니다.

  • Azure Database for PostgreSQL의 방화벽 설정에서 IP 주소가 허용되는지 확인합니다.

  • 필수 구성 요소를 충족하지 않는 경우 사이드 창은 연결 다시 시도를 포함하여 문제를 해결하기 위한 피드백과 단계를 제공합니다.

피드백 및 지원

버그, 기능 요청 및 문제의 경우 Visual Studio Code의 기본 제공 피드백 도구를 사용합니다. Visual Studio Code 도움말 메뉴 또는 PGSQL 명령 팔레트를 통해 이 피드백 프로세스를 완료할 수 있습니다.

  • 도움말 메뉴

    • 도움말 > 보고서 문제로 이동

  • 명령 팔레트

    • 명령 팔레트 Ctrl + Shift + P 를 열고 다음을 실행합니다. PGSQL: Report Issue

관련 콘텐츠

  • Last updated on