MetricSign
EN|NLRequest Access
High severityconnection

Power BI Refresh Error:
KAFKA_SCHEMA_REGISTRY_ERROR

What does this error mean?

The Snowflake Kafka Connector could not connect to or retrieve a schema from the Confluent Schema Registry, preventing message deserialization and halting topic ingestion.

Common causes

  • 1The Schema Registry URL in the connector configuration is incorrect or the service is down
  • 2SSL/TLS certificate validation fails when connecting to a secured Schema Registry endpoint
  • 3The schema ID referenced in a Kafka message does not exist in the registry (schema was deleted)
  • 4Network firewall rules block the Kafka Connect worker from reaching the Schema Registry host

How to fix it

  1. 1Step 1: Check the Kafka Connect worker logs for the specific error — ERROR_0011 (schema ID not found) and ERROR_0012 (service unreachable) have different root causes.
  2. 2Step 2: Test Schema Registry connectivity from the Kafka Connect worker: curl -k https://<schema-registry-host>/subjects.
  3. 3Step 3: Verify schema.registry.url in the connector config and confirm SSL settings match the registry's certificate.
  4. 4Step 4: For ERROR_0011, check if the schema was manually deleted from the registry — restore it or re-register the schema.
  5. 5Step 5: Add schema.registry.ssl.engine.factory.class if using a custom trust store for SSL verification.

Frequently asked questions

Can I use the Snowflake Kafka Connector without a Schema Registry?

Yes — for JSON payloads without schema enforcement, you can disable Schema Registry integration. The connector supports schemaless JSON ingestion using the SNOWFLAKE_AVRO_SCHEMA_EVOLUTION setting.

What happens to in-flight messages when the Schema Registry goes down?

The connector buffers messages and retries deserialization. If the registry is unavailable for longer than the configured timeout, the connector task fails and must be restarted manually after the registry recovers.

Other connection errors