Criar uma versão de tipo

Este guia descreve como criar uma nova versão de tipo para um tipo atual no Manufacturing Data Engine (MDE).

Antes de começar

Antes de começar a criar uma nova versão de tipo para um tipo atual, você precisa ler sobre como criar um tipo.

Restrições de controle de versão

Ao criar novas versões de um tipo, considere as seguintes limitações:

Novas versões podem :

• Adicionar novos campos opcionais ao esquema de dados.
• Marcar um campo obrigatório como opcional no esquema de dados.
• Adicionar novas referências de bucket de metadados.

Novas versões não podem :

• Remover campos do esquema de dados.
• Mudar o tipo de dados de campos atuais no esquema de dados.
• Marcar um atributo opcional como obrigatório no esquema de dados.
• Remover referências de bucket de metadados.

Criar uma nova versão de tipo

É possível criar uma nova versão de tipo que associa um novo bucket de metadados a um tipo atual que já tem uma associação de bucket de metadados e aplica especificações de armazenamento típicas usando a API ou o console.

REST

Execute a seguinte solicitação de API REST:

POST /configuration/v1/types/TYPE_NAME/versions

{
  "metadataBuckets": [
    {
      "bucketName": "EXISTING_BUCKET_NAME",
      "version": "EXISTING_BUCKET_VERSION"
    },
    {
      "bucketName": "NEW_BUCKET_NAME",
      "version": "NEW_BUCKET_VERSION"
    }
  ],
  "storageSpecs": [
    {
      "sink": "BIG_QUERY",
      "disabled": "false",
      "materializeCloudMetadata": "true"
    },
    {
      "sink": "BIG_TABLE",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "GCS",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_PROTO",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    },
    {
      "sink": "PUBSUB_JSON",
      "disabled": "false",
      "materializeCloudMetadata": "false"
    }
  ]
}

Substitua:

• TYPE_NAME: nome do tipo para o qual uma nova versão é criada.
• EXISTING_BUCKET_NAME: nome do bucket atual já associado a esse tipo.
• EXISTING_BUCKET_VERSION: versão do bucket atual já associado a esse tipo.
• NEW_BUCKET_NAME: nome do novo bucket.
• NEW_BUCKET_VERSION: versão do novo bucket.

Console

1. Para criar uma nova versão de tipo usando o console, abra a guia da seção Tipos.

   

2. Todos os tipos disponíveis na instância do MDE são listados nessa seção. A lista expõe a configuração básica de cada tipo, incluindo:

• Nome: nome exclusivo do tipo. Todos os tipos precisam ter nomes exclusivos diferentes.
• Armazenamento: mostra as especificações de armazenamento atuais associadas ao tipo.
• Arquétipo: mostra o nome do arquétipo que define o tipo. Cada tipo está associado a um arquétipo exclusivo. A associação de arquétipo não pode ser modificada depois que o tipo é criado.
• Versão: número da versão do tipo. Um tipo pode ser versionado. A visualização padrão nessa lista mostra apenas a versão mais recente disponível para o tipo. É possível mostrar versões anteriores desmarcando a caixa de seleção Mostrar mais recente.
• Metadados: renderiza um selo com código de cores para cada bucket de metadados associado ao tipo. Os buckets de metadados de tag são diferenciados dos buckets de metadados de registro usando um ícone específico dentro do selo.
  • Transformações: mostra um selo para cada tipo de transformação associado ao tipo.
• Ativado: mostra um valor true se o tipo estiver ativado e um valor false se não estiver. Os usuários podem ativar ou desativar tipos a qualquer momento.
• Ativo: quando os tipos são criados, eles levam um tempo para serem provisionados. Enquanto os tipos estão sendo provisionados, o status ativo deles é false. Quando estão prontos, eles aparecem como true.

1. Para criar uma nova versão de tipo nessa interface da Web, clique no ícone Ações e em Criar nova versão. O formulário a seguir vai aparecer:

   

2. A opção Criar nova versão de tipo é aberta mostrando um formulário para modificar as configurações do tipo selecionado:

   

A seção superior do formulário mostra o nome e o arquétipo do tipo. Esses atributos não podem ser modificados. Somente a mudança da especificação de metadados ou a modificação do esquema de dados acionará uma nova versão de tipo. A modificação do restante dos parâmetros do tipo vai atualizar o tipo, mas não exigirá uma nova versão.

A especificação de metadados e o esquema de dados podem ser modificados pela adição de novos elementos. No entanto, todas as novas versões de tipo precisam ser compatíveis com versões anteriores. Não é possível remover buckets de metadados para criar uma nova versão do tipo. É possível adicionar novos buckets de metadados abrindo a seção Bucket de metadados.