MagicDB Studio 标志 MagicDB Studio 内测版
文档/ NoSQL/ Redis 键与命令操作
NoSQL

Redis 键与命令操作

从连接与渐进式键扫描，到类型、TTL、值核验和受控命令执行。

适用场景

本页适用于排查缓存命中异常、确认键是否过期、按业务前缀抽样浏览键，以及在明确影响范围后执行只读或维护命令。MagicDB Studio 可按模式扫描键、查看常见 Redis 类型的键详情与 TTL，并提供命令行交互入口。

  • 日常核验：按命名空间或业务前缀定位少量键，确认类型、过期策略和值内容。
  • 故障排查：检查键不存在、TTL 异常、类型不匹配或值与预期不一致的问题。
  • 受控维护：先在只读账号或非生产环境验证命令，再按变更流程处理生产数据。
边界：键浏览与命令执行受 Redis 版本、部署拓扑、ACL、云服务限制和当前账号权限影响。MagicDB Studio 不保证账号拥有任意命令权限，也不会替代生产变更审批、备份或回滚方案。

入口路径

先在连接中心创建或选择 Redis 数据源。填写实际主机、端口和认证信息后，使用「测试连接」确认网络与认证可用，再保存并打开连接。进入 Redis 工作区后，从键列表按模式扫描；选中目标键查看详情，需要执行命令时再打开命令行入口。

连接中心 · Redis 数据源入口
MagicDB Studio 连接中心的数据源列表与环境标签
连接中心：先通过数据源列表和环境标签确认目标 Redis 连接，生产连接尤其要核对名称、分组与环境，避免误操作到错误实例。

前置条件

  • 已取得 Redis 的主机、端口及所需认证信息，并确认本机网络、代理、VPN 或隧道能够访问目标实例。
  • 账号至少具备连接及预期读取能力；若 ACL 禁止 SCAN、TYPE、TTL 或取值命令，相关操作会失败，应由实例管理员按最小权限原则处理。
  • 操作前明确实例环境与逻辑库，生产环境优先使用只读或受限账号；不要把测试命令直接复制到生产执行。
  • 涉及修改、过期时间调整或删除时，先记录键名、类型、TTL 和必要的值摘要，并准备业务侧验证与恢复方式。大键处置应安排低峰窗口。
不要使用 KEYS * 做全库盘点：KEYS 会一次遍历键空间，在大实例上可能长时间占用 Redis 主线程并放大延迟。应使用基于游标的 SCAN 分批迭代；即便如此，也要限制匹配范围和每批工作量并观察实例负载。

编号步骤

  1. 确认连接目标。在连接中心核对连接名称、主机、端口、环境标签和账号，先执行连接测试。若是生产实例，按团队流程确认操作窗口和责任人。
  2. 缩小扫描范围。进入 Redis 键列表，优先输入具体前缀模式，例如 order:2026:*，使用游标扫描逐批加载；不要以 KEYS * 替代扫描，也不要一开始就扫描无前缀的全部键空间。
  3. 从少量结果中选键。检查返回键名是否属于目标业务，再逐个打开。游标扫描可能分多批返回，单批数量只是工作量提示；需要继续迭代至游标完成，且并发写入时结果可能重复或发生变化。
  4. 核对类型、TTL 与值。先看键类型，再用对应视图读取 String、Hash、List、Set 或 ZSet 内容；同时确认 TTL。对集合类或疑似大键只抽样、分页或限制范围，避免一次读取全部成员。
  5. 预览命令及影响。在命令行中先运行只读检查，确认键名、逻辑库、参数与返回值。执行写入、过期时间变更或删除前，保留必要快照或可恢复数据，并让业务负责人确认影响。
  6. 执行后复查。命令返回成功不等于业务正确；重新扫描目标键并检查类型、TTL、值或是否已删除，同时观察应用错误率、缓存命中与 Redis 延迟。出现异常立即停止后续批次并按预案恢复。
Redis · 键详情
Redis 键详情界面中的键类型、值内容与 TTL 信息
Redis 键详情：选中单个键后核对类型、值与 TTL；对集合类数据和大值应限制读取范围，不要把完整加载当作默认检查方式。

参数说明

参数或信息用途操作建议
连接 / 环境确定实际 Redis 实例与操作边界连接前后都核对主机、端口、环境标签与逻辑库，生产连接避免使用含糊名称。
匹配模式（MATCH）按键名模式过滤扫描结果使用尽可能具体的业务前缀；通配符过宽会增加扫描轮次和无关结果。
游标（cursor）记录 SCAN 的迭代位置从初始游标开始并按返回游标继续，直到完成；不要把某一批结果误当成全量结果。
批次提示（COUNT）提示服务端每轮扫描的大致工作量它不是精确返回条数保证；生产环境从较小值开始，结合延迟和负载逐步调整。
键类型（TYPE）决定读取值时采用的命令与展示方式先确认类型再读取，避免对 Hash、List、Set 或 ZSet 使用不匹配的命令。
TTL / PTTL查看剩余有效期或持久化状态区分剩余时间、无过期时间与键不存在等返回语义；修改 TTL 前先记录原值。
命令与参数执行只读检查或受控维护先逐字检查键名和参数，不拼接来源不明的文本；可用命令取决于 ACL 与托管服务策略。

预期结果

连接成功后，应能按指定模式分批获得键名，并在选中单个键后看到与其类型相符的值详情和 TTL 信息。命令行应显示 Redis 返回结果或明确错误；权限不足、命令被禁用、键类型不匹配和连接中断都应作为失败处理，而不是假定操作已经完成。

  • 扫描检查：结果集中以目标业务前缀为主，继续游标后能获得后续批次；并发写入期间允许看到变化或重复，因此不能把扫描当作强一致快照。
  • 详情检查：类型与业务模型一致，TTL 状态符合缓存策略，值抽样能够解释当前业务现象。
  • 命令检查：返回值与预期一致，并通过再次读取或业务监控验证实际效果。仅看到“已发送”或无报错不能替代复查。
生产大键与删除风险：完整读取大 String 或大集合可能造成网络、内存和主线程压力；直接 DEL 大键可能产生明显阻塞。先评估大小和成员数量，按实例能力与组织规范选择分批清理或异步释放方案。即使考虑 UNLINK，也必须确认 Redis 版本、权限、内存余量及业务可恢复性，不能假定命令一定可用或无影响。

常见问题

为什么扫描结果数量少于预期，或出现重复键？

SCAN 是游标迭代，单轮返回数量不固定，COUNT 只是提示。继续使用返回游标直到扫描完成；实例同时发生写入时可能出现重复或变化，关键盘点应在业务允许的条件下另行设计一致性方案。

为什么能连接，但看不到值或命令执行提示无权限？

连通权限与键读取、扫描、管理命令权限并不等价。记录 Redis 返回的权限或命令错误，确认当前用户名与 ACL 规则，再由管理员仅开放任务所需命令。MagicDB Studio 不绕过 ACL，也不保证托管服务开放全部命令。

TTL 显示异常或与刚才不同，应该怎么处理？

TTL 会持续递减，键也可能被应用续期、覆盖或删除。先区分“持久键”“键不存在”和正常剩余时间，再连续复查并结合应用写入逻辑判断；不要在未确认业务策略前直接执行 EXPIRE 或 PERSIST。

发现疑似大键，可以直接查看全部内容或删除吗？

不建议。先在低影响方式下确认类型、大小或成员数量，并只抽样查看。删除前确认业务所有者、备份或重建路径和低峰窗口；大键应按实例版本、拓扑与运维规范选择分批清理或异步释放，并在每批后观察延迟和内存。