데이터베이스 에이전트 사용하도록 설정 및 활성화

이 문서는 선택한 Azure SQL 데이터베이스 또는 Azure Database for PostgreSQL 유연한 서버에 대해 Database Agents를 사용하도록 설정하고 이를 활성화해야 하는 데이터베이스 관리자를 위한 문서입니다.

Important

데이터베이스 에이전트는 미리보기 상태입니다. 지원되는 데이터베이스 및 서버 범위를 사용하고, 프로덕션 워크로드에 사용하도록 설정하기 전에 조직의 운영 요구 사항을 검토하십시오.

Note

Azure Database for PostgreSQL 플렉시블 서버용 데이터베이스 에이전트는 현재 Visual Studio Code에서만 제한된 미리보기로 제공됩니다. 액세스가 제한되며 승인이 필요합니다. 접근 권한을 요청하려면 데이터베이스 에이전트 제한된 미리 보기 참여 양식을 작성하세요. Fabric Database Hub에서 PostgreSQL 데이터베이스 에이전트에 대한 지원이 곧 제공될 예정입니다.

Prerequisites

  • 지원되는 Azure SQL 데이터베이스(지원되는 서버리스 또는 하이퍼스케일 데이터베이스를 포함)를 사용하세요. One-vCore 서버리스 데이터베이스는 지원되지 않습니다.
  • 데이터베이스에 접근할 권한이 있는 신원으로 Fabric에 로그인하세요.
  • 데이터베이스가 Fabric 테넌트 홈 리전과 관련된 지원되는 영역에 있는지 확인합니다.
  • Microsoft SQL에 대한 성능 모니터링 활성화에서 해당 설정을 완료하세요. Azure SQL Database에 대한 지침을 따르세요. 데이터베이스가 서버리스라면, 절전 해제되어 있는지 확인하세요.
  • 에이전트를 저장할 때 선택한 모든 데이터베이스에 대해 Azure 리소스에 대해 Azure 역할 기반 접근 제어(Azure RBAC) 쓰기 권한이 필요합니다. 이 권한은 SQL 변경 실행 권한과는 구별됩니다.

Important

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

  • Visual Studio Code와 Visual Studio Code용 PostgreSQL 확장 기능(버전 1.32.0 이상)을 설치하세요.
  • 지원되는 제한된 미리보기 지역(South Central US, West US 3, 또는 Sweden Central)에서 실행 중인 Azure Database for PostgreSQL for PostgreSQL 플렉시브 서버를 PostgreSQL 16 이상(Burstable, General Purpose 또는 Memory Optimized 컴퓨팅 티어 포함)에서 사용하세요.
  • Azure 서버 리소스에 접근할 수 있는 ID(에이전트 구성 시 서버 리소스에 대한 Azure RBAC 쓰기 권한 포함)와 함께 서버에 연결할 수 있는 PostgreSQL 자격 증명으로 Visual Studio Code에 로그인하세요.

Note

모든 PostgreSQL 조사는 AI 지원을 받으며, 미국 데이터 존 ( 남중부 미국 및 서부 US 3)과 EU 데이터 존 ( 스웨덴 중부 포함)에서 AI 모델 처리가 이루어집니다. 한정 미리보기에서는 조사 비용을 지불하지 않습니다. 청구는 일반 제공 전에 시작되며, Microsoft는 청구 시작 전에 등록된 고객에게 미리 알림을 보냅니다.

데이터베이스 에이전트 사용 및 활성화

먼저, Fabric Database Hub에서 데이터베이스 에이전트를 사용 설정하고 활성화하세요:

  1. Fabric 데이터베이스 허브를 엽니다.
  2. 왼쪽 상단에서 에이전트 관리를 선택합니다.
  3. 데이터베이스 에이전트 설정을 선택합니다.
  4. 사용을 켜세요.
  5. 저장을 선택합니다.

이 단계는 데이터베이스 에이전트를 활성화하지만, 어떤 데이터베이스에도 데이터베이스 에이전트를 활성화하지는 않습니다.

성능 모니터링을 활성화한 후에는 데이터베이스 목록과 구성이 업데이트될 때까지 약 15분간 기다리십시오. 이 정보가 제공되기 전까지는 데이터베이스를 등록할 수 없습니다. 문제 감지는 등록 전에 시작되지 않습니다.

  1. 데이터베이스 에이전트가 모니터링할 하나 이상의 데이터베이스를 선택하세요.

  2. 선택한 데이터베이스에 대해 에이전트 정책을 엽니다.

  3. 활성화 항목에서 데이터베이스 에이전트가 분석 및 안내를 제공하는 작업 범주 또는 개별 작업을 선택합니다:

    작업 범주 활동
    차단 및 교착 상태 차단 세션 종료(차단 세션 식별)
    쿼리 성능 장기 실행 쿼리를 표시합니다; 마지막으로 정상으로 확인된 계획을 강제합니다
    인덱스 튜닝 누락된 인덱스 생성; 사용하지 않는 인덱스 삭제; 중복 인덱스 삭제
    자원 압박과 경합 CPU 사용량 높음 플래그; 메모리 사용량 높음 플래그; I/O 사용량 높음 플래그
  4. 적용을 선택합니다.

  5. 데이터베이스 구성을 저장하려면 저장을 선택하세요.

