跳到主要内容
版本：3.0.0

InfluxDB

InfluxDB 源连接器

引擎支持​

Spark
Flink
SeaTunnel Zeta

描述​

通过 InfluxQL 查询从 InfluxDB 1.x 读取数据。连接器支持普通单查询，也支持按一个整数列范围切分查询， 让多个并行任务分别读取不同范围的数据。 使用 tables_configs 可以在一个 source 中读取多个查询、数据库以及不同的输出 schema。

关键特性​

数据类型映射​

SeaTunnel 数据类型说明
BOOLEAN从 InfluxDB 返回值解析。
SMALLINT从 InfluxDB 返回值解析。
INT从 InfluxDB 返回值解析。
BIGINT从 InfluxDB 返回值解析。
FLOATInfluxDB 会把数字按 double 返回，连接器再转换成 FLOAT。
DOUBLE使用返回的数字值。
STRING使用返回值作为字符串。

当前 InfluxDB source 转换器不支持其他 SeaTunnel 类型。

Source 选项​

参数名类型必须默认值描述
urlstring是-InfluxDB 连接 URL，例如 http://influxdb-host:8086。
sqlstring否-单表模式必填，与 tables_configs 互斥。
schemaconfig否-单表模式必填；多表模式需要在每个条目中配置。
databasestring否-单表模式必填；可作为多表条目的默认数据库。
tables_configslist否-多表模式的查询及 schema 配置，详见下文。
usernamestring否-InfluxDB 用户名。必须和 password 一起配置。
passwordstring否-InfluxDB 密码。必须和 username 一起配置。
lower_boundint否-启用并行范围读取时，split_column 的下界。
upper_boundint否-启用并行范围读取时，split_column 的上界。
partition_numint否0查询切分数量。0 表示不切分，直接执行原始 sql。
split_columnstring否-用于并行切分的整数列。
wherestring否-预留的 source 配置项。当前切分逻辑直接从 sql 中读取小写 where 关键字。
epochstring否n返回的时间精度，例如：H、m、s、MS、u、n。
connect_timeout_mslong否15000连接 InfluxDB 的超时时间（毫秒）。
query_timeout_secint否3查询 InfluxDB 的超时时间（秒）。
common-optionsconfig否-Source 插件通用参数，详见 Source 通用选项。

url [string]​

连接到 InfluxDB 的 URL，例如 http://influxdb-host:8086。

tables_configs [list]​

用于替代根级别的 sql 和 schema。每个条目需要配置：

  • sql：该表的 InfluxQL 查询。
  • database：数据库名称；未配置时继承根级别的 database。
  • schema：输出字段以及非空的 schema.table，该标识在所有输出表中必须唯一。

每个条目还可一起配置 split_column、lower_bound、upper_bound 和 partition_num。 多表模式的范围选项必须放在条目内，不能放在根级别。此模式按包含上下界的整数范围切分， 范围不能整除时也不会重叠，切分数量不超过范围内的整数数量。原有单表范围切分行为保持不变。 启用切分的条目支持简单的 SELECT fields FROM measurement，以及可选的 WHERE 条件， 关键字不区分大小写。范围切分不支持带引号的标识符、字符串字面量、函数、子查询、多条语句， 以及 LIMIT、ORDER BY、tz(...) 等尾部子句；这些查询请使用不切分的条目，查询会原样发送。

所有条目共享根级别的 url、认证信息、epoch 和超时选项，条目内的连接选项会被拒绝。 根级别的 sql 或 schema、空列表、缺失的表名以及重复输出表标识会在连接前报错。 输出表标识可以不同于查询中的 measurement 名称，并用于下游路由。 恢复 checkpoint 时请保持表标识及其查询、schema 定义不变；从单表模式切换到多表模式需要启动新作业。

每个查询必须返回其 schema 声明的字段；允许空查询结果。 不启用范围切分时，查询（包括 tz(...)）会原样发送到 InfluxDB。

sql [string]​

用于读取数据的 InfluxQL 查询，例如：

select name, age from test

schema [config]​

上游数据的 schema 信息，更多语法参考 Schema 特性。 例如：

schema {
    fields {
        name = string
        age = int
    }
}

database [string]​

InfluxDB 数据库名称。

username [string]​

InfluxDB 用户名。必须和 password 一起配置。

password [string]​

InfluxDB 密码。必须和 username 一起配置。

split_column [string]​

用于把一次查询切分成多个范围查询的整数列。启用并行范围读取时必须配置。

