> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/ja/configuration/system-settings/throttling-prevention.md).

# スロットリング防止

**KONNEKT のスロットリング防止** 2つのポリシー、つまり「[更新頻度制御](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)」ポリシーと「[リクエストレート制限](/ja/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)」ポリシーは、Microsoft の GraphAPI に対して行われるリクエストの速度を管理・制御するよう設計されており、SharePoint Online (SPO) への接続を安定させ、最適に動作するようにします。これらのポリシーは、過度なリソース使用を防ぎ、スムーズなユーザー体験を維持するうえで特に有用です。

Microsoft 365 APIs の使用は、アプリケーションが一定時間内に送信できるリクエスト数に制限があります。アプリケーションがより多くのリソースを使用すると、スロットルされます。詳細は次を参照してください。 [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 へ多数のファイルをアップロードしたり、SPO 内でデータ移行を行おうとすると、デバイスが指定された上限に達する場合があります。

### **シナリオ 2: 集中的な読み取り操作**

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

例:

* 大きなフォルダーでエクスプローラー検索を使用する
* 多数の画像または PDF ファイルがあるフォルダーをスクロールする

### **シナリオ 3: 権限クエリ**

バージョン 2.10 以降、KONNEKT はフォルダーおよびファイルごとの権限も追加でチェックします。これらのクエリは他の操作より多くのリソース単位を消費するためです。システムは指定された上限により早く達する可能性があり、これがスロットリング防止を引き起こすことがあります。権限クエリは、「[SharePoint のスロットリング防止](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)」が 'High' に設定されている場合は実行されません。

{% hint style="warning" %}
高負荷環境では、すべての対策を講じてもスロットリングを防ぎきれない場合があります。

KONNEKT は通常のオフィス作業向けに作られています。大容量ファイル（例: 動画編集、グラフィックデザイン、CAD）やギガバイト単位のデータの読み書きを行う場合、KONNEKT（および SPO）は適切な選択肢ではないかもしれません。

あわせて次もご確認ください [ユースケース](/ja/readme.md#use-cases).
{% endhint %}

## **リソース単位**

GraphAPI の各種類のリクエストは、消費するリソース単位の量が異なります:

* 単一項目の読み取り: 各 1 リソース単位
* 書き込み操作およびディレクトリクエリ: 各 2 リソース単位
* 権限クエリ: 5

詳細は次を参照:\
<https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online>

## スロットリングを防ぐにはどうすればよいですか?

#### 以下の状況はスロットリングを促進します:

* SPO バックアップのためのサードパーティ製ツールの使用 - 特に勤務時間中
* ファイルシステム全体をクロールするツールの使用（プレビュー レンダラーなど）
* フォルダーの第1階層に >1000 ファイルを含む非常に大きなフォルダーの使用
* 大きなサイト コレクションやドキュメント ライブラリでのエクスプローラー検索の過度な使用

{% hint style="info" %}
例外なく、M365 Tenant のすべてのユーザーに対して以下の設定と対応を検討してください。
{% endhint %}

#### スロットリングを回避するには:

* 営業時間中に SPO バックアップを実行しないでください。
* エクスプローラー検索が避けられない場合: エクスプローラー検索を最適化し、特定のフォルダーまたはサブフォルダーに絞って GraphAPI リクエストを抑えてください
* 定期的なメンテナンス: 古くなったファイル、フォルダー、ドキュメント ライブラリ、サイト コレクションをアーカイブまたは削除します。
* 大きなサイト コレクションやドキュメント ライブラリでのエクスプローラー検索の過度な使用を避けてください
* KONNEKT リソースにプレビュー レンダラーを使用しないでください。あわせて参照 [こちらから](/ja/configuration/system-settings/offline-attribute.md)。さらに次を設定できます [オフライン フィルター](/ja/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) をファイル拡張子「YYY」（実在しない拡張子）に設定すると、Windows のファイル エクスプローラーが PDF ファイルのプレビューをレンダリングするのを防げます。
* データを分割してください（フォルダーの第1階層にファイルを多く置きすぎない）。
* 「[SharePoint のスロットリング防止](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)」ポリシーを「High」に設定します - KONNEKT バージョン 2.10.2 までのみ推奨
* バージョン 2.11.0 以降では、「[クライアント側スロットリング](/ja/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)」を有効にし、「[SharePoint のスロットリング防止](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)」ポリシーを「Auto」に設定することを推奨します。

次を有効にすると [KONNEKT のログ記録を「debug」に](/ja/configuration/system-settings/logging.md#log-level)すると、「`ThrottlingHook: 開始前に X 秒待つ必要があります`」（X は SPO が待機を求める秒数を表します）。

「`[Sharepoint] UpdateDrives: スロットリング防止のためボリュームをスキップしています。`」は SharePoint のスロットリングによって発生するものではありません。これらはスロットリングを防ぐための通常の操作を示しており、心配ありません。;-)

## **仕組み**

「[更新頻度制御](/ja/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)」ポリシーは、強化された更新サイクルによってリクエストを制限します。たとえば、ユーザーのサイト コレクションを更新する場合などです。

「[リクエストレート制限](/ja/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)」ポリシーは、指定された時間枠内で行われるリクエスト数とそれに対応するリソース単位を監視し、これらのリクエストに制限を適用することで動作します。このポリシー「[クライアント側スロットリング](/ja/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)」には **ソフト** と **ハード** 制限があります:

* **ソフトリミット**:\
  ソフト制限に達すると、システムはリクエストのスロットリングを開始します。つまり、ほとんどの操作が短時間（例: 2 秒）遅延し、スロットリング防止レベルは HIGH に切り替わります。機会的アップロード ジョブや先読み操作など一部の操作は、リクエスト数がソフト制限を下回るまで延期されます。
* **ハードリミット**:\
  ハード制限に達すると、システムは一切のリクエスト送信を停止します。アプリケーションには、時間枠の終了時刻に達するまでエラーメッセージが表示されます。

{% hint style="warning" %}
「Hard Limit」は、KONNEKT が Microsoft のエンドポイントへのアクセスおよび通信を行うのを妨げるため、必要な場合にのみ使用してください。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.konnekt.io/ja/configuration/system-settings/throttling-prevention.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.