QueryHub 数据源配置与查询示例¶

本文将介绍不同数据源的连接配置、原生查询和 DQL Like 查询示例，以及如何查看可查询的表、指标、索引、集合和字段。

• MySQL · PostgreSQL · Prometheus · Elasticsearch · MongoDB
• 数据源 ID、名称、描述，以及测试连接、权限和保存的公共步骤，见概览与配置。数据源 ID 需要手动填写。
• 实际查询入口和刷新结果的步骤，见查询与应用。QueryHub 支持原生查询和 DQL Like，两种方式均为手写输入，以所选实例实际开放的查询模式为准。

各表中的认证字段标注了具体必填条件，选择相应认证方式后需填写对应凭据；证书字段按 TLS 要求填写。地址、账号、密码、令牌及证书由数据源管理员或运维人员提供。

DQL Like 表达式中的 datasource 必须与当前选中实例的 ID 一致，source 必须与数据源类型一致。查询对象和字段按实际数据填写。以下示例均为只读，账号也需要具备目标数据的读取权限。

公共 TLS 配置¶

五种数据源均提供 TLS 设置。新建连接时默认使用 disable，证书等子字段隐藏；选择非 disable 模式后，按服务端要求填写对应字段。各类型专属字段见后续对应章节。

MySQL¶

连接字段¶

查询示例¶

示例使用 orders 表中的 id、total 和 status 字段，请替换为实际表名和字段。

原生查询

查询最多 10 笔已支付订单，并按订单 ID 排序：

SELECT id, total FROM orders WHERE status = 'paid' ORDER BY id LIMIT 10

DQL Like

queryhub(source="mysql", datasource="mysql-orders")::orders:(id,total) {status = "paid"} ORDER BY id LIMIT 10

查看表和字段¶

以下均在原生查询中手动执行，每次运行一条。

查看当前数据库中账号有权看到的表：

SHOW TABLES

查看 orders 的列名、类型等定义：

SHOW COLUMNS FROM orders

这些查询返回元数据表格，不代表页面会自动扫描或生成全部字段。可见范围受数据库账号权限影响。

汇总查询示例¶

在原生查询中输入以下 SQL，按订单状态汇总金额，再点击右上角刷新查看结果：

SELECT status, SUM(total) AS total_amount
FROM orders
GROUP BY status
ORDER BY total_amount DESC
LIMIT 10

需要限定时间时，在 SQL 中使用实际存在的时间字段编写条件；调整页面时间范围不会自动为任意 SQL 添加时间过滤。

PostgreSQL¶

连接字段¶

查询示例¶

示例使用 public Schema 下的 orders 表，请按实际配置替换 Schema、表名和字段。数据库与 Schema 是两层不同的范围。

原生查询

SELECT id, total FROM public.orders WHERE id = 1 ORDER BY id LIMIT 10

DQL Like

queryhub(source="postgres", datasource="pg-orders")::public.orders:(id,total) {id = 1} LIMIT 10

查看表和字段¶

在原生查询中每次执行一条，并将 public 替换为配置的 Schema。结果受数据库账号可见范围影响。

查看表名：

SELECT table_name FROM information_schema.tables
WHERE table_schema = 'public'
LIMIT 20

查看 orders 的字段名和类型：

SELECT column_name, data_type FROM information_schema.columns
WHERE table_schema = 'public' AND table_name = 'orders'
ORDER BY ordinal_position LIMIT 50

表名相同但 Schema 不同时，应在查询中使用完整的 schema.table，并与所选实例允许的范围一致。

Prometheus¶

连接字段¶

查询示例¶

查询对象是指标，job、instance 等是样本标签。请用实际的指标和标签替换示例。

原生查询

在原生查询输入框中填写完整 JSON，通过 operation 指定查询操作，PromQL 写在 statement 中。

即时查询：

{"operation":"query","statement":"up{job=\"fixture\"}"}

