Quickstart: Create an Azure Event Hubs schema registry using Azure portal

In this quickstart, you create a schema group with schemas in a schema registry hosted by Azure Event Hubs.

Azure Schema Registry is a feature of Event Hubs. It provides a central repository for schemas for event-driven and messaging-centric applications. It provides the flexibility for your producer and consumer applications to exchange data without having to manage and share the schema. It also provides a simple governance framework for reusable schemas and defines relationship between schemas through a grouping construct (schema groups). For more information, see Azure Schema Registry in Event Hubs.

Prerequisites

Create an Event Hubs namespace. You can instead use an existing namespace.

Create a schema group

1. Navigate to the Event Hubs Namespace page.

2. In the left menu, expand Entities and select Schema Registry.

3. To create a schema group, select + Schema Group.

   

4. On the Create Schema Group page, do these steps:

   1. Enter a name for the schema group.

   2. For Serialization type, select Avro serialization format. This format applies to all schemas in the schema group. JSON serialization format is also supported (preview).

   3. Select a compatibility mode for all schemas in the group. For Avro, forward and backward compatibility modes are supported.

   4. Select Create to create the schema group.

      

5. Select the name of the schema group in the list of schema groups.

   

6. You see the Schema Group page for the group.

   

Add a schema to the schema group

In this section, you add a schema to the schema group using the Azure portal.

1. On the Schema Group page, select + Schema on the toolbar.

2. On the Create Schema page, do these steps:

   1. For Name, enter orderschema.

   2. Enter the following schema into the text box. You can instead select a file with the schema.

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

   3. Select Create.

3. Select the schema from the list of schemas.

   

4. You see the Schema Overview page for the schema.

   

5. If there are multiple versions of a schema, you see them in the Versions. Select a version to switch to that version schema.

Create a new version of schema

1. Update the schema in the text box, and select Validate. In the following example, you add a new field called description to the schema.

   

2. Review validation status and changes, and select Save.

   

   You see that 2 is selected for the version on the Schema Overview page.

   

3. Select 1 to see the version 1 of the schema.

Clean up resources

1. Navigate to the Event Hubs Namespace page.
2. Select Schema Registry on the left menu.
3. Select the schema group you created in this quickstart.
4. On the Schema Group page, select Delete on the toolbar.
5. On the Delete Schema Group page, type the name of the schema group, and select Delete.

Next step