Criar uma versão do bucket de metadados

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

Com as versões do bucket de metadados, é possível evoluir o esquema do bucket. Os tipos e analisadores sempre fazem referência a uma versão específica do bucket. Portanto, quando você cria uma nova versão, ela não afeta os pipelines de processamento de dados atuais. Você precisa fazer upgrade dos seus tipos e analisadores ou criar novos para usar a nova versão do bucket. É possível criar uma versão do bucket de metadados usando a API de configuração ou a interface da Web do MDE.

Antes de começar

Este guia exige que você já tenha criado um bucket de metadados para o MDE.

Restrições de controle de versões

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

As novas versões podem:

• Adicione novos campos opcionais.
• Marcar um campo obrigatório como opcional.

As novas versões não podem:

• Remova os campos.
• Mudar o tipo de dados dos campos atuais.
• Marcar um atributo opcional como obrigatório.

Criar uma versão de bucket de metadados

É possível criar uma versão do bucket de metadados usando o terminal ou o console.

REST

Execute a seguinte solicitação de API REST:

POST /metadata/v1/buckets/BUCKET_NAME/versions

{
  "schema": "BUCKET_SCHEMA",
  "provider": "local"
}

Substitua:

• BUCKET_NAME: nome do bucket a ser criado.
• BUCKET_TYPE: tipo do bucket a ser criado. Precisa ser TAG, RECORD ou LOOKUP. O natural_key de uma instância de metadados em um bucket TAG precisa ser um nome de tag. O natural_key de uma instância de metadados em um bucket RECORD pode ser qualquer chave. O natural_key de uma instância de metadados em um bucket LOOKUP pode ser qualquer chave, mas os registros não podem referenciar instâncias em um bucket de pesquisa, e as instâncias não são gravadas em nenhum coletor de dados. Os buckets de pesquisa servem apenas como fonte de dados de referência que podem ser recuperados por um analisador usando a função lookupByKey do Whistle e usados para enriquecer registros.
• BUCKET_SCHEMA: esquema JSON do bucket. O esquema restringe as instâncias que podem ser criadas no bucket.
• INSTANCE_OVERWRITE_MODE: TRUE ou FALSE. Determina se novas instâncias são criadas mesclando a instância fornecida com a mais recente para uma determinada chave natural ou se novas instâncias são criadas conforme fornecidas.

Console

1. Para criar uma nova versão do intervalo de metadados, clique em Criar nova versão na seção METADADOS da interface da Web do MC do Cloud Management:

   

2. Um painel de configuração é exibido com um formulário para atualizar os parâmetros da nova versão do bucket de metadados:

   

   Apenas mudanças compatíveis com versões anteriores são permitidas para novas versões. Para novidades, mudanças e alterações significativas, é necessário criar um novo bucket. No painel, é possível atualizar o seguinte:

   • Modo de atualização da instância: muda o comportamento de ingestão de instâncias do bucket.
   • Esquema de metadados: adicione novos atributos ao esquema atual do bucket.

3. Depois que as mudanças forem implementadas, clique em CRIAR para salvar a nova versão do bucket de metadados.

4. Uma mensagem de erro será exibida se a mudança não for realizada. Uma mensagem de sucesso será mostrada se a mudança for bem-sucedida. O novo número de versão é sequencial e atribuído automaticamente ao bucket.