Kurs NestJS · Moduł 8: Cache i wydajność
Caching - skrytki z zapasami w aplikacji
W tej lekcji7
Lista prowincji zmienia się raz na kwartał. Zapytanie o nią przychodzi tysiąc razy na minutę - i za każdym razem baza wykonuje tę samą pracę, żeby zwrócić ten sam wynik. Serwer jest obciążony nie dlatego, że robi dużo, tylko dlatego, że robi wciąż to samo.
Legion nie posyłał gońca do Rzymu po każdy bochenek chleba. Trzymał skrytkę z zapasami przy obozie: to, co potrzebne często, leżało pod ręką, a po resztę schodziło się do składu. Cache to taka skrytka - tymczasowe przechowywanie danych dla szybszego dostępu.
Zwróć uwagę na słowo „tymczasowe". Cache nie jest trwałym magazynem - od tego jest baza. Nie jest też narzędziem do kompresji ani do logowania. Dane w nim mają zniknąć, i to jest cecha, nie usterka.
Konfiguracja
CacheModule.register() konfiguruje cache wraz z jego parametrami - nie routing, nie autoryzację, nie logowanie:
@Module({
imports: [
CacheModule.register({
isGlobal: true,
ttl: 300000,
max: 1000,
}),
],
})
export class AppModule {}ttl (Time To Live) oznacza maksymalny czas życia wpisu, po którym jest on automatycznie usuwany - tutaj 300 000 ms, czyli pięć minut (aktualny @nestjs/cache-manager przyjmuje TTL w milisekundach). Nie jest to liczba dozwolonych odczytów ani czas odpowiedzi; to termin ważności.
max ogranicza liczbę wpisów. Gdy zostanie przekroczona, cache usuwa najdawniej używane - bo pamięć jest skończona, a cache bez limitu prędzej czy później ją wyczerpie.
Ręczny odczyt i zapis
Cache wstrzykujemy po tokenie. Kolejność zapisu: @Inject(CACHE_MANAGER), private cache:, Cache:
@Injectable()
export class ProvinceService {
constructor(
@Inject(CACHE_MANAGER) private cache: Cache,
private repo: ProvinceRepository,
) {}
async findAll() {
const cached = await this.cache.get<Province[]>('provinces:all');
if (cached) {
return cached;
}
const provinces = await this.repo.findAll();
await this.cache.set('provinces:all', provinces, 600000);
return provinces;
}
}Ten schemat nazywa się cache-aside (albo lazy loading) i oznacza, że kod ręcznie pobiera dane z cache i ręcznie je tam zapisuje. Cztery kroki, zawsze w tej kolejności:
- Sprawdź cache (
get). - Jeśli jest wpis - zwróć go klientowi.
- Jeśli brak (miss) - pobierz z bazy.
- Zapisz wynik do cache (
set) i zwróć.
Nazwa „lazy" bierze się z kroku trzeciego: cache zapełnia się leniwie, dopiero gdy ktoś o dane poprosi. Pierwsze żądanie zawsze idzie do bazy.
Automatycznie, przez dekoratory
Dla zwykłych odczytów nie musisz pisać tych czterech kroków:
@Controller('provinces')
export class ProvinceController {
@Get()
@UseInterceptors(CacheInterceptor)
@CacheKey('provinces:all')
@CacheTTL(600000)
findAll() {
return this.provinceService.findAll();
}
}@UseInterceptors(CacheInterceptor) automatycznie cache'uje odpowiedzi endpointu - nie kompresuje ich, nie loguje i nie waliduje.
@CacheTTL(600000) to dekorator odpowiadający za czas życia danych z tej metody - 600 000 milisekund, czyli dziesięć minut, niezależnie od wartości domyślnej. Nie mylić z @CacheKey, który nadaje nazwę wpisu, ani z @UseInterceptors, który dopiero włącza cache'owanie.
Domyślnie klucz powstaje z adresu URL. @CacheKey przydaje się, gdy chcesz go ustalić sam - na przykład po to, żeby móc ten sam wpis później usunąć z serwisu.
Zapis - dwie strategie
Powyższe podejścia zapełniają cache przy odczycie. Można też przy zapisie, i tu istnieją dwa warianty różniące się jednym słowem:
- Write-through zapisuje do cache i do bazy synchronicznie - aplikacja czeka na oba. Cache nigdy nie jest nieaktualny, ale zapis trwa dłużej.
- Write-behind zapisuje do cache od razu, a do bazy asynchronicznie, później. Zapis jest błyskawiczny, ale przy awarii między jednym a drugim dane mogą przepaść.
Różnica sprowadza się więc do tego, czy aplikacja czeka na bazę. Write-through wybieraj tam, gdzie utrata zapisu jest niedopuszczalna; write-behind tam, gdzie liczy się przepustowość, a pojedynczy zgubiony wpis nie jest katastrofą - jak przy licznikach odsłon.
Unieważnianie - trzy strategie
Dane w cache starzeją się. Sposoby radzenia sobie z tym układają się od najprostszego do najbardziej złożonego:
- Expiration (TTL) - wpis znika sam po czasie. Nic nie piszesz, ale przez chwilę pokazujesz dane nieaktualne.
- Manual - usuwasz konkretny klucz, gdy dane się zmienią. Dokładne, ale musisz pamiętać o każdym miejscu zapisu.
- Pattern-based - usuwasz grupy kluczy pasujących do wzorca, na przykład wszystko zaczynające się od
provinces:. Najpotężniejsze i najłatwiej nim usunąć za dużo.
Sam proces unieważnienia po aktualizacji ma trzy kroki: zaktualizuj dane w bazie, zidentyfikuj i usuń odpowiednie klucze, a następne żądanie pobierze świeże dane i zapisze je na nowo.
Rozgrzewanie cache
Przy cache-aside pierwszy użytkownik po każdym restarcie płaci pełną cenę odczytu z bazy. Można temu zapobiec, zapełniając skrytkę zanim ktokolwiek poprosi:
@Injectable()
export class CacheWarmupService implements OnModuleInit {
constructor(
@Inject(CACHE_MANAGER) private cache: Cache,
private repo: ProvinceRepository,
) {}
async onModuleInit() {
const provinces = await this.repo.findAll();
await this.cache.set('provinces:all', provinces, 3600000);
}
}onModuleInit to metoda wywoływana przez NestJS przy starcie aplikacji, po zbudowaniu modułu. Proces jest trzyetapowy: zidentyfikuj dane krytyczne, pobierz je i zapisz przy starcie, dostosuj listę na podstawie tego, co naprawdę jest odpytywane najczęściej.
Rozgrzewaj tylko to, co jest jednocześnie często potrzebne i rzadko zmieniane. Rozgrzewanie wszystkiego wydłuża start aplikacji i zapełnia pamięć danymi, po które nikt nie sięgnie.
Podsumowanie
Skrytka przy obozie działa, po resztę schodzi się do składu:
- cache to tymczasowe przechowywanie danych dla szybszego dostępu - nie trwały magazyn, nie kompresja, nie logowanie,
CacheModule.register()konfiguruje cache z parametrami;maxogranicza liczbę wpisów,- TTL to maksymalny czas życia wpisu, po którym jest on automatycznie usuwany,
- wstrzyknięcie w kolejności:
@Inject(CACHE_MANAGER),private cache:,Cache, - cache-aside oznacza ręczne pobieranie i ręczny zapis; cztery kroki: sprawdź cache → zwróć przy trafieniu → pobierz z bazy przy pudle → zapisz i zwróć,
@UseInterceptors(CacheInterceptor)automatycznie cache'uje odpowiedzi endpointu,@CacheTTL(600000)ustawia czas życia;@CacheKeynadaje nazwę wpisu,@UseInterceptorswłącza mechanizm,- write-through zapisuje do bazy synchronicznie, write-behind - asynchronicznie, ryzykując utratę przy awarii,
- strategie unieważniania od najprostszej: expiration (TTL) → manual (jeden klucz) → pattern-based (grupy kluczy),
- proces po aktualizacji: zaktualizuj bazę → zidentyfikuj i usuń klucze → następne żądanie pobierze świeże dane,
- cache warming przez
onModuleInit: zidentyfikuj dane krytyczne → pobierz i zapisz przy starcie → dostosuj listę.
W następnej lekcji przeniesiemy skrytkę poza proces - do Redisa, dzięki czemu zobaczą ją wszystkie instancje aplikacji. A na razie zapamiętaj: cache nie przyspiesza pracy, tylko pozwala jej nie wykonywać - a cała trudność polega na tym, by wiedzieć, kiedy zapas się zestarzał.
Kod do tej lekcji: src/caching-intro.ts
// Caching - Skrytki z Zapasami w Imperium Rzymskim
import { Injectable, Inject, Module } from '@nestjs/common';
import { CACHE_MANAGER } from '@nestjs/cache-manager';
import { CacheModule } from '@nestjs/cache-manager';
import { Cache } from 'cache-manager';
// 1. Konfiguracja CacheModule w NestJS
@Module({
imports: [
CacheModule.register({
ttl: 300, // Time To Live: 300 sekund (5 minut)
max: 100, // Maksymalnie 100 elementow w cache
isGlobal: true // Dostepny globalnie w calej aplikacji
}),
],
})
export class AppModule {}
// 2. Serwis z cache'owaniem
@Injectable()
export class TributeCacheService {
constructor(
@Inject(CACHE_MANAGER) private cacheManager: Cache
) {}
// GET - Pobierz z cache lub z bazy danych
async getTribute(id: number) {
const cacheKey = `tribute:${id}`;
// Sprawdz cache
let tribute = await this.cacheManager.get(cacheKey);
if (tribute) {
console.log('CACHE HIT - dane ze skrytki!');
return tribute;
}
// CACHE MISS - pobierz z bazy
console.log('CACHE MISS - ide do archiwum...');
tribute = await this.fetchFromDatabase(id);
// Zapisz do cache na 5 minut
if (tribute) {
await this.cacheManager.set(cacheKey, tribute, 300000);
}
return tribute;
}
// SET - Zapisz do cache
async cacheTribute(id: number, data: any, ttl = 300000) {
const key = `tribute:${id}`;
await this.cacheManager.set(key, data, ttl);
console.log(`Tribut ${id} zapisany w skrytce na ${ttl/1000}s`);
}
// DELETE - Usun z cache (invalidacja)
async invalidate(id: number) {
await this.cacheManager.del(`tribute:${id}`);
console.log(`Tribut ${id} usuniety ze skrytki`);
}
// CLEAR - Wyczysc caly cache
async clearAll() {
await this.cacheManager.reset();
console.log('Wszystkie skrytki wyczyszczone!');
}
private async fetchFromDatabase(id: number) {
// Symulacja zapytania do bazy
const tributes: Record<number, any> = {
1: { id: 1, province: 'Gallia', amount: 1000, type: 'gold' },
2: { id: 2, province: 'Aegyptus', amount: 2000, type: 'silver' },
};
return tributes[id] || null;
}
}
// Wzorce cache'owania:
// - Cache-Aside (Lazy): Sprawdz cache -> jesli brak -> pobierz -> zapisz
// - Write-Through: Zapisz do DB i cache jednoczesnie
// - Write-Behind: Zapisz do cache, pozniej synchronizuj z DB
// - Cache Warming: Wypelnij cache z gory popularnymi danymi
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Cache w aplikacji NestJS to:
2. CacheModule.register() w NestJS konfiguruje:
To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Zbuduj serwis cache z metodami get i set dla tributów
- Klikanie w kolejności
Ułóż wstrzyknięcie CACHE_MANAGER do serwisu:
- Układanie w pionie
Uporządkuj kroki wzorca Cache-Aside (Lazy Loading):
- Edytor kodu
Zastosuj CacheInterceptor i CacheTTL na endpoincie GET /provinces
- Klikanie w kolejności
Ułóż proces inwalidacji cache po aktualizacji danych:
- Edytor kodu
Napisz metodę update która czyści odpowiedni klucz cache po zmianie danych
- Układanie w pionie
Uporządkuj strategie invalidation od najprostszej do najzłożonej:
- Klikanie w kolejności
Ułóż proces cache warming (pre-loading cache przy starcie):
Zadania po tej lekcji
- PytanieCzym jest cache w aplikacji
- PytanieCacheModule w NestJS
- Zadanie z kodemPraktyka: Podstawowy cache service
- PytanieParametr TTL w cache
- Kliknij w kolejnościWstrzykiwanie CACHE_MANAGER
- Ułóż w kolejnościCache-Aside pattern
- PytanieCacheInterceptor w NestJS
- PytanieDekorator @CacheTTL
- Zadanie z kodemPraktyka: CacheInterceptor na kontrolerze
- PytanieDekoratory cache na kontrolerze
- Kliknij w kolejnościInwalidacja cache
- PytanieCache-Aside pattern
- PytanieWrite-through vs Write-behind
- Zadanie z kodemPraktyka: Cache invalidation
- Ułóż w kolejnościProces cache invalidation
- Kliknij w kolejnościCache Warmer service