알려진 문제 및 SQL Server IaaS 에이전트 익스텐션 문제 해결
적용 대상: 
Azure VM 기반 SQL Server
이 문서는 SQL Server IaaS 에이전트 익스텐션을 사용할 때 알려진 문제를 해결하고 오류를 해결하는 데 도움이 됩니다.
확장에 대한 질문과 대답을 보려면 FAQ를 확인하세요.
필수 구성 요소 확인
지원되지 않는 옵션 또는 제한 사항으로 인한 오류를 방지하려면 확장의 필수 조건을 확인합니다.
SQL IaaS 에이전트 익스텐션을 복구하거나 다시 설치하는 경우 라이선싱 변경 내용 외에는 설정이 유지되지 않습니다. 익스텐션을 복구하거나 다시 설치한 경우 복구 또는 다시 설치하기 전에 자동화된 백업, 자동화된 패치 및 구성한 다른 서비스를 재구성해야 합니다.
익스텐션 상태 확인
Azure Portal에 있는 SQL 가상 머신 리소스의 개요 페이지에 있는 익스텐션 상태 아래에서 익스텐션의 상태를 확인할 수 있습니다.
참고 항목
PowerShell 스크립트를 사용하여 가상 머신에서 익스텐션 상태를 확인할 수도 있습니다. GitHub에서 전체 스크립트를 찾을 수 있습니다. Az PowerShell을 사용하여 SQL IaaS 에이전트 익스텐션 상태 가져오기를 참조하세요.
SQL IaaS 에이전트 익스텐션의 상태는 다음과 같습니다.
- 정상: 모든 작업이 예상대로 작동합니다.
- 실패: 기본 SQL IaaS 에이전트 서비스가 SQL Server VM에서 실행되고 있지 않습니다.
- 비정상: 하나 이상의 하위 서비스에 문제가 있습니다.
SQL IaaS 에이전트 익스텐션의 상태가 비정상 또는 실패인 경우 개요 페이지에서 알림을 확인하여 자세한 내용을 알아보세요.
확장 복구
SQL IaaS 에이전트 익스텐션이 실패한 상태일 수 있습니다. Azure Portal을 사용하여 SQL IaaS 에이전트 익스텐션을 복구합니다.
Azure Portal을 사용하여 확장을 복구하려면 다음을 수행합니다.
Azure Portal에 로그인합니다.
SQL 가상 머신 리소스로 이동합니다.
목록에서 SQL Server VM을 선택합니다. SQL Server VM이 여기에 나열되지 않는 경우 SQL IaaS 에이전트 익스텐션에 등록되지 않았을 수 있습니다.
도움말에서 SQL IaaS 에이전트 익스텐션 설정을 선택합니다.
프로비저닝 상태가 실패로 표시되는 경우 복구를 선택하여 확장을 복구합니다. 상태가 성공인 경우 강제 복구 옆에 있는 확인란을 선택하여 상태에 관계없이 확장을 복구할 수 있습니다.
기본 확장 서비스가 실행 중이 아닙니다.
SQL IaaS 에이전트 익스텐션(Microsoft SQL Server IaaS 에이전트)에 대한 기본 서비스가 중지된 상태입니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 실패입니다.
이 오류 조건을 해결하려면 익스텐션을 복구하십시오.
확장 쿼리 서비스가 실행되고 있지 않음
SQL IaaS 에이전트 익스텐션은 쿼리 서비스(Microsoft SQL Server IaaS 쿼리 서비스)를 사용하여 SQL Server와 통신합니다. 쿼리 서비스가 중지된 상태인 경우 SQL Server와의 통신에 의존하는 기능이 작동하지 않습니다. 이 오류로 인해 SQL IaaS 에이전트 익스텐션 상태가 비정상입니다.
이 오류 조건을 해결하려면 익스텐션을 복구하십시오.
서버가 실행되고 있지 않음
SQL Server 서비스가 중지되었습니다. 이 오류로 인해 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 Marketplace 이미지에서 차단됩니다.
- Power BI 가상 머신
- SQL Server Analysis Services
관리에 유효한 상태가 아님
다음 오류 메시지가 표시되면 확장을 복구합니다.
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 Server VM에서 익스텐션을 삭제한 후 다음 작업을 수행한 경우 SQL VM을 익스텐션에 다시 등록합니다.
- 한 구독에서 다른 구독으로 VM을 마이그레이션했습니다.
- SQL Server의 로캘 또는 데이터 정렬을 변경했습니다.
- SQL Server 인스턴스의 버전(version)을 변경했습니다.
- SQL Server 인스턴스의 버전(edition)을 변경했습니다.
프로비전 실패로 표시됩니다.
SQL IaaS 에이전트 익스텐션 상태가 Azure Portal에서 프로비저닝 실패로 표시되면 익스텐션을 복구합니다.
SQL Server 구성 관리자 또는 가상 머신 수준에서 TCP/IP를 사용하지 않도록 설정한 경우 SQL IaaS 에이전트 확장을 설치하지 못할 수 있습니다.
포털에서 SQL VM 리소스를 사용할 수 없음
SQL IaaS 에이전트 확장이 설치되고 VM이 온라인 상태이지만 Azure Portal에서 SQL VM 리소스를 사용할 수 없는 경우 VM 내에서 SQL Server 및 SQL Browser 서비스가 시작되었는지 확인합니다. 문제가 해결되지 않으면 확장을 복구합니다.
기능이 회색으로 표시됨
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 이미지를 배포할 때 디스크/스토리지 풀 이름에 대한 사용자 지정 명명 규칙을 사용한 경우.
- 프리미엄 SSDv2를 사용하여 SQL Server VM을 배포한 경우
- SQL Server 구성 관리자 또는 가상 머신 수준에서 TCP/IP를 사용하지 않도록 설정한 경우
배포하는 동안 디스크 구성이 회색으로 표시됨
비관리 디스크를 사용하여 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 에이전트에 등록하는 기능은 지원되지 않습니다.
TCP/IP가 사용하지 않도록 설정됨
SQL IaaS 에이전트 확장을 사용하려면 SQL Server 구성 관리자 및 가상 머신 수준 모두에서 TCP/IP를 사용하도록 설정해야 합니다. TCP/IP를 사용하지 않도록 설정하면 설치 실패 또는 일부 기능이 예상대로 작동하지 않는 등 예측할 수 없는 동작이 발생할 수 있습니다.
대상으로 지정할 SQL 인스턴스를 찾을 수 없음
오류: Unable to find SQL instance to target. Skipping 'NT Service\\SQLIaaSExtensionQuery' removal from SQL logins는 무시해도 되는 경고 메시지입니다.
구독에 자동 등록이 설정되어 있지만 Azure 가상 머신에 SQL Server가 설치되어 있지 않은 경우 Windows 이벤트 뷰어에 이 메시지가 표시될 수 있으며, 이 경우 이 메시지는 무시해도 안전합니다.
컴퓨터에서 MSSQLSERVER 서비스를 찾을 수 없음
오류: SQL Server IaaS Agent: PreReq failure: ErrorCode: NotRetryableUnexpectedError, Message: Service MSSQLSERVER was not found on computer '.'.;The specified service does not exist as an installed service
SQL IaaS 에이전트 확장은 하나의 기본 인스턴스 또는 하나의 명명된 인스턴스에서만 작동합니다. 자세한 내용은 여러 인스턴스 지원을 검토하세요.
이름이 'MSSQLSERVER'인 서비스가 실행되고 있지 않습니다.
오류: Service with name 'MSSQLSERVER' is not running. Please make sure service 'MSSQLSERVER' is running and retry this operation
기본 인스턴스에 대한 SQL Server 서비스가 VM 내부에서 실행 중인지 확인하거나, 그렇지 않으면 IaaS 확장을 복구합니다. 여러 SQL Server 인스턴스가 있는 경우 여러 인스턴스가 현재 지원되지 않으므로 SQL IaaS 에이전트 확장이 작동하지 않습니다. 자세한 내용은 여러 인스턴스 지원을 검토하세요.
확장이 전환 또는 프로비저닝 실패 상태에서 멈췄습니다.
SQL IaaS 에이전트 익스텐션을 복구하십시오. 하나의 기본 인스턴스 또는 하나의 명명된 인스턴스만 있는지 확인합니다. 자세한 내용은 여러 인스턴스 지원을 검토하세요.
ExtensionLog_0.log 대한 액세스 거부
오류: EventID:56067 denied access to 'C:\WindowsAzure\Logs\Plugins\Microsoft.SqlServer.Management.SqlIaaSAgent\2.0.x.x\ExtensionLog_0.log'
오류에 나열된 경로에 [NT Service\SQLIaaSExtensionQuery]에 대한 권한을 추가합니다.
SQL VM 리소스를 만들지 못했습니다.
SQL 가상 머신 리소스는 다음 시나리오에서 생성되지 않습니다.
- 가상 머신 복제
- Azure Site Recovery 사용
- 한 구독, 리소스 그룹 또는 지역에서 다른 구독, 리소스 그룹 또는 지역으로 마이그레이션하기
SQL IaaS 에이전트 확장을 다시 설치하여 이 오류를 해결합니다.
게스트 에이전트/가상 에이전트 상태가 “준비되지 않음”으로 인해 실패했습니다.
VM 에이전트 확장을 설치하여 오류를 해결합니다.
확장 기능이 여러 인스턴스에서 작동하지 않습니다.
이는 예상된 동작입니다. 자세한 내용은 여러 인스턴스 지원을 검토하세요.
더 많은 메모리/CPU를 소비하는 확장 서비스
이 메시지가 표시되면 확장 프로그램을 제거했다가 다시 설치하여 SQL IaaS 에이전트 확장 프로그램이 최신 버전인지 확인하거나 services.msc에서 SQL IaaS 에이전트 확장 프로그램 서비스를 다시 시작하세요.
확장 기능이 SQL FCI에서 작동하지 않음
이는 예상된 동작입니다. 현재 SQL IaaS 에이전트 확장으로 등록된 Azure 가상 머신의 SQL Server 장애 조치 클러스터 인스턴스는 기본 등록을 통해 제공되는 제한된 수의 기능만 지원합니다.
관련 콘텐츠
- SQL IaaS 에이전트 익스텐션이 제공하는 이점을 검토합니다.
- 수동으로 단일 VM 등록
- 구독에 모든 VM을 자동으로 등록합니다.
- SQL IaaS 에이전트 익스텐션 개인정보처리방침을 검토합니다.
- 모범 사례 체크리스트를 검토하여 성능과 보안을 최적화합니다.
더 알아보려면 다음 문서를 검토하세요.