批量操作
功能的按模式删除键或设置过期时间,先以试运行清点数量,并可导入命令文件。
批量操作可以一次清理多个键,同时不放弃单键对话框的安全性。右键点击资源管理器中的 Redis 数据库或键文件夹(在数据库上,删除和 TTL 更改位于 批量编辑 下,而命令文件位于 导入 / 导出):
- 按模式删除键… (作用于数据库) 或 删除文件夹中的键… (文件夹)
- 按模式设置 TTL… 或者 在文件夹中设置 TTL… - 为每个匹配的键设置过期时间,或者勾选 改为移除过期 (PERSIST) 以清除它
- 导入命令文件… (数据库)- 运行一个 Redis 命令文件,每行一条命令
- 导出为命令文件… (作用于数据库) 或 将文件夹导出为命令文件… (文件夹) - 把匹配的键写入一个文件,“导入命令文件…”之后可以把它们导回来
单个键的菜单新增了 重命名… (RENAMENX,或 RENAME 当你允许覆盖时) 并且,在 复制到, 复制到数据库… (COPY key key DB n,Redis 6.2 及更高版本)以及 复制到连接… (DUMP 在此连接上, RESTORE 在你选中的那个上,含过期时间)。每个操作在运行前都会显示确切的命令;在只读和锁定的生产连接上会被禁用(复制到连接会检查 目标 连接也是如此),并且在原本查询标签页会要求确认的地方都要再点一次。勾选 替换 会覆盖目标中已存在的键;没有勾选时,复制操作会拒绝并显示提示。
先试运行
删除和 TTL 绝不会先写入。对话框从文件夹的前缀或数据库当前的键筛选器出发,且 统计匹配的键 以相同的有界方式遍历键空间 SCAN 键浏览器会使用的键(最多 25,000 个),所以这个计数并无影响。计数按页逐次进行,带有累计总数和一个 停止 按钮;停止或达到上限的计数会标注为 部分的,而且应用步骤只碰试运行列出的那些键,绝不碰其他。在应用任何东西之前,你就能看到有多少键匹配。批量删除会要求你输入匹配的键数,按钮才会启用,然后再分批运行 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 然后文件才能运行。
只读连接会禁用批量写入和导入;生产连接在写入被锁定期间同样禁用。资源管理器里的相关项目会显示为灰色,对话框会说明原因,同时仍允许计数或文件检查。请先通过状态栏的徽标解锁写入。确认时会再次检查锁定状态,因此在对话框打开期间才过期的解锁仍然有效。如果运行过程中关闭对话框,它会在当前批次完成后停止,部分完成的摘要会显示在状态栏中。