알려진 문제 및 SQL Server IaaS 에이전트 익스텐션 문제 해결

  • 아티클

적용 대상:Azure VM 기반 SQL Server

이 문서는 SQL Server IaaS 에이전트 익스텐션을 사용할 때 알려진 문제를 해결하고 오류를 해결하는 데 도움이 됩니다.

확장에 대한 질문과 대답을 보려면 FAQ를 확인하세요.

필수 구성 요소 확인

지원되지 않는 옵션 또는 제한 사항으로 인한 오류를 방지하려면 확장의 필수 조건을 확인합니다.

SQL IaaS 에이전트 익스텐션을 복구하거나 다시 설치하는 경우 라이선싱 변경 내용 외에는 설정이 유지되지 않습니다. 익스텐션을 복구하거나 다시 설치한 경우 복구 또는 다시 설치하기 전에 자동화된 백업, 자동화된 패치 및 구성한 다른 서비스를 재구성해야 합니다.

익스텐션 상태 확인

Azure Portal에 있는 SQL 가상 머신 리소스의 개요 페이지에 있는 익스텐션 상태 아래에서 익스텐션의 상태를 확인할 수 있습니다.

Screenshot of the Azure portal, the overview pane of the SQL virtual machines resource.

참고 항목

PowerShell 스크립트를 사용하여 가상 머신에서 익스텐션 상태를 확인할 수도 있습니다. GitHub에서 전체 스크립트를 찾을 수 있습니다. Az PowerShell을 사용하여 SQL IaaS 에이전트 익스텐션 상태 가져오기를 참조하세요.

SQL IaaS 에이전트 익스텐션의 상태는 다음과 같습니다.

  • 정상: 모든 작업이 예상대로 작동합니다.
  • 실패: 기본 SQL IaaS 에이전트 서비스가 SQL Server VM에서 실행되고 있지 않습니다.
  • 비정상: 하나 이상의 하위 서비스에 문제가 있습니다.

SQL IaaS 에이전트 익스텐션의 상태가 비정상 또는 실패인 경우 개요 페이지에서 알림을 확인하여 자세한 내용을 알아보세요.

이 섹션의 나머지 부분에서는 각 오류 조건 알림에 대한 정보를 제공합니다.

기본 SQL IaaS 에이전트 익스텐션 서비스가 실행되고 있지 않음

SQL IaaS 에이전트 익스텐션(Microsoft SQL Server IaaS 에이전트)에 대한 기본 서비스가 중지된 상태입니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 실패입니다.

이 오류 조건을 해결하려면 익스텐션을 복구하십시오.

서버가 실행되고 있지 않음

SQL Server 서비스가 중지되었습니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 비정상입니다.

자세히 조사하고 서비스를 다시 시작합니다.

SQL IaaS 에이전트 익스텐션 쿼리 서비스가 실행되고 있지 않음

SQL IaaS 에이전트 익스텐션은 쿼리 서비스(Microsoft SQL Server IaaS 쿼리 서비스)를 사용하여 SQL Server와 통신합니다. 쿼리 서비스가 중지된 상태인 경우 SQL Server와의 통신에 의존하는 기능이 작동하지 않습니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 비정상입니다.

이 오류 조건을 해결하려면 익스텐션을 복구하십시오.

SQL IaaS 에이전트 익스텐션에 올바른 권한이 없음

SQL IaaS 에이전트 익스텐션 쿼리 서비스(Microsoft SQL Server IaaS 쿼리 서비스)는 NT Service\SQLIaaSExtensionQuery 계정을 사용하여 SQL Server 인스턴스를 쿼리합니다. 이 로그인이 SQL Server에서 제거되거나 사용자 또는 기본 정책이 로그인에 대한 권한을 변경하는 경우 익스텐션에 올바른 권한이 없다는 오류가 표시됩니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 비정상입니다.

최소 권한 모델을 사용하는 SQL Server VM의 경우 NT Service\SQLIaaSExtensionQuery 계정에 사용하도록 설정된 각 기능과 관련된 적절한 권한이 있는지 확인하십시오. 사용하도록 설정된 기능이 없으면 NT Service\SQLIaaSExtensionQuery 로그인이 SQL Server 내에 존재하지 않거나 Microsoft SQL Server IaaS 쿼리 서비스가 NT Service\SQLIaaSExtensionQuery와 다른 사용자 이름으로 실행되고 있는 경우 오류가 표시됩니다.

