빠른 시작: Azure Portal을 사용하여 Azure Event Hubs 스키마 레지스트리 만들기

2025-06-18

이 빠른 시작에서는 Azure Event Hubs에서 호스트하는 스키마 레지스트리에 스키마가 있는 스키마 그룹을 만듭니다.

Azure 스키마 레지스트리 는 Event Hubs의 기능입니다. 이벤트 기반 및 메시징 중심 애플리케이션에 대한 스키마에 대한 중앙 리포지토리를 제공합니다. 생산자 및 소비자 애플리케이션이 스키마를 관리 및 공유하지 않고도 데이터를 교환할 수 있는 유연성을 제공합니다. 또한 재사용 가능한 스키마에 대한 간단한 거버넌스 프레임워크를 제공하고, 그룹화 구성(스키마 그룹)을 통해 스키마 간의 관계를 정의합니다. 자세한 내용은 Event Hubs의 Azure 스키마 레지스트리를 참조하세요.

참고 항목

이 기능은 기본 계층에서 사용할 수 없습니다.
소유자, 기여자 또는 스키마 레지스트리 기여자 역할 중 하나의 구성원인지 확인합니다. 자세한 내용은 Azure 역할 기반 액세스 제어를 참조하세요.
이벤트 허브가 가상 네트워크에 있는 경우 동일한 가상 네트워크의 가상 머신에서 포털에 액세스하지 않는 한 Azure Portal에서 스키마를 만들 수 없습니다.

필수 조건

Event Hubs 네임스페이스 만들기 대신 기존 네임스페이스를 사용할 수 있습니다.

스키마 그룹 만들기

Event Hubs 네임스페이스 페이지로 이동합니다.
왼쪽 메뉴에서 엔터티 를 확장하고 스키마 레지스트리를 선택합니다.
스키마 그룹을 만들려면 + 스키마 그룹을 선택합니다.
스키마 그룹 만들기 페이지에서 다음 단계를 수행합니다.
1. 스키마 그룹의 이름을 입력합니다.
2. Serialization 형식의 경우 Avro serialization 형식을 선택합니다. 이 형식은 스키마 그룹의 모든 스키마에 적용됩니다. JSON serialization 형식도 지원됩니다(미리 보기).
3. 그룹의 모든 스키마에 대해 호환성 모드를 선택합니다. Avro의 경우 향후 및 이전 버전과의 호환성 모드가 지원됩니다.
4. 만들기를 선택하여 스키마 그룹을 만듭니다.
스키마 그룹 목록에서 스키마 그룹의 이름을 선택합니다.
그룹에 대한 스키마 그룹 페이지가 표시됩니다.

스키마 그룹에 스키마 추가

이 섹션에서는 Azure Portal을 사용하여 스키마 그룹에 스키마를 추가합니다.

스키마 그룹 페이지의 도구 모음에서 + 스키마 를 선택합니다.
스키마 만들기 페이지에서 다음 단계를 수행합니다.
1. 이름에 orderschema를 입력합니다.
2. 텍스트 상자에 다음 스키마를 입력합니다. 대신 스키마가 있는 파일을 선택할 수 있습니다.
```
{
  "namespace": "com.azure.schemaregistry.samples",
  "type": "record",
  "name": "Order",
  "fields": [
    {
      "name": "id",
      "type": "string"
    },
    {
      "name": "amount",
      "type": "double"
    }
  ]
}
```
3. 만들기를 실행합니다.
스키마 목록에서 스키마를 선택합니다.
스키마에 대한 스키마 개요 페이지가 표시됩니다.
여러 버전의 스키마가 있는 경우 버전에 표시됩니다. 버전을 선택하여 해당 버전 스키마로 전환합니다.

새 버전의 스키마 만들기

텍스트 상자에서 스키마를 업데이트하고 유효성 검사를 선택합니다. 다음 예제에서는 스키마에 이름이 description인 새 필드를 추가합니다.
유효성 검사 상태 및 변경 내용을 검토하고 저장을 선택합니다.

2 페이지의 버전에 대해 가 선택된 것을 볼 수 있습니다.
스키마의 버전 1을 표시하려면 1을 선택합니다.