Skip to content

Schema evolution docs make reference to unexplained schemaRegistryCompatibilityCheckers flag #15855

@jon-hanson

Description

@jon-hanson

What issue do you find in Pulsar docs?

Regarding schema evolution, the Pulsar documentation states the following:

How does Pulsar support schema evolution?

When a producer/consumer/reader connects to a broker, the broker deploys the schema compatibility checker configured by schemaRegistryCompatibilityCheckers to enforce schema compatibility check.

What exactly is "schemaRegistryCompatibilityCheckers" and where is it configured? The term seems to appear out of the blue without any context.

It isn't referenced anywhere else in the documentation as far as I can see. If I search for the term online all I find is a reference in the Pulsar codebase (specifically a parameter to the SchemaRegistryService.create method):

static SchemaRegistryService create(SchemaStorage schemaStorage, Set<String> schemaRegistryCompatibilityCheckers) {

The documentation doesn't appear to be suggesting that I should be calling this method, so what does it mean?

What is your suggestion?

The documentation should make clear what exactly "schemaRegistryCompatibilityCheckers" is and where it is defined/configured. A code example would help enormously.

Do you have any references?

N/A

Would you like to fix this issue?

I would if I knew the answer.

Note

  • I have researched my question.

Metadata

Metadata

Assignees

No one assigned

    Labels

    doc-requiredYour PR changes impact docs and you will update later.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions