Mise en cache des réponses du serveur

Weave fournit une mise en cache des réponses du serveur afin d’améliorer les performances lorsque vous effectuez des requêtes répétées ou que vous disposez d’une bande passante réseau limitée. Actuellement désactivée par défaut, cette fonctionnalité devrait devenir le comportement par défaut dans une prochaine version.

Quand utiliser la mise en cache

La mise en cache des réponses du serveur est particulièrement avantageuse dans les cas suivants :

Vous exécutez fréquemment les mêmes requêtes.
Vous disposez d’une bande passante réseau limitée.
Vous travaillez dans un environnement à latence élevée.
Vous développez hors ligne et souhaitez mettre en cache les réponses pour les réutiliser plus tard.

Cette fonctionnalité s’avère particulièrement utile lorsque vous exécutez des évaluations répétées sur un dataset, car elle permet de conserver le dataset en cache d’un run à l’autre.

Activer la mise en cache

Pour activer la mise en cache, définissez les variables d’environnement suivantes :

# Activer la mise en cache des réponses du serveur
export WEAVE_USE_SERVER_CACHE=true

# Définir la taille maximale du cache (1 Go par défaut)
export WEAVE_SERVER_CACHE_SIZE_LIMIT=1000000000

# Définir le répertoire du cache (facultatif, répertoire temporaire par défaut)
export WEAVE_SERVER_CACHE_DIR=/path/to/cache

Comportement de mise en cache

Techniquement, cette fonctionnalité met en cache les requêtes idempotentes adressées au serveur. Plus précisément, les requêtes suivantes sont mises en cache :

obj_read
table_query
table_query_stats
refs_read_batch
file_content_read

Taille du cache et détails sur le stockage

La taille du cache est définie par WEAVE_SERVER_CACHE_SIZE_LIMIT (en octets). L’espace disque réellement utilisé comprend trois composants :

Un fichier de somme de contrôle d’une taille fixe de 32 Ko
Un fichier de journal à écriture anticipée (WAL) pouvant atteindre environ 4 Mo par client en cours d’exécution (supprimé automatiquement à la fermeture du programme)
Le fichier de base de données principal, dont la taille est comprise entre 32 Ko et WEAVE_SERVER_CACHE_SIZE_LIMIT

Espace disque total utilisé :

Pendant l’exécution : >= 32 Ko + ~4 Mo + taille du cache
Après la fermeture : >= 32 Ko + taille du cache

Par exemple, avec une limite de cache de 5 Mo :

Pendant l’exécution : ~9 Mo maximum
Après la fermeture : ~5 Mo maximum

​Quand utiliser la mise en cache

​Activer la mise en cache

​Comportement de mise en cache

​Taille du cache et détails sur le stockage

Quand utiliser la mise en cache

Activer la mise en cache

Comportement de mise en cache

Taille du cache et détails sur le stockage