核心概念

更新时间:
复制 MD 格式

数据连接用于访问数据库或日志服务中的数据。您可以先查看数据结构、测试查询,再通过平台提供的访问地址和 MCP 服务将连接用于应用。

连接器与数据连接

连接器 决定可以接入哪类数据源,以及该类型支持哪些操作。当前连接市场提供 MySQL、PostgreSQL 和 Alibaba Cloud 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 服务已启动和某次查询执行成功是不同的状态。接入时应分别确认网络、鉴权、服务状态及实际调用反馈。具体工具信息以成功加载的工具列表为准。