クイック スタート: Azure portal を使用して Azure Event Hubs スキーマ レジストリを作成する

このクイック スタートでは、Azure Event Hubs によってホストされるスキーマ レジストリにスキーマを含むスキーマ グループを作成します。

Azure スキーマ レジストリ は、Event Hubs の機能です。 イベント ドリブンおよびメッセージング中心のアプリケーション用のスキーマ用の中央リポジトリを提供します。 プロデューサーとコンシューマー アプリケーションに対し、スキーマを管理して共有することなく、データを交換できる柔軟性を提供します。 また、再利用可能なスキーマのための単純なガバナンス フレームワークが用意されており、グループ化構成体 (スキーマ グループ) を使用してスキーマ間のリレーションシップを定義します。 詳細については、Event Hubs の Azure スキーマ レジストリ に関するページを参照してください。

前提条件

Event Hubs 名前空間を作成します。 代わりに、既存の名前空間を使用できます。

スキーマ グループを作成する

1. [Event Hubs 名前空間] ページに移動します。

2. 左側のメニューで、[ エンティティ ] を展開し、[ スキーマ レジストリ] を選択します。

3. スキーマ グループを作成するには、[ + スキーマ グループ] を選択します。

   

4. [スキーマ グループの作成] ページで、次の手順を実行します。

   1. スキーマ グループの名前を入力します。

   2. [シリアル化の種類] で、[Avro シリアル化の形式] を選択します。 この形式は、スキーマ グループ内のすべてのスキーマに適用されます。 JSON シリアル化形式もサポートされています (プレビュー)。

   3. グループ内のすべてのスキーマに対して、互換モードを選択します。 [Avro] の場合、上位および下位の各互換性モードがサポートされています。

   4. [ 作成] を選択してスキーマ グループを作成します。

      

5. スキーマ グループの一覧でスキーマ グループの名前を選択します。

   

6. グループの [スキーマ グループ] ページが表示されます。

   

スキーマ グループにスキーマを追加する

このセクションでは、Azure portal を使用してスキーマ グループにスキーマを追加します。

1. [スキーマ グループ] ページで、ツールバーの [+ スキーマ] を選択します。

2. [スキーマの作成] ページで、こちらの手順を実行します。

   1. 名前には、orderschemaを入力します。

   2. 次のスキーマをテキスト ボックスにコピーします。 代わりに、スキーマを含むファイルを選択できます。

      {
        "namespace": "com.azure.schemaregistry.samples",
        "type": "record",
        "name": "Order",
        "fields": [
          {
            "name": "id",
            "type": "string"
          },
          {
            "name": "amount",
            "type": "double"
          }
        ]
      }
      

   3. ［作成］ を選択します

3. スキーマの一覧からスキーマを選択します。

   

4. スキーマの [スキーマの概要] ページが表示されます。

   

5. スキーマのバージョンが複数ある場合は、[バージョン] に表示 されます。 バージョンを選択して、そのバージョン スキーマに切り替えます。

新しいバージョンのスキーマを作成する

1. テキスト ボックス内のスキーマを更新し、 [検証] を選択します。 次の例では、スキーマに description という名前の新しいフィールドを追加します。

   

2. 検証の状態と変更を確認し、 [保存] を選択します。

   

   2 ページの [バージョン] で [] が選択されていることがわかります。

   

3. 1 を選択し、スキーマのバージョン 1 を確認します。

リソースをクリーンアップする

1. [Event Hubs 名前空間] ページに移動します。
2. 左側のメニューの [スキーマ レジストリ] を選択します。
3. このクイック スタートで作成したスキーマ グループを選択します。
4. [スキーマ グループ] ページで、ツールバーの [削除] を選択します。
5. [スキーマ グループの削除] ページで、スキーマ グループの名前を入力し、[削除] を選択します。

次のステップ