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. Service Control Manager으로 이동하세요.

3. Microsoft Entra ID 동기화 의 상태를 확인합니다.

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

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

데이터베이스 축소

축소 작업을 사용하여 동기화 서비스를 시작하기에 충분한 DB 공간을 확보합니다. 데이터베이스에서 공백을 제거하여 DB 공간을 확보합니다. 이 단계는 항상 공간을 복구할 수 있다고 보장되지 않으므로 최선의 노력입니다. 데이터베이스 축소와 관련된 작업에 대해 더 알고 싶다면 문서을 읽어보세요.

중요하다

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

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

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

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

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

3. 폴더 %ProgramFiles%\Microsoft SQL Server\110\Tools\Binn으로 이동하세요.

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

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

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

실행 기록 데이터 삭제

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

1. START → 동기화 서비스를 열어 동기화 서비스 관리자를 실행합니다.

2. 작업 탭으로 이동합니다.

3. 작업에서 실행 지우기를 선택합니다.

4. 모든 실행 지우기 선택하거나 전에 실행 지우기... <날짜> 옵션을 선택할 수 있습니다. 먼저 2일보다 오래된 실행 기록 데이터를 지우는 것이 좋습니다. DB 크기 문제가 계속 발생하면 모든 실행 지우기 옵션을 선택합니다.

실행 기록 데이터의 보존 기간 단축

이 단계는 여러 동기화 주기 후에 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 Server의 전체 버전을 사용하도록 전환하는 것이 좋습니다. 기존 Microsoft Entra Connect 배포의 LocalDB를 전체 버전의 SQL 데이터베이스로 직접 바꿀 수는 없습니다. 대신 전체 버전의 SQL을 사용하여 새 Microsoft Entra Connect 서버를 배포해야 합니다. 새 Microsoft Entra Connect 서버(SQL DB 포함)가 기존 Microsoft Entra Connect 서버(LocalDB 포함) 옆에 스테이징 서버로 배포되는 스윙 마이그레이션을 수행하는 것이 좋습니다.

• Microsoft Entra Connect를 사용하여 원격 SQL을 구성하는 방법에 대한 지침은 Microsoft Entra Connect 사용자 지정 설치문서를 참조하세요.
• Microsoft Entra Connect 업그레이드에 대한 스윙 마이그레이션 지침은 Microsoft Entra Connect: 이전 버전에서 최신 버전으로 업그레이드관련 문서를 참조하세요.

다음 단계

Microsoft Entra ID과 온-프레미스 ID를 통합하는 방법에 대해 자세히 알아보세요.