IDistributedCache抽象化
複数のサーバー間でデータをキャッシュします。
「IDistributedCache抽象化」はCoddyKit上の無料C# Academyレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全4レッスンが含まれています。
分散キャッシュを使う理由
インメモリキャッシュは単一のプロセス内に存在するため、再起動すると失われ、複数のサーバー間でも共有されません。分散キャッシュは Redis などの外部ストアに存在し、アプリのすべてのインスタンスから読み書きできます。そのため、スケールアウトしたデプロイでもキャッシュを一貫して利用できます。
IDistributedCache インターフェース
ASP.NET Core では、IDistributedCache を使用して Microsoft.Extensions.Caching.Distributed の背後に分散キャッシュを抽象化しています。コードは Redis に直接依存せず、このインターフェースに依存するため、実装を入れ替えられます。
public interface IDistributedCache
{
byte[] Get(string key);
Task<byte[]> GetAsync(string key, CancellationToken token = default);
void Set(string key, byte[] value, DistributedCacheEntryOptions options);
void Remove(string key);
void Refresh(string key);
}バイト列を保存する
キャッシュが byte[] を保存している点に注目してください。文字列やオブジェクトをキャッシュするには、まずシリアライズする必要があります。一般的な用途には便利な文字列用拡張メソッドが用意されています。
using Microsoft.Extensions.Caching.Distributed;
await cache.SetStringAsync("greeting", "Hello, world");
string value = await cache.GetStringAsync("greeting");キャッシュのインジェクション
他のサービスと同じように、コンストラクターインジェクションで IDistributedCache を要求します。
public class WeatherService
{
private readonly IDistributedCache _cache;
public WeatherService(IDistributedCache cache)
{
_cache = cache;
}
}キャッシュからの読み取り
GetStringAsync は、キーが存在しない場合や有効期限切れの場合に null を返します。キャッシュミスを必ず処理してください。
string cached = await _cache.GetStringAsync("forecast:istanbul");
if (cached is null)
{
// cache miss: load from source
}キャッシュへの書き込み
SetStringAsync は、任意の有効期限オプションとともに値を保存します（詳しくは後のレッスンで説明します）。
await _cache.SetStringAsync(
"forecast:istanbul",
"22C sunny",
new DistributedCacheEntryOptions
{
AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(10)
});削除と更新
RemoveAsync はキーをキャッシュから削除します（たとえば、元のデータが変更された場合です）。RefreshAsync は値を変更せずにスライディング有効期限をリセットします。
await _cache.RemoveAsync("forecast:istanbul");
await _cache.RefreshAsync("session:abc123");メモリ内実装
開発やテストでは、メモリ内分散キャッシュを登録できます。同じインターフェースを実装しているためコードは同じですが、データは実際にはプロセス間で共有されません。
builder.Services.AddDistributedMemoryCache();プロバイダーに依存しないコード
IDistributedCache のみに依存しているため、メモリ内プロバイダーから Redis（または SQL Server）への切り替えは、サービスのコードを変更せずに登録処理を1行変更するだけで行えます。
キーの命名規則
entity:id:field のような構造化された名前空間付きキーを使用してください（例: user:42:profile）。明確な規則により衝突を防ぎ、キャッシュの無効化を予測しやすくできます。
string key = $"user:{userId}:profile";キャッシュしない場合
頻繁に読み取られ、変更が少ないデータをキャッシュしてください。変更が激しいデータやユーザー固有の機密データはキャッシュに適さない場合があります。また、古いデータを返すリスクと性能向上の効果を常に比較検討する必要があります。
クイックチェック
すぐに IDistributedCache の抽象化をテストしてみましょう。
まとめ
IDistributedCache は外部の共有キャッシュを抽象化するため、すべてのアプリインスタンスが同じデータを参照できます。データは byte[] として保存され、文字列には GetStringAsync/SetStringAsync を使用し、さらに RemoveAsync と RefreshAsync も利用できます。インターフェースに依存すればコードをプロバイダーに依存しない形に保てるため、AddDistributedMemoryCache と Redis の間を1行の変更で切り替えられます。明確な名前空間付きキーを使用してください。
よくある質問
「IDistributedCache抽象化」レッスンは無料ですか？
はい。「IDistributedCache抽象化」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全4レッスンが含まれています。
「IDistributedCache抽象化」で何を学びますか？
複数のサーバー間でデータをキャッシュします。 ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
C# Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「IDistributedCache抽象化」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このC# Academyレッスンでコードを書いて実行できますか？
はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- IDistributedCache抽象化
- Redisへの接続
- キャッシュパターンと有効期限
- シリアライズされたオブジェクトのキャッシュ