데이터베이스 에이전트란 무엇인가요?

데이터베이스 에이전트는 애플리케이션 소유자와 데이터베이스 관리자가 Azure SQL Database 및 Azure Database for PostgreSQL flexible server에서 지원되는 성능 문제를 탐지, 조사 및 대응할 수 있도록 지원합니다.

데이터베이스 에이전트를 사용하여 다음을 수행하세요:

  • 지원되는 데이터베이스 성능 조건을 감지합니다.
  • 쟁점 요약, 증거, 지침을 검토하세요.
  • 조사, 문제 종료, 재발 상황을 추적하세요.

데이터베이스 에이전트를 어디서 사용하는지는 미리보기 시 데이터베이스 엔진에 따라 달라집니다:

  • Azure SQL Database:Fabric Database Hub에서 제공됩니다. Visual Studio Code 지원이 곧 도입될 예정입니다.
  • Azure Database for PostgreSQL 플렉시블 서버:Visual Studio Code에서 제한된 미리보기로 제공됩니다. Fabric Database Hub 지원이 곧 제공될 예정입니다.

데이터베이스 에이전트는 기존 ID, Azure 리소스 권한 및 데이터베이스 권한을 사용합니다. 추가 접근을 부여하거나 기존 승인 및 변경 관리 요구 사항을 우회하지 않습니다.

Important

데이터베이스 에이전트는 미리보기 상태입니다. 지원되는 문제를 조사하고 지침을 제공합니다. 이슈에서 데이터베이스 변경을 직접 적용할 수는 없습니다. 모든 시나리오는 승인된 데이터베이스 워크플로우를 통한 수동 응답이 필요합니다.

Note

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

데이터베이스 에이전트의 작동 방식

데이터베이스 에이전트는 선택된 데이터베이스와 서버에 대해 안내된 운영 워크플로우를 생성합니다:

  1. 지원되는 데이터베이스 조건을 감지합니다.
  2. 상태를 조사하고 증거를 수집하세요.
  3. 문제 유형에 따라 다음 대응을 안내하거나 추천하세요.
  4. 조사 및 이슈 상태를 종료 또는 재발 시까지 추적하세요.

모든 문제는 수동 대응을 위한 지침을 제공합니다. 기존 데이터베이스 권한과 운영 통제는 계속 적용됩니다.

데이터베이스 에이전트가 AI를 사용하는 방법

Database Agents는 대형 언어 모델(LLM) 없이도 Azure SQL Database 문제를 탐지하고 조사합니다. 이 핵심 조사는 Copilot 용량을 소모하지 않습니다.

높은 CPU와 장기간 진행되는 쿼리 문제의 경우, 선택적으로 맥락형 AI 지원을 활용해 증거를 탐색할 수 있습니다. 컨텍스트 AI는 LLM과 관리자가 할당한 Copilot 용량을 사용합니다.

모든 Azure Database for PostgreSQL 조사는 AI 지원을 받습니다. Database Agents는 대규모 언어 모델(LLM)을 사용하여 상태를 진단하고 수동 대응을 권장합니다. AI 모델 처리는 미국 지역(미국 중남부 및 미국 서부 3)의 경우 US Data Zone에서, 스웨덴 중부의 경우 EU Data Zone에서 실행됩니다.

제한 미리보기 기간 동안에는 PostgreSQL 데이터베이스 에이전트 조사에 대해 비용을 지불하지 않습니다. 청구는 일반 제공 전에 시작되며, Microsoft는 청구 시작 전에 등록된 고객에게 미리 알림을 보냅니다.

Get started

데이터베이스 에이전트를 활성화하기 전에 다음 사전 요구 사항을 확인하십시오.

