Workers KV に関するよくある質問です。
はい。Workers の外からも、REST API または REST API 向けの Cloudflare SDKs で Workers KV を使えます。REST API の制限 が適用される点に注意してください。
Workers KV へのアクセス方法を選ぶときは、次を考慮します。
- パフォーマンス: Workers Binding API 経由のアクセスは、HTTP リクエストのオーバーヘッドがないため、REST API より一般的に高速です。
- レート制限: アクセス方法ごとにレート制限が異なります。REST API の書き込みレート制限は、Workers Binding API より低くなっています。Workers KV のレート制限は？ を参照してください。
Workers KV は、Cloudflare ネットワーク全体でデータを強くキャッシュします。そのため、最大で cache TTL のあいだ、キャッシュされた値を読むことがあります。
Workers KV は結果整合です。
Workers KV は中央ストアにデータを保存し、プッシュとプルを組み合わせたハイブリッドレプリケーションで、すべての Cloudflare ロケーションへ複製します。そのため、cache TTL のあいだ、あるロケーションでキーと値のペアの以前の値が見えることがあります。つまり、Workers KV は結果整合です。
KV の仕組み を参照してください。
Worker が Workers KV へ一括リクエストした場合、個々のキーは Worker のサブリクエスト制限（1000） にカウントされますか？
いいえ。Workers KV への一括リクエストは、含まれるキーの数に関係なく、1 回の操作としてカウントされます。たとえば、一括 KV リクエストを 500 回、R2 リクエストを 500 回行い、合計 1000 操作にできます。
Workers KV のレート制限は、アクセス方法によって異なります。
REST API 経由の操作には、REST API と同じ制限 が適用されます。この制限は、すべての Cloudflare REST API リクエストで共有されます。
Workers Binding API 経由で Workers KV に書き込む場合、書き込みレート制限はキーあたり 1 秒に 1 回で、KV キー全体では無制限です。
Workers KV の REST API で書き込む場合、書き込みはどう課金されますか？
PUT リクエスト内の各キーと値のペアが 1 回の書き込みとしてカウントされます。Workers API の PUT 呼び出しが 1 回の書き込みになるのと同じです。REST API で 5,000 キーを書き込むコストは、Worker 内で PUT を 5,000 回呼ぶ場合と同じです。
はい。Cloudflare ダッシュボードまたは wrangler 経由の操作（キーの更新（書き込み）、キーの削除、名前空間内のキー一覧）は、課金対象の Workers KV 使用量になります。
いいえ。
いいえ。キーの有効期限切れは課金対象の操作ではありません。