Configuration de Redis
Le fichier de configuration Redis se trouve dans le répertoire d'installation de Redis, avec le nom de fichierredis.conf(sous Windows, nommé redis.windows.conf).
Vous pouvez utiliser la commandeCONFIGpour afficher ou définir des éléments de configuration.
Syntaxe
Le format de la commande CONFIG de Redis est le suivant :
redis 127.0.0.1:6379> CONFIG GET CONFIG_SETTING_NAME
Exemple
redis 127.0.0.1:6379> CONFIG GET loglevel 1) "loglevel" 2) "notice"
Utilisez*pour obtenir tous les éléments de configuration :
Exemple
redis 127.0.0.1:6379> CONFIG GET * 1) "dbfilename" 2) "dump.rdb" 3) "requirepass" 4) "" 5) "masterauth" 6) "" 7) "unixsocket" 8) "" 9) "logfile" 10) "" 11) "pidfile" 12) "/var/run/redis.pid" 13) "maxmemory" 14) "0" 15) "maxmemory-samples" 16) "3" 17) "timeout" 18) "0" 19) "tcp-keepalive" 20) "0" 21) "auto-aof-rewrite-percentage" 22) "100" 23) "auto-aof-rewrite-min-size" 24) "67108864" 25) "hash-max-ziplist-entries" 26) "512" 27) "hash-max-ziplist-value" 28) "64" 29) "list-max-ziplist-entries" 30) "512" 31) "list-max-ziplist-value" 32) "64" 33) "set-max-intset-entries" 34) "512" 35) "zset-max-ziplist-entries" 36) "128" 37) "zset-max-ziplist-value" 38) "64" 39) "hll-sparse-max-bytes" 40) "3000" 41) "lua-time-limit" 42) "5000" 43) "slowlog-log-slower-than" 44) "10000" 45) "latency-monitor-threshold" 46) "0" 47) "slowlog-max-len" 48) "128" 49) "port" 50) "6379" 51) "tcp-backlog" 52) "511" 53) "databases" 54) "16" 55) "repl-ping-slave-period" 56) "10" 57) "repl-timeout" 58) "60" 59) "repl-backlog-size" 60) "1048576" 61) "repl-backlog-ttl" 62) "3600" 63) "maxclients" 64) "4064" 65) "watchdog-period" 66) "0" 67) "slave-priority" 68) "100" 69) "min-slaves-to-write" 70) "0" 71) "min-slaves-max-lag" 72) "10" 73) "hz" 74) "10" 75) "no-appendfsync-on-rewrite" 76) "no" 77) "slave-serve-stale-data" 78) "yes" 79) "slave-read-only" 80) "yes" 81) "stop-writes-on-bgsave-error" 82) "yes" 83) "daemonize" 84) "no" 85) "rdbcompression" 86) "yes" 87) "rdbchecksum" 88) "yes" 89) "activerehashing" 90) "yes" 91) "repl-disable-tcp-nodelay" 92) "no" 93) "aof-rewrite-incremental-fsync" 94) "yes" 95) "appendonly" 96) "no" 97) "dir" 98) "/home/deepak/Downloads/redis-2.8.13/src" 99) "maxmemory-policy" 100) "volatile-lru" 101) "appendfsync" 102) "everysec" 103) "save" 104) "3600 1 300 100 60 10000" 105) "loglevel" 106) "notice" 107) "client-output-buffer-limit" 108) "normal 0 0 0 slave 268435456 67108864 60 pubsub 33554432 8388608 60" 109) "unixsocketperm" 110) "0" 111) "slaveof" 112) "" 113) "notify-keyspace-events" 114) "" 115) "bind" 116) ""
Modifier la configuration
Vous pouvez modifier la configuration en éditant le fichier redis.conf ou en utilisant la commandeCONFIG setpour modifier la configuration.
Syntaxe
CONFIG SETLa syntaxe de base de la commande :
redis 127.0.0.1:6379> CONFIG SET CONFIG_SETTING_NAME NEW_CONFIG_VALUE
Exemple
redis 127.0.0.1:6379> CONFIG SET loglevel "notice" OK redis 127.0.0.1:6379> CONFIG GET loglevel 1) "loglevel" 2) "notice"
Description des paramètres
Les éléments de configuration de redis.conf sont décrits comme suit :
| Numéro | Élément de configuration | Description |
|---|---|---|
| 1 | daemonize no |
Redis ne s'exécute pas en tant que processus démon par défaut. Vous pouvez modifier cet élément de configuration et utiliser yes pour activer le processus démon (Windows ne prend pas en charge les threads démon ; la configuration est no). |
| 2 | pidfile /var/run/redis.pid |
Lorsque Redis s'exécute en tant que processus démon, Redis écrira le pid dans le fichier /var/run/redis.pid par défaut. Vous pouvez le spécifier via pidfile. |
| 3 |
port 6379 |
Spécifiez le port d'écoute de Redis. Le port par défaut est 6379. L'auteur a expliqué dans l'un de ses articles de blog pourquoi 6379 a été choisi comme port par défaut, car 6379 correspond à MERZ sur un clavier de téléphone, et MERZ est tiré du nom de la chanteuse italienne Alessia Merz. |
| 4 | bind 127.0.0.1 |
Adresse d'hôte de liaison |
| 5 | timeout 300 |
Fermez la connexion après combien de secondes le client est inactif. Si la valeur est 0, cette fonctionnalité est désactivée. |
| 6 | loglevel notice |
Spécifiez le niveau de journalisation. Redis prend en charge un total de quatre niveaux : debug, verbose, notice, warning. La valeur par défaut est notice. |
| 7 | logfile stdout |
La méthode de journalisation est par défaut la sortie standard. Si Redis est configuré pour s'exécuter en tant que processus démon et que la méthode de journalisation ici est également configurée comme sortie standard, les journaux seront envoyés vers /dev/null. |
| 8 | databases 16 |
Définissez le nombre de bases de données. La base de données par défaut est 0. Vous pouvez utiliser SELECT |
| 9 |
save <seconds> <changes> Le fichier de configuration par défaut de Redis fournit trois conditions : save 900 1 save 300 10 save 60 10000 Elles signifient respectivement 1 changement dans les 900 secondes (15 minutes), 10 changements dans les 300 secondes (5 minutes), et 10000 changements dans les 60 secondes. |
Spécifiez combien d'opérations de mise à jour dans une certaine période déclencheront la synchronisation des données vers le fichier de données. Plusieurs conditions peuvent être combinées. |
| 10 | rdbcompression yes |
Spécifiez s'il faut compresser les données lors du stockage dans la base de données locale. La valeur par défaut est oui. Redis utilise la compression LZF. Pour économiser du temps CPU, vous pouvez désactiver cette option, mais cela entraînera une taille énorme du fichier de base de données. |
| 11 | dbfilename dump.rdb |
Spécifiez le nom du fichier de base de données local. La valeur par défaut est dump.rdb. |
| 12 | dir ./ |
Spécifiez le répertoire où la base de données locale est stockée. |
| 13 | slaveof <masterip> <masterport> |
Lorsque cette machine est un service esclave, définissez l'adresse IP et le port du service maître. Au démarrage de Redis, il synchronisera automatiquement les données depuis le maître. |
| 14 | masterauth <master-password> |
Lorsque le service maître a la protection par mot de passe activée, il s'agit du mot de passe permettant au service esclave de se connecter au maître. |
| 15 | requirepass foobared |
Définissez le mot de passe de connexion Redis. Si un mot de passe de connexion est configuré, le client doit fournir le mot de passe via la commande AUTH <password> lors de la connexion à Redis. Il est désactivé par défaut. |
| 16 | maxclients 128 |
Définissez le nombre maximal de connexions client simultanées. Il n'y a aucune limite par défaut. Le nombre de connexions client que Redis peut ouvrir simultanément correspond au nombre maximal de descripteurs de fichiers que le processus Redis peut ouvrir. Si maxclients est défini sur 0, cela signifie aucune limite. Lorsque le nombre de connexions client atteint la limite, Redis fermera les nouvelles connexions et renverra au client le message d'erreur "max number of clients reached". |
| 17 | maxmemory <bytes> |
Spécifiez la limite de mémoire maximale pour Redis. Redis charge les données en mémoire au démarrage. Après avoir atteint la mémoire maximale, Redis essaiera d'abord d'effacer les clés expirées ou sur le point d'expirer. Une fois cette méthode traitée, si le paramètre de mémoire maximale est toujours atteint, les opérations d'écriture ne peuvent plus être effectuées, mais les opérations de lecture restent possibles. Le nouveau mécanisme vm de Redis stocke les clés en mémoire et les valeurs dans la zone d'échange. |
| 18 | appendonly no |
Spécifiez s'il faut effectuer une journalisation après chaque opération de mise à jour. Par défaut, Redis écrit les données sur le disque de manière asynchrone. Si ce n'est pas activé, une panne de courant peut entraîner une perte de données pendant un certain temps. Étant donné que Redis lui-même synchronise les fichiers de données selon les conditions de sauvegarde ci-dessus, certaines données peuvent n'exister qu'en mémoire pendant un certain temps. La valeur par défaut est no. |
| 19 | appendfilename appendonly.aof |
Spécifiez le nom du fichier journal de mise à jour. La valeur par défaut est appendonly.aof. |
| 20 | appendfsync everysec |
Spécifiez la condition du journal de mise à jour. Il y a 3 valeurs optionnelles:
|
| 21 | vm-enabled no |
Spécifiez s'il faut activer le mécanisme de mémoire virtuelle. La valeur par défaut est no. En bref, le mécanisme VM stocke les données en pages. Redis échange les pages moins accédées, c'est-à-dire les données froides, vers le disque. Les pages plus accédées sont automatiquement échangées du disque vers la mémoire (j'analyserai en détail le mécanisme VM de Redis dans un prochain article). |
| 22 | vm-swap-file /tmp/redis.swap |
Chemin du fichier de mémoire virtuelle. La valeur par défaut est /tmp/redis.swap. Il ne peut pas être partagé par plusieurs instances Redis. |
| 23 | vm-max-memory 0 |
Stocke toutes les données supérieures à vm-max-memory en mémoire virtuelle. Peu importe la petite taille de vm-max-memory, toutes les données d'index sont stockées en mémoire (les données d'index de Redis sont les clés). C'est-à-dire que lorsque vm-max-memory est défini à 0, en fait toutes les valeurs existent sur le disque. La valeur par défaut est 0. |
| 24 | vm-page-size 32 |
Le fichier d'échange Redis est divisé en plusieurs pages. Un objet peut être stocké sur plusieurs pages, mais une page ne peut pas être partagée par plusieurs objets. vm-page-size doit être défini en fonction de la taille des données stockées. L'auteur suggère que si vous stockez beaucoup de petits objets, la taille de page est mieux définie à 32 ou 64 bytes ; si vous stockez de très gros objets, vous pouvez utiliser une page plus grande ; si vous n'êtes pas sûr, utilisez la valeur par défaut. |
| 25 | vm-pages 134217728 |
Définit le nombre de pages dans le fichier d'échange. Étant donné que la table des pages (un bitmap indiquant si les pages sont libres ou utilisées) est stockée en mémoire, chaque 8 pages sur le disque consommera 1 octet de mémoire. |
| 26 | vm-max-threads 4 |
Définit le nombre de threads accédant au fichier d'échange. Il est préférable de ne pas dépasser le nombre de cœurs de la machine. Si défini à 0, toutes les opérations sur le fichier d'échange sont sérialisées, ce qui peut entraîner un délai relativement long. La valeur par défaut est 4. |
| 27 | glueoutputbuf yes |
Définit s'il faut fusionner les paquets plus petits en un seul paquet lors de la réponse aux clients. Il est activé par défaut. |
| 28 |
hash-max-zipmap-entries 64 hash-max-zipmap-value 512 |
Définit que lorsqu'une certaine quantité est dépassée ou que l'élément maximal dépasse un certain seuil, un algorithme de hachage spécial est utilisé. |
| 29 | activerehashing yes |
Définit s'il faut activer le rehachage. Il est activé par défaut (les détails seront présentés plus tard lors de l'introduction de l'algorithme de hachage de Redis). |
| 30 |
include /path/to/local.conf |
Définit d'inclure d'autres fichiers de configuration. Vous pouvez utiliser le même fichier de configuration parmi plusieurs instances Redis sur le même hôte, tandis que chaque instance possède également son propre fichier de configuration spécifique. |