快速开始
应用要访问业务数据库,需要先在控制台建立数据连接并验证其可用。本页以 MySQL 为例,介绍如何创建数据连接、查看数据集和字段、发起只读查询,以及获取应用集成所需的访问地址与鉴权信息。完成后即可得到一个可被应用访问的数据连接;已有连接时,直接从查看数据集和字段开始。
开始前
已获取有权访问的数据库地址、端口、数据库名、用户名和密码。
已向数据库管理员确认数据库的网络访问方式和 SSL/TLS 要求。
建议使用仅具备所需表读取权限的专用账号。
本例在认证配置中选择 连接串模式,在网络配置中使用页面默认的公网接入。两者是相互独立的配置项,分别在不同步骤中设置。如需改用实例模式、VPC 私网接入,或连接其他类型的数据库,配置方法见创建数据连接。
1. 创建 MySQL 数据连接
在左侧导航栏,选择 AGENT 上下文 > 数据连接,切换到 连接市场。
单击 MySQL 卡片查看详情,再单击 创建数据连接,进入独立的创建页面。
填写连接名称,例如“业务查询连接”,并按需填写描述,描述最多 255 个字符。确认 集成类型 为 MySQL。
在认证配置中选择 连接串模式,按字段分别填写主机地址、端口、数据库名、用户名和密码,无需粘贴完整 URI。其中主机地址、数据库名、用户名和密码为必填项,MySQL 默认端口为
3306。如需改用实例模式,配置方法见创建数据连接。按数据库管理员确认的 SSL/TLS 要求配置 SSL 模式,默认值为
DISABLED。核对网络配置。页面默认选择公网;数据库使用私网时,改用相应的 VPC 配置,具体方法见创建数据连接。
单击页面顶部的 测试连接,根据页面反馈检查配置。如果修改了地址、账号或网络等配置,需要重新测试。
确认测试反馈后,单击 创建数据连接。
返回 数据连接 列表,按连接名称搜索并查看连接状态。
其他入口:也可以从 数据连接 页签的列表直接单击 创建数据连接。
2. 查看数据集和字段
在连接列表中单击目标连接的 查看,打开 概览。
在左侧数据集树中选择一张有权访问的表,中间区域显示该表的列、类型和描述。
通过搜索框按字段名称、类型或描述查找字段。
在右侧核对数据集名称、数据源类型、字段数量和元数据更新时间,并检查连接信息是否指向预期数据库。
可选操作:
需要更新字段信息时,单击 刷新。
如需了解字段值的格式,选中表后单击 查看样本。
3. 发起只读查询
以下操作均在目标连接的详情页完成。查询以只读方式执行,SQL 中只能引用已获授权的表和字段。
切换到 查询测试,在 查询分析 页签中编写查询。
确认编辑区显示的连接名称,参考左侧目录(可折叠),在 SQL 查询 编辑区填写 SQL。
在结果区切换 表格 和 原始 页签查看返回内容。
可选操作:
除在 查询分析 页签中编写查询外,也可以新建分析。
以下示例仅为查询写法示意,表名和字段名均为虚构。运行前,请替换为已获授权的表和字段。
SELECT record_id, recorded_at
FROM example_records
LIMIT 20;4. 查看集成信息
在目标连接的详情页,打开 集成。
获取平台提供的数据连接访问地址、鉴权信息和 MCP 服务配置。API Key 默认遮罩展示,可通过 查看鉴权 查看相关信息。
后续步骤
应用可以使用平台提供的 MCP 服务,无需先自行搭建查询服务。