【亲测免费】 Flume-ng-sql-source 使用教程

1. 项目目录结构及介绍

Flume-ng-sql-source 的目录结构如下：

.
├── src
│   ├── src
│   │   └── main
│   │       ├── java
│   │       │   └── org
│   │       │       └── keedio
│   │       │           └── flume
│   │       │               └── source
│   │       ├── resources
│   │       └── test
│   └── ...
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
└── pom.xml

这个结构包含了源代码（Java 和资源文件）、配置文件以及项目管理文件（比如 pom.xml）。主要的代码实现位于 src/main/java/org/keedio/flume/source 目录下，这些Java类用于Flume与SQL数据库的交互。

2. 项目的启动文件介绍

Flume-ng-sql-source 不包含特定的启动脚本，因为它作为Flume的Source插件运行。你需要在你的Flume配置文件中引入该插件，然后通过Flume自身的服务命令来启动或重启Flume服务。

当你编译项目并打包成JAR文件后，应将其放置在Flume的插件目录中，通常是 $FLUME_HOME/plugins.d。例如：

$ mvn package
$ cp target/flume-ng-sql-source-*.jar $FLUME_HOME/plugins.d

之后，Flume会自动发现并加载这个插件。

3. 项目的配置文件介绍

Flume 的配置文件（通常以 .conf 结尾）是JSON格式的，你可以通过以下方式创建和配置SQL-source：

agent_name.sinks = hdfs
agent_name.sources = sqlSource
agent_name.channels = memChannel

# 配置SQL-source
agent_name.sources.sqlSource.type = org.keedio.flume.source.SQLSource
agent_name.sources.sqlSource.batchSize = 100
agent_name.sources.sqlSource.connectionString = jdbc:mysql://localhost:3306/mydb?useSSL=false
agent_name.sources.sqlSource.username = myuser
agent_name.sources.sqlSource.password = mypassword
agent_name.sources.sqlSource.query = SELECT * FROM mytable WHERE timestamp > ${lastEventTimestamp}
agent_name.sources.sqlSource.lastEventTimestampAttribute = lastEventTimestamp

# 配置channel
agent_name.channels.memChannel.type = memory
agent_name.channels.memChannel.capacity = 1000

# 配置sink
agent_name.sinks.hdfs.type = hdfs
agent_name.sinks.hdfs.hdfs.path = hdfs://namenode:port/path/to/save/data
agent_name.sinks.hdfs.hdfs.filePrefix = flume-
agent_name.sinks.hdfs.hdfs.fileSuffix = .txt
agent_name.sinks.hdfs.hdfs.writeFormat = Text
agent_name.sinks.hdfs.channel = memChannel

在这个配置中，sqlSource 是Source的名字，它连接到MySQL数据库并执行SQL查询。memChannel 是用来暂存事件的通道，而hdfs 是Sink，负责将数据写入HDFS。query 属性允许设置SQL查询，其中 ${lastEventTimestamp} 是一个变量，可以通过Flume事件属性传递。这样可以实现基于时间戳的增量抓取。

请确保将上述配置中的连接字符串、用户名、密码、查询语句以及其他相关路径和属性替换为你自己的实际值。完成配置后，通过Flume服务命令启动或更新配置即可启用SQL-source。

注意：Flume-ng-sql-source 还提供了一些自定义属性，如字符集编码 (charset)，可以根据具体需求在配置文件中设定。