Status

Current state: Under DiscussionAccepted

Discussion thread: TBD here

JIRA: KAFKA-4343

Released: 0.11.0.0

Please keep the discussion on the mailing list rather than commenting on the wiki (wiki discussions get unwieldy fast).

...

Currently we don't expose information about whether a connector is a source or sink. This is useful when, e.g., categorizing connectors in a UI. Given naming conventions we try to encourage you might be able to determine this via the connector's class name, but that isn't reliable. We would also like to expose a Connector's version information.

Public Interfaces

We will modify the following REST API endpoint for Connect:

...

[ 
  { 
    "class": "org.apache.kafka.connect.file.FileStreamSourceConnector",
    "type": "SOURCEsource",
	"version": "0.11.0.0"
  },
  { 
    "class": "org.apache.kafka.connect.file.FileStreamSinkConnector",
    "type": "SINK"sink",
	"version": "0.11.0.0"
  }
]

Compatibility, Deprecation, and Migration Plan

• What impact (if any) will there be on existing users?
• If we are changing behavior how will we phase out the older behavior?
• If we need special migration tools, describe them here.
• When will we remove the existing behavior?

Rejected Alternatives

• This is purely an addition to the current API and is backwards compatible.

Rejected Alternatives

The current method to get this information is to use a heuristic (does a class contain SInk/Source?), or use a lookup table. Neither of which works in every case, or with dynamically loaded ConnectorsIf there are alternative ways of accomplishing the same thing, what were they? The purpose of this section is to motivate why the design is the way it is and not some other way.