Aller au contenu

Architecture

Cache et écritures différées

Caches de lecture, lots et limites de persistance.

Sur cette page

Portée et lecture

pkg/cache fournit des caches locaux bornés et regroupe les chargements concurrents. Les dépôts des services de données les utilisent pour réduire les lectures; les messages d’invalidation permettent aux autres instances d’écarter leurs anciennes entrées. Les TTL et le comportement en cas d’erreur dépendent de l’appelant : consultez le dépôt concerné.

Écriture et durabilité

pkg/batch regroupe les écritures en attente par clé et appelle une fonction de flush fournie par le service. Les commandes, modules et certaines préférences utilisent cette écriture différée. Les valeurs attendent en mémoire : une mise à jour acceptée peut être perdue si le processus s’arrête avant un flush réussi. Un échec est réessayé; la réponse initiale ne devient pas pour autant un commit durable. N’utilisez pas ce mécanisme pour l’argent ou les jetons.

sequenceDiagram
    participant C as Appelant
    participant R as Dépôt
    participant B as Lot en mémoire
    participant D as Base de données
    participant N as NATS
    C->>R: Modifier un paramètre
    R->>B: Placer la dernière valeur par clé
    R-->>C: Accepté
    B->>D: Flush
    alt Commit réussi
        D-->>B: Commit effectué
        B->>N: Publier le changement
    else Échec du flush
        D-->>B: Erreur
        Note over B: Réessayer le travail en attente
    end

Pour les détails d’implémentation et d’échec, consultez pkg/batch/batcher.go, pkg/cache et app/db/<service>/repository/. La projection est un autre modèle de lecture dérivé, décrit séparément.

Écritures simultanées

Supposons que les mises à jour A et B utilisent la même clé de lot. Add remplace la valeur en attente : un flush qui n’a pas encore pris la table voit B. Si A est déjà en cours de flush lorsque B arrive, B entre dans la nouvelle table. Si A échoue, le batcher ne restaure A que si aucune valeur plus récente n’attend pour cette clé; B n’est pas écrasée. Voir Add et flushPending et leurs tests.

Une fermeture normale tente de vider les données en attente dans le contexte fourni. Un crash ne peut pas le faire. La fonction de flush décide de sa transaction et de la publication d’événements; vérifiez le dépôt concerné avant de supposer des effets identiques pour tous les lots.

Échecs de lecture et invalidation

Le client de projection configure des caches locaux avec données périmées en cas d’erreur et écoute les invalidations. Utilisateurs, modules et commandes ont des caches distincts. À froid, il peut demander un instantané au propriétaire; le chemin modules utilise aussi un court délai de repli pendant une panne. Les tests RPC couvrent les nouvelles tentatives et l’effacement de ce délai à l’invalidation. Ces politiques sont propres à ce client.

Pour modifier une écriture mise en cache, testez la valeur locale, l’invalidation sur une autre instance, l’échec d’un rechargement et l’arrivée d’une nouvelle écriture pendant un flush échoué. Pour les données durables, choisissez un chemin direct et testez une nouvelle tentative après un délai au résultat ambigu.