大量操作
功能性的先以試執行清點數量,再依模式刪除鍵或讓鍵到期,並可匯入命令檔案。
大量操作可以一次清理多個鍵,同時保有單一鍵對話方塊的安全性。在物件總管中對 Redis 資料庫或鍵資料夾按右鍵(在資料庫上,刪除與 TTL 變更位於 大量編輯 ,指令檔則在 匯入 / 匯出):
- 依模式刪除鍵… (資料庫)或 刪除資料夾中的鍵… (資料夾)
- 依模式設定 TTL… 或 設定資料夾的 TTL… - 為每個相符的鍵設定到期時間,或勾選 改為移除到期時間(PERSIST) 以清除它
- 匯入命令檔案… (資料庫)- 執行存放 Redis 指令的檔案,每行一條
- 匯出為命令檔… (資料庫)或 將資料夾匯出為命令檔… (資料夾)- 把符合的鍵寫入一個檔案,再交由匯入指令檔…讀回執行
單一鍵的選單會新增 重新命名… (RENAMENX,或 RENAME 當你允許覆寫時),並且在 複製到, 複製到資料庫… (COPY key key DB n,Redis 6.2 及以上版本)以及 複製到連線… (DUMP 在此連線上, RESTORE 套用在你選擇的連線上,包括效期)。每個動作都會在執行前顯示確切的命令,在唯讀與鎖定的正式環境連線上則停用(複製到連線也會檢查 目標 連線),凡是原本由查詢分頁確認的地方,都會多要求一次點擊。勾選 取代 會覆蓋目標已存在的鍵;若未勾選,複製會拒絕並提示。
先試跑
刪除與 TTL 一律不會先寫入。對話方塊會從資料夾的前綴或資料庫目前的鍵篩選器開始,並 計算符合的金鑰 走訪鍵空間,同樣使用有界的 SCAN 鍵值瀏覽器所使用的(最多 25,000 個鍵),因此計數不會有影響。計數一次處理一頁,同時顯示累計總數和一個 停止 按鈕;停止或達上限的計數標記為 部分,而且套用步驟只會動到 dry run 列出的鍵值,其餘一律不碰。在真正套用之前,你就會看到有多少鍵值符合。批次刪除要你輸入符合的鍵值數量,按鈕才會啟用,然後分批執行 UNLINK 命令,並顯示進度計數和一個 停止 按鈕;批次從 500 個鍵開始,並在任何一個批次花費超過一秒時縮小(最少 50 個),所以停止操作時從不會長時間等待正在處理的批次。TTL 變更會針對每個鍵執行一次 EXPIRE 或 PERSIST 每個鍵一條,分批節奏相同;秒數欄位與 改為移除到期時間(PERSIST) 框在計數之後仍可編輯。二進位鍵名全程保持位元組完全一致。


對你選擇的鍵執行操作
當你要的鍵用挑的比用模式描述更容易時,把它們列在查詢分頁裡,然後使用 SQLLY.KEYS <pattern> <limit>,對網格進行排序或篩選(依 ttl_seconds,例如),選取資料列,按右鍵,然後選擇 工具 › Redis 鍵 › 刪除選取的鍵…, 為選取的鍵設定 TTL… 或 移除所選鍵的到期時間…不必等任何試跑:選取的內容就是清單,因此對話方塊會直接開在確認畫面並列出這些鍵。刪除時仍會要求你輸入鍵的數量,叢集上的鍵則會分批刪除,每批都不跨出同一個雜湊槽。此操作會使用該表格所屬分頁的連線與資料庫。請參見 鍵值瀏覽器 了解哪些結果會提供這個選單。
匯入命令檔案
選擇一個 UTF-8 文字檔,每行一個指令(SET, HSET, EXPIRE…;空白行與 # 註解會被略過)。二進位值請寫成帶引號的 "\xHH" 跳脫字元。SQLly 會在任何東西執行之前讀取並解析整個檔案,如果檔案不是可執行的腳本就會拒絕,並指出行號:引號不對稱、JSON 行格式錯誤,或位元組不是有效的 UTF-8。執行時每一行最多嘗試一次,並持續累計已處理的指令數。某一行失敗不會中斷匯入:每個失敗都會列出行號、指令和伺服器的錯誤,摘要會統計成功與失敗的數量。一個 SELECT 若位於檔案中,會對其後的各行持續生效。
檔案會分成每批約 200 行來執行,每一批都使用自己的連線,因此一個 MULTI … EXEC 區塊絕不會拆到兩個批次裡。交易內有一行失敗,整個交易就會被捨棄:該區塊其餘部分會跳過而不在交易外執行,摘要會計入被跳過的資料列。
將資料夾匯出為命令檔
匯出會把與資料夾字首(或資料庫的鍵值篩選器)相符的每個鍵,寫成重建它們的命令: SET 對於字串, HSET, RPUSH, SADD 和 ZADD 以每行最多 500 個成員的形式,一個 XADD 對應每個串流項目,並保留其原始 ID, JSON.SET 對於 JSON 文件,然後 PEXPIRE ,用於設有存活時間的鍵(自匯入時起算)。二進位鍵名與值會寫成 "\xHH" 跳脫字元,所以在空資料庫匯入該檔案會得到完全相同的位元組,鍵的數量也一樣。它只做讀取:伺服器上不會有任何改變,所以在唯讀連線上也能用。
匯出會在你選擇的鍵數上限(預設 10,000)以及 8 MB(匯入的檔案大小上限)處停止,因此每次匯出都能再匯入。中斷的匯出會以 # partial 行,而匯入無法重建的型別(其他模組型別)會列為 # skipped 註解寫出,而不是默默略過。串流的消費者群組不會匯出,只匯出項目本身。在既有鍵上匯入時,會附加到清單與串流。請匯入空的資料庫,或先刪除資料夾。
安全性審查
匯入執行前,每一行都會對照查詢編輯器所用的同一份 Redis 命令清單檢查。對話方塊會顯示有多少行會寫入資料,並按行號列出找到的每個破壞性或伺服器管理命令,例如 FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN, DEBUG, SCRIPT, MODULE 和 ACL。當存在任何這類命令,或者當連線的安全設定會讓編輯器要求確認時,你必須輸入 RUN ALL ,才能讓檔案執行。
唯讀連線,以及寫入被鎖定的生產環境連線,都會停用大量寫入與匯入。物件總管中的項目會變灰,對話方塊會說明原因,但仍允許進行數量或檔案檢查。請先從狀態列的鎖定圖示解鎖寫入。確認時會再檢查一次鎖定狀態,所以就算解鎖在對話方塊開啟期間到期,也會如實生效。如果執行期間關閉對話方塊,它會在目前這批完成後停止,並把部分完成的摘要顯示在狀態列。