Product Brief

This document contains a brief description of the Kafka Connect OData v4 Connectors.

Contact

Company
INIT Individuelle Softwareentwicklung & Beratung GmbH
Rotebühlplatz 21
70178 Stuttgart - Deutschland
Amtsgericht Stuttgart, HRB 224214
Geschäftsführer: Thomas Winkelsdorf
https://init-software.de/

Business and technical contact
Ronald Schertle
connector-contact@init-software.de
+49 173 81 49 709

Description

The OData v4 connectors package consists of Apache Kafka Connect source and sink connectors for interacting with OData v4 services. Even though the connectors can serve any OData v4 service, they are optimized for interaction with SAP OData v4 services. Both connectors solely work on exposed entity sets of an OData v4 service. The source connector allows reading entity sets and associated properties, the sink connectors allows for inserting and updating entity set instances.

OData v4 may not be compatible to other versions of the OData protocol. For more details refer to https://www.odata.org/.

OData v4 does not define common services for offset handling, delta data delivery or change data capture. Therefore, the source connector is not able to provide exactly once delivery semantics in general.

OData v4 entity sets can provide data in a nested format. Nesting of data types is also supported by the source connector. All OData v4 simple data types are also supported by the source connector. The source connector makes use of meta data provided by the OData v4service for each entity property when building a rich Kafka connect schema provided with each generated SourceRecord.

Versioning

OData v4 Connectors

  • Connector name: OData v4 Source Connector
  • Version: 1.3.5
  • Type: Kafka Connect source connector

  • Connector name: OData v4 Sink Connector
  • Version: 1.3.5
  • Type: Kafka Connect sink connector

OData Protocol

The OData v4 Connectors follow the OData v4 protocol.

Kafka

  • Tested on Confluent Platform v7.0.1, v7.3.0, v7.5.0 and v7.6.0
  • Tested with Apache Kafka and Connect API 2.8, v3.3, v3.5 and v3.6

Dependencies

The connectors package includes all library dependencies. Apache Olingo v4 is being used for connecting to OData v4 services.

Configuration

The package for the OData v4 connectors contains expressive configuration documentation for the source and sink connector respectively in doc/source/configuration.html and doc/sink/configuration.html. Minimal configuration examples are included as odatav4-source-connector.properties and odatav4-sink-connector.properties. The connectors make heavy use of validators and recommenders and have been tested with the Confluent Control Center UI.