Prerequisites

  • 모니터링하려는 Azure SQL 데이터베이스에 접근할 수 있는 ID로 Fabric에 로그인하세요.
  • 지원되는 Azure SQL 데이터베이스를 사용하세요.
  • 데이터베이스가 서버리스인 경우, 데이터베이스 에이전트가 평가할 수 있도록 깨어 있는지 확인하세요.
  • 데이터베이스가 Fabric 테넌트 홈 리전에 관련된 지원되는 영역에 있는지 확인합니다.
  • Microsoft SQL용 성능 모니터링 활성화에서 해당 Azure SQL Database 설정을 완료하세요.
  • 문제를 보려면 데이터베이스 읽기 권한이 있는지 확인하세요.
  • 에이전트를 저장할 때 선택한 모든 데이터베이스에 대해 Azure 리소스에 대해 Azure 역할 기반 접근 제어(Azure RBAC) 쓰기 권한이 있는지 확인합니다.

Important

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

  • Visual Studio Code와 Visual Studio Code용 PostgreSQL 확장 기능(버전 1.32.0 이상)을 설치하세요. Fabric Database Hub에서 PostgreSQL 데이터베이스 에이전트에 대한 지원이 곧 제공될 예정입니다.
  • 지원되는 제한된 미리 보기 지역(South Central US, West US 3 또는 Sweden Central)에서 PostgreSQL 16 이상을 실행하는 Azure Database for PostgreSQL flexible server를 사용하십시오.
  • Azure 서버 리소스에 접근할 수 있는 ID(에이전트 구성 시 서버 리소스에 대한 Azure RBAC 쓰기 권한 포함)와 함께 서버에 연결할 수 있는 PostgreSQL 자격 증명으로 Visual Studio Code에 로그인하세요.

전체 설치 지침은 데이터베이스 에이전트 사용 및 활성화 또는 Visual Studio Code에서 데이터베이스 에이전트 사용을 참조하세요.

데이터베이스 에이전트 열기

  1. Database Hub을 여세요.
  2. 에이전트 관리를 선택하세요.
  3. 데이터베이스 에이전트 설정을 선택합니다.

데이터베이스 에이전트 설정에서 Azure SQL 데이터베이스를 선택하고, 에이전트 정책을 검토한 후 구성을 저장할 수 있습니다. Visual Studio Code에서 Azure SQL Database 지원이 곧 제공될 예정입니다.

제한 미리보기 기간 동안 Visual Studio Code에서 PostgreSQL용 데이터베이스 에이전트에 접근할 수 있습니다(Fabric Database Hub 지원도 곧 제공될 예정입니다):

  1. Visual Studio Code를 열고 작업 표시줄에서 PostgreSQL 아이콘을 선택하여 연결을 엽니다.
  2. 서버에서 연결된 Azure Database for PostgreSQL 플렉시브 서버를 마우스 오른쪽 버튼으로 클릭합니다.
  3. 에이전트를 구성하려면 데이터베이스 에이전트를 선택하거나, 진행 중인 조사 및 문제를 검토하려면 대시보드를 선택하세요.

전체 Visual Studio Code 워크플로우에 대해서는 Visual Studio Code에서 데이터베이스 에이전트 사용을 참조하세요.

1. 지원되는 문제 탐지

데이터베이스 에이전트는 저장된 에이전트 정책에 따라 선택된 데이터베이스와 서버를 평가합니다.

Azure SQL Database에 대한 지원되는 문제 시나리오는 다음과 같습니다:

  • 높은 CPU.
  • 높은 메모리.
  • 높은 I/O 사용량.
  • 장시간 실행되는 쿼리.
  • 쿼리 차단.
  • 누락된 인덱스.
  • 사용하지 않거나 중복된 인덱스를 삭제합니다.
  • 쿼리 실행 계획 회귀.

Azure Database for PostgreSQL에서 지원되는 문제 시나리오는 다음과 같습니다:

Scenario 데이터베이스 에이전트가 조사하는 항목
연결 고갈 역할 연결 제한과 세션 독점.
데드 튜플 팽창 죽은 튜플 누적, 힙 전용 튜플(HOT) 업데이트 저하, 그리고 빈번한 업데이트로 인한 인덱스 팽창 등이 있습니다.
높은 CPU 인덱스 유형 불일치, 오래된 통계, 그리고 인덱싱되지 않은 쿼리.
트랜잭션 유휴 상태 트랜잭션 중 유휴 세션에 따른 스냅샷 보존.
잠금 경합 행 잠금장치와 테이블 잠금장치.
쿼리 플랜 회귀 Gather 병목 현상, 조인 유형 오선택, 손실 비트맵 재검사, 삭제된 지원 인덱스.
유출 및 메모리 압력 정렬 전체 집계, 해시 조인, 대규모 정렬 및 병렬 쿼리에서 발생하는 스필입니다.