范围查询：

{"operation":"query_range","statement":"up{job=\"fixture\"}","arguments":{"start":"#{startTime}","end":"#{endTime}","step":15}}

#{startTime} 和 #{endTime} 引用图表的时间范围，前端会自动将时间转换为秒；step 的单位也是秒，示例中为 15 秒。这些参数填写在 JSON 的 arguments 中。

DQL Like

queryhub(source="prometheus", datasource="metrics")::up:(*) {job = "fixture"}

查询结果¶

在 Studio 表格中，“名称”和“标签”分别来自序列的 name 和 tags。时间列为 time，接口使用 Unix 毫秒时间戳，页面会格式化显示；数值列名随指标名或表达式变化。

查看指标和标签¶

在原生查询输入框中填写以下 JSON，将查看指标的 PromQL 放在 statement 中。使用已知名称或窄范围正则查看当前有样本的指标：

{"operation":"query","statement":"count by (__name__) ({__name__=~\"up|http_requests_total\"})"}

示例只匹配 up 和 http_requests_total，执行后在表格中查看命中序列的名称和标签。

查看 job、instance 等标签时，执行上面的即时查询 JSON，在结果表格的“标签”中查看。没有样本时，可检查标签条件或调整查询时间。

这些结果只反映当前匹配的样本，不代表全量标签或指标目录，不能据此判断其他指标不存在。

Elasticsearch¶

连接字段¶

查询示例¶

示例假设实例配置的索引为 orders。查询文档时，使用表格图查看结果。

原生查询

在原生查询输入框中填写完整 JSON，operation 使用 search，请求正文放在 arguments.body 中：

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"size":10}}}

DQL Like

queryhub(source="elasticsearch", datasource="es-orders")::orders:(id,status) LIMIT 10

在表格图中展开 document JSON 查看文档。投影字段保留在 JSON 内，不会自动变成独立的表格列。

查看索引和字段¶

可查询索引以当前实例配置为准。在原生查询输入框中填写以下 JSON，执行后在表格中读取命中结果的 index 列：

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"_source":false,"size":1}}}

索引没有命中文档时，以实例配置为准，不通过空结果判断索引是否存在。

查看文档样本及其键，原生查询填写：

{"operation":"search","arguments":{"body":{"query":{"match_all":{}},"size":1}}}

在表格图中展开结果的 document JSON 查看字段。文档可能包含稀疏字段，可在有限范围内读取更多样本；这不是完整 mapping，完整定义需在 Elasticsearch 侧查看。

MongoDB¶

连接字段¶

查询示例¶

示例假设实例配置了 items 集合，文档中包含业务字段 id 和 status。查询数据库与认证数据库可能不同，使用表格图查看文档结果。

原生查询

在原生查询输入框中填写完整 JSON，operation 使用 find，筛选、投影和返回数量写在 arguments 中。数据库和集合沿用当前实例配置：

{"operation":"find","arguments":{"filter":{"status":"paid"},"projection":{"id":1,"status":1},"limit":10}}

filter 定义筛选条件，projection 指定要读取的文档字段，limit 限制返回数量。示例中的 id 是业务字段，不等同于 MongoDB 默认的 _id，请根据实际文档结构调整。

DQL Like

queryhub(source="mongodb", datasource="mongo-orders")::items:(id,status) {status = "paid"} LIMIT 10

在表格图中展开 document JSON 查看文档。投影字段保留在 JSON 中，不会自动展开成独立列。

查看集合和字段¶

可查询的数据库和集合以当前实例配置为准。Studio 入口不提供 listCollections。

在原生查询输入框中填写以下 JSON，读取一条样本文档：

{"operation":"find","arguments":{"filter":{},"limit":1}}

在表格图中展开 document JSON 查看文档的键。不同文档的结构可能不同，可更换筛选条件或适当增加有限的样本数；样本内容不代表完整 Schema，也不会增加账号权限。