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を開発した主な理由（ドキュメントの修復以外）は以下の通りです：

ご質問がございましたら、お気軽にお問い合わせください。