QueryHub¶
QueryHub 是观测云内置的外部数据查询能力。配置连接后，可以在支持外部数据源的查询入口中读取数据库、指标服务或文档存储中的数据，再用于分析和图表展示，无需先将这些数据采集到工作空间。
QueryHub 提供原生查询和 DQL Like 两种查询方式，均在输入框中手写内容，以所选实例实际开放的查询模式为准。
原生查询中，MySQL、PostgreSQL 填写 SQL，Prometheus、Elasticsearch、MongoDB 填写完整查询 JSON；DQL Like 填写完整的 QueryHub 表达式。DQL Like 是 QueryHub 的查询语法，与查询工作空间内日志、指标时使用的普通 DQL 不同。
选择数据源类型¶
| 类型 | 查询对象 | 配置和查询指南 |
|---|---|---|
| MySQL | 数据库中的表 | MySQL |
| PostgreSQL | 指定 Schema 中的表 | PostgreSQL |
| Prometheus | 指标及样本标签 | Prometheus |
| Elasticsearch | 配置范围内的索引和文档 | Elasticsearch |
| MongoDB | 配置的数据库、集合和文档 | MongoDB |
查询访问范围由所选数据源的连接配置、账号读取权限和工作空间权限共同决定。
添加连接¶
1. 选择接入方式和数据源类型¶
切换到目标工作空间，进入集成 > 外部数据源，点击添加数据源，选择 QueryHub 接入方式和数据源类型。
2. 填写连接属性¶
各类型均需先填写以下公共字段。认证字段会随所选认证方式展示，具体必填条件见对应数据源类型的说明；证书字段按 TLS 要求填写。
| 配置项 | 必填 | 含义与填写方式 |
|---|---|---|
| 数据源 ID | 是 | 手动填写这条连接的标识，例如 mysql-orders，最多 100 个字符。DQL Like 表达式中的 datasource 使用此值；它不是从数据库获取的账号或库名 |
| 名称 | 是 | 便于在查询页面识别连接的名称，例如“生产订单库”，最多 100 个字符 |
| 描述 | 否 | 补充说明连接用途或数据范围，最多 256 个字符 |
按数据源配置与查询示例中对应的类型填写地址、数据库或资源范围和认证信息。地址、账号、密码或令牌来自数据源管理员、运维人员或云服务的连接信息页面，不是观测云的登录账号。
TLS 模式、证书等字段统一见公共 TLS 配置，按服务端要求填写。
账号应具有目标数据的只读查询权限。配置连接是告诉观测云如何访问数据源，不需要预先在数据库中保存查询语句，也不会替数据库账号增加权限。
3. 测试连接¶
填写连接信息后，点击测试连接，根据结果继续操作：
| 结果 | 处理方式 |
|---|---|
| 连接成功 | 继续保存配置；生效后再通过实际查询验证目标数据的读取权限 |
| 地址、网络或超时错误 | 核对地址和端口；需要时联系运维检查网络、白名单及服务状态 |
| 认证失败 | 向数据源管理员确认用户名、密码、认证数据库或令牌是否正确 |
| 权限不足 | 确认账号是否有目标库、表、索引、集合或指标的读取权限 |
连接测试通过不代表所有对象都可查询。修改连接地址、资源范围或认证信息后，应重新测试。
4. 查询设置和权限¶
查询设置默认折叠，可展开后按需填写页面提供的选项。具体字段、默认值和上限以展开后的页面为准；这些设置用于保存后的实际查询，不只用于测试连接。
在权限区域设置自定义操作权限：
- 关闭：跟随“外部数据源”的默认权限。
- 开启：按展开的权限选项设置这条连接的操作权限。
这些权限控制工作空间成员对连接的操作，不改变数据库账号本身的读取权限。
5. 保存并验证查询¶
点击页面底部的保存，回到数据源列表确认配置，再进入查询页面选择该连接，执行一条只读查询验证是否可用。
使用 DQL Like 时，将配置时填写的数据源 ID写入表达式的 datasource，并与查询页面选中的实例保持一致。ID 可在数据源列表或详情中查看、复制。
开始查询¶
- 临时查询与分析：进入指标 > 指标分析，点击 + 添加数据源，选择连接和查询方式，填写查询后点击右上角刷新。完整步骤见在指标分析中查询。
- 保存到图表：进入仪表板的图表编辑页，在查询区域添加数据源并配置查询，确认预览结果后保存。完整步骤见在仪表板图表中查询。
各类型的原生查询、DQL Like 和来源、字段查看示例，统一见数据源配置与查询示例。