跳到主要内容

元数据与数据查询

数据查询页用于在开发接口前确认数据结构、验证 SQL 与预览结果。它复用数据源连接，但只开放只读能力。

进入查询页​

  1. 进入【数据源】。
  2. 在左侧元数据树展开目标数据源。
  3. 选择库与表，点击表名。
  4. 右侧进入数据查询页，默认查询该表数据。

元数据树按三级展示：

数据源
└── 库 / Schema
    └── 表 / 视图
        └── 字段

查询页能力​

能力说明
表数据预览默认加载当前表数据，支持分页
自定义 SQL在编辑器中编写只读 SQL 并执行
SQL 格式化一键格式化当前 SQL
建表脚本查看表的 DDL，便于生成查询或迁移脚本
执行结果展示列名、类型与数据，长文本自动截断
耗时与行数辅助判断查询性能与结果规模

只读限制​

平台只允许以下语句开头（忽略前导空白）：

SELECT ...
SHOW ...
DESC ...
DESCRIBE ...
EXPLAIN ...

其他语句（INSERT、UPDATE、DELETE、ALTER、DROP、CREATE、存储过程调用等）会被拒绝。这是数据源侧的保护，不依赖前端校验。

查询范围

只读限制只保证语句类型安全，不限制查询的数据范围。请为数据源配置最小权限账号，并通过视图或行级权限控制敏感数据。

结果预览​

  • 查询结果默认按页展示，单次预览最多返回 100 行。
  • 字段较多时表格支持横向滚动。
  • NULL、二进制、超长文本会按展示规则处理。
  • 非关系型数据源的返回结构可能不是标准二维表，平台会尽量转换为表格。

建表脚本​

点击建表脚本可查看当前表的 DDL，用于：

  • 确认字段类型、主键、索引与注释。
  • 复制到 SQL 模式中作为查询基础。
  • 对比不同环境表结构。

常见问题​

现象原因处理
查询被拒绝语句不是只读前缀改用 SELECT / SHOW / DESC / DESCRIBE / EXPLAIN
元数据为空账号无库表权限或 Schema 选择错误检查账号授权与默认 Schema
连接超时网络或数据库负载检查防火墙、连接池与数据库状态
查询很慢缺少索引或数据量大加索引、限制条件、减少返回列
特殊字符报错表名/字段名含 - 等字符使用英文双引号包裹

与接口开发的关系​

数据查询页验证通过的 SQL 可以直接复制到 SQL 模式。注意：

  • 查询页使用的是数据源账号权限，接口运行时使用同一数据源，但会经过参数绑定、分页与插件处理。
  • 查询页不会解析 #{} 参数；接口中的参数语法请在 SQL 模式中编写与解析。
  • 查询页结果不经过数据插件（过滤、脱敏、字段映射），不能替代接口的最终返回验证。

相关阅读​