이 문서는 데이터베이스 또는 서버를 활성화할 수 없거나, 표시되지 않거나, 예상된 문제가 발생하지 않는 이유를 확인해야 하는 데이터베이스 관리자를 위한 것입니다.
Important
데이터베이스 에이전트는 미리보기 상태입니다. 지원되는 구성, 지역 가용성 및 문제 동작은 정식 출시 전에 변경될 수 있습니다.
지원되는 데이터베이스 범위
Database Agents는 서버리스 및 하이퍼스케일 데이터베이스를 포함한 Azure SQL 데이터베이스를 지원합니다. 서버리스 데이터베이스는 Database Agents가 평가할 수 있으려면 활성 상태여야 합니다.
현재 데이터베이스 에이전트는 다음을 지원하지 않습니다:
- Azure SQL elastic pools.
- One-vCore 서버리스 데이터베이스.
- Azure SQL Managed Instance.
- Azure Virtual Machines의 SQL Server.
- Azure Arc로 활성화된 SQL Server.
데이터베이스 에이전트는 플렉시블 서버 컴퓨팅 계층(Burstable, General Purpose, Memory Optimized 포함)과 배포 구성 전반에서 PostgreSQL 16 이상을 실행하는 Azure Database for PostgreSQL 플렉시블 서버를 지원합니다. Azure HorizonDB에 대한 지원이 곧 제공될 예정입니다.
PostgreSQL 데이터베이스 에이전트는 현재 Visual Studio Code에서만 제한 미리보기로 제공되고 있으며(Fabric Database Hub 지원도 곧 제공될 예정), 처음에는 미국 남중부, 미국 서부 3, 스웨덴 중부에서 지원됩니다. 액세스가 제한되며 승인이 필요합니다. 접근 권한을 요청하려면 데이터베이스 에이전트 제한적 미리보기 참여 양식을 작성하세요.
모든 PostgreSQL 조사는 AI 지원을 받으며, 미국 데이터 존 ( 남중부 미국 및 서부 US 3)과 EU 데이터 존 ( 스웨덴 중부 포함)에서 AI 모델 처리가 이루어집니다. 한정 미리보기에서는 조사 비용을 지불하지 않습니다. 청구는 일반 출시 전에 시작되며, Microsoft는 가입한 고객에게 사전에 통보합니다. AI가 생성한 결과는 불완전하거나 부정확할 수 있으니, 행동하기 전에 반드시 실시간 서버와 대조해 검증하세요.
데이터베이스나 서버가 나타나지 않습니다
- 데이터베이스가 지원되는 범위 내에 있는지 확인합니다.
- 데이터베이스에 접근할 수 있는지 확인하세요.
- Microsoft SQL용 성능 모니터링 활성화에서 해당 구독 및 데이터베이스 설정을 완료했는지 확인하세요.
- 데이터베이스가 서버리스라면, 깨어 있는지 확인하세요.
- 데이터베이스가 Fabric 테넌트 홈 리전과 연관된 지원되는 리전에 있는지 확인합니다.
- 성능 모니터링 활성화가 데이터베이스 목록과 구성에 전파될 때까지 약 15분 정도 기다리십시오. 데이터베이스는 해당 정보가 제공되기 전까지는 등록할 수 없으므로, 등록 전에 에이전트가 해당 데이터베이스에 대해 문제를 감지하거나 생성할 수 없습니다.
데이터베이스가 여전히 나타나지 않으면 Microsoft 지원에 문의하십시오.
PostgreSQL 데이터베이스 에이전트는 아직 Fabric Database Hub에서 제공되지 않습니다(곧 출시 예정). 대신 Visual Studio Code에서 설정을 확인하세요:
- 데이터베이스 에이전트 제한 미리보기 참여 양식을 통해 접근 권한을 요청했고 승인을 받았는지 확인하세요.
- Visual Studio Code용 PostgreSQL 확장 기능(버전 1.32.0 이상)을 설치했는지 확인하세요.
- 유연한 서버가 PostgreSQL 16 이상을 실행하고, 실행 중(중지되지 않았으며), 지원되는 제한된 미리보기 지역(미국 남중부, 미국 서부 3, 또는 스웨덴 중부)에 있는지 확인하세요.
- 서버에 액세스할 수 있는 Azure 계정으로 로그인했는지 확인하고, Azure Server Detected 또는 Incomplete Azure Metadata가 나타나면 서버 대시보드에서 메타데이터 가져오기를 선택하세요.
Visual Studio Code에서 서버에 여전히 Database Agent를 사용할 수 없으면 Microsoft 지원에 문의하세요.
에이전트를 저장할 수 없거나 활성화되지 않는 경우
- 오류를 검토하여 저장이 에이전트 수준 검사 또는 데이터베이스 권한 검사 때문에 실패했는지 확인하십시오.
- 선택한 모든 데이터베이스에 대해 Azure 리소스에 대해 역할 기반 접근 제어(Azure RBAC) 쓰기 권한이 Azure 있는지 확인하세요. SQL 변경 사항을 실행할 수 있는 권한은 이 Azure 리소스 권한을 대체할 수 없습니다.
- 선택한 데이터베이스 중 하나라도 쓰기 권한 검사에 실패하면 전체 저장이 실패합니다. 권한이 없는 데이터베이스를 선택한 목록에서 제거한 후 나머지 구성을 저장하세요.
- 선택한 각 데이터베이스가 지원되고 Fabric 테넌트 홈 리전과 연결된 지원되는 영역에 속하는지 확인하세요.
- 선택한 데이터베이스가 서버리스인 경우, 해당 데이터베이스가 절전 또는 일시 중지 상태가 아닌지 확인하십시오.
- 저장이 성공한 후, 데이터베이스 에이전트 설정에서 '데이터베이스 에이전트가 활성 상태'라는 메시지를 찾아보세요. 이 메시지는 각 데이터베이스에 대한 별도의 활성화 상태가 아니라 에이전트 수준 상태를 나타냅니다.
그래도 에이전트를 저장하거나 활성화할 수 없다면 Microsoft 지원에 문의하세요.
- 데이터베이스 에이전트 제한 미리보기 참여 양식을 통해 접근 권한을 요청했고 승인을 받았는지 확인하세요.
- Azure 서버 리소스에 대해 Azure 역할 기반 접근 제어(Azure RBAC) 쓰기 권한이 있는지 확인합니다. SQL 변경 사항을 실행할 수 있는 권한은 이 Azure 리소스 권한을 대체할 수 없습니다.
- 유연한 서버가 PostgreSQL 16 이상을 실행하고, 실행 중(중지되지 않았으며), 지원되는 제한된 미리보기 지역(미국 남중부, 미국 서부 3, 또는 스웨덴 중부)에 있는지 확인하세요.
- Visual Studio Code의 서버 대시보드에서 Azure Server Detected 또는 불완전한 Azure 메타데이터가 나타나면 메타데이터 가져오기를 선택한 후 데이터베이스 에이전트 구성을 다시 시도하세요.
그래도 에이전트를 저장하거나 활성화할 수 없다면 Microsoft 지원에 문의하세요.
새로운 문제가 나타나지 않음
새 데이터베이스, 서버 또는 시나리오를 활성화하면 새 문제가 나타나기까지 약 15분이 걸릴 수 있습니다.
- 최소 15분은 기다리십시오.
- 소스 조건이 여전히 활성화되어 있는지 확인하십시오.
- 문제 목록을 새로 고침하세요.
- 데이터베이스 또는 서버에 해당하는 에이전트 정책 옵션이 활성화되어 있는지 확인합니다.
예상한 문제가 여전히 나타나지 않으면 Microsoft 지원에 문의하십시오.
이슈 세부 정보가 불완전합니다
데이터베이스 에이전트는 데이터베이스 또는 서버의 읽기 권한을 검증하고, 복구 가능한 오류에 대해 최대 세 번까지 조사를 자동으로 재시도합니다.
조사가 실패 또는 조사 완료에 도달하더라도 해당 세부 정보가 자동으로 재생성되지 않습니다. 대기, 새로고침, 또는 문제를 다시 여는 것은 누락된 세부 사항을 복구하지 못합니다. 데이터베이스 또는 서버에 대한 읽기 권한이 있는지 확인하고, 세부 정보가 누락된 경우 Microsoft 지원에 문의하십시오.
문제를 열 수 없습니다
데이터베이스 또는 서버에 대한 읽기 권한이 있는지 확인합니다. 그래도 문제를 열 수 없다면 Microsoft 지원에 문의하세요. 새로 고치거나 다시 열어도 실패했거나 완료된 조사는 다시 실행되지 않으며 누락된 세부 정보도 다시 생성되지 않습니다.
조사 실패
실패는 조사가 성공적으로 완료되지 않았다는 뜻입니다. 이는 데이터베이스 에이전트가 데이터베이스나 서버 변경을 시도했다는 의미가 아닙니다. 자동 재시도는 재시도 가능한 오류에만 적용되며 세 번의 재시도로 제한됩니다. 조사가 실패로 표시되면, 새로고침하거나 다시 열어도 조사가 다시 시작되지 않습니다. 사용 가능한 문제 정보를 검토하고, 데이터베이스 또는 서버에 대한 읽기 권한을 확인한 후 도움이 필요하면 Microsoft 지원에 연락하십시오.
이슈의 추천을 적용할 수 없습니다
데이터베이스 에이전트는 조사와 안내만 제공합니다. 모든 시나리오는 승인된 데이터베이스 워크플로우를 통한 수동 응답이 필요합니다. 에이전트 정책에서 옵션을 활성화해도 데이터베이스나 서버 변경이 실행되지 않습니다.
응답 및 검증 단계에 대해서는 수동으로 응답하고 조건 확인하기를 참조하세요.
맥락형 AI 범위 및 요구 사항
컨텍스트 AI 지원은 CPU 사용량이 높은 쿼리 문제와 장기간 진행되는 쿼리 문제에만 제공됩니다. 관리자가 할당한 Copilot 용량은 기존 데이터베이스 에이전트 설정 및 접근 요구 사항 외에 충분합니다.
이 기능들은 자동 해결책이 아니라 설명과 제안을 제공합니다. 생성된 분석은 이용 가능한 증거에 의존하며 불완전할 수 있습니다. 수동 답변을 선택하기 전에 증거와 명시된 제한 사항을 검토하세요.
이슈-컨텍스트 Copilot 프롬프트, 인라인 이유 설명, 및 쿼리 수준 느린 쿼리 분석의 차이점은 컨텍스트 AI로 조사를 참조하세요.
컨텍스트 기반 AI 컨트롤을 사용할 수 없거나 작동하지 않습니다
권장 작업, 이유 설명 또는 느린 쿼리 분석의 프롬프트 버튼이 사용 불가능하거나 실패하면 관리자에게 문의하십시오.
데이터베이스 또는 서버 목록을 로드할 수 없습니다
귀하의 신원이 테넌트에 이미 저장된 하나 이상의 리소스에 접근할 수 없을 때 리소스 목록이 실패할 수 있습니다.
Azure 읽기 권한을 확인하거나 구성된 리소스에 접근할 수 있는 ID로 재시도하세요. 여전히 목록을 로드할 수 없다면 Microsoft 지원에 문의하십시오.
데이터베이스 또는 서버가 다른 지역에 있습니다
데이터베이스 에이전트는 모든 Azure SQL 데이터베이스가 Fabric 테넌트 홈 리전과 동일한 리전에 위치해야 합니다. 지역 간 등록은 지원되지 않습니다.
제한된 미리보기 기간 동안, PostgreSQL 지원은 미국 남중부, 미국 서부 3, 스 웨덴 중부 의 유연한 서버에서만 제공됩니다. AI 모델 처리는 US Data Zone에서 South Central US 및 West US 3에 대해 실행되며, EU Data Zone에서 Sweden Central에 대해 실행됩니다.
지원되는 영역에서 자격이 있는 데이터베이스나 서버를 사용하세요.