2022년 10월 이전에 배포된 일부 SQL Server VM은 여전히 이전 sysadmin 권한 모델을 사용할 수 있습니다. 이러한 오래된 VM의 경우 NT Service\SQLIaaSExtensionQuery가 없거나 SQL Server 내에 sysadmin 권한이 없거나 Microsoft SQL Server IaaS 쿼리 서비스가 NT Service\SQLIaaSExtensionQuery와 다른 사용자 이름으로 실행 중인 경우 사용 권한 오류가 표시됩니다.

이 오류 조건을 해결하려면 로그인이 SQL Server에 있고 사용하도록 설정한 기능에 따라 올바른 권한이 있는지 확인합니다. 로그인을 다시 만들고 올바른 권한을 할당해야 할 수 있습니다. 또한 Microsoft SQL Server IaaS 쿼리 서비스가 사용자 이름 NT Service\SQLIaaSExtensionQuery로 실행되고 있는지 확인합니다.

확장 복구

SQL IaaS 에이전트 익스텐션이 실패한 상태일 수 있습니다. Azure Portal을 사용하여 SQL IaaS 에이전트 익스텐션을 복구합니다.

Azure Portal을 사용하여 확장을 복구하려면 다음을 수행합니다.

  1. Azure Portal에 로그인합니다.

  2. SQL 가상 머신 리소스로 이동합니다.

  3. 목록에서 SQL Server VM을 선택합니다. SQL Server VM이 여기에 나열되지 않는 경우 SQL IaaS 에이전트 익스텐션에 등록되지 않았을 수 있습니다.

  4. 도움말에서 SQL IaaS 에이전트 익스텐션 설정을 선택합니다.

  5. 프로비저닝 상태가 실패로 표시되는 경우 복구를 선택하여 확장을 복구합니다. 상태가 성공인 경우 강제 복구 옆에 있는 확인란을 선택하여 상태에 관계없이 확장을 복구할 수 있습니다.

    Screenshot of the SQL IaaS Agent extension settings page of the SQL virtual machines extension in the Azure portal showing where to repair the extension.

"Power BI VM 이미지에 대한 SQL Virtual Machine 리소스 만들기가 지원되지 않음" 오류와 함께 SQL IaaS 에이전트 익스텐션 등록이 실패합니다.

Azure Marketplace에서 배포된 Power BI VM, SQL Server Reporting Server 및 SQL Server Analysis Service 이미지에서는 SQL IaaS 에이전트 익스텐션 등록이 차단되고 지원되지 않습니다.

관리에 유효한 상태가 아님

다음 오류 메시지가 표시되면 확장을 복구합니다.

The SQL virtual machines resource is not in a valid state for management

기본 가상 머신이 유효하지 않음

다음 오류 메시지가 표시되는 경우

SQL management operations are disabled because the state of underlying virtual machine is invalid

다음을 살펴보세요.

  • SQL VM이 중지 또는 할당 취소되거나, 실패 상태이거나, 찾을 수 없습니다. 기본 가상 머신이 실행 중인지 유효성을 검사합니다.
  • SQL IaaS 에이전트 익스텐션이 실패 상태일 수 있습니다. 확장을 복구합니다.

확장에서 SQL VM을 등록 취소한 후 다음 작업을 수행한 경우 SQL VM을 확장에 다시 등록합니다.

  • 한 구독에서 다른 구독으로 VM을 마이그레이션했습니다.
  • SQL Server의 로캘 또는 데이터 정렬을 변경했습니다.
  • SQL Server 인스턴스의 버전(version)을 변경했습니다.
  • SQL Server 인스턴스의 버전(edition)을 변경했습니다.

프로비전 실패로 표시됩니다.

SQL IaaS 에이전트 익스텐션 상태가 Azure Portal에서 프로비저닝 실패로 표시되면 익스텐션을 복구합니다.

포털에서 SQL VM 리소스를 사용할 수 없음

SQL IaaS 에이전트 익스텐션이 설치되어 있고 VM이 온라인 상태이지만 Azure Portal에서 SQL VM 리소스를 사용할 수 없는 경우입니다. SQL Server 및 SQL Browser 서비스가 VM 내에서 시작되었는지 확인합니다. 문제가 해결되지 않으면 확장을 복구합니다.

