JDBC Driver for Apache Kafka

Build 25.0.9539

AllowKeyOnlyRegistryTopics

Specifies whether the provider exposes key-only Schema Registry topics as tables.

Data Type

bool

Default Value

false

Remarks

This property applies only when TypeDetectionScheme is set to SchemaRegistry.

The driver supports two types of schemas in the Schema Registry: value schemas and key schemas. By default, the driver requires a value schema for a topic to be exposed as a table. Topics that contain only a key schema are not exposed unless this property is enabled. Key schemas are optional and are used only when MessageKeyColumn is set.

When set to true, the driver exposes topics that contain either a key schema, a value schema, or both. For topics without a value schema, the message value is returned as a base64 blob because no deserialization can be performed. This behavior is similar to scenarios where SerializationFormat is set to NONE or TypeDetectionScheme is set to MessageOnly.

When set to false, topics without a value schema are not exposed. This is the default behavior and ensures that only topics with complete value schemas are represented as tables.

This behavior is independent of the MessageKeyColumn setting. Even when this property is enabled, you must set MessageKeyColumn if you want the driver to return message key data.

Enable this property when you need to read topics defined only with key schemas or when working with registries where not all topics include value schemas. Enabling this property may increase the number of exposed tables and may require additional processing when handling base64-encoded message values.

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 25.0.9539