管理数据连接

更新时间:
复制 MD 格式

本页介绍如何查找连接、查看字段、调整配置和测试查询,以及停用或删除连接前需要检查的事项。

查找连接并打开详情

  1. 在左侧进入 AGENT 上下文 > 数据连接,打开 数据连接 页签。

  2. 按连接名称搜索,或使用 类型、状态 筛选。需要更新列表时单击 刷新。

  3. 在目标行单击 查看 打开详情;修改配置可使用行内 编辑。其他管理入口位于 更多操作。

列表展示名称描述、状态、连接类型、绑定资源数量和创建时间,并提供 创建数据连接 入口。维护前,核对连接名称、类型及绑定资源数量,确认操作对象和影响范围。

详情页包含 概览、查询测试、集成 三个导航项。顶部提供 返回数据连接、编辑配置、测试连接、停用、删除。

查看表和字段

  1. 打开 概览,在左侧数据集树中选择目标表。

  2. 在中间区域查看列、类型和描述。可按字段名称、类型或描述搜索,快速定位所需字段。

  3. 在右侧查看数据集名称、数据源类型、字段数量和元数据更新时间。

  4. 核对右侧连接信息中的类型、网络、主机、端口和数据库,确认访问的是预期来源。

  5. 数据结构有变化时,单击 刷新 后重新检查字段。

PostgreSQL 还需确认表所属的 Schema;SLS 则需确认目标 Project 和 Logstore。目录、字段及元数据更新时间用于核对数据结构;业务记录的更新情况请结合业务时间字段确认。

先选中表,再单击 查看样本,核对字段值的格式。统计全表数量或金额时,执行覆盖完整业务范围的汇总查询。

编辑连接配置

  1. 在列表中单击 编辑,或在详情顶部单击 编辑配置。

  2. 核对当前配置,修改需要调整的内容。MySQL、PostgreSQL 和 SLS 的字段说明见创建数据连接

  3. 按编辑页要求填写并提交变更,根据页面反馈处理校验问题。

  4. 返回详情,核对连接信息;地址、端口、数据库、认证或网络发生变化后,重新执行 测试连接。

  5. 返回列表单击 刷新,检查当前状态。

实例模式的网络配置跟随所选实例。更换账号或角色前,请确认新身份仅具备所需资源的读取权限;密码和其他凭证只填写在对应的认证字段中。

测试连接

在详情顶部单击 测试连接,根据本次反馈检查当前访问配置。

遇到的问题 优先检查
无法连接数据库 主机地址、端口和所选网络能否访问目标数据库
认证或授权失败 数据库用户名和密码,或 SLS 角色及其资源授权
SSL/TLS 相关错误 保持数据库要求的 TLS 保护,核对 SSL 模式和证书配置
连接可用但查询失败 目标表或 Logstore 的读取权限、查询语法及所用字段

连接测试通过后,使用目标表、字段或 Logstore 执行一次获准的小范围查询,验证实际读取权限和结果。

运行查询测试

  1. 切换到 查询测试,打开 查询分析 页签;需要另写一条查询时,可以新建分析。

  2. 核对编辑区显示的连接名称,参考左侧目录,在 SQL 查询 编辑区填写查询。目录可以折叠。

  3. 填写 SQL 后,单击 运行,或使用 ⌘+Enter(macOS)/ Ctrl+Enter(Windows)。页面提供 运行选项。

  4. 在结果区切换 表格 或 原始 页签查看反馈,也可以展开结果区。

检查应用接入信息

在 集成 中分别检查以下内容:

  • 数据连接访问:查看公网和 VPC Endpoint 及其就绪状态。API Key 默认遮罩展示,可通过 查看鉴权 查看相关信息。

  • MCP 服务:查看服务状态,页面提供 刷新 和 关闭服务 操作。

  • MCP 配置:按应用的网络环境选择公网或 VPC 配置,并查看工具列表。

应用可直接使用平台提供的 MCP 服务。确认 Endpoint 已就绪、MCP 服务已启动后,在应用侧检查网络和鉴权,再通过实际调用验证接入结果。

工具列表加载失败时,先刷新并检查服务状态、网络和鉴权配置。持续报错时,保留错误信息并联系技术支持。工具名称及参数以成功加载的列表为准。

API Key 仅保存在应用的安全配置中;共享排查材料前先对凭据脱敏。应用接入步骤见使用高代码方式集成数据

停用和恢复连接

  1. 停用前,检查调用该连接的应用及绑定资源,与使用方确认影响。

  2. 打开目标连接详情,单击顶部 停用,按页面提示操作。

  3. 返回列表并刷新,核对状态及相关应用的反馈。

需要撤销数据访问授权时,请资源管理员另外回收对应数据库账号或 RAM 角色的权限,并核对授权变更结果。

需要恢复时,先确认配置、授权和应用用途,再使用页面提供的启用操作,并重新检查状态、连接测试和应用调用情况。

删除连接

  1. 检查仍在调用该连接的应用、绑定资源和相关查询,确认是否需要先迁移或停止使用。

  2. 打开目标连接详情,核对名称和连接信息,再单击顶部 删除。

  3. 阅读页面提示,确认操作对象和影响后再继续。

  4. 返回列表并刷新,核对删除结果,并检查相关应用。