创建数据连接

更新时间:
复制 MD 格式

创建数据连接时,先选择数据源类型,再填写认证和网络配置。本文分别介绍 MySQL、PostgreSQL 和 Alibaba Cloud SLS 的填写方法。已有连接的维护方法见管理数据连接

开始前

  • 连接数据库:准备数据库地址或实例、数据库名、用户名和密码,使用仅具备所需表读取权限的账号,并了解数据库的端口、网络和 TLS 要求。

  • 连接 SLS:确认目标 Project 和 Logstore,以及可用于访问这些日志资源的 RAM 角色。需要创建授权时,先确认授权范围。

  • 密码等凭证仅填写在对应的认证字段中。共享配置或排查材料前,先对凭据脱敏。

已有连接需要维护时,参见管理数据连接。

1. 打开创建页面

在左侧进入 AGENT 上下文 > 数据连接,选择以下任一入口:

  • 在 数据连接 页签中单击 创建数据连接。

  • 在 连接市场 中单击连接器卡片,查看详情后单击 创建数据连接。

创建表单是独立页面。三种集成类型的页面顶部均提供 测试连接 和 创建数据连接。

2. 填写基本信息

字段 填写说明
连接名称 必填。使用便于识别用途的名称,例如“业务查询连接”
描述 按需填写用途说明,最多 255 个字符
集成类型 从 MySQL、PostgreSQL、Alibaba Cloud SLS 中选择与数据源一致的类型

3. 配置认证信息

MySQL / PostgreSQL:连接串模式

在认证配置中将 配置模式 设为 连接串模式,分别填写以下字段。

字段 填写说明
主机地址 必填,填写数据库实际访问地址
端口 MySQL 默认为 3306,PostgreSQL 默认为 5432;使用其他端口时按实际配置修改
数据库名 必填,填写要访问的数据库
用户名 必填,建议使用仅有必要读取权限的专用账号
密码 必填,填写该账号的密码
SSL 模式 按数据库的 TLS 要求选择

MySQL 的 SSL 模式默认值为 DISABLED,PostgreSQL 为 disable;留空也使用对应默认值。请向数据库管理员确认加密和证书校验要求,并选择相应的 SSL 模式。排查连接失败时,保持数据库要求的 TLS 保护,检查 SSL 模式和证书配置。

MySQL / PostgreSQL:实例模式

  1. 将 配置模式 切换为 实例模式。

  2. 选择目标实例;如需更新可选项,单击 刷新实例。

  3. 填写数据库名、用户名、密码和 SSL 模式。

  4. 核对实例对应的网络信息。此模式的网络配置跟随所选实例。

需要新建实例时,请到对应数据库产品控制台完成;当前页面的 创建实例 按钮不可用。如果出现当前地域没有实例的提示,先核对账号和地域,再确认可用实例。已有有效数据库地址和访问条件时,也可以使用连接串模式。

Alibaba Cloud SLS

SLS 的认证表单包含 SLS Project 和 RAM 角色名称:

  1. 选择要访问的 SLS Project。

  2. 填写用于授权的 RAM 角色名称。页面默认名称为 AliyunAgentCoreDataConnectorDefaultRole,并提示需要 AliyunLogReadOnlyAccess。

  3. 确认角色已创建,使用 查看已关联策略 检查权限,并与账号管理员核对目标 Project 和 Logstore 的读取范围。

  4. 如果角色尚未创建或需要授权,可使用 快捷创建授权 入口。在提交授权前,确认将创建的角色、关联策略和可访问资源范围;完成后使用 刷新 更新信息。

4. 配置数据库网络

MySQL 和 PostgreSQL 的连接串模式提供以下网络选择:

网络类型 配置方法
公网 页面默认选项。确认数据库地址可通过相应公网路径访问
VPC 私网 选择 VPC 和交换机,交换机可选 1–20 个;确认所选网络能够访问目标数据库

服务端会校验所选 VPC 和交换机的账号、地域归属。请选择当前账号和地域下的适用资源,并检查所选网络到数据库的访问路径及访问规则。

使用实例模式时,网络跟随实例,直接核对实例网络即可。

5. 测试并创建

  1. 核对连接名称、集成类型、认证和网络配置,单击顶部的 测试连接。

  2. 根据实际反馈检查配置。连接失败时,优先核对地址、端口、认证信息、网络和 TLS;SLS 还需检查角色,并按目标日志资源所需的最小读取范围修正授权。

  3. 如果调整了访问配置,重新测试。

  4. 确认后单击顶部的 创建数据连接,根据页面反馈处理校验问题。

  5. 创建成功后,返回 数据连接 列表,按连接名称搜索,查看当前状态并打开详情。

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

6. 查看数据并继续使用

打开详情中的 概览,在左侧数据集树选择目标对象。对于数据库表,中间区域显示列、类型和描述,右侧显示数据集及连接信息。需要更新结构信息时可单击 刷新;选中表后可使用 查看样本。