저장은 선택한 모든 데이터베이스에 대해 에이전트를 검증하고 Azure 리소스에 대한 쓰기 권한을 확인합니다. 선택한 데이터베이스 중 하나라도 해당 권한 검사에 실패하면 전체 저장이 실패합니다. 권한이 없는 데이터베이스를 선택한 목록에서 제거한 후 나머지 구성을 저장하세요. 기타 저장 실패에 대해서는 에이전트를 저장할 수 없거나 활성 상태가 되지 않음을 참조하세요.

에이전트 정책의 동작 이름은 UI 레이블입니다. 동작을 활성화해도 명명된 데이터베이스 변경이 승인되거나 실행되지 않습니다. 모든 시나리오에 대해 이슈 관련 지침을 검토하고 승인된 데이터베이스 워크플로우를 통해 수동으로 대응을 수행하십시오.

제한 미리보기 기간 동안, Visual Studio Code에서 PostgreSQL용 데이터베이스 에이전트를 직접 구성하고 엽니다(Fabric Database Hub 지원은 곧 제공됩니다):

  1. Visual Studio Code에서 활동 표시줄의 PostgreSQL 아이콘을 선택하여 연결을 엽니다.
  2. 서버 항목에서 Azure Database for PostgreSQL 플렉시브 서버에 추가하거나 연결하고, 요청이 표시되면 Azure 계정으로 로그인하세요.
  3. 연결된 서버 노드를 마우스 오른쪽 버튼으로 클릭하고 데이터베이스 에이전트 를 선택하여 서버용 데이터베이스 에이전트를 구성하고 활성화하십시오.
  4. 대시보드를 열고 Azure Server Detected(또는 불완전한 Azure 메타데이터)를 보면 Fetch 메타데이터를 선택하여 확장이 서버의 Azure 리소스 ID를 해결하도록 합니다.

스크린샷이 포함된 전체 Visual Studio Code 워크플로우는 'Visual Studio Code에서 데이터베이스 에이전트 사용하기'를 참조하세요.

결과를 확인해

  1. 데이터베이스 에이전트 설정을 열고 녹색 데이터베이스 에이전트가 활성 상태 메시지가 나타나는지 확인합니다. 이 메시지는 각 데이터베이스별로 별도의 활성화 상태가 아니라 에이전트 수준 상태를 표시합니다. 문제가 있는지 확인하기 전에 구성 저장이 오류 없이 완료되었는지 확인하십시오.
  2. 구성을 저장한 후 약 15분간 새 문제가 나타나기를 기다린 후 데이터베이스 허브에서 문제 목록을 엽니다. 문제는 Database Agents가 등록된 데이터베이스에서 조건을 감지할 때만 나타납니다. 이 15분 이슈 생성 간격은 SQL 성능 모니터링을 활성화한 후 초기 전파 지연과는 별개입니다.

높은 CPU 사용량이나 장기 실행 쿼리 문제를 검토할 때, 수동 응답을 결정하기 전에 선택적으로 컨텍스트 AI로 조사할 수 있습니다.

  1. Visual Studio Code의 연결>서버 아래의 서버를 마우스 오른쪽 버튼으로 클릭하고 대시보드를 선택합니다.
  2. 서버의 Azure 메타데이터가 로드되었는지 확인하고 대시보드 상단에서 Investigation 배너를 모니터링하세요. 서버를 활성화한 후에는 활성 조건을 감지하고 문제를 드러내는 데 최대 15분이 걸릴 수 있습니다.

제한 사항 및 알려진 문제

  • 현재 Azure SQL Database용 데이터베이스 에이전트는 Fabric Database Hub에서 사용할 수 있습니다(Visual Studio Code 지원은 곧 제공될 예정입니다).
  • 현재 데이터베이스 에이전트는 Azure SQL 탄력적 풀, 단일 vCore 서버리스 데이터베이스, Azure SQL Managed Instance, Azure Virtual Machines의 SQL Server 또는 Azure Arc으로 활성화된 SQL Server을 지원하지 않습니다.
  • 데이터베이스는 Fabric 테넌트 홈 리전과 연관된 지원되는 영역에 있어야 합니다.
  • 현재 PostgreSQL용 데이터베이스 에이전트는 Visual Studio Code에서만 제공되며, Fabric Database Hub에서의 지원도 곧 제공될 예정입니다.
  • 현재 Database Agents는 Azure Database for PostgreSQL 유연한 서버(PostgreSQL 16 이상)만 지원합니다. Azure HorizonDB에 대한 지원이 곧 제공될 예정입니다.
  • PostgreSQL 지원은 현재 제한된 미리 보기로 미국 남중부, 미국 서부 3 및 스웨덴 중부의 서버에서 제공되며(미국 데이터 존 및 EU 데이터 존에서 AI 처리), 있습니다. 접근 권한이 제한되며, 데이터베이스 에이전트의 제한적 미리보기 참여 양식을 통한 승인이 필요합니다.
  • 새로 활성화된 데이터베이스, 서버 또는 시나리오는 문제가 생성되는 데 약 15분이 걸릴 수 있습니다.
  • 권장 사항을 검토하고 승인된 워크플로우를 통해 데이터베이스나 서버 변경 사항을 적용하세요.

Troubleshoot

현재 설치 및 문제 발견 점검에 대해서는 데이터베이스 에이전트 제한 사항 및 문제 해결을 참조하세요.

다음 단계