############################# LAZY FREEING ####################################

# Redis has two primitives to delete keys. One is called DEL and is a blocking
# deletion of the object. It means that the server stops processing new commands
# in order to reclaim all the memory associated with an object in a synchronous
# way. If the key deleted is associated with a small object, the time needed
# in order to execute the DEL command is very small and comparable to most other
# O(1) or O(log_N) commands in Redis. However if the key is associated with an
# aggregated value containing millions of elements, the server can block for
# a long time (even seconds) in order to complete the operation.
#
# For the above reasons Redis also offers non blocking deletion primitives
# such as UNLINK (non blocking DEL) and the ASYNC option of FLUSHALL and
# FLUSHDB commands, in order to reclaim memory in background. Those commands
# are executed in constant time. Another thread will incrementally free the
# object in the background as fast as possible.
#
# DEL, UNLINK and ASYNC option of FLUSHALL and FLUSHDB are user-controlled.
# It's up to the design of the application to understand when it is a good
# idea to use one or the other. However the Redis server sometimes has to
# delete keys or flush the whole database as a side effect of other operations.
# Specifically Redis deletes objects independently of a user call in the
# following scenarios:
#
# 1) On eviction, because of the maxmemory and maxmemory policy configurations,
#    in order to make room for new data, without going over the specified
#    memory limit.
# 2) Because of expire: when a key with an associated time to live (see the
#    EXPIRE command) must be deleted from memory.
# 3) Because of a side effect of a command that stores data on a key that may
#    already exist. For example the RENAME command may delete the old key
#    content when it is replaced with another one. Similarly SUNIONSTORE
#    or SORT with STORE option may delete existing keys. The SET command
#    itself removes any old content of the specified key in order to replace
#    it with the specified string.
# 4) During replication, when a replica performs a full resynchronization with
#    its master, the content of the whole database is removed in order to
#    load the RDB file just transferred.
#
# In all the above cases the default is to delete objects in a blocking way,
# like if DEL was called. However you can configure each case specifically
# in order to instead release memory in a non-blocking way like if UNLINK
# was called, using the following configuration directives.

lazyfree-lazy-eviction no
lazyfree-lazy-expire no
lazyfree-lazy-server-del no
replica-lazy-flush no

# It is also possible, for the case when to replace the user code DEL calls
# with UNLINK calls is not easy, to modify the default behavior of the DEL
# command to act exactly like UNLINK, using the following configuration
# directive:

lazyfree-lazy-user-del no

# FLUSHDB, FLUSHALL, SCRIPT FLUSH and FUNCTION FLUSH support both asynchronous and synchronous
# deletion, which can be controlled by passing the [SYNC|ASYNC] flags into the
# commands. When neither flag is passed, this directive will be used to determine
# if the data should be deleted asynchronously.

lazyfree-lazy-user-flush no

############################# LAZY FREEING ####################################

# Redis 有兩種刪除鍵的原語。一種叫 DEL，它是阻塞式刪除對象。
# 這意味着服務器會停止處理新的命令，以同步的方式回收與該對象相關的所有內存。
# 如果被刪除的鍵對應的是一個很小的對象，那麼執行 DEL 命令所需的時間非常短，
# 可以和 Redis 中大多數其他 O(1) 或 O(log_N) 命令相媲美。
# 然而，如果這個鍵對應的是一個包含數百萬元素的聚合值，
# 那麼為了完成這個操作，服務器可能會阻塞很長時間（甚至幾秒）。

#
# 基於以上原因，Redis 也提供了非阻塞的刪除原語，
# 例如 UNLINK（非阻塞版 DEL）以及 FLUSHALL 和 FLUSHDB 命令的 ASYNC 選項，
# 用來在後台回收內存。這些命令在常數時間內執行。
# 另一個線程會在後台儘可能快地逐步釋放這個對象。

#
# DEL、UNLINK 以及 FLUSHALL 和 FLUSHDB 的 ASYNC 選項都是由用户控制的。
# 由應用的設計者來決定在什麼情況下使用哪一種方式更合適。
# 然而，Redis 服務器有時必須在沒有用户顯式調用的情況下刪除鍵或清空整個數據庫，
# 作為其他操作的副作用。
# 具體來説，Redis 在以下場景下會獨立於用户調用而刪除對象：

#
# 1）淘汰（eviction）：由於 maxmemory 和 maxmemory policy 配置，
#    為了給新數據騰出空間並不超過指定的內存上限。

# 2）過期（expire）：當一個帶有存活時間（TTL，參見 EXPIRE 命令）的鍵需要
#    從內存中刪除時。

# 3）作為某些命令的副作用，當一個命令在某個可能已存在的鍵上存儲數據時。
#    比如，RENAME 命令在用另一個鍵替換原來的鍵時，可能會刪除舊鍵的內容。
#    同樣地，SUNIONSTORE 或帶有 STORE 選項的 SORT 可能會刪除已有的鍵。
#    SET 命令本身也會移除指定鍵的任何舊內容，以便用指定的字符串替換它。

# 4）在複製期間，當一個從節點對主節點執行全量重同步時，
#    為了加載剛剛傳輸過來的 RDB 文件，會刪除整個數據庫的內容。

#
# 在以上所有場景中，默認都是以阻塞的方式刪除對象，
# 就好像調用了 DEL 一樣。
# 然而，你可以通過如下配置項，為每一種情況單獨配置，
# 使其改為以非阻塞的方式釋放內存，就像調用 UNLINK 一樣。

lazyfree-lazy-eviction no
lazyfree-lazy-expire no
lazyfree-lazy-server-del no
replica-lazy-flush no

# 另外一種情況是，當你很難在用户代碼中把 DEL 調用全部替換為 UNLINK 調用時，
# 可以修改 DEL 命令的默認行為，讓它的行為與 UNLINK 完全一致，
# 使用下面這個配置項即可：

lazyfree-lazy-user-del no

# FLUSHDB、FLUSHALL、SCRIPT FLUSH 和 FUNCTION FLUSH 都同時支持異步和同步刪除，
# 可以通過給命令傳入 [SYNC|ASYNC] 標誌來控制。
# 當既沒有傳 SYNC，也沒有傳 ASYNC 時，會使用下面這個配置項來決定
# 是否以異步方式刪除數據。

lazyfree-lazy-user-flush no

# 是否在鍵被淘汰（eviction）時異步釋放內存（而不是阻塞式刪除），yes 為異步，no 為同步
lazyfree-lazy-eviction no

# 是否在鍵過期（expire）刪除時異步釋放內存（而不是阻塞式刪除），yes 為異步，no 為同步
lazyfree-lazy-expire no

# 是否對由服務器內部觸發的刪除（如 SET 覆蓋、RENAME 替換等）採用異步釋放內存，yes 為異步，no 為同步
lazyfree-lazy-server-del no

# 從節點在全量同步時清空數據（flush）是否使用異步方式，yes 為異步清空，no 為同步清空
replica-lazy-flush no

# 是否將用户執行的 DEL 命令改為與 UNLINK 一樣的異步釋放內存行為，yes 為將 DEL 視作 UNLINK，no 為保持傳統同步 DEL
lazyfree-lazy-user-del no

# 當 FLUSHDB / FLUSHALL / SCRIPT FLUSH / FUNCTION FLUSH 未顯式指定 [SYNC|ASYNC] 時，
# 是否默認使用異步方式刪除數據，yes 為默認異步，no 為默認同步
lazyfree-lazy-user-flush no

# 淘汰鍵時異步釋放（強烈推薦打開）
lazyfree-lazy-eviction yes

# 過期鍵刪除時異步釋放（推薦打開）
lazyfree-lazy-expire yes

# 服務器內部觸發的刪除（如覆蓋、重命名等）異步釋放（推薦打開）
lazyfree-lazy-server-del yes

# 從庫在全量同步時清空數據是否異步（推薦打開）
replica-lazy-flush yes

# 是否把用户的 DEL 當成 UNLINK（可按業務情況選擇）
# - 有大 key、刪鍵較頻繁：建議 yes
# - 沒啥大 key 或非常在意“刪除後立刻釋放內存量”的精確性：可以保持 no
lazyfree-lazy-user-del yes

# FLUSHDB / FLUSHALL / SCRIPT FLUSH / FUNCTION FLUSH 默認是否異步
# - 線上極少用同步 flush，推薦默認異步
lazyfree-lazy-user-flush yes