---
title: "스키마 레지스트리"
slug: "datastream-topic05-vpc"
updated: 2026-09-17T09:07:29Z
published: 2026-09-17T09:07:29Z
canonical: "guide.ncloud-docs.com/datastream-topic05-vpc"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 스키마 레지스트리

VPC 환경에서 이용 가능합니다.

**Topic** 메뉴에서 스키마를 연동하는 방법을 설명합니다. 스키마 레지스트리에 메시지 Value에 대한 스키마를 정의하고 관리할 수 있습니다.

## 스키마 레지스트리 설정

스키마 레지스트리 설정을 변경할 수 있습니다. 스키마를 생성한 후에 설정을 변경할 수 있습니다. 스키마가 없는 경우, **[설정]** 버튼은 비활성화됩니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 **Menu** > **All Services** > **Big Data & Analytics** > **Data Stream** 메뉴를 차례대로 클릭해 주십시오.
2. **Topic** 메뉴를 클릭해 주십시오.
3. 토픽 목록에서 **서비스 상세 보기**를 클릭해 주십시오.
4. 토픽 상세 화면에서 **[스키마 레지스트리]** 탭 메뉴를 클릭해 주십시오.
5. **[설정]** 버튼을 클릭해 주십시오.
  - **설정**
    - **활성**: 이전 버전의 스키마와 호환되어야 스키마를 등록할 수 있습니다. 설정 후 직전 버전과 호환성을 검사(BACKWARD)합니다.
    - **비활성**: 이전 버전의 스키마와 호환되지 않아도 스키마를 등록할 수 있습니다. 설정 후 호환되지 않는 데이터가 유입되면 처리되지 않을 수 있습니다.
  - **호환성**: 메시지 Value에 대해서 호환성 검사 활성화 여부 설정

## 스키마 레지스트리 정보 확인

스키마 레지스트리 정보를 확인할 수 있습니다.

- **접속 엔드포인트**: Kafka Client를 통해 스키마 연동 시 사용가능한 네트워크 주소

## 스키마 생성

스키마를 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 **Menu** > **All Services** > **Big Data & Analytics** > **Data Stream** 메뉴를 차례대로 클릭해 주십시오.
2. **Topic** 메뉴를 클릭해 주십시오.
3. 토픽 목록에서 **서비스 상세 보기**를 클릭해 주십시오.
4. 토픽 상세 화면에서 **[스키마 레지스트리]** 탭 메뉴를 클릭해 주십시오.
5. **[추가]** 버튼을 클릭해 주십시오.
6. 기본 정보를 입력해 주십시오.
  - **기본 정보**
    - **데이터 유형**: 메시지 Value를 직렬화 하거나 역직렬화 하는 방법을 지정합니다.
      - Producer가 메시지 Value를 직렬화하는 방법을 지정합니다.
      - Consumer가 수신한 바이트 데이터를 다시 Value 객체로 역직렬화하는 방법을 지정합니다.
      - AVRO, JSON, PROTOBUF 를 사용할 수 있습니다.
    - **스키마**: 등록하고자 하는 스키마를 입력합니다. 1MB 이내로 입력
    - **호환성 검증**: 입력한 스키마와 이전버전 스키마 간 호환성(BACKWARD)을 검증합니다.
7. **[완료]** 버튼을 클릭해 주십시오.

스키마 목록에 생성한 스키마가 표시됩니다.

## 스키마 정보 확인

스키마 정보를 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 **Menu** > **All Services** > **Big Data & Analytics** > **Data Stream** 메뉴를 차례대로 클릭해 주십시오.
2. **Topic** 메뉴를 클릭해 주십시오.
3. 토픽 목록에서 **서비스 상세 보기**를 클릭해 주십시오.
4. 토픽 상세 화면에서 **[스키마 레지스트리]** 탭 메뉴를 클릭해 주십시오.
5. 스키마 ID를 클릭해 주십시오.
6. 필요한 정보를 확인해 주십시오.
  - **ID**: 스키마 고유 ID
  - **Version**: 스키마 레지스트리 내에 등록된 이력
  - **데이터 유형**: 메시지 Value를 직렬화 하거나 역직렬화 하는 방법
  - **스키마**: 등록한 스키마 확인

## 스키마 삭제

스키마를 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔의 VPC 환경에서 **Menu** > **All Services** > **Big Data & Analytics** > **Data Stream** 메뉴를 차례대로 클릭해 주십시오.
2. **Topic** 메뉴를 클릭해 주십시오.
3. 토픽 목록에서 **서비스 상세 보기**를 클릭해 주십시오.
4. 토픽 상세 화면에서 **[스키마 레지스트리]** 탭 메뉴를 클릭해 주십시오.
5. 삭제할 스키마 버전을 선택해 주십시오.
6. **[삭제]** 버튼을 클릭해 주십시오.
7. **알림** 팝업 창이 나타나면 내용을 확인한 후 **[삭제]** 버튼을 클릭해 주십시오.

스키마 목록에서 삭제한 스키마 버전이 사라집니다.