日志服务检索分析功能模块支持关联外部存储，即检索日志时将日志服务的日志数据与 MySQL 数据库进行关联。本文档介绍关联 MySQL 数据源的操作步骤。

背景信息

在实际生产环境中，系统日志、销售记录等与生产事件行为相关的事实表和业务基础元数据的维表通常独立保存在不同的系统或数据库中。例如电商场景中，用户的事件与行为相关的信息会以日志的形式保存在日志服务中，包括用户的访问数据、购买商品数据、支付方式、网络类型等等；而用户的注册信息及会员数据保存在数据库系统中，出于数据安全的考虑并不会打印到日志中。
在日志分析场景中，事实表和维表可以互相关联，以原始数据流作为检索分析的基础，关联大量的外部表来补充一些详细信息和属性。基于以上场景，日志服务检索分析引擎提供关联数据源功能，即支持日志主题和外部 MySQL 数据源联合查询分析。在日志服务中检索数据时，可以通过 SQL 的 JOIN 子句关联日志主题中的日志数据和 MySQL 数据库中的数据，扩大检索分析的数据范围。

注意事项

使用限制

操作步骤

1 设置白名单

在关联 MySQL 数据源之前，需先在 MySQL 数据源端设置白名单，允许日志服务相关 IP 地址访问 MySQL 数据源。应添加到白名单的 IP地址如下：

2 创建 MySQL 数据源关联

1. 登录日志服务控制台。

2. 在顶部导航栏中，选择日志服务所在的地域。

3. 在左侧导航栏中，选择资源管理 > 日志项目。

4. 在外部数据源页签中，单击创建数据源关联。

5. 填写数据源的基本配置。

   • 自建数据库

     配置	说明
     数据源名称	外部数据源名称。应符合以下要求： 同一个日志项目下唯一。 支持小写字母、数字、中文和连字符（-）。 必须以小写字母、中文或者数字开头和结尾。 长度为 3~30 字符。
     类型	外部数据源的类型。目前仅支持设置为 MySQL，表示 MySQL 数据源。
     数据库类型	数据库类型。此处以自建数据库为例，即火山引擎 ECS 中自建的 MySQL 数据库。
     连接地址	ECS 的私网 IP 地址。
     端口	MySQL 服务绑定的端口号。
     VPCId	ECS 实例所在的 VPC ID。
     数据库用户名	MySQL 数据库用户名。
     数据库密码	MySQL 数据库用户密码。
     数据库	MySQL 数据库名称。
     数据库表	MySQL 数据库表名称。

   • 火山引擎云数据库 MySQL 版

     配置	说明
     数据源名称	外部数据源名称。应符合以下要求： 同一个日志项目下唯一。 支持小写字母、数字、中文和连字符（-）。 必须以小写字母、中文或者数字开头和结尾。 长度为 3~30 字符。
     类型	外部数据源的类型。目前仅支持设置为 MySQL，表示 MySQL 数据源。
     数据库类型	数据库类型。此处以火山引擎RDS for MySQL 为例，即火山引擎云数据库 MySQL 版。
     选择Region	云数据库 MySQL 实例所在的地域。应与当前日志项目的地域相同。
     选择AZ	云数据库 MySQL 实例所在的可用区。
     选择实例	云数据库 MySQL 实例名称。
     连接地址	云数据库 MySQL 实例的内网连接地址。
     端口	云数据库 MySQL 实例的内网连接端口号。指定连接地址时页面会自动填充对应的端口号。
     VPCId	云数据库 MySQL 实例所在的 VPC。指定实例时页面会自动填充对应的 VPC。
     数据库用户名	云数据库 MySQL 实例的数据库用户名。
     数据库密码	云数据库 MySQL 实例的数据库用户密码。
     数据库	云数据库 MySQL 实例的数据库名称。
     数据库表	云数据库 MySQL 实例的数据库表名称。

6. 单击测试连接。
   日志服务将自动测试服务端与 MySQL 数据源的连通性。

7. 测试通过后，单击创建数据源关联。

相关操作

创建数据源关联后，还可以查看、修改或删除数据源关联，相关操作说明如下。