기능이 회색으로 표시됨

Azure Portal에서 SQL VM 리소스로 이동하고 회색으로 표시된 기능이 있는 경우 SQL VM이 실행 중이고 최신 버전의 SQL IaaS 에이전트 익스텐션이 있는지 확인합니다.

서비스 계정이 변경됨

확장과 연결된 두 서비스 중 하나에 대한 서비스 계정을 변경하면 확장이 실패하거나 예기치 않게 동작할 수 있습니다.

두 서비스는 다음 계정으로 실행되어야 합니다.

  • Microsoft SQL Server IaaS 에이전트는 SQL IaaS 에이전트 익스텐션의 기본 서비스이며 로컬 시스템 계정으로 실행해야 합니다.
  • Microsoft SQL Server IaaS 쿼리 서비스는 확장이 SQL Server 내에서 쿼리를 실행하는 데 도움이 되는 도우미 서비스이며 NT 서비스 계정 NT Service\SqlIaaSExtensionQuery로 실행해야 합니다.

자동 등록 실패

자동으로 등록하지 못한 몇몇 SQL Server VM이 있는 경우 등록에 실패한 VM에서 SQL Server 버전을 확인합니다. 기본적으로 SQL Server 2016 이상이 설치된 Azure VM은 CEIP 서비스에서 검색될 때 SQL IaaS 에이전트 익스텐션에 자동으로 등록됩니다. 2016 이전 버전이 있는 SQL Server VM은 개별적으로 또는 대량으로 수동으로 등록해야 합니다.

높은 리소스 사용

SQL IaaS 에이전트 익스텐션이 예기치 않게 높은 CPU 또는 메모리를 사용하고 있는 경우 익스텐션이 최신 버전인지 확인합니다. 최신 버전이라면 services.msc에서 Microsoft SQL Server IaaS 에이전트를 다시 시작합니다.

디스크를 확장할 수 없음

다음 조건에서는 SQL VM 리소스의 스토리지 구성 페이지에서 디스크를 확장할 수 없습니다.

  • SQL IaaS 에이전트 익스텐션을 제거하고 다시 설치하는 경우.
  • SQL Server 인스턴스를 제거하고 다시 설치하는 경우.
  • Azure Marketplace에서 SQL Server 이미지를 배포할 때 디스크/스토리지 풀 이름에 대한 사용자 지정 명명 규칙을 사용한 경우.

배포하는 동안 디스크 구성이 회색으로 표시됨

비관리 디스크를 사용하여 SQL Server VM을 만드는 경우 디스크 구성은 의도적으로 회색으로 표시됩니다.

자동화된 백업이 사용하지 않도록 설정됨

SQL VM 리소스에 자동화된 백업이 현재 사용하지 않도록 설정됨이 표시되는 경우 SQL Server 인스턴스에서 관리형 백업이 사용하도록 설정되었는지 확인합니다. Azure Portal에서 자동화된 백업을 사용하려면 SQL Server에서 관리형 백업을 사용하지 않도록 설정합니다.

확장이 전환 상태에서 중단됨

다음 시나리오에서 SQL IaaS 에이전트 익스텐션이 전환 상태에서 중단되었을 수 있습니다.

  • SQL Server 로그인 및/또는 로컬 관리자 그룹에서 NT service\SQLIaaSExtension 서비스를 제거했습니다.
  • 다음 두 서비스 중 하나가 services.msc에서 중지되었습니다.
    • Microsoft SQL Server IaaS 에이전트
    • Microsoft SQL Server IaaS 쿼리 서비스

도메인 컨트롤러에 설치 실패

도메인 컨트롤러에 설치된 SQL Server 인스턴스를 SQL IaaS 에이전트 익스텐션에 등록하는 기능은 지원되지 않습니다. 익스텐션에 등록하면 NT Service\SQLIaaSExtension 사용자가 만들어지며 도메인 컨트롤러에서는 이 사용자를 만들 수 없으므로 이 VM을 SQL IaaS 에이전트에 등록하는 기능은 지원되지 않습니다.

다음 단계

더 알아보려면 다음 문서를 검토하세요.