Skip to content

kafkaConnect ​

Command: kafkaConnect
Category: Data Tools
Status: Production Ready

Description ​

Manage Kafka connector configurations for integrating streaming data from Apache Kafka into SAP HANA. Actions include listing, creating, deleting, testing, and inspecting connectors.

Syntax ​

bash
hana-cli kafkaConnect [action] [options]

Aliases ​

  • kafka
  • kafkaAdapter
  • kafkasub

Command Diagram ​

Parameters ​

Positional Arguments ​

ParameterTypeDescription
actionstringAction to perform. Choices: list, create, delete, status, test, info. Defaults to list.

Options ​

OptionAliasTypeDefaultDescription
--action-astringlistAction to perform. Choices: list, create, delete, status, test, info.
--name-nstring-Kafka connector name. Required for create, delete, status, test, info.
--brokers-bstring-Kafka brokers (comma-separated). Required for create.
--topic-tstring-Kafka topic name. Required for create.
--config-cstring-Configuration file path (accepted but not currently used by the command).

Connection Parameters ​

OptionAliasTypeDefaultDescription
--admin-abooleanfalseConnect via admin (default-env-admin.json).
--conn-string-Connection filename to override default-env.json.

Troubleshooting ​

OptionAliasTypeDefaultDescription
--disableVerbose--quietbooleanfalseDisable verbose output for scripting.
--debug-dbooleanfalseDebug hana-cli with detailed intermediate output.

Actions ​

ActionRequired ParametersDescription
list-List all Kafka connectors.
create--name, --brokers, --topicCreate a new connector.
delete--nameDelete a connector.
status--name (optional)Show status for a connector or all connectors.
test--nameTest connector connectivity.
info--nameShow detailed connector information.

Output ​

The command prints tables with connector metadata (list/info) or status metrics (status/test) using the standard CLI output formatting.

Interactive Mode ​

In interactive mode, you are prompted for:

ParameterRequiredPromptedNotes
actionYesAlwaysDefaults to list if omitted.
nameNoAlwaysRequired for most actions except list.
brokersNoAlwaysRequired for create.
topicNoAlwaysRequired for create.

Examples ​

bash
hana-cli kafkaConnect --action list

Notes ​

  • Kafka brokers must be accessible from the HANA system.
  • The --config option is accepted but not currently used by the handler.
  • Both --action and --admin use the -a short alias; prefer the long form to avoid ambiguity.

See the Commands Reference for other commands in this category.

See Also ​