Apache Pulsar
Apache Pulsar source connector
Descriptionâ
Source connector for Apache Pulsar.
Key featuresâ
Optionsâ
name | type | required | default value |
---|---|---|---|
topic | String | No | - |
topic-pattern | String | No | - |
topic-discovery.interval | Long | No | -1 |
subscription.name | String | Yes | - |
client.service-url | String | Yes | - |
admin.service-url | String | Yes | - |
auth.plugin-class | String | No | - |
auth.params | String | No | - |
poll.timeout | Integer | No | 100 |
poll.interval | Long | No | 50 |
poll.batch.size | Integer | No | 500 |
cursor.startup.mode | Enum | No | LATEST |
cursor.startup.timestamp | Long | No | - |
cursor.reset.mode | Enum | No | LATEST |
cursor.stop.mode | Enum | No | NEVER |
cursor.stop.timestamp | Long | No | - |
schema | config | No | - |
common-options | no | - | |
format | String | no | json |
topic [String]â
Topic name(s) to read data from when the table is used as source. It also supports topic list for source by separating topic by semicolon like 'topic-1;topic-2'.
Note, only one of "topic-pattern" and "topic" can be specified for sources.
topic-pattern [String]â
The regular expression for a pattern of topic names to read from. All topics with names that match the specified regular expression will be subscribed by the consumer when the job starts running.
Note, only one of "topic-pattern" and "topic" can be specified for sources.
topic-discovery.interval [Long]â
The interval (in ms) for the Pulsar source to discover the new topic partitions. A non-positive value disables the topic partition discovery.
Note, This option only works if the 'topic-pattern' option is used.
subscription.name [String]â
Specify the subscription name for this consumer. This argument is required when constructing the consumer.
client.service-url [String]â
Service URL provider for Pulsar service. To connect to Pulsar using client libraries, you need to specify a Pulsar protocol URL. You can assign Pulsar protocol URLs to specific clusters and use the Pulsar scheme.
For example, localhost
: pulsar://localhost:6650,localhost:6651
.
admin.service-url [String]â
The Pulsar service HTTP URL for the admin endpoint.
For example, http://my-broker.example.com:8080
, or https://my-broker.example.com:8443
for TLS.
auth.plugin-class [String]â
Name of the authentication plugin.
auth.params [String]â
Parameters for the authentication plugin.
For example, key1:val1,key2:val2
poll.timeout [Integer]â
The maximum time (in ms) to wait when fetching records. A longer time increases throughput but also latency.
poll.interval [Long]â
The interval time(in ms) when fetcing records. A shorter time increases throughput, but also increases CPU load.
poll.batch.size [Integer]â
The maximum number of records to fetch to wait when polling. A longer time increases throughput but also latency.
cursor.startup.mode [Enum]â
Startup mode for Pulsar consumer, valid values are 'EARLIEST'
, 'LATEST'
, 'SUBSCRIPTION'
, 'TIMESTAMP'
.
cursor.startup.timestamp [Long]â
Start from the specified epoch timestamp (in milliseconds).
Note, This option is required when the "cursor.startup.mode" option used 'TIMESTAMP'
.
cursor.reset.mode [Enum]â
Cursor reset strategy for Pulsar consumer valid values are 'EARLIEST'
, 'LATEST'
.
Note, This option only works if the "cursor.startup.mode" option used 'SUBSCRIPTION'
.
cursor.stop.mode [String]â
Stop mode for Pulsar consumer, valid values are 'NEVER'
, 'LATEST'
and 'TIMESTAMP'
.
Note, When 'NEVER'
is specified, it is a real-time job, and other mode are off-line jobs.
cursor.stop.timestamp [Long]â
Stop from the specified epoch timestamp (in milliseconds).
Note, This option is required when the "cursor.stop.mode" option used 'TIMESTAMP'
.
schema [Config]â
The structure of the data, including field names and field types. reference to Schema-Feature
format [String]â
Data format. The default format is json, reference formats.
common optionsâ
Source plugin common parameters, please refer to Source Common Options for details.
Exampleâ
source {
Pulsar {
topic = "example"
subscription.name = "seatunnel"
client.service-url = "pulsar://localhost:6650"
admin.service-url = "http://my-broker.example.com:8080"
result_table_name = "test"
}
}
Changelogâ
2.3.0-beta 2022-10-20â
- Add Pulsar Source Connector
next versionâ
- [Feature] Add Pulsar canal-format and e2e (4111)