Redis 配置

Redis 配置

Redis 的配置檔案位於 Redis 安裝目錄下,檔名為 redis.conf(Windows 名為 redis.windows.conf)。

你可以通過 CONFIG 命令檢視或設定配置項。


語法

Redis CONFIG 命令格式如下:

redis 127.0.0.1:6379> CONFIG GET CONFIG_SETTING_NAME

例項

redis 127.0.0.1:6379> CONFIG GET loglevel

1) "loglevel"
2) "notice"

使用 * 號獲取所有配置項:

例項

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) ""

編輯配置

你可以通過修改 redis.conf 檔案或使用 CONFIG set 命令來修改配置。

語法

CONFIG SET 命令基本語法:

redis 127.0.0.1:6379> CONFIG SET CONFIG_SETTING_NAME NEW_CONFIG_VALUE

例項

redis 127.0.0.1:6379> CONFIG SET loglevel "notice"
OK
redis 127.0.0.1:6379> CONFIG GET loglevel

1) "loglevel"
2) "notice"

引數說明

redis.conf 配置項說明如下:

序號配置項說明
1
daemonize no
Redis 預設不是以守護程序的方式執行,可以通過該配置項修改,使用 yes 啟用守護程序(Windows 不支援守護執行緒的配置為 no )
2
pidfile /var/run/redis.pid
當 Redis 以守護程序方式執行時,Redis 預設會把 pid 寫入 /var/run/redis.pid 檔案,可以通過 pidfile 指定
3
port 6379
指定 Redis 監聽埠,預設埠為 6379,作者在自己的一篇博文中解釋了為什麼選用 6379 作為預設埠,因為 6379 在手機按鍵上 MERZ 對應的號碼,而 MERZ 取自義大利歌女 Alessia Merz 的名字
4
bind 127.0.0.1
繫結的主機地址
5
timeout 300
當客戶端閒置多長秒後關閉連線,如果指定為 0 ,表示關閉該功能
6
loglevel notice
指定日誌記錄級別,Redis 總共支援四個級別:debug、verbose、notice、warning,預設為 notice
7
logfile stdout
日誌記錄方式,預設為標準輸出,如果配置 Redis 為守護程序方式執行,而這裡又配置為日誌記錄方式為標準輸出,則日誌將會發送給 /dev/null
8
databases 16
設定資料庫的數量,預設資料庫為0,可以使用SELECT 命令在連線上指定資料庫id
9
save <seconds> <changes>

Redis 預設配置檔案中提供了三個條件:

save 900 1

save 300 10

save 60 10000

分別表示 900 秒(15 分鐘)內有 1 個更改,300 秒(5 分鐘)內有 10 個更改以及 60 秒內有 10000 個更改。

指定在多長時間內,有多少次更新操作,就將資料同步到資料檔案,可以多個條件配合
10
rdbcompression yes
指定儲存至本地資料庫時是否壓縮資料,預設為 yes,Redis 採用 LZF 壓縮,如果為了節省 CPU 時間,可以關閉該選項,但會導致資料庫檔案變的巨大
11
dbfilename dump.rdb
指定本地資料庫檔名,預設值為 dump.rdb
12
dir ./
指定本地資料庫存放目錄
13
slaveof <masterip> <masterport>
設定當本機為 slave 服務時,設定 master 服務的 IP 地址及埠,在 Redis 啟動時,它會自動從 master 進行資料同步
14
masterauth <master-password>
當 master 服務設定了密碼保護時,slav 服務連線 master 的密碼
15
requirepass foobared
設定 Redis 連線密碼,如果配置了連線密碼,客戶端在連線 Redis 時需要通過 AUTH <password> 命令提供密碼,預設關閉
16
 maxclients 128
設定同一時間最大客戶端連線數,預設無限制,Redis 可以同時開啟的客戶端連線數為 Redis 程序可以開啟的最大檔案描述符數,如果設定 maxclients 0,表示不作限制。當客戶端連線數到達限制時,Redis 會關閉新的連線並向客戶端返回 max number of clients reached 錯誤資訊
17
maxmemory <bytes>
指定 Redis 最大記憶體限制,Redis 在啟動時會把資料載入到記憶體中,達到最大記憶體後,Redis 會先嚐試清除已到期或即將到期的 Key,當此方法處理 後,仍然到達最大記憶體設定,將無法再進行寫入操作,但仍然可以進行讀取操作。Redis 新的 vm 機制,會把 Key 存放記憶體,Value 會存放在 swap 區
18
appendonly no
指定是否在每次更新操作後進行日誌記錄,Redis 在預設情況下是非同步的把資料寫入磁碟,如果不開啟,可能會在斷電時導致一段時間內的資料丟失。因為 redis 本身同步資料檔案是按上面 save 條件來同步的,所以有的資料會在一段時間內只存在於記憶體中。預設為 no
19
appendfilename appendonly.aof
指定更新日誌檔名,預設為 appendonly.aof
20
appendfsync everysec

指定更新日誌條件,共有 3 個可選值:

  • no:表示等作業系統進行資料快取同步到磁碟(快)
  • always:表示每次更新操作後手動呼叫 fsync() 將資料寫到磁碟(慢,安全)
  • everysec:表示每秒同步一次(折中,預設值)
21
vm-enabled no
指定是否啟用虛擬記憶體機制,預設值為 no,簡單的介紹一下,VM 機制將資料分頁存放,由 Redis 將訪問量較少的頁即冷資料 swap 到磁碟上,訪問多的頁面由磁碟自動換出到記憶體中(在後面的文章我會仔細分析 Redis 的 VM 機制)
22
vm-swap-file /tmp/redis.swap
虛擬記憶體檔案路徑,預設值為 /tmp/redis.swap,不可多個 Redis 例項共享
23
vm-max-memory 0
將所有大於 vm-max-memory 的資料存入虛擬記憶體,無論 vm-max-memory 設定多小,所有索引資料都是記憶體儲存的(Redis 的索引資料 就是 keys),也就是說,當 vm-max-memory 設定為 0 的時候,其實是所有 value 都存在於磁碟。預設值為 0
24
vm-page-size 32
Redis swap 檔案分成了很多的 page,一個物件可以儲存在多個 page 上面,但一個 page 上不能被多個物件共享,vm-page-size 是要根據儲存的 資料大小來設定的,作者建議如果儲存很多小物件,page 大小最好設定為 32 或者 64bytes;如果儲存很大大物件,則可以使用更大的 page,如果不確定,就使用預設值
25
vm-pages 134217728
設定 swap 檔案中的 page 數量,由於頁表(一種表示頁面空閒或使用的 bitmap)是在放在記憶體中的,,在磁碟上每 8 個 pages 將消耗 1byte 的記憶體。
26
vm-max-threads 4
設定訪問swap檔案的執行緒數,最好不要超過機器的核數,如果設定為0,那麼所有對swap檔案的操作都是序列的,可能會造成比較長時間的延遲。預設值為4
27
glueoutputbuf yes
設定在向客戶端應答時,是否把較小的包合併為一個包傳送,預設為開啟
28
hash-max-zipmap-entries 64
hash-max-zipmap-value 512
指定在超過一定的數量或者最大的元素超過某一臨界值時,採用一種特殊的雜湊演算法
29
activerehashing yes
指定是否啟用重置雜湊,預設為開啟(後面在介紹 Redis 的雜湊演算法時具體介紹)
30
include /path/to/local.conf
指定包含其它的配置檔案,可以在同一主機上多個Redis例項之間使用同一份配置檔案,而同時各個例項又擁有自己的特定配置檔案