# スロットリング防止 **KONNEKT のスロットリング防止** には 2 つのポリシーが含まれます。1 つは「[更新頻度制御](/ja/configuration/system-settings/surottoringu/sharepoint-throttling-prevention.md)」ポリシー、もう 1 つは「[request rate limiting](/ja/configuration/system-settings/surottoringu/surottoringukuraianto.md)」ポリシーで、Microsoft の GraphAPI に対して行われるリクエストの速度を管理・制御し、SharePoint Online (SPO) への接続が安定した状態を保ち、最適に動作するように設計されています。これらのポリシーは、過剰なリソース使用を防ぎ、スムーズなユーザー体験を維持するうえで特に有効です。 Microsoft 365 API の使用には、アプリケーションが一定時間内に送信できるリクエスト数に関する制限があります。アプリケーションがより多くのリソースを使用すると、スロットリングされます。詳細は [Microsoft のドキュメント](https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online). をご覧ください。KONNEKT は Microsoft SharePoint Online REST API および Microsoft Graph API を使用しているため、Microsoft API によって KONNEKT の使用がスロットリングされる場合があります。アプリケーションがスロットリングされると、対応する API（例: SPO REST API）は KONNEKT に対し、所定の時間待機する必要があることを通知します。これは数秒から始まり、使用状況によっては数分まで増加します。KONNEKT への影響としては、ファイルの閲覧や読み込み/書き込みが遅くなることがあります。スロットリングが数分単位まで長引くと、ドライブが現在利用できないというエラーメッセージが表示されます。 KONNEKT には、スロットリングの発生を減らすための複数の仕組みがあり、これらは自動的に適用されます。 ## スロットリング防止の一般的なシナリオ ### **シナリオ 1: 大量のデータアップロードまたはデータ移行** ユーザーが短時間に大量のファイルをアップロードしようとしたり、SPO 内でデータ移行を行ったりすると、デバイスが指定された上限に達する場合があります。 ### **シナリオ 2: 集中的な読み取り操作** ユーザーが大きなディレクトリ（> 1000 アイテム）の検索や照会など、集中的な読み取り操作を行うと、デバイスが指定された上限に達する場合があります。 例: * 大きなフォルダーでの File Explorer Search の使用 * 多数の画像ファイルや PDF ファイルがあるフォルダーをスクロールする ### **シナリオ 3: 権限クエリ** バージョン 2.10 以降、KONNEKT はフォルダーおよびファイルごとの権限も追加でチェックします。これらのクエリは他の操作に比べてより多くのリソース単位を消費するためです。そのため、システムが指定された上限により早く達し、スロットリング防止が発動する可能性があります。「[SharePoint Throttling Prevention](/ja/configuration/system-settings/surottoringu/sharepoint-throttling-prevention.md)」が 'High' に設定されている場合、権限クエリはトリガーされません。 {% hint style="warning" %} 高負荷環境では、すべての対策を講じてもスロットリングを防げない場合があります。 KONNEKT は通常のオフィスワーク向けに作られています。大量のファイル（例: 動画編集、グラフィックデザイン、CAD）を扱う場合や、ギガバイト単位のデータを読み書きする場合、KONNEKT（および SPO）は適切な選択肢ではない可能性があります。 あわせて当社の [ユースケース](/ja/readme.md#use-cases). {% endhint %} ## **リソース単位** GraphAPI の各リクエスト種別は、消費するリソース単位が異なります。 * 単一アイテムの読み取り: 各 1 リソース単位 * 書き込み操作およびディレクトリクエリ: 各 2 リソース単位 * 権限クエリ: 5 詳細は以下を参照してください:\ ## スロットリングを防ぐにはどうすればよいですか? #### 以下の状況はスロットリングを促進します。 * SPO バックアップにサードパーティツールを使用する - 特に勤務時間中 * ファイルシステム全体をクロールするツール（プレビュー レンダラーなど）の使用 * フォルダーの第 1 階層に >1000 ファイルがある非常に大きなフォルダーの使用 * 大規模なサイト コレクションまたはドキュメント ライブラリでの File Explorer Search の過度な使用 {% hint style="info" %} M365 テナントのすべてのユーザーに対して、例外なく以下の設定と対策を検討してください。 {% endhint %} #### スロットリングを回避するには: * 業務時間中に SPO バックアップを実行しないでください。 * File Explorer Search が避けられない場合: File Explorer Search を最適化し、特定のフォルダーまたはサブフォルダーに絞って GraphAPI のリクエスト数を抑えてください * 定期的なメンテナンス: 古いファイル、フォルダー、ドキュメント ライブラリ、サイト コレクションをアーカイブまたは削除します。 * 大規模なサイト コレクションまたはドキュメント ライブラリでの File Explorer Search の過度な使用を避ける * KONNEKT リソースに対してプレビュー レンダラーを使用しないでください。こちらも参照してください [こちらから](/ja/configuration/system-settings/offline-attribute.md)。さらに [Offline Filter](/ja/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) をファイル拡張子「YYY」（存在しない拡張子）に設定すると、Windows File Explorer が PDF ファイルのプレビューをレンダリングするのを防げます。 * データを分割してください（フォルダーの第 1 階層にファイルを増やしすぎない）。 * 「[SharePoint Throttling Prevention](/ja/configuration/system-settings/surottoringu/sharepoint-throttling-prevention.md)」ポリシーを「High」に設定する - KONNEKT バージョン 2.10.2 までのみ推奨 * バージョン 2.11.0 以降では、「[Client side throttling](/ja/configuration/system-settings/surottoringu/surottoringukuraianto.md)」を有効にし、「[SharePoint Throttling Prevention](/ja/configuration/system-settings/surottoringu/sharepoint-throttling-prevention.md)」ポリシーを「Auto」に設定することを推奨します。 を [KONNEKT logging を「debug」に](/ja/configuration/system-settings/logging.md#log-level)すると、「`ThrottlingHook: Need to wait Xs before start`」を含むログエントリが表示されます（X は SPO が待機を要求する秒数を表します）。 「`[Sharepoint] UpdateDrives: Skipping volume due to throttling prevention.`」を含むログエントリは、SharePoint のスロットリングが原因ではありません。これらはスロットリングを防ぐための通常の操作を示しているだけなので、心配はいりません。 ;-) ## **仕組み** 「[更新頻度制御](/ja/configuration/system-settings/surottoringu/sharepoint-throttling-prevention.md)」ポリシーは、ユーザーの Site Collections の更新など、拡張された更新サイクルごとのリクエストを制限します。 「[request rate limiting](/ja/configuration/system-settings/surottoringu/surottoringukuraianto.md)」ポリシーは、指定された時間枠内に行われたリクエスト数と対応するリソース単位を監視し、それらのリクエストに制限を適用することで機能します。このポリシー「[Client side throttling](/ja/configuration/system-settings/surottoringu/surottoringukuraianto.md)」には、 **ソフト** と **ハード** の制限が含まれます: * **ソフト制限**:\ ソフト制限に達すると、システムはリクエストのスロットリングを開始します。これは、ほとんどの操作が短時間（例: 2 秒）遅延し、スロットリング防止レベルが HIGH に切り替わることを意味します。 opportunistic upload jobs や read-ahead operations などの一部の操作は、リクエスト数がソフト制限を下回るまで延期されます。 * **ハード制限**:\ ハード制限に達すると、システムは一切のリクエスト送信を停止します。アプリケーションは、時間枠の終了までエラーメッセージを表示します。 {% hint style="warning" %} ハード制限は、KONNEKT が Microsoft のエンドポイントへアクセスし、通信するのを妨げるため、必要な場合にのみ使用してください。 {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.konnekt.io/ja/configuration/system-settings/surottoringu.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.