提示：

  • InfluxDB tags 不支持作为分割主键，因为 tags 的类型只能是字符串。
  • InfluxDB time 不支持作为分割主键，因为 time 字段无法参与数学计算。
  • 目前，split_column 仅支持整数数据分割，不支持 float、string、date 等类型。
  • split_column、lower_bound、upper_bound、partition_num 需要一起配置。
  • 如果切分读取的 SQL 中包含过滤条件，请在 sql 里使用小写 where，例如 select * from test where age > 0。当前切分解析逻辑区分大小写。
  • where 是配置校验中保留的选项，但当前切分逻辑会从 sql 里读取过滤条件。请把过滤条件写在 sql 中，不要单独配置 where。

upper_bound [int]​

split_column 列的上界。启用并行范围读取时使用。

lower_bound [int]​

split_column 列的下界。启用并行范围读取时使用。

连接器会把 split_column 范围切成 partition_num 份；若 partition_num = 1，则使用整段范围；若 partition_num 小于 upper_bound - lower_bound，则按 upper_bound - lower_bound 切分。

例如 lower_bound = 1、upper_bound = 10、partition_num = 2、 sql = "select * from test where age > 0 and age < 10" 会被切分成：

split 1: select * from test where ($split_column >= 1 and $split_column < 6)  and (  age > 0 and age < 10 )
split 2: select * from test where ($split_column >= 6 and $split_column < 11) and (  age > 0 and age < 10 )

partition_num [int]​

查询切分数量。须与 lower_bound、upper_bound、split_column 一起配置。

提示：确保 upper_bound - lower_bound 能被 partition_num 整除，否则查询结果会重叠。

epoch [string]​

InfluxDB 返回的时间精度。可选值：H、m、s、MS、u、n，默认值为 n。

query_timeout_sec [int]​

InfluxDB 客户端的查询超时时间，单位为秒。

connect_timeout_ms [long]​

连接到 InfluxDB 的超时时间，单位为毫秒。

通用选项​

Source 插件通用参数，请参考 Source 通用选项 详见。

任务示例​

读取多张表​

env {
    parallelism = 2
    job.mode = "BATCH"
}
source {
    InfluxDB {
        url = "http://influxdb-host:8086"
        tables_configs = [
            {
                database = "telemetry"
                sql = "select value from temperature"
                schema {
                    table = "temperatures"
                    fields { value = DOUBLE }
                }
            },
            {
                database = "operations"
                sql = "select active, label from alerts"
                schema {
                    table = "alerts"
                    fields {
                        active = BOOLEAN
                        label = STRING
                    }
                }
            }
        ]
    }
}
sink { Console {} }

使用并行范围读取​

env {
    parallelism = 1
    job.mode = "BATCH"
}

source {
    InfluxDB {
        url = "http://influxdb-host:8086"
        sql = "select label, c_string, c_double, c_bigint, c_float, c_int, c_smallint, c_boolean from source"
        database = "test"
        upper_bound = 99
        lower_bound = 0
        partition_num = 4
        split_column = "c_int"
        schema {
            fields {
                label = STRING
                c_string = STRING
                c_double = DOUBLE
                c_bigint = BIGINT
                c_float = FLOAT
                c_int = INT
                c_smallint = SMALLINT
                c_boolean = BOOLEAN
                time = BIGINT
            }
        }
    }
}

sink {
    Console {}
}

不使用并行范围读取​

env {
    parallelism = 1
    job.mode = "BATCH"
}

source {
    InfluxDB {
        url = "http://influxdb-host:8086"
        sql = "select label, c_string, c_double, c_bigint, c_float, c_int, c_smallint, c_boolean from source"
        database = "test"
        schema {
            fields {
                label = STRING
                c_string = STRING
                c_double = DOUBLE
                c_bigint = BIGINT
                c_float = FLOAT
                c_int = INT
                c_smallint = SMALLINT
                c_boolean = BOOLEAN
                time = BIGINT
            }
        }
    }
}

sink {
    Console {}
}

使用 InfluxQL 时区查询​

env {
    parallelism = 1
    job.mode = "BATCH"
}

source {
    InfluxDB {
        url = "http://influxdb-host:8086"
        sql = "select label, c_string, c_double, c_bigint, c_float, c_int, c_smallint, c_boolean from source tz('Asia/Shanghai')"
        database = "test"
        schema {
            fields {
                label = STRING
                c_string = STRING
                c_double = DOUBLE
                c_bigint = BIGINT
                c_float = FLOAT
                c_int = INT
                c_smallint = SMALLINT
                c_boolean = BOOLEAN
                time = BIGINT
            }
        }
    }
}

sink {
    Console {}
}

变更日志​

Change Log
ChangeCommitVersion
[Feature][Connector-V2] Support multi-table InfluxDB source (#12247)https://github.com/apache/seatunnel/commit/9c8052f403.0.0
[Fix][Connector-V2][InfluxDB] Fix NPE when query returns empty result (#11966)https://github.com/apache/seatunnel/commit/1491a8e0a3.0.0
[Improve][Connector-V2] Improve source split round-robin assignment for InfluxDB IoTDB Kudu and TDengine (#11573)https://github.com/apache/seatunnel/commit/1fe15cbb83.0.0
[Feature][Checkpoint] Add check script for source/sink state class serialVersionUID missing (#9118)https://github.com/apache/seatunnel/commit/4f5adeb1c72.3.11
[Improve] influxdb options (#8966)https://github.com/apache/seatunnel/commit/9f498b81332.3.10
[Improve] restruct connector common options (#8634)https://github.com/apache/seatunnel/commit/f3499a6eeb2.3.10
[Improve][dist]add shade check rule (#8136)https://github.com/apache/seatunnel/commit/51ef8000162.3.9
[Feature][Restapi] Allow metrics information to be associated to logical plan nodes (#7786)https://github.com/apache/seatunnel/commit/6b7c53d03c2.3.9
[Improve] Improve some connectors prepare check error message (#7465)https://github.com/apache/seatunnel/commit/6930a25edd2.3.8
[Improve][Connector] Add multi-table sink option check (#7360)https://github.com/apache/seatunnel/commit/2489f6446b2.3.7
[Feature][Core] Support using upstream table placeholders in sink options and auto replacement (#7131)https://github.com/apache/seatunnel/commit/c4ca74122c2.3.6
Support multi-table sink feature for influxdb (#6278)https://github.com/apache/seatunnel/commit/56f13e920d2.3.5
[Improve][Zeta] Add classloader cache mode to fix metaspace leak (#6355)https://github.com/apache/seatunnel/commit/9c3c2f183d2.3.5
[Test][E2E] Add thread leak check for connector (#5773)https://github.com/apache/seatunnel/commit/1f2f3fc5f02.3.4
[BugFix][InfluxDBSource] Resolve invalid SQL in initColumnsIndex method caused by direct QUERY_LIMIT appendage with 'tz' function. (#4829)https://github.com/apache/seatunnel/commit/deed9c62c32.3.4
[Improve][Common] Introduce new error define rule (#5793)https://github.com/apache/seatunnel/commit/9d1b2582b22.3.4
[Improve] Remove use SeaTunnelSink::getConsumedType method and mark it as deprecated (#5755)https://github.com/apache/seatunnel/commit/8de74081002.3.4
Support config column/primaryKey/constraintKey in schema (#5564)https://github.com/apache/seatunnel/commit/eac76b4e502.3.4
[Improve][Connector-V2] Remove scheduler in InfluxDB sink (#5271)https://github.com/apache/seatunnel/commit/f459f500cb2.3.4
[Improve][CheckStyle] Remove useless 'SuppressWarnings' annotation of checkstyle. (#5260)https://github.com/apache/seatunnel/commit/51c0d709ba2.3.4
Merge branch 'dev' into merge/cdchttps://github.com/apache/seatunnel/commit/4324ee19122.3.1
[Improve][Project] Code format with spotless plugin.https://github.com/apache/seatunnel/commit/423b5830382.3.1
[improve][api] Refactoring schema parse (#4157)https://github.com/apache/seatunnel/commit/b2f573a13e2.3.1
[Improve][build] Give the maven module a human readable name (#4114)https://github.com/apache/seatunnel/commit/d7cd6010512.3.1
[Improve][Project] Code format with spotless plugin. (#4101)https://github.com/apache/seatunnel/commit/a2ab1665612.3.1
[Improve][SourceConnector] Unifie InfluxDB source fields to schema (#3897)https://github.com/apache/seatunnel/commit/85a984a64f2.3.1
[Feature][Connector] add get source method to all source connector (#3846)https://github.com/apache/seatunnel/commit/417178fb842.3.1
[Feature][API &amp; Connector &amp; Doc] add parallelism and column projection interface (#3829)https://github.com/apache/seatunnel/commit/b9164b8ba12.3.1
[Hotfix][OptionRule] Fix option rule about all connectors (#3592)https://github.com/apache/seatunnel/commit/226dc6a1192.3.0
[Improve][Connector-V2][Influxdb] Unified exception for influxdb source & sink connector (#3558)https://github.com/apache/seatunnel/commit/4686f35d682.3.0
[Feature][Connector][influx] Expose configurable options in influx db (#3392)https://github.com/apache/seatunnel/commit/b247ff0aef2.3.0
[Feature][Connector-V2] influxdb sink connector (#3174)https://github.com/apache/seatunnel/commit/630e8847912.3.0
[Feature][Connector-V2] Add influxDB connector source (#2697)https://github.com/apache/seatunnel/commit/1d70ea30842.3.0-beta