Skip to main content Início Criadores biwakonbu cc-plugins storage-services
storage-services Use when user asks about KV, R2, D1, Durable Objects, Queues, Hyperdrive, storage, database, or data persistence on Cloudflare. Also use when user says KV ストア, R2 バケット, D1 データベース, Durable Objects, キュー, ストレージ. Cloudflare ストレージサービスの完全ガイドで、KV、R2、D1、Durable Objects、Queues、Hyperdrive の使い方、設定、ベストプラクティスを提供する。
Ir para a instalação Skills Marketplace Descubra e explore skills de IA criadas pela comunidade.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Mostrar detalhes do prompt Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
npx skills add https://github.com/biwakonbu/cc-plugins --skill storage-servicesO comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.
Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.
Baixar Zip Baixando... Use when user asks about Claude Code, plugins, skills, slash commands, subagents, hooks, LSP, MCP, permissions, sessions, plan mode, agent teams, background agents, worktree, teleport, effort, structured output, --bare, or --console. Also use when user says Claude Code について, プラグイン開発, スキル定義, フック設定, 権限設定. Claude Code CLI の仕様と使い方に関する知識を提供し、プラグイン開発、スキル、スラッシュコマンド、サブエージェント、フック、LSP、MCP、権限設定、セッション管理、エージェントチーム、バックグラウンドエージェント、Git Worktree、セッションテレポート、effort 制御、構造化出力、リモートセッションについて回答する。
Ocupações relacionadas SOC
Baseado na classificação ocupacional SOC
name storage-services description Use when user asks about KV, R2, D1, Durable Objects, Queues, Hyperdrive, storage, database, or data persistence on Cloudflare. Also use when user says KV ストア, R2 バケット, D1 データベース, Durable Objects, キュー, ストレージ. Cloudflare ストレージサービスの完全ガイドで、KV、R2、D1、Durable Objects、Queues、Hyperdrive の使い方、設定、ベストプラクティスを提供する。 context fork
Cloudflare Storage Services
サービス概要
サービス 種類 特徴 用途 KV Key-Value 高速読み取り、結果整合性 キャッシュ、設定 R2 オブジェクト S3互換、エグレス無料 ファイル保存 D1 SQL SQLite、エッジネイティブ アプリデータ Durable Objects ステートフル 単一インスタンス保証 リアルタイム Queues メッセージ 非同期処理 バッチ、ETL Hyperdrive 接続プール 既存DB高速化 レガシーDB
KV（Workers KV）
概要
グローバルに分散された Key-Value ストア。読み取り最適化、結果整合性。
特徴
読み取りレイテンシ : 5ms未満（p99）書き込み伝播 : 最大60秒値サイズ : 最大25MBキー数 : 1,000万/Namespace
設定
[[kv_namespaces]]
binding = "MY_KV"
id = "xxx"
preview_id = "yyy"
基本操作
const value = await env.MY_KV .get ("key" );
const json = await env.MY_KV .get ("key" , "json" );
const stream = await env.MY_KV .get ("key" , "stream" );
const { value, metadata } = await env.MY_KV .getWithMetadata ("key" );
await env.MY_KV .put ("key" , "value" );
await env.MY_KV .put ("key" , JSON .stringify (data));
await env.MY_KV .put ("key" , "value" , {
expirationTtl : 3600 ,
});
await env.MY_KV .put ("key" , "value" , {
metadata : { createdAt : Date .now () },
});
await env.MY_KV .delete ("key" );
const { keys, cursor } = await env.MY_KV .list ({ prefix : "user:" });
ベストプラクティス
async function getCached (key : string , fetcher : () => Promise <string >let value = await env.MY_KV .get (key);
if (!value) {
value = await fetcher ();
await env.MY_KV .put (key, value, { expirationTtl : 3600 });
}
return value;
}
R2（オブジェクトストレージ）
概要 S3 互換のオブジェクトストレージ。エグレス料金無料 が最大の特徴。
特徴
S3 互換 API エグレス料金 : 無料オブジェクトサイズ : 最大5GB（マルチパート対応）ストレージ : 無制限
設定
[[r2_buckets]]
binding = "MY_BUCKET"
bucket_name = "my-bucket"
基本操作
await env.MY_BUCKET .put ("path/to/file.txt" , "content" );
await env.MY_BUCKET .put ("image.png" , imageBuffer, {
httpMetadata : { contentType : "image/png" },
});
const object = await env.MY_BUCKET .get ("path/to/file.txt" );
if (object ) {
const text = await object .text ();
const headers = new Headers ();
object .writeHttpMetadata (headers);
}
await env.MY_BUCKET .delete ("path/to/file.txt" );
const { objects, truncated, cursor } = await env.MY_BUCKET .list ({
prefix : "images/" ,
limit : 100 ,
});
const head = await env.MY_BUCKET .head ("path/to/file.txt" );
署名付きURL
export default {
async fetch (request : Request , env : Env const url = new URL (request.url );
const key = url.pathname .slice (1 );
if (!isAuthenticated (request)) {
return new Response ("Unauthorized" , { status : 401 });
}
const object = await env.MY_BUCKET .get (key);
if (!object ) {
return new Response ("Not Found" , { status : 404 });
}
const headers = new Headers ();
object .writeHttpMetadata (headers);
return new Response (object .body , { headers });
},
};
D1（SQLite データベース）
概要 サーバーレス SQLite データベース。エッジネイティブでグローバル読み取りレプリケーション対応。
特徴
SQLite 互換 Time Travel : 30日間の任意時点復元グローバル読み取り : ベータ機能サイズ : 10GB/DB（Paid）
設定
[[d1_databases]]
binding = "DB"
database_name = "my-database"
database_id = "xxx"
基本操作
const { results } = await env.DB .prepare (
"SELECT * FROM users WHERE id = ?"
).bind (userId).all ();
const user = await env.DB .prepare (
"SELECT * FROM users WHERE id = ?"
).bind (userId).first ();
const { meta } = await env.DB .prepare (
"INSERT INTO users (name, email) VALUES (?, ?)"
).bind (name, email).run ();
const lastRowId = meta.last_row_id ;
const changes = meta.changes ;
const results = await env.DB .batch ([
env.DB .prepare ("INSERT INTO users (name) VALUES (?)" ).bind ("Alice" ),
env.DB .prepare ("INSERT INTO users (name) VALUES (?)" ).bind ("Bob" ),
]);
const { results } = await env.DB .exec (`
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
email TEXT UNIQUE
)
` );
マイグレーション
wrangler d1 migrations create my-database "add_users_table"
CREATE TABLE users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);
wrangler d1 migrations apply my-database
wrangler d1 migrations apply my-database --local
ORM（Drizzle） import { drizzle } from "drizzle-orm/d1" ;
import { users } from "./schema" ;
export default {
async fetch (request : Request , env : Env const db = drizzle (env.DB );
const allUsers = await db.select ().from (users).all ();
return Response .json (allUsers);
},
};
Durable Objects
概要 ステートフルなエッジコンピューティング。グローバルで単一インスタンスを保証。
特徴
単一インスタンス保証 : 同じIDは常に同じインスタンス永続ストレージ : SQLite Storageリアルタイム対応 : WebSocket サポート
設定
[durable_objects]
bindings = [
{ name = "COUNTER" , class_name = "Counter" }
]
[[migrations]]
tag = "v1"
new_classes = ["Counter" ]
実装 export class Counter {
private state : DurableObjectState ;
private count : number = 0 ;
constructor (state : DurableObjectState , env : Env this .state = state;
this .state .blockConcurrencyWhile (async () => {
const stored = await this .state .storage .get <number >("count" );
this .count = stored ?? 0 ;
});
}
async fetch (request : Request ): Promise <Response > {
const url = new URL (request.url );
if (url.pathname === "/increment" ) {
this .count ++;
await this .state .storage .put ("count" , this .count );
}
return new Response (String (this .count ));
}
}
export default {
async fetch (request : Request , env : Env const id = env.COUNTER .idFromName ("global" );
const stub = env.COUNTER .get (id);
return stub.fetch (request);
},
};
WebSocket サポート export class ChatRoom {
private sessions : Set <WebSocket > = new Set ();
async fetch (request : Request ): Promise <Response > {
if (request.headers .get ("Upgrade" ) === "websocket" ) {
const pair = new WebSocketPair ();
const [client, server] = Object .values (pair);
server.accept ();
this .sessions .add (server);
server.addEventListener ("message" , (event ) => {
for (const session of this .sessions ) {
session.send (event.data );
}
});
server.addEventListener ("close" , () => {
this .sessions .delete (server);
});
return new Response (null , { status : 101 , webSocket : client });
}
return new Response ("Expected WebSocket" , { status : 400 });
}
}
Queues
概要 Workers 間の非同期メッセージング。バッチ処理、ETL パイプラインに最適。
設定
[[queues.producers]]
binding = "MY_QUEUE"
queue = "my-queue"
[[queues.consumers]]
queue = "my-queue"
max_batch_size = 10
max_batch_timeout = 30
Producer export default {
async fetch (request : Request , env : Env await env.MY_QUEUE .send ({
type : "user_created" ,
userId : 123 ,
timestamp : Date .now (),
});
await env.MY_QUEUE .sendBatch ([
{ body : { id : 1 } },
{ body : { id : 2 } },
]);
return new Response ("Queued" );
},
};
Consumer export default {
async queue (
batch : MessageBatch ,
env : Env ,
ctx : ExecutionContext
): Promise <void > {
for (const message of batch.messages ) {
try {
console .log (message.body );
message.ack ();
} catch (error) {
message.retry ();
}
}
},
};
Hyperdrive
概要 既存の PostgreSQL/MySQL への接続を高速化。接続プーリングと地域キャッシュ。
特徴
接続プーリング : コネクション再利用クエリキャッシュ : エッジでのキャッシュレイテンシ削減 : 最大10倍高速化
設定
wrangler hyperdrive create my-hyperdrive \
--connection-string="postgres://user:pass@host:5432/db"
[[hyperdrive]]
binding = "HYPERDRIVE"
id = "xxx"
使用例 import { Client } from "pg" ;
export default {
async fetch (request : Request , env : Env const client = new Client (env.HYPERDRIVE .connectionString );
await client.connect ();
const result = await client.query ("SELECT * FROM users LIMIT 10" );
await client.end ();
return Response .json (result.rows );
},
};
比較表 項目 KV R2 D1 DO 整合性 結果整合 強整合 強整合 強整合 読み取り 超高速 高速 高速 中速 書き込み 遅い 中速 中速 高速 クエリ キーのみ プレフィックス SQL カスタム 用途 キャッシュ ファイル 構造化データ リアルタイム
公式リソース 