创建数据连接
创建数据连接时,先选择数据源类型,再填写认证和网络配置。本文分别介绍 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:实例模式
-
将 配置模式 切换为 实例模式。
-
选择目标实例;如需更新可选项,单击 刷新实例。
-
填写数据库名、用户名、密码和 SSL 模式。
-
核对实例对应的网络信息。此模式的网络配置跟随所选实例。
需要新建实例时,请到对应数据库产品控制台完成;当前页面的 创建实例 按钮不可用。如果出现当前地域没有实例的提示,先核对账号和地域,再确认可用实例。已有有效数据库地址和访问条件时,也可以使用连接串模式。
Alibaba Cloud SLS
SLS 的认证表单包含 SLS Project 和 RAM 角色名称:
-
选择要访问的 SLS Project。
-
填写用于授权的 RAM 角色名称。页面默认名称为
AliyunAgentCoreDataConnectorDefaultRole,并提示需要AliyunLogReadOnlyAccess。 -
确认角色已创建,使用 查看已关联策略 检查权限,并与账号管理员核对目标 Project 和 Logstore 的读取范围。
-
如果角色尚未创建或需要授权,可使用 快捷创建授权 入口。在提交授权前,确认将创建的角色、关联策略和可访问资源范围;完成后使用 刷新 更新信息。
4. 配置数据库网络
MySQL 和 PostgreSQL 的连接串模式提供以下网络选择:
| 网络类型 | 配置方法 |
| 公网 | 页面默认选项。确认数据库地址可通过相应公网路径访问 |
| VPC 私网 | 选择 VPC 和交换机,交换机可选 1–20 个;确认所选网络能够访问目标数据库 |
服务端会校验所选 VPC 和交换机的账号、地域归属。请选择当前账号和地域下的适用资源,并检查所选网络到数据库的访问路径及访问规则。
使用实例模式时,网络跟随实例,直接核对实例网络即可。
5. 测试并创建
-
核对连接名称、集成类型、认证和网络配置,单击顶部的 测试连接。
-
根据实际反馈检查配置。连接失败时,优先核对地址、端口、认证信息、网络和 TLS;SLS 还需检查角色,并按目标日志资源所需的最小读取范围修正授权。
-
如果调整了访问配置,重新测试。
-
确认后单击顶部的 创建数据连接,根据页面反馈处理校验问题。
-
创建成功后,返回 数据连接 列表,按连接名称搜索,查看当前状态并打开详情。
连接测试通过后,对目标表或 Logstore 执行一次获准的小范围查询,验证实际读取权限和查询结果。
6. 查看数据并继续使用
打开详情中的 概览,在左侧数据集树选择目标对象。对于数据库表,中间区域显示列、类型和描述,右侧显示数据集及连接信息。需要更新结构信息时可单击 刷新;选中表后可使用 查看样本。