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

아티클
06/14/2024

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

이 문서에서는 Azure Event Hubs에서 호스트하는 스키마 레지스트리에서 스키마를 사용하여 스키마 그룹을 만드는 방법을 보여 줍니다.

참고 항목

기본 계층에서는 이 기능을 사용할 수 없습니다.
소유자, 기여자 또는 스키마 레지스트리 기여자 역할 중 하나의 구성원인지 확인합니다. 역할 기반 액세스 제어에 대한 자세한 내용은 스키마 레지스트리 개요를 참조하세요.
이벤트 허브가 가상 네트워크에 있는 경우 동일한 가상 네트워크의 VM에서 포털에 액세스하지 않는 한, 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을 선택합니다.