Compartilhar via


Início rápido: Criar um registro de esquema de Hubs de Eventos do Azure com o portal do Azure

Neste início rápido, crie um grupo de esquemas com esquemas em um registro de esquema hospedado pelos Hubs de Eventos do Azure.

O Registro de Esquema do Azure é um recurso dos Hubs de Eventos. Ele fornece um repositório central para esquemas para aplicativos centrados em eventos e mensagens. É uma ferramenta flexível para aplicativos de consumidor e produtor trocarem dados sem precisar gerenciar e compartilhar o esquema. Ele também conta com uma estrutura de governança simples para esquemas reutilizáveis e define a relação entre os esquemas por meio de um constructo de agrupamento (grupos de esquemas). Para saber mais, confira Registro de Esquema do Azure nos Hubs de Eventos.

Observação

  • O recurso não está disponível na camada Básica .
  • Verifique se você é membro de uma destas funções: Proprietário, Colaborador ou Colaborador do Registro de Esquema. Para saber mais, confira Controle de acesso baseado em função no Azure.
  • Se o hub de eventos estiver em uma rede virtual, você não poderá criar esquemas no portal do Azure, a menos que acesse o portal de uma máquina virtual na mesma rede virtual.

Pré-requisitos

Criar um namespace dos Hubs de Eventos. Em vez disso, você pode usar um namespace existente.

Criar um grupo de esquemas

  1. Navegue até a página Namespace dos Hubs de Eventos.

  2. No menu à esquerda, expanda Entidades e selecione o Registro de Esquema.

  3. Para criar um grupo de esquemas, selecione + Grupo de Esquemas.

    Captura de tela mostrando a página Registro de Esquema no portal do Azure

  4. Na página Criar Grupo de Esquemas, siga estas etapas:

    1. Insira um nome para o grupo de esquemas.

    2. Para o tipo de serialização, selecione o formato de serialização Avro. Esse formato se aplica a todos os esquemas no grupo de esquemas. Também há suporte para o formato de serialização JSON (versão prévia).

    3. Selecione um modo de compatibilidade para todos os esquemas no grupo. Para Avro, há suporte para os modos de compatibilidade com versões anteriores e posteriores.

    4. Selecione Criar para criar o grupo de esquemas.

      Captura de tela mostrando a página para criar um grupo de esquemas.

  5. Selecione o nome do grupo de esquemas na lista de grupos de esquemas.

    Captura de tela mostrando o grupo de esquemas na lista selecionada.

  6. Você verá a página Grupo de Esquemas para o grupo.

    Captura de tela mostrando a página Grupo de Esquemas.

Adicionar um esquema ao grupo de esquemas

Nesta seção, você adiciona um esquema ao grupo de esquemas usando o portal do Azure.

  1. Na página Grupo de Esquemas, selecione + Esquema na barra de ferramentas.

  2. Na página Criar Esquema, siga estas etapas:

    1. Para Nome, insira orderschema.

    2. Insira o esquema na caixa de texto a seguir. Em vez disso, você pode selecionar um arquivo com o esquema.

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

  3. Selecione o esquema na lista de esquemas.

    Captura de tela mostrando o esquema selecionado.

  4. Você verá a página Visão Geral do Esquema para o esquema.

    Imagem mostrando a página Visão geral do esquema.

  5. Se houver várias versões de um esquema, você as verá nas versões. Selecione uma versão para alternar para esse esquema de versão.

Criar uma versão do esquema

  1. Atualize o esquema na caixa de texto e selecione Validar. No exemplo a seguir, você adiciona um novo campo chamado description ao esquema.

    Captura de tela mostrando a página Atualizar esquema

  2. Examine o status de validação e as alterações e selecione Salvar.

    Captura de tela mostrando a página Revisão que mostra o status da validação, as alterações e o salvamento.

    Você verá que 2 está selecionado para a versão na página Visão Geral do Esquema.

    Captura de tela mostrando a nova versão do esquema.

  3. Selecione 1 para ver a versão 1 do esquema.

Limpar os recursos

Observação

Não limpe os recursos se quiser continuar para o próximo início rápido vinculado em Próxima etapa.

  1. Navegue até a página Namespace dos Hubs de Eventos.
  2. Selecione Registro de Esquema no menu à esquerda.
  3. Selecione o grupo de esquemas que você criou neste início rápido.
  4. Na página Grupo de esquemas, selecione Excluir na barra de ferramentas.
  5. Na página Excluir grupo de esquemas, digite o nome do grupo de esquemas e selecione Excluir.

Próxima etapa