Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
    • Cloud Interconnect
    • Cloud Backup
    • Cloud Registry
    • Yandex AI Studio
    • Compute Cloud
    • Object Storage
    • Managed Service for Kubernetes®
    • Yandex BareMetal
    • Smart Web Security
    • Security Deck
    • Managed Service for PostgreSQL
    • Managed Service for ClickHouse®
    • Monium
    • Cloud CDN
    • Network Load Balancer
    • Virtual Private Cloud
    • Cloud DNS
    • Application Load Balancer
    • Yandex Cloud Video
    • Stackland
    • Yandex Cloud Router
    • Yandex Managed Service for Trino
    • Managed Service for MySQL®
    • Managed Service for Valkey™
    • Managed Service for Apache Spark™
    • Yandex StoreDoc
    • Managed Service for OpenSearch
    • Managed Service for Apache Kafka®
    • Data Transfer
    • Yandex MPP Analytics Engine for PostgreSQL
    • Yandex Managed Service for Apache Airflow®
    • Data Processing
    • Yandex MetaData Hub
    • Managed Service for YDB
    • Managed Service for Sharded PostgreSQL
    • Managed Service for YTsaurus
    • Yandex WebSQL
    • DataLens
    • Yandex Search API
    • SpeechSense
    • SpeechKit
    • DataSphere
    • Vision OCR
    • Translate
    • Yandex Identity Hub
    • Key Management Service
    • Certificate Manager
    • Yandex Lockbox
    • Audit Trails
    • SmartCaptcha
    • Cloud Desktop
    • SourceCraft Code Assistant
    • Container Registry
    • Managed Service for GitLab
    • Managed Service for Prometheus®
    • Cloud Functions
    • API Gateway
    • Yandex Cloud Postbox
    • Message Queue
    • Serverless Integrations
    • IoT Core
    • Data Streams
    • Serverless Containers
    • Cloud Notification Service
    • Yandex Query
    • Identity and Access Management
    • Yandex Cloud Console
    • Resource Manager
    • Yandex Cloud Billing
    • Yandex Cloud Quota Manager
    • Cloud Apps
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex MetaData Hub
  • About Yandex MetaData Hub
    • Getting started
      • Schema registry
      • JSON schema compatibility
      • Content models and JSON schema evolution issues
      • Compatibility policies
    • Service roles for access management
    • Troubleshooting
  • Access management
  • Quotas and limits
  • Pricing policy
  • Public materials
  • Release notes

In this article:

  • Namespace
  • Subject
  • Schema
  • Reference
  • Use cases
  1. Schema Registry
  2. Concepts
  3. Schema registry

Data schema registry

Written by
Yandex Cloud
Updated at March 17, 2026
View in Markdown
  • Namespace
  • Subject
  • Schema
  • Reference
  • Use cases

Note

This feature is at the Preview stage.

Schema Registry implements a schema registry, i.e., a centralized repository for managing and validating data schemas. The schema registry ensures safe data schema evolution, resolves data compatibility issues, and enhances system performance by reducing the volume of data transmitted over the network. Moreover, the schema registry will allow you to satisfy data security requirements and promote collaboration across teams. In Schema Registry, you can add schemas in Avro, JSON Schema, and Protobuf formats.

NamespaceNamespace

A namespace is a certain number of schemas. Schemas and subjects of different namespaces are completely isolated from one another. It is up to the user to decide how many namespaces to create and what principle to follow for placing schemas in them. You cannot create references between schemas from different namespaces.

SubjectSubject

A subject is a named entity within which a data schema evolves.
The particular subject version contains metainformation about the schema and the schema itself. Subject versions are numbered sequentially incrementing by 1. Each subject version is unique and contains only one schema. You can compare schemas in different versions of a subject.

SchemaSchema

A _schema_ is a definition of a data format used to describe data type and structure.
Schemas are used to check data structure in messages on events, thereby ensuring that producers and consumers send and receive data in the same format. You can define schemas in a schema registry only within a given subject.
You can edit a data schema. To do this, upload an updated schema to a subject. The new schema will appear in the new subject version:

ReferenceReference

A reference (schema reference) is a link to other schemas comprising the following parameters:

  • Reference name. For Avro, a reference name is a full schema name; for JSON, it is a URL address; and for Protobuf, a name of a Protobuf file with a schema (as stated in the import directive).
  • Subject name used to register the referenced schema.
  • Subject version containing the referenced schema.
Example of a Protobuf schema reference

Let's take a look at the msg2.proto schema in the test-msg2 subject that refers to the msg1.proto schema in the test-msg1 subject.

msg1.proto file contents:

message msg1 {
    int8 my_field = 1
}

msg2.proto contents:

import "msg1.proto"

message msg2 {
    msg1 my_field = 1
}

To link these schemas, add a reference with the following parameters when loading the msg2.proto schema into the test-msg2 subject:

  • msg1.proto: Reference name.
  • test-msg1: Subject name used to register the referenced schema, msg1.proto.
  • 1: test-msg1 subject version containing the referenced schema.

Use casesUse cases

  • Creating a schema registry to deliver data in Debezium CDC format from Apache Kafka®

Was the article helpful?

Previous
Delivering data in Debezium CDC format from Apache Kafka®
Next
JSON schema compatibility
© 2026 Direct Cursus Technology L.L.C.