데이터베이스, 서버 또는 시나리오를 활성화하면 새 문제가 생성되는 데 약 15분이 걸릴 수 있습니다. 이슈 생성은 더 빨리 끝날 수 있습니다.

별도로, 성능 모니터링을 활성화하는 것은 데이터베이스 목록과 구성에 전파되기까지 약 15분이 걸릴 수 있으며, 그 후 데이터베이스를 등록할 수 있습니다. 데이터베이스 에이전트는 등록 전에 데이터베이스에 대한 문제를 감지하거나 생성할 수 없습니다.

2. 조사 및 증거 검토

이슈를 열어 감지된 상태를 이해하고 다음에 무엇을 할지 결정하세요. 문제 유형과 현재 상태에 따라 데이터베이스 에이전트는 다음을 제공할 수 있습니다:

  • 상태에 대한 요약입니다.
  • 수집된 증거.
  • 권장 사항.
  • 수동 대응에 대한 안내.
  • 현재 문제 상태 및 이력.

포착된 증거는 발견 당시의 상태를 설명합니다. 조치를 하기 전에 현재 상태와 이용 가능한 증거를 검토하세요.

높은 CPU와 장기 쿼리 문제의 경우, 맥락형 AI 지원은 추가 기술을 활용해 증거를 탐색할 수 있도록 돕습니다. 권장 작업의 프롬프트 버튼은 문제를 맥락으로 사용하여 Copilot 창을 엽니다; '왜 설명하라'는 인라인 설명을 표시합니다; '느린 쿼리 분석'은 캡처된 쿼리에 대한 인라인 제안을 제공합니다. 이 지원은 관리자가 할당한 Copilot 용량을 사용하며 데이터베이스 변경을 적용하지 않습니다.

이러한 선택적 조사 단계에 대해서는 '컨텍스트 AI로 조사하기'를 참조하세요.

PostgreSQL 조사가 AI 지원이기 때문에, 요약, 분석, 권장 조치 ( 권장 변경, 안전한 이유, 롤 백 SQL 포함), 예상 결과 는 LLM에 의해 생성됩니다. Visual Studio Code의 서버 대시보드에서 이 섹션에 대해 Copilot에게 질문하기을 선택하여 GitHub Copilot Chat에서 문제를 탐색할 수도 있습니다. 실행 전에 진단과 제안된 SQL 문장 또는 서버 매개변수 변경 사항을 라이브 서버에 대해 검증하십시오.

자세한 검토 지침은 데이터베이스 에이전트 성능 문제 검토를 참조하세요.

3. 어떻게 대응할지 결정하세요

권장되는 수동 대응은 문제 상황에 따라 다릅니다. Database Agents가 응답을 실행하지 않습니다.

지침을 따르고 수동으로 대응하세요

모든 문제는 조사 결과와 수동 시정 지침을 제공합니다.

증거와 지침을 검토하고, 현재 상태를 다시 확인한 뒤, 승인된 데이터베이스 워크플로우를 통해 적절한 대응을 완료하십시오. 응답 후 라이브 상태를 확인하십시오. 작업을 마친 후에도 문제가 계속 열려 있다면 종료하세요.

응답 및 검증 지침은 데이터베이스 에이전트 성능 문제 검토를 참조하세요.

4. 문제 상태 추적

데이터베이스 에이전트는 상태를 조사하는 동안 또는 해당 상태에 더 이상 주의가 필요하지 않다고 판단할 때 문제 정보를 업데이트합니다.

