다음을 통해 공유

Microsoft Entra Connect: LocalDB 10GB 제한에서 복구하는 방법

  • 아티클

Microsoft Entra Connect에는 ID 데이터를 저장하기 위한 SQL Server 데이터베이스가 필요합니다. Microsoft Entra Connect와 함께 설치된 기본 SQL Server 2019 Express LocalDB를 사용하거나 자체 전체 SQL을 사용할 수 있습니다. SQL Server Express는 10GB 크기 제한을 적용합니다. LocalDB를 사용하고 이 제한에 도달하면 Microsoft Entra Connect 동기화 서비스가 더 이상 제대로 시작되거나 동기화될 수 없습니다. 이 문서에서는 복구 단계를 제공합니다.

증상

두 가지 일반적인 증상이 있습니다.

  • Microsoft Entra Connect 동기화 서비스가 실행 중이지만 "stopped-database-disk-full" 오류로 인해 동기화에 실패했습니다.

  • Microsoft Entra Connect 동기화 서비스를 시작할 수 없습니다. 서비스를 시작하려고 할 때 이벤트 6323 및 오류 메시지 "SQL Server의 디스크 공간이 부족하기 때문에 서버에서 오류가 발생했습니다."와 함께 실패합니다.

단기 복구 단계

이 섹션에서는 Microsoft Entra Connect 동기화 서비스가 작업을 다시 시작하는 데 필요한 DB 공간을 회수하는 단계를 제공합니다. 단계는 다음과 같습니다.

  1. 동기화 서비스 상태 확인
  2. 데이터베이스 축소
  3. 실행 기록 데이터 삭제
  4. 실행 기록 데이터에 대한 보존 기간 단축

동기화 서비스 상태 확인

먼저 동기화 서비스가 계속 실행 중인지 여부를 확인합니다.

  1. Microsoft Entra Connect 서버에 관리자로 로그인합니다.

  2. 서비스 제어 관리자로 이동합니다.

  3. Microsoft Entra ID Sync 상태를 확인합니다.

  4. 실행 중인 경우 서비스를 중지하거나 다시 시작하지 마십시오. 데이터베이스 축소 단계를 건너뛰고 실행 기록 데이터 삭제 단계로 이동합니다.

  5. 실행 중이 아닌 경우 서비스를 시작하세요. 서비스가 성공적으로 시작하는 경우 데이터베이스 축소 단계를 건너뛰고 실행 기록 데이터 삭제 단계로 이동합니다. 그렇지 않으면 데이터베이스 축소 단계를 계속합니다.

데이터베이스 축소

축소 작업을 사용하여 동기화 서비스를 시작하는 데 충분한 DB 공간을 확보합니다. 데이터베이스에서 공백을 제거하여 DB 공간을 확보합니다. 항상 공백을 복구할 수 있다고 보장되지 않으므로 이 단계가 최선적입니다. 축소 작업에 대한 자세한 내용은 이 데이터베이스 축소 문서를 참조하세요.

Important

동기화 서비스를 실행할 수 있는 경우 이 단계를 건너뜁니다. 늘어난 조각화로 인해 성능 저하가 발생할 수 있으므로 SQL DB를 축소하는 것은 좋지 않습니다.

Microsoft Entra Connect에 대해 만든 데이터베이스 이름은 ADSync입니다. 축소 작업을 수행하려면 sysadmin 또는 데이터베이스의 DBO로 로그인해야 합니다. Microsoft Entra Connect 설치 중에 다음 계정에 sysadmin 권한이 부여됩니다.

  • 로컬 관리자
  • Microsoft Entra Connect 설치를 실행하는 데 사용된 사용자 계정입니다.
  • Microsoft Entra Connect 동기화 서비스의 운영 컨텍스트로 사용되는 동기화 서비스 계정입니다.
  • 설치 중 생성된 로컬 그룹 ADSyncAdmins입니다.

  1. %ProgramFiles%\Microsoft Azure AD Sync\Data 아래에 위치한 ADSync.mdf 및 ADSync_log.ldf 파일을 복사하여 데이터베이스를 안전한 위치로 백업합니다.

  2. 새 PowerShell 세션을 시작합니다.

  3. %ProgramFiles%\Microsoft SQL Server\110\Tools\Binn 폴더로 이동합니다.

  4. ./SQLCMD.EXE -S "(localdb)\.\ADSync" -U <Username> -P <Password> 명령을 실행하고 sysadmin 또는 DBO 데이터베이스의 자격 증명을 사용하여 sqlcmd 유틸리티를 시작합니다.

  5. 데이터베이스를 축소하려면 sqlcmd 프롬프트(1>)에서 DBCC Shrinkdatabase(ADSync,1);를 입력하고 그다음 줄에 GO를 입력합니다.

  6. 작업이 성공한 경우 동기화 서비스를 다시 시작합니다. 동기화 서비스를 시작할 수 있는 경우 실행 기록 데이터 삭제 단계로 이동합니다. 그렇지 않은 경우 고객 지원으로 문의하세요.

실행 기록 데이터 삭제

기본적으로 Microsoft Entra Connect는 최대 7일간의 실행 기록 데이터를 보존합니다. 이번 단계에서는 Microsoft Entra Connect 동기화 서비스가 동기화를 다시 시작할 수 있도록 실행 기록 데이터를 삭제하여 DB 공간을 확보합니다.

  1. 시작 → 동기화 서비스로 이동하여 Synchronization Service Manager를 시작합니다.

  2. Operations 탭으로 이동합니다.

  3. 실행 아래에서 실행 지우기를 선택합니다.

  4. 모등 실행 지우기 또는 이전 실행 지우기… <날짜> 옵션 중에서 선택할 수 있습니다. 2일보다 오래된 실행 기록 데이터를 삭제하여 시작하는 것이 좋습니다. DB 크기 문제가 계속되면 Clear all runs 옵션을 선택합니다.

실행 기록 데이터에 대한 보존 기간 단축

이 단계는 여러 동기화 주기 후 10GB 제한 문제의 발생 가능성을 줄이는 것입니다.

  1. 새 PowerShell 세션을 엽니다.

  2. Get-ADSyncScheduler를 실행하고 현재 보존 기간을 지정하는 PurgeRunHistoryInterval 속성을 기록해 둡니다.

  3. Set-ADSyncScheduler -PurgeRunHistoryInterval 2.00:00:00을 실행하여 보존 기간을 2일로 설정합니다. 보존 기간을 적절하게 조정합니다.

장기 솔루션 – 전체 SQL로 마이그레이션

일반적으로 이 문제는 Microsoft Entra Connect가 온-프레미스 Active Directory를 Microsoft Entra ID와 동기화하는 데 더 이상 10GB 데이터베이스 크기가 충분하지 않음을 나타냅니다. SQL 서버의 전체 버전을 사용하도록 전환하는 것이 좋습니다. 기존 Microsoft Entra Connect 배포의 LocalDB를 전체 SQL 버전의 데이터베이스로 직접 바꿀 수는 없습니다. 대신, 전체 버전의 SQL이 포함된 새로운 Microsoft Entra Connect 서버를 배포해야 합니다. 기존 Microsoft Entra Connect 서버(LocalDB 포함) 옆에 새로운 Microsoft Entra Connect 서버(SQL DB 포함)를 준비 서버로 배포하는 스윙 마이그레이션을 수행하는 것이 좋습니다.

다음 단계

Microsoft Entra ID와 온-프레미스 ID 통합에 대해 자세히 알아봅니다.