list_datasources
所属分类:数据资产感知 · Tool 名称:
list_datasources
功能说明
列出 TIS 中已配置的所有数据源,返回数据源名称、类型、连接摘要信息。是盘点 TIS 数据资产的入口 Tool,通常与 list_pipeline 配合使用,让 AI Agent 快速建立「TIS 里有什么」的整体认知。
输入参数
无参数。
输出结果
业务 JSON 直返(非信封结构),字段说明如下:
| 字段 | 类型 | 说明 |
|---|---|---|
datasources | array | 已配置的数据源列表 |
datasources[].name | string | 数据源唯一性名称 |
datasources[].type | string | 数据源类型标识(插件类型,如 MySQL、Doris 等) |
datasources[].jdbcUrl | string | 数据库 JDBC 连接地址 |
返回示例
{
"datasources": [
{
"name": "order_mysql",
"type": "MySQL",
"jdbcUrl": "jdbc:mysql://10.1.1.100:3306/order_db"
},
{
"name": "analytics_doris",
"type": "Doris",
"jdbcUrl": "jdbc:mysql://10.1.1.200:9030/analytics"
}
]
}
错误返回
| 情况 | 表现 |
|---|---|
| 服务端内部异常 | MCP 层 isError: true,内容为通用错误提示文本 |
注意点
- 仅返回带 JDBC 连接信息的数据源:当前版本只输出能解析出
jdbcUrl的数据源,未提供 JDBC 连接配置的数据源类型(如部分非关系型数据源)不会出现在结果中。 - 插件加载失败会被静默跳过:个别数据源插件缺失或配置损坏时,该数据源不会出现在列表中,但不会影响其他数据源的返回。
- 返回的是连接摘要信息,不包含用户名、密码等敏感配置。
典型用法
在 Hermes 中的提问示例:
TIS 里配置了哪些数据源?
使用 list_datasources 工具:列出所有 MySQL 类型的数据源
拿到数据源名称后,可继续调用 list_tables 查看库下表清单,或调用 get_table_columns 查看某张表的列结构。