核心概念
数据连接用于访问数据库或日志服务(SLS)中的数据。可以先查看数据结构、测试查询,再通过平台提供的访问地址和 MCP 服务将连接用于应用。
连接器与数据连接
连接器决定可以接入哪类数据源,以及该类型支持哪些操作。当前连接市场提供 MySQL、PostgreSQL 和 SLS 三种连接器。
数据连接是针对一个数据源填写的具体配置。例如,选择 MySQL 连接器后,再指定要访问的数据库、认证信息和网络。连接名称用于在列表和应用接入时识别这份配置,不是源数据库的名称。
数据连接页面位于左侧导航 AGENT 上下文 > 数据连接,包含两个主页签:
| 页签 | 承载内容 |
| 数据连接 | 已创建连接的列表,支持按名称搜索、按类型或状态筛选,以及查看、编辑和管理连接 |
| 连接市场 | 按类型组织的连接器卡片,展示连接器支持的能力详情,是创建数据连接的入口 |
数据集、目录和元数据
浏览和查询连接中的数据时,涉及以下对象与结构信息:
| 名称 | 含义 |
| 数据集 | 连接下可浏览或查询的数据对象,例如数据库中的表、SLS 中的 Logstore |
| 数据集树 | 连接详情左侧的目录,用于定位要查看的对象 |
| 字段元数据 | 字段的名称、类型和描述等结构信息,不是表中的业务记录 |
| PostgreSQL Schema | 数据库中组织表等对象的命名空间,浏览目录时需要区分目标 Schema 及其表 |
| SLS Project / Logstore | Project 用于组织日志资源,Logstore 是其中存放和查询日志的对象 |
网络、认证和查询权限
数据连接涉及两段访问路径,分别在不同环节配置:
| 访问路径 | 配置环节与选项 | 作用 |
| 平台访问数据源 | 配置连接时选择公网或 VPC 私网 | 决定平台如何访问数据源 |
| 应用访问数据连接服务 | 应用集成时选择公网或 VPC Endpoint | 决定应用访问数据连接服务的地址 |
数据源可访问,不等于应用到 Endpoint 的网络也已连通,两段访问路径都需要确认。网络配置还取决于数据源的指定方式:实例模式跟随所选实例,连接串模式可按来源的实际访问方式配置。
MySQL 和 PostgreSQL 使用数据库认证信息,SLS 使用 RAM 角色授权。按所需数据库、表或日志资源授予权限,不要仅为通过测试扩大授权范围。
查询测试只执行当前连接的数据查询,查询权限和只读限制由服务端校验。能看到目录、连接状态为“可用”,都不代表任意查询一定有权限执行。
平台提供的 MCP 服务
MCP 服务让应用通过工具访问数据连接。集成页提供服务状态、刷新和关闭服务操作,以及公网或 VPC 的 MCP 配置选项和工具列表。应用可使用平台提供的服务,无需先自行搭建查询服务。
访问地址就绪、MCP 服务已启动和某次查询执行成功是不同的状态。接入时应分别确认网络、鉴权、服务状态及实际调用反馈。具体工具信息以成功加载的工具列表为准。
了解更多
创建数据连接:在连接市场选择连接器,填写数据源、认证信息和网络配置。
查询测试:验证当前连接的查询权限和只读限制。
集成 MCP 服务:在集成页确认服务状态,获取公网或 VPC 的 MCP 配置和工具列表。