데이터베이스 허브에서 이슈 상태는 다음과 같습니다:

  • 활성 상태: 이 상태는 주의가 필요합니다.
  • 조사 중: 데이터베이스 에이전트가 증거를 수집하거나 분석하고 있습니다.
  • 조사 완료: 안내가 제공됩니다. 응답을 수동으로 수행하십시오.
  • 실패: 조사가 성공적으로 완료되지 않았습니다.
  • 종료됨: 이 이슈는 더 이상 활성화되어 있지 않으며 기록 속에서 확인할 수 있습니다.

Visual Studio Code 서버 대시보드에서 데이터베이스 에이전트는 조사 배너에 활성 조사 진행 상황을 표시하고, 각 문제를 감지 및 진단부터 해결까지 추적합니다—예를 들어 변경 완료 후 수동으로 적용됨 표시를 선택하거나 조치가 필요 없는 경우 문제 해제를 선택할 때가 포함됩니다.

조사 실패가 데이터베이스나 서버 변경에 실패했다는 의미는 아닙니다. 데이터베이스 에이전트들은 사용자의 작업 없이 데이터베이스나 서버 변경을 자동으로 실행하지 않습니다.

복구 가능한 오류에 대해서는 조사가 최대 세 번까지 자동으로 재시도됩니다. 조사가 실패 또는 조사 완료에 도달한 후, 문제를 새로 고치거나 다시 열어도 누락된 세부 정보는 다시 생성되지 않습니다. 데이터베이스나 서버에서 읽기 권한을 확인하고, 조사 세부 정보가 누락된 경우 Microsoft 지원에 문의하십시오.

5. 문제 이력 및 반복 검토

문제는 수동 응답을 완료하거나 모니터링이 조건이 해소되었다고 판단한 후 종료될 수 있습니다. 어느 경우든 최종 상태는 종료입니다. 문제 이력과 실시간 데이터베이스 또는 서버 상태를 검토하여 결과를 이해하십시오. 문제를 종료한다고 해서 워크로드가 복구되었다는 증거는 아닙니다.

문제가 종료된 후 조건이 반복되면 데이터베이스 에이전트가 새 문제를 생성하고 해당 종료된 이슈를 기록에 보존합니다.

데이터베이스 에이전트를 책임감 있게 사용하세요

데이터베이스 에이전트 결과 및 권고를 위해서는 운영자 검토가 필요합니다.

데이터베이스 에이전트는 다음을 대체하지 않습니다:

  • 데이터베이스 인증 및 인가.
  • 기존 승인 절차.
  • 변화 관리 요구사항.
  • 생산 검증.
  • 데이터베이스 변경에 대한 인간의 책임.

지원되는 데이터베이스 및 서버

Database Agents는 서버리스 및 하이퍼스케일 데이터베이스를 포함한 Azure SQL 데이터베이스를 지원합니다.

현재 데이터베이스 에이전트는 다음을 지원하지 않습니다:

  • Azure SQL elastic pools.
  • One-vCore 서버리스 데이터베이스.
  • Azure SQL Managed Instance.
  • Azure Virtual Machines의 SQL Server.
  • Azure Arc 지원 SQL Server.

데이터베이스 에이전트는 Flexible Server 연산 계층(Burstable, General Purpose, Memory Optimized 포함)과 배포 구성에서 PostgreSQL 16 이상을 실행하는 Azure Database for PostgreSQL 플렉시브 서버를 지원합니다. Azure HorizonDB에 대한 지원이 곧 제공될 예정입니다.

PostgreSQL 지원은 현재 Visual Studio Code에서 제한된 미리보기로 제공되며, Fabric Database Hub에서의 지원도 곧 제공될 예정입니다. 액세스가 제한되며 승인이 필요합니다. 접근 권한을 요청하려면 데이터베이스 에이전트 제한적 미리보기 참여 양식을 작성하세요.

공개 미리보기의 한계

  • Surface 가용성: Azure SQL Database는 현재 Fabric Database Hub에서 지원됩니다; Visual Studio Code 지원도 곧 제공될 예정입니다.
  • 지역 가용성: 데이터베이스는 Fabric 테넌트 홈 리전에 연결된 지원되는 리전에 있어야 합니다. 지역 간 등록은 지원되지 않습니다.
  • Surface 사용 가능 여부: PostgreSQL 데이터베이스 에이전트는 현재 Visual Studio Code에서만 제한된 미리보기로 제공됩니다. Fabric Database Hub 지원이 곧 제공될 예정입니다.
  • 제한된 미리보기 지역 및 데이터 존: PostgreSQL 지원은 초기에는 미국 남중부, 미국 서부 3 및 스웨덴 중부 지역의 서버에서 제공되며, AI 처리는 미국 데이터 존과 EU 데이터 존에서 수행됩니다.
  • 문제 가용성: 새로 활성화된 데이터베이스, 서버 또는 시나리오는 새 문제를 생성하는 데 약 15분이 걸릴 수 있습니다.
  • 수동 대응: 권한 있는 데이터베이스 워크플로우를 통해 권장 사항을 검토하고 변경을 수행하세요.
  • 미리보기 동작: 지원되는 문제, 구성 및 지역은 미리보기 중에 변경될 수 있습니다.

전체 목록과 복구 단계는 Database Agents 제한 사항 및 문제 해결을 참조하세요.

Troubleshoot

데이터베이스나 서버가 나타나지 않습니다

데이터베이스가 지원되고, 지원되는 리전에 있으며, 사용자 ID에 표시되는지 확인하세요. 데이터베이스가 서버리스라면, 깨어 있는지 확인하세요. Microsoft SQL의 성능 모니터링이 활성화되어 있는지 확인하고, 활성화가 데이터베이스 목록과 구성에 전파될 때까지 약 15분을 기다립니다. 데이터베이스가 여전히 나타나지 않으면 Microsoft 지원에 문의하십시오.

제한된 미리보기에 대한 승인을 받았는지, Visual Studio Code용 PostgreSQL 확장(버전 1.32.0 이상)을 설치했는지, 유연한 서버가 PostgreSQL 16 이상을 실행하고 있고, 실행 중(중지되지 않았으며), 지원되는 제한된 미리보기 지역(미국 남중부, 미국 서부 3, 스웨덴 중부)에 있고, 서버 대시보드에 Azure 메타데이터가 로드되어 있는지(Fetch 메타데이터)인지 확인하세요. PostgreSQL 데이터베이스 에이전트는 아직 Fabric Database Hub에서 제공되지 않는다는 점에 유의하세요(곧 출시 예정). 서버나 에이전트가 여전히 Visual Studio Code에 나타나지 않으면 Microsoft 지원에 문의하세요.

에이전트 구성을 저장할 수 없습니다

저장은 선택한 각 데이터베이스 또는 서버에 대해 에이전트와 사용자의 Azure 리소스 쓰기 권한을 검증합니다. 선택한 데이터베이스나 서버가 권한 검사에 실패하면 전체 저장이 실패합니다. 권한이 없는 리소스는 선택 영역에서 제거하고 나머지 구성을 저장하세요. 기타 오류나 지속적인 실패에 대해서는 에이전트를 저장할 수 없거나 활성 상태가 되지 않는 경우를 참조하세요.

새로운 문제가 나타나지 않음

최소 15분간 기다리고, 소스 조건이 활성 상태로 유지되며, 해당 에이전트 정책 옵션이 활성화되어 있는지 확인한 후 문제 목록을 새로 고칩니다.

데이터베이스 또는 서버 목록을 로드할 수 없습니다

본인의 계정이 테넌트에 이미 저장된 리소스를 읽을 수 있는지 확인하세요. 구성된 리소스에 접근할 수 있는 ID로 다시 시도하세요.

지역 서비스 중단 후 데이터베이스 에이전트는 돌아오지 않음

데이터베이스 에이전트를 다시 구성하거나 다시 활성화할 필요가 없습니다. 서비스가 복구된 후 Database Hub 또는 Visual Studio Code를 새로 고침하고 작업을 다시 시도하세요. 데이터베이스 에이전트가 돌아오지 않으면 Microsoft 지원에 문의하십시오.

다음 단계