Confirmar uma revisão de esquema

Este documento mostra como confirmar uma revisão de esquema para tópicos do Pub/Sub.

Antes de começar

Papéis e permissões necessárias

Para receber as permissões necessárias para confirmar uma revisão de esquema e gerenciar esquemas, peça ao administrador para conceder a você opapel do IAM de Editor do Pub/Sub (roles/pubsub.editor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para confirmar uma revisão de esquema e gerenciar esquemas. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para confirmar uma revisão de esquema e gerenciar esquemas:

  • Criar esquema: pubsub.schemas.create
  • Anexar esquema ao tópico: pubsub.schemas.attach
  • Confirmar uma revisão de esquema: pubsub.schemas.commit
  • Excluir um esquema ou uma revisão de esquema: pubsub.schemas.delete
  • Gerar um esquema ou revisões de esquema: pubsub.schemas.get
  • Listar esquemas: pubsub.schemas.list
  • Listar revisões de esquema: pubsub.schemas.listRevisions
  • Reverter um esquema: pubsub.schemas.rollback
  • Validar uma mensagem: pubsub.schemas.validate
  • Gerar a política do IAM para um esquema: pubsub.schemas.getIamPolicy
  • Configurar a política do IAM para um esquema: pubsub.schemas.setIamPolicy

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

É possível conceder papéis e permissões a principais, como usuários, grupos, domínios ou contas de serviço. Você pode criar um esquema em um projeto e anexá-lo a um tópico localizado em um projeto diferente. Verifique se você tem as permissões necessárias para cada projeto.

Revisar um esquema

É possível confirmar uma revisão de esquema usando o Google Cloud console, a CLI gcloud, a API Pub/Sub, ou as bibliotecas de cliente do Cloud.

Confira algumas diretrizes para confirmar uma revisão de esquema:

  • É possível revisar um esquema dentro de restrições específicas:

    • Para esquemas de buffer de protocolo, é possível adicionar ou remover campos opcionais. Não é possível adicionar ou excluir outros campos. Também não é possível editar nenhum campo existente.

    • Para esquemas Avro, consulte a documentação do Avro para conferir as regras sobre a resolução de esquemas. Uma nova revisão precisa seguir as regras como se fosse o esquema do leitor e o esquema do gravador.

    • Um esquema pode ter no máximo 20 revisões por vez. Se você exceder o limite, exclua uma revisão de esquema antes de criar outra.

  • Cada revisão tem um ID exclusivo associado a ela. O ID da revisão é um UUID de oito caracteres gerado automaticamente.

  • Ao atualizar o intervalo de revisão ou a revisão de um esquema usado para validação de tópicos, pode levar alguns minutos para que as mudanças entrem em vigor.

Console

Para criar uma revisão de esquema, siga estas etapas:

  1. No Google Cloud console, acesse a página Esquemas do Pub/Sub.

    Acessar esquemas

  2. Clique no ID do esquema de um esquema existente.

    A página Detalhes do esquema é aberta.

  3. Clique em Criar revisão.

    A página Criar revisão de esquema é aberta.

  4. Faça as mudanças necessárias.

    Por exemplo, para o esquema de amostra no Avro que você criou em Criar um esquema, é possível adicionar um campo opcional extra chamado Price, da seguinte maneira:

     {
   "type": "record",
   "name": "Avro",
   "fields": [
     {
       "name": "ProductName",
       "type": "string",
       "default": ""
     },
     {
       "name": "SKU",
       "type": "int",
       "default": 0
     },
     {
       "name": "InStock",
       "type": "boolean",
       "default": false
     },
     {
       "name": "Price",
       "type": "double",
       "default": "0.0"