Skip to main content
Weave propose la mise en cache des réponses du serveur pour améliorer les performances lors de requêtes répétées ou lorsque la bande passante réseau est limitée. Cet article explique dans quels cas la mise en cache est utile, comment l’activer, quelles requêtes Weave met en cache et comment le cache utilise l’espace disque, afin que vous puissiez décider si vous souhaitez l’activer et prévoir son empreinte de stockage. La fonctionnalité est désactivée par défaut.

​
Quand utiliser la mise en cache

La mise en cache des réponses du serveur est utile dans les cas suivants :
  • Vous exécutez fréquemment les mêmes requêtes.
  • Votre bande passante réseau est limitée.
  • Vous travaillez dans un environnement à forte latence.
  • Vous développez hors ligne et souhaitez mettre en cache les réponses pour les réutiliser plus tard.
Cette fonctionnalité est utile lorsque vous exécutez des évaluations répétées sur un jeu de données, car Weave peut mettre ce jeu de données en cache entre deux exécutions.

​
Activer la mise en cache

Pour activer la mise en cache, définissez les variables d’environnement suivantes. WEAVE_USE_SERVER_CACHE active le cache, et les autres variables vous permettent d’en ajuster la taille et l’emplacement. 
# Activer la mise en cache des réponses du serveur
export WEAVE_USE_SERVER_CACHE=true

# Définir la limite de taille du cache (la valeur par défaut est 1 Go)
export WEAVE_SERVER_CACHE_SIZE_LIMIT=1000000000

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

​
Fonctionnement de la mise en cache

Cette section décrit quelles requêtes adressées au serveur Weave met en cache, afin que vous puissiez prévoir quelles opérations bénéficient de la mise en cache. Techniquement, cette fonctionnalité met en cache les requêtes idempotentes envoyées au serveur. Plus précisément, les éléments suivants sont mis en cache :
  • obj_read
  • table_query
  • table_query_stats
  • refs_read_batch
  • file_content_read

​
Taille du cache et détails de stockage

Utilisez cette section pour estimer l’espace disque requis par le cache, afin de dimensionner WEAVE_SERVER_CACHE_SIZE_LIMIT pour votre environnement. WEAVE_SERVER_CACHE_SIZE_LIMIT (en octets) définit la taille du cache. L’espace disque réellement utilisé se compose de trois éléments :
  • Un fichier de somme de contrôle constant de 32 Ko.
  • Un fichier de journal à écriture anticipée (WAL) pouvant atteindre ~4 Mo par client en cours d’exécution. Weave supprime automatiquement le fichier WAL lorsque le programme se termine.
  • Le fichier principal de la base de données, dont la taille est d’au moins 32 Ko et d’au plus WEAVE_SERVER_CACHE_SIZE_LIMIT.
Espace disque total utilisé :
  • Pendant l’exécution >= 32 Ko + ~4 Mo + taille du cache.
  • Après l’arrêt >= 32 Ko + taille du cache.
Par exemple, avec une limite de cache de 5 Mo :
  • Pendant l’exécution : ~9 Mo maximum.
  • Après l’arrêt : ~5 Mo maximum.
Performances