RDB 使用

RDB 用于在运维平台中查看和排查关系型数据库数据，常用于确认业务记录、配置记录、任务状态、操作日志等结构化数据。

使用前请确认当前账号具备中间件工具权限，并已选择正确的部署环境。

RDB 工具会直接访问数据库数据。查询前请确认库表和过滤条件，避免执行高成本查询或误操作生产数据。

一、进入 RDB

在顶部选择 系统服务。

在左侧导航栏展开 中间件工具。

选择 RDB。

页面通常包含数据库连接、库表选择、SQL 输入和查询结果等区域。

二、选择数据库连接

在 RDB 页面选择需要访问的数据库实例。

确认实例名称、数据库地址或环境标识与当前排查目标一致。

选择目标数据库。

展开表列表，确认目标表存在。

如数据库实例为空或连接失败，请先检查中间件配置、账号权限和网络连通性。

三、查看表结构

在左侧表列表中选择目标表。

查看字段名、字段类型、主键和索引信息。

根据字段含义确认后续查询条件。

建议重点确认以下信息：

信息	说明
主键	用于精确查询单条记录。
业务 ID	如租户 ID、用户 ID、任务 ID、文件 ID。
状态字段	用于确认业务当前流转状态。
时间字段	用于限定查询时间范围。
索引字段	优先作为查询过滤条件，减少全表扫描。

四、使用常用 SQL

“常用SQL”用于快速执行预置查询，适合证书、应用、文件、用户等高频排查场景。

在 SQL 编辑器上方单击 常用SQL。

在下拉列表中选择需要使用的 SQL。

如需先确认语句内容，单击对应 SQL 后的预览。

在预览窗口中核对说明、数据库、表名和 SQL 内容。

确认无误后，单击执行。

常用 SQL 中可能包含占位符：

占位符	参数类型	示例
`%s`	字符串	app ID、provider file ID、history guid、provider user ID
`%d`	数字	内部用户 ID

如 SQL 包含占位符，执行时页面会弹出 填写SQL参数 窗口。

按提示填写每个参数。

字符串参数填写完整 ID，不需要额外添加引号。

数字参数填写纯数字。

单击 执行查询。

当前常用 SQL 主要包含以下场景：

场景	说明
证书查询	查询应用证书和应用 ID。
指定 appid 查询	按应用 ID 查询应用详情。
指定客户文件 guid 查询	按 `provider_file_id` 查询文件详情。
指定内部文件 guid 查询	按 `history_guid` 查询文件详情。
指定内部用户 id 查询	按内部用户 ID 查询用户详情。
指定客户用户 id 查询	按 `provider_user_id` 查询用户详情。

使用常用 SQL 前仍需确认目标环境和参数值。常用 SQL 只是减少手写成本，不代表查询结果一定符合本次排查目标。

五、执行查询

在 SQL 输入区域填写查询语句。

优先使用 SELECT 查询，不执行写入、更新或删除语句。

查询 LIMIT 默认为10，可手动进行调整。

单击 执行查询。

优先进行 EXPLAIN，确认执行后开始查询。

示例：

六、查看查询结果

在结果区域查看返回记录。

核对关键字段是否符合预期。

如结果为空，检查数据库、表名、查询条件和时间范围。

如结果过多，补充更精确的过滤条件后重新查询。

七、使用查询历史

「查询历史」用于查看当前页面已执行过的 SQL，便于复用排查语句、确认执行结果和复制 SQL。

查询历史保存在当前浏览器本地，不会持久化保存。每个数据库/表维度最多保留最近 100 条记录，当前没有按时间自动过期；清理浏览器站点数据、更换浏览器、更换设备，或切换到不同数据库/表后，看到的历史记录会不同。

在结果区域切换到 查询历史。

查看历史记录中的执行状态、时间、数据库、表、SQL、返回行数和耗时。

如需再次执行某条 SQL，单击该记录操作列中的 插入到编辑器并执行。

如只需复用语句，单击 复制SQL。

查询历史字段说明：

字段	说明
状态	SQL 是否执行成功；失败时需结合错误提示排查。
时间	本次查询执行时间。
数据库	SQL 执行时选择的数据库。
表	SQL 执行时关联的表。
SQL	实际执行的查询语句。
返回行数	本次查询返回的数据行数。
耗时	SQL 执行耗时，可用于判断是否存在慢查询风险。
操作	支持重新插入并执行，或复制 SQL。

使用查询历史排查问题时，建议重点关注：

情况	处理建议
状态失败	先查看 SQL 语法、库表是否存在、字段是否正确。
耗时较长	补充过滤条件，或先检查表结构和索引字段。
返回行数过多	增加 `WHERE` 条件和 `LIMIT`。
多次查询结果不一致	确认是否切换了数据库、表或环境。

查询历史用于辅助复查当前排查过程。重新执行历史 SQL 前，仍需确认 SQL 内容、目标数据库和当前环境。

八、常见排查场景

场景	操作建议
确认业务记录是否存在	使用业务 ID 精确查询。
检查任务状态	按任务 ID 查询状态字段和更新时间。
排查配置未生效	查询配置表中的当前值和更新时间。
检查最近变更	按时间字段倒序查询，并限制返回条数。
查询应用或证书信息	优先使用“常用SQL”中的证书查询或 appid 查询。
复用排查语句	从“查询历史”复制 SQL，核对参数后再次执行。

九、注意事项

生产环境禁止无条件查询大表。

不确定 SQL 影响时，先在低风险环境验证。

不通过 RDB 工具直接修复业务数据，除非已有明确变更方案和审批。

常用 SQL 中的参数必须按当前环境实际值填写，避免跨环境误查。

查询历史中的 SQL 可能包含敏感 ID，复制和转发前需确认范围。

查询结果涉及敏感信息时，不要外传完整截图或明文数据。

RDB

RDB 使用#

一、进入 RDB#

二、选择数据库连接#

三、查看表结构#

四、使用常用 SQL#

五、执行查询#

六、查看查询结果#

七、使用查询历史#

八、常见排查场景#

九、注意事项#

RDB 使用

一、进入 RDB

二、选择数据库连接

三、查看表结构

四、使用常用 SQL

五、执行查询

六、查看查询结果

七、使用查询历史

八、常见排查场景

九、注意事项