ReplaceMagic에서 SharePoint 스로틀링 처리 방법

SharePoint 스로틀링 이해 및 방지

ReplaceMagic 다운로드 동영상: ReplaceMagic 사용 방법

SharePoint Online(및 경우에 따라 온프레미스)은 플랫폼 안정성을 보호하기 위해 API 호출을 속도 제한합니다. 너무 많은 요청이 빠르게 들어오면 SharePoint는 HTTP 429(요청이 너무 많음) 또는 503 오류를 반환합니다 — 이를 스로틀링이라고 합니다. ReplaceMagic에는 스로틀링을 자동으로 처리하는 내장 도구가 있습니다.

ReplaceMagic은 여러 문서를 병렬로 처리할 수 있지만 SharePoint Online에서 스로틀링이나 차단을 피해야 합니다. 물론 성능에는 좋지만 SharePoint 플랫폼은 내부 규칙에 따라 ReplaceMagic이 생성하는 워크로드가 너무 높다고 판단할 수 있습니다. 그 결과 SharePoint가 처리 속도를 늦추거나 심지어 차단할 수 있습니다.

이는 주로 SharePoint.Online 측에서 발생하지만 SharePoint 관리자가 구성한 내용에 따라 온프레미스 SharePoint에도 적용될 수 있습니다.

ReplaceMagic이 생성하는 워크로드(병렬 처리)를 제어하려면 구성 탭(기본 ReplaceMagic 양식에서 구성 버튼 클릭)에 있는 "병렬 문서 처리" 매개변수를 사용할 수 있습니다:



SharePoint 구성에 따라 이 수치는 더 높거나 낮을 수 있지만 3~5로 시작하여 SharePoint 플랫폼 동작에 따라 미세 조정하는 것을 권장합니다.

SharePoint 스로틀링에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

SharePoint 스로틀링의 원인

• 너무 많은 병렬 문서 처리 스레드가 동시에 SharePoint API에 접근하는 경우
• 다른 사용자와 서비스도 API 호출을 하는 사용량이 많은 시간대에 처리하는 경우
• 속도 제한 없이 매우 큰 문서 라이브러리를 처리하는 경우
• 테넌트 전체 스로틀링: 전체 Microsoft 365 테넌트에 과부하가 걸리면 모든 애플리케이션이 스로틀링될 수 있음

ReplaceMagic의 자동 스로틀링 처리 방법

• 구성 → 구성 탭에서 "SharePoint 스로틀링 중 워크로드 감소"를 활성화하세요
• 429/503 오류가 감지되면 ReplaceMagic이 자동으로 병렬 처리를 줄입니다
• "X개 문서마다 워크로드 최적화"를 활성화하여 스로틀링이 해소된 후 ReplaceMagic이 점진적으로 병렬 처리를 늘리도록 합니다
• "SharePoint 워크로드 안전 벨트" 옵션은 SharePoint 대상에 대해 병렬 처리를 최대 8개 문서로 제한합니다

SharePoint Online 권장 설정

• 3~5개의 병렬 스레드로 시작하세요(구성 → 구성 탭 → "병렬 문서 처리")
• 자동 관리를 위해 "SharePoint 스로틀링 중 워크로드 감소"와 "워크로드 최적화"를 모두 활성화하세요
• 매우 큰 라이브러리나 테넌트 전체 마이그레이션의 경우 사용량이 적은 시간대(야간 및 주말)에 실행하는 것을 고려하세요
• 낮은 병렬 처리에서도 스로틀링이 지속되면 Microsoft 365 관리자에게 문의하세요 — 테넌트 수준의 리소스 제한이 적용될 수 있습니다

SharePoint 온프레미스와 스로틀링

• SharePoint 온프레미스도 스로틀링될 수 있으며, 특히 이전 2013/2016 버전에서 그렇습니다
• 온프레미스 스로틀링은 일반적으로 SharePoint Online보다 덜 엄격합니다
• 동일한 구성 설정이 적용됩니다: 온프레미스 스로틀링 오류가 발생하면 병렬 처리를 줄이세요
• SharePoint 관리자의 리소스 스로틀링 정책을 확인하세요

ReplaceMagic 다운로드 동영상: ReplaceMagic 사용 방법

ReplaceMagic의 주요 기능(문서 수정 외에):

궁금한 사항이 있으시면 언제든지 문의하기를 통해 연락해 주세요.