Criar uma versão de tipo

Neste guia, descrevemos como criar uma nova versão de tipo para um tipo existente no Manufacturing Data Engine (MDE).

Antes de começar

Antes de criar uma nova versão de um tipo, leia sobre como criar um tipo.

Restrições de controle de versões

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

As novas versões podem:

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

As novas versões não podem:

Remova campos do esquema de dados.
Mudar o tipo de dados dos campos atuais no esquema de dados.
Marque um atributo opcional como obrigatório no esquema de dados.
Remova as referências ao bucket de metadados.

Criar uma versão de tipo

É possível criar uma versão de tipo que associa um novo bucket de metadados a um tipo 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 da 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 já associado a esse tipo.
EXISTING_BUCKET_VERSION: versão do bucket atual já associada a esse tipo.
NEW_BUCKET_NAME: nome do novo bucket.
NEW_BUCKET_VERSION: a versão do novo bucket.

Console

Para criar uma nova versão de tipo usando o console, abra a guia da seção Tipos.
Todos os tipos disponíveis na instância do MDE estão listados nesta seção. A lista mostra 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 codificado por 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, leva um tempo para o provisionamento. Enquanto os tipos estão sendo provisionados, o status ativo deles é false. Quando estiverem prontos, eles vão aparecer como true.

Para criar uma nova versão de tipo nessa interface da Web, clique no ícone Ações e em Criar nova versão. O seguinte formulário vai aparecer:
A janela Criar nova versão do tipo é aberta com 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. Apenas a mudança na especificação de metadados ou a modificação do esquema de dados acionará uma nova versão de tipo. Modificar o restante dos parâmetros de tipo vai atualizar o tipo, mas não vai exigir uma nova versão.

A especificação de metadados e o esquema de dados podem ser modificados com a 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.