When using Kafka as a target in a Qlik Replicate task, the "Control Table" name in target is created in lower case, for example the Apply Exception topic name is "attrep_apply_exceptions" (if auto.create.topics.enable=true is set in Kafka broker config/server.properties file), This is the default behavior.
In some scenarios, you may want to use the non-default topic name or topic name in upper case etc to match the organization naming standards rule. This article describes how to rename control table topics' name.
In this article, we will use the topic name "attrep_apply_exceptions" as an example. You can customize below control topics using the same process:
- attrep_apply_exceptions
- attrep_status
- attrep_suspended_tables
- attrep_history
The same way works for more generic level , not only for Kafka target endpoint. In generic level we may rename other metadata eg "target_schema" too.
Resolution
- Export the JSON of the task
![john_wang_4-1694271226252.png john_wang_4-1694271226252.png](https://community.qlik.com/t5/image/serverpage/image-id/115941iFEEC7D31D99444C6/image-size/medium?v=v2&px=400)
- Position to the line of the JSON file and identify the element "exception_table_settings" (usually is empty, as below):
"exception_table_settings": {
},
- Override the element to add the table_name attribute and SAVE the changes:
"exception_table_settings": {
"table_name": "CUSTOM_NAME_ATTREP_APPLY_EXCEPTIONS_TABLE"
},
In above sample, we rename the topic exception_table_settings name to CUSTOM_NAME_ATTREP_APPLY_EXCEPTIONS_TABLE (it's case sensitive, and in upper case).
Kafka topic names cannot exceed 255 characters (249 from Kafka 0.10) and can only contain the following characters:
a-z|A-Z|0-9|. (dot)|_(underscore)|-(minus)
More detailed information can be found at Limitations and considerations.
The safest topic name length is 209 (rather than 255/249).
- Import the JSON of the task
![john_wang_5-1694271585712.png john_wang_5-1694271585712.png](https://community.qlik.com/t5/image/serverpage/image-id/115942iD24A61DBFE68406D/image-size/medium?v=v2&px=400)
After the import, The topic name shows in GUI is default name still, however the new topics name takes action, the task can be edited by using GUI freely until change the control topics name again by above steps.
- Run the task.
Environment
Qlik Replicate (versions 2022.11, 2023.5 and above)
Kafka target
Related Content:
case #00010983, #00108779
Generate a record to attrep_apply_exceptions topic for Kafka endpoint