スロットリング防止

KONNEKTのスロットリング防止機能 には「更新頻度制御」ポリシーと「リクエストレート制限」ポリシーが含まれており、MicrosoftのGraph APIへのリクエスト頻度を管理・制御して、SharePoint Online（SPO）への接続が安定して最適に機能するようにします。これらのポリシーは、過剰なリソース使用を防ぎ、スムーズなユーザー体験を維持するのに特に有用です。

Microsoft 365 APIの使用には、アプリケーションが送信できる時間当たりのリクエスト数に関する制限があります。アプリケーションがより多くのリソースを使用すると、スロットリングされます。詳細は次をご覧ください： Microsoft ドキュメント.

KONNEKTはMicrosoft SharePoint Online REST APIおよびMicrosoft Graph APIを使用しているため、MicrosoftのAPIがKONNEKTの利用をスロットリングすることがあります。アプリケーションがスロットリングされると、該当するAPI（例：SPO REST API）は、KONNEKTに対して定義された時間だけ待機するよう指示します。これは数秒から始まり、使用状況によっては数分にまで達することがあります。KONNEKTへの影響としては、ブラウジングやファイルの読み込み／書き込みが遅くなることが挙げられます。スロットリングが数分に及ぶと、ドライブが現在利用できないというエラーメッセージが表示されます。

KONNEKTにはスロットリング発生を低減するためのいくつかのメカニズムがあり、自動的に適用されます。

スロットリング防止の一般的なシナリオ

シナリオ1：大量データのアップロードまたはデータ移行

ユーザーが短時間で大量のファイルをSPOにアップロードしたり、SPO内でデータ移行を行ったりすると、デバイスが指定された制限に達する可能性があります。

シナリオ2：集中的な読み取り操作

ユーザーが大きなディレクトリ（> 1000項目）をクエリや検索するなどの集中的な読み取り操作を行うと、デバイスが指定された制限に達する可能性があります。

例：

• 大きなフォルダーでのファイルエクスプローラー検索の使用

• 多数のグラフィックやPDFファイルを含むフォルダーをスクロールすること

シナリオ3：権限クエリ

バージョン2.10以降、KONNEKTはフォルダやファイルごとの権限を追加でチェックします。これらのクエリは他の操作と比べてより多くのリソース単位を消費するためです。システムは指定された制限により速く到達し、スロットリング防止が発動する可能性があります。"SharePointスロットリング防止"が「高」に設定されていると、権限クエリはトリガーされません。

高負荷環境では、すべての対策でもスロットリングを防げない場合があります。

KONNEKTは通常のオフィス作業向けに設計されています。大容量ファイル（例：ビデオ編集、グラフィックデザイン、CAD）を多用したり、ギガバイト単位のデータを読み書きしたりする場合、KONNEKT（およびSPO）は適切なツールではない可能性があります。

また、以下もご確認ください： ユースケース.

リソース単位

Graph APIの各種リクエストは、異なる量のリソース単位を消費します：

• 単一アイテムの読み取り：各1リソース単位

• 書き込み操作とディレクトリクエリ：各2リソース単位

• 権限クエリ：5

詳細は次をご覧ください： https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online

スロットリングを防ぐには？

次のような状況がスロットリングを促進します：

• 業務時間中のSPOバックアップにサードパーティ製ツールを使用すること（特に）

• ファイルシステム全体をクロールするツール（プレビューレンダラー等）の使用

• フォルダーの第一階層に>1000ファイルを含む非常に大きなフォルダーの使用

• 大きなサイトコレクションやドキュメントライブラリでのファイルエクスプローラー検索の過度な使用

M365テナントの全ユーザーに対して、以下の設定および対応を例外なく検討してください。

スロットリングを避けるために：

• 業務時間中にSPOバックアップを実行しないでください。

• ファイルエクスプローラー検索が避けられない場合：File Explorer検索を最適化し、Graph APIリクエストを制限するために特定のフォルダーやサブフォルダーに焦点を当ててください。

• 定期的なメンテナンス：古くなったファイル、フォルダー、ドキュメントライブラリ、サイトコレクションをアーカイブするか削除してください。

• 大規模なサイトコレクションやドキュメントライブラリでのファイルエクスプローラー検索の過度な使用を避けてください。

• KONNEKTリソースに対してプレビューレンダラーを使用しないでください。詳細は次も参照してください： ここから。さらに、 オフラインフィルター をファイル拡張子「YYY」（存在しない拡張子）に設定すると、WindowsファイルエクスプローラーがPDFファイルのプレビューをレンダリングするのを防げます。

• データを分割してください（フォルダーの第一階層にファイルを詰め込みすぎない）。

• 「SharePointスロットリング防止」ポリシーを「高」に設定してください — KONNEKTバージョン2.10.2までの間のみ推奨。

• バージョン2.11.0以降では、次の設定を有効にすることを推奨します："クライアント側スロットリング"を有効にし、"SharePointスロットリング防止」ポリシーを「自動」に設定してください。

を有効にすると、 KONNEKTのログを「debug」に設定すると、」というログエントリが表示されます。ThrottlingHook: 開始前にXs待機する必要があります」（ここでXはSPOが待機を要求する秒数を表します）。

"を含むログエントリは、[Sharepoint] UpdateDrives: スロットリング防止のためボリュームをスキップします。" はSharePointのスロットリングが原因ではありません。これらはスロットリングを防ぐための通常の操作を示しており、心配する必要はありません。 ;-）

仕組み

「更新頻度制御」ポリシーは、たとえばユーザーのサイトコレクションを更新するなど、拡張されたリフレッシュサイクルによってリクエストを制限します。

「リクエストレート制限「クライアント側スロットリング」ポリシーは、指定された時間ウィンドウ内で行われたリクエスト数とそれらに対応するリソース単位を監視し、これらのリクエストに制限を適用することで動作します。このポリシー「 」には と ソフト ハード

• ソフトリミット制限が含まれます： ソフトリミットに達すると、システムはリクエストのスロットリングを開始します。つまり、ほとんどの操作は短期間（例えば2秒）遅延され、スロットリング防止レベルは高（HIGH）に切り替わります。機会的アップロードジョブや先読み操作など一部の操作は、リクエスト量がソフトリミットを下回るまで延期されます。

• ハードリミット制限に達すると、システムは一切のリクエスト送信を停止します。時間ウィンドウの終了までアプリケーションはエラーメッセージを表示します。

「ハードリミット」はKONNEKTがMicrosoftのエンドポイントへの通信を行うのを妨げるため、必要な場合にのみ使用してください。