Share via


Inicio rápido: Creación de un registro de esquema de Azure Event Hubs mediante Azure Portal

El registro de esquema de Azure es una característica de Event Hubs, que proporciona un repositorio central para los esquemas de aplicaciones controladas por eventos y basadas en mensajería. Ofrece la flexibilidad para que las aplicaciones de productor y consumidor intercambien datos sin tener que administrar y compartir el esquema. También proporciona un marco de gobierno sencillo para los esquemas reutilizables y define la relación entre los esquemas a través de una construcción de agrupación (grupos de esquemas). Para más información, consulte Registro de esquema de Azure en Event Hubs.

En este artículo se muestra cómo crear un grupo de esquemas con esquemas en un registro de esquemas hospedado en Azure Event Hubs.

Nota:

  • La característica no está disponible en el nivel básico.
  • Asegúrese de que es miembro de uno de estos roles: Propietario, Colaborador o Colaborador del registro de esquema. Para obtener más información sobre el control de acceso basado en roles, consulte Introducción al registro de esquemas.
  • Si el centro de eventos se encuentra en una red virtual, no podrá crear esquemas en Azure Portal a menos que tenga acceso al portal desde una máquina virtual de la misma red virtual.
  • La funcionalidad del Registro de esquemas no se admite para espacios de nombres con un punto de conexión privado habilitado.

Requisitos previos

Cree un espacio de nombres de Event Hubs. También puede usar un espacio de nombres existente.

Creación de un grupo de esquemas

  1. Desplácese a la página Espacio de nombres de Event Hubs.

  2. Seleccione Schema Registry (Registro de esquemas) en el menú de la izquierda. Para crear un grupo de esquemas, seleccione + Schema Group (+ Grupo de esquemas) en la barra de herramientas.

    Imagen que muestra la página del registro de esquema en Azure Portal

  3. En la página Crear grupo de esquemas, siga estos pasos:

    1. Escriba un nombre para el grupo de esquemas.

    2. En Tipo de serialización, seleccione un formato de serialización Avro que se aplique a todos los esquemas del grupo de esquemas. También se admite el formato de serialización JSON (versión preliminar).

    3. Seleccione un modo de compatibilidad para todos los esquemas del grupo. En el caso de Avro, se admiten los modos de compatibilidad con versiones anteriores y posteriores.

    4. Después, seleccione Crear para crear el grupo de esquemas.

      Imagen que muestra la página para crear un grupo de esquemas

  4. Seleccione el nombre del grupo de esquemas en la lista de grupos de esquemas.

    Imagen que muestra el grupo de esquemas en la lista seleccionada.

  5. Verá la página de Grupo de esquemas para el grupo.

    Imagen que muestra la página del grupo de esquemas

Incorporación de un esquema al grupo de esquemas

En esta sección, agregará un esquema al grupo de esquemas mediante Azure Portal.

  1. En la página Grupo de esquemas, seleccione + Schema (+ Esquema) en la barra de herramientas.

  2. En la página Crear esquema, siga estos pasos:

    1. En Nombre, escriba orderschema.

    2. Escriba el siguiente esquema en el cuadro de texto. También puede seleccionar un archivo con el esquema.

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

  3. Seleccione el esquema de la lista de esquemas.

    Imagen que muestra el esquema seleccionado.

  4. Verá la página de Información general del esquema del esquema.

    Imagen que muestra la página de información general del esquema.

  5. Si hay varias versiones de un esquema, se verán en la lista desplegable Versiones. Seleccione una versión para cambiar a ese esquema de versiones.

Creación de una nueva versión del esquema

  1. Actualice el esquema en el cuadro de texto y seleccione Validar. En el ejemplo siguiente, se ha agregado un nuevo campo description al esquema.

    Imagen que muestra la página de actualización del esquema

  2. Revise el estado y los cambios de validación y seleccione Guardar.

    Imagen que muestra la página de revisión que muestra el estado de validación, los cambios y Guardar

  3. Verá que se ha seleccionado 2 para la versión en la página de Información general del esquema.

    Imagen que muestra la nueva versión del esquema

  4. Seleccione 1 para ver la versión 1 del esquema.

Limpieza de recursos

Nota:

No limpie los recursos si desea continuar con el próximo inicio rápido vinculado desde Pasos siguientes.

  1. Desplácese a la página Espacio de nombres de Event Hubs.
  2. Seleccione Schema Registry (Registro de esquemas) en el menú de la izquierda.
  3. Seleccione el grupo de esquemas que creó en este inicio rápido.
  4. En la página Grupo de esquemas, seleccione Eliminar en la barra de herramientas.
  5. En la página Delete Schema Group (Eliminación del grupo de esquemas), escriba el nombre del grupo de esquemas y seleccione Eliminar.

Pasos siguientes