Visual Studio Code에서 데이터베이스 에이전트 사용하기

Database Agents는 Visual Studio Code와 통합되어 에이전트를 구성하고, AI 지원 성능 조사를 검토하며, 실시간 서버 상태를 점검하고, 편집기를 떠나지 않고도 수동 대응을 수행할 수 있습니다.

Important

Azure Database for PostgreSQL 유연한 서버용 데이터베이스 에이전트는 현재 Visual Studio Code에서 제한된 미리 보기로 제공됩니다. 액세스가 제한되며 승인이 필요합니다. 접근 권한을 요청하려면 데이터베이스 에이전트 제한적 미리보기 참여 양식을 작성하세요.

AI 생성 진단, SQL 문장 및 매개변수 변경 사항을 실제 서버에 대해 검증한 후 조치를 수행하고, 조직의 승인 및 변경 관리 워크플로우를 따르세요.

Note

  • Azure Database for PostgreSQL 플렉시블 서버: 현재 Visual Studio Code에서 제한된 미리보기로 제공됩니다. Fabric Database Hub에서 PostgreSQL 데이터베이스 에이전트에 대한 지원이 곧 제공될 예정입니다.
  • Azure SQL Database: Visual Studio Code 지원이 곧 제공될 예정입니다. 오늘은 Azure SQL Database용 Database Hub를 사용하세요.

Prerequisites

Important

Azure Database for PostgreSQL용 데이터베이스 에이전트는 제한된 미리 보기 상태입니다. 이 기능을 사용하도록 설정하려면 먼저 참여 양식을 통해 액세스를 요청하고 승인을 받아야 합니다.

  • 지원되는 제한된 미리보기 지역(South Central US, West US 3, 또는 Sweden Central)에서 PostgreSQL 16 이상에서 실행되는 Azure Database for PostgreSQL의 유연한 서버를 사용하십시오.
  • Visual Studio Code 설치(모델 컨텍스트 프로토콜(MCP) 에이전트 도구에는 버전 1.102.0 이상이 권장됩니다).
  • Visual Studio Code용 PostgreSQL 확장 기능(버전 1.32.0 이상)을 설치하세요.
  • Microsoft Entra ID로 로그인하며, Azure 서버 리소스에 대한 접근 권한(데이터베이스 에이전트 구성 시 서버 리소스에 대한 Azure RBAC 쓰기 권한 포함), PostgreSQL 자격 증명 및 네트워크 액세스를 통해 쿼리를 연결하고 실행할 수 있습니다.
  • (선택 사항) Visual Studio Code에 GitHub Copilot를 설치하여 이 섹션과 에이전트 모드 도구에 대해 Copilot에게 질문하기을 사용하세요.

서버의 Open Database Agent를 엽니다

PostgreSQL 확장에서 Azure Database for PostgreSQL 유연한 서버를 연결하여 데이터베이스 에이전트를 열거나 서버 대시보드에서 발견 사항을 확인하세요.

  1. Visual Studio Code에서 활동 표시줄의 PostgreSQL 아이콘을 선택하여 연결을 엽니다.

  2. 서버 항목에서 Azure Database for PostgreSQL 플렉시브 서버에 추가하거나 연결하고, 요청이 표시되면 Azure 계정으로 로그인하세요.

  3. 연결된 서버 노드를 마우스 오른쪽 버튼으로 클릭하세요:

    • 데이터베이스 에이전트 를 선택하여 서버용 데이터베이스 에이전트를 구성하고 관리합니다.
    • 대시보드를 선택하여 서버 대시보드를 열고 진행 중인 조사 및 문제를 검토하세요.

    Visual Studio Code의 PostgreSQL 연결 트리 스크린샷으로, 대시보드 및 데이터베이스 에이전트가 포함된 서버 컨텍스트 메뉴를 보여줍니다.

  4. 대시보드 도구 모음에 Azure Server 감지됨이 표시되면 확장이 서버의 Azure 리소스 식별자를 확인할 수 있도록 메타데이터 가져오기를 선택하세요. Incomplete Azure Metadata가 표시되면 배너에서 메타데이터 가져오기를 선택하여 테넌트 확인을 완료하세요.

문제 검토

Visual Studio Code의 서버의 대시보드 탭에서 PostgreSQL 데이터베이스 에이전트 문제를 직접 검토하고 관리할 수 있습니다.

  1. 서버용 대시보드 를 엽니다. 데이터베이스 에이전트가 조사 중이거나 서버에서 문제를 감지하면, 대시보드 상단에 문제 수와 함께 조사 배너가 나타납니다—'N개 문제 중 첫 번째 보기'를 선택하여 바로 결과로 이동하세요.

  2. 문제를 확장하여 심각도, 상태(예: DETECTED 또는 DIAGNOSED), 탐지 타임스탬프, AI 생성 분석을 검사합니다:

    • 권장 조치에는 권장 변경(생성된 SQL 및 편집기에서 열기와 복사 컨트롤 포함), 이것이 안전한 이유, 롤백 SQL(여기에도 편집기에서 열기 및 복사 포함), 그리고 전체 세부 정보 보기가 포함됩니다.
    • 예상 결과 는 예상되는 업무량 개선을 요약하고 접이식 롤백 계획을 제공합니다.
    • 문제 하단의 동작 버튼을 통해 검토 작업, 수동 적용 표시, 또는 문제 무시을 선택할 수 있습니다.

    Visual Studio Code 서버 대시보드에서 PostgreSQL 데이터베이스 에이전트 이슈의 스크린샷으로, 조사 배너, 권장 조치, 안전 이유, SQL 롤백, 예상 결과, 문제 작업 버튼이 표시됩니다.

  3. AI로 이슈 섹션을 탐색하려면 Copilot에게 질문하기 about this section이라고 표시된 반짝임 아이콘을 RECOMMENDED ACTION 또는 EXPECTED OUTCOME 같은 제목 옆에서 선택하세요. GitHub Copilot 채팅은 구조화된 이슈 세부 정보가 미리 로드되어 있어 후속 질문을 하거나 실시간 서버 지표, 세션 또는 실행 계획을 확인할 수 있습니다.

    PostgreSQL 데이터베이스 에이전트 문제에 대한 권장 조치 옆에서 '이 섹션에 대해 Copilot에게 질문하기'을 선택한 스크린샷, 문제 세부 정보가 미리 로드된 GitHub Copilot Chat이 열리는 모습.

문제에 대응하기

캡처된 증거는 문제가 진단되었을 당시 서버 상태를 반영하며, AI가 생성한 결과는 불완전하거나 부정확할 수 있습니다. 변경 전에 모든 권장 사항을 라이브 서버에서 검증하세요.

  1. 서버 대시보드 (쿼리, 대기, 세션 탭)를 사용하거나 쿼리 편집기를 열어 감지된 상태가 라이브 서버에서 여전히 활성 상태인지 확인하세요(예: 쿼리 pg_stat_activity 및 pg_locks 호출 pg_terminate_backend()전).

  2. SQL 변경(예: 인덱스 생성 또는 ANALYZE 실행)의 경우, RECOMMENDED ACTION의 권장 변경 SQL 블록에서 편집기에서 열기 또는 복사를 선택하세요:

    • 쿼리 또는 인덱스 변경 사항을 검증할 때 EXPLAIN에서 출력을 검사합니다.
    • 잠금과 리소스 영향을 검토하고(예: 활성 테이블에서 쓰기 차단을 피하기 위해 CREATE INDEX CONCURRENTLY를 유지), 롤백 SQL을 준비 상태로 유지하세요.
    • 승인된 명령문을 승인된 데이터베이스 워크플로우를 통해 수동으로 실행하세요.
  3. 서버 매개변수 권장 사항(예: 튜닝 work_mem 또는 자동 진공 청소 설정)을 위해 연결>서버 에서 서버를 마우스 오른쪽 버튼으로 클릭하고 서버 관리>서버 매개변수를 선택하십시오. 정적 매개변수 변경으로 재시작이 필요한 경우, 승인된 유지 관리 시간 동안 서버 관리>서버 다시 시작을 사용하십시오.

    Visual Studio Code의 PostgreSQL 서버 컨텍스트 메뉴 스크린샷에서 서버 관리 및 서버 매개변수를 강조 표시합니다.

  4. 라이브 서버 메트릭과 쿼리 계획을 다시 확인하여 워크로드가 복구되었는지 확인하십시오.

  5. 대시보드에서 해당 문제로 돌아가 문제 해결을 완료했음을 기록하려면 수동 적용으로 표시를 선택하고, 변경이 필요하지 않으면 문제 해제를 선택하세요. 기각된 쟁점에 대한 해고 내역을 여전히 검토할 수 있습니다.

데이터베이스 엔진별 Surface 사용 가능 여부

미리 보기 기간에는 Visual Studio Code와 Fabric Database Hub에서의 데이터베이스 에이전트 지원이 엔진별로 다릅니다:

Engine 비주얼 스튜디오 코드 Fabric 데이터베이스 허브
유연한 서버 Azure Database for PostgreSQL 현재 (제한적 미리보기) PostgreSQL 확장(데이터베이스 에이전트 및 대시보드)을 통해 제공됩니다. 곧 Database Agents에 적용 예정(기본 환경 및 지표 모니터링은 Azure Database for PostgreSQL 유연한 서버 모니터링에서 제공됩니다)
Azure SQL Database 곧 출시 예정 데이터베이스 허브에서 지금 사용 가능(미리보기)