Deploy the DataStax Apache Kafka™ Connector to stream records from an Apache Kafka topic to your DataStax Astra DB database.
The DataStax Apache Kafka Connector download package includes a sample JSON properties file ( dse-sink-distributed.json.sample ).Use the sample file as a reference when configuring your deployment.The dse-sink-distributed.json.sample file is located in the conf directory of the DataStax Apache Kafka Connector distribution package.
Prerequisites
- Download and install the DataStax Apache Kafka Connector.
- Configure the distributed worker configuration file connect-distributed.properties to fit your needs.Use this example from DataStax as a starting point.Specify the converter for the key.converter and value.converter properties that matches the form of your Kafka data.See Configuring converters in the Confluent documentation for more information on these properties.
- From the directory where you installed Apache Kafka, start the distributed worker:
- 1
The worker startup process outputs a large number of informational messages.The following message displays after the process completes: `[2019-10-13 19:49:25,385] INFO Finished starting connectors and tasks (org.apache.kafka.connect.runtime.distributed.DistributedHerder:852)`. Configure the JSON configuration file (such as dse-sink.json) to use the Astra DB secure connect bundle.
- 1
- name: Unique name for the connector. Default: dse-sink
- connector.class: DataStax connector Java class provided in the kafka-connect-dse-N.N.N.jar . Default: com.datastax.kafkaconnector.DseSinkConnector
- cloud.secureConnectBundle: The full path to the secure connect bundle for your Astra DB database (`secure-connect-*database_name*.zip`).
Download the secure connect bundle from the DataStax Cloud console.If this option is specified, you must also include the auth.username and auth.password for the database user.
- auth.username: Astra DB database username
When authorization is enabled, the DataStax connector login role must have a minimum of modify privileges on tables receiving data from the DataStax Apache Kafka® Connector.
- *auth.password*: Astra DB database password for the specified username
- Register the connector configuration with the distributed worker:
- 1
ip and port are the IP address and port number of the Kafka worker.Use the same port as the rest.port parameter set in connect-distributed.properties .The default port is 8083.
You configured the dse-sink.json or dse-sink.properties file when installing the DataStax Apache Kafka Connector.