Criar instâncias de metadados

Este guia descreve como criar instâncias de metadados na nuvem em buckets de metadados. O Manufacturing Data Engine (MDE) oferece duas maneiras de criar instâncias de metadados:

1. Na API Metadata ou na interface da Web (todos os buckets).
2. Dinamicamente de analisadores (somente buckets de registro e tag).

Antes de começar

Para concluir este guia, você precisa ter criado um bucket de metadados .

Criação de instâncias de metadados na API Metadata ou no console

É possível criar instâncias de metadados na API Metadata ou na interface do MDE. Use a API para carregar instâncias de metadados no MDE de fontes externas e preencher buckets de pesquisa com dados de referência.

Crie uma instância de metadados na nuvem com as instruções a seguir para chamadas da API REST ou do console do Google Cloud:

REST

POST metadata/v1/buckets/BUCKET_NAME/BUCKET_VERSION/instances

{
    "naturalKey": "NATURAL_KEY",
    "instance": METADATA_INSTANCE_OBJECT
}

Substitua:

• BUCKET_NAME pelo nome do bucket em que você quer criar uma instância de metadados.
• BUCKET_VERSION pela versão do bucket de metadados em que você quer criar uma instância de metadados.
• NATURAL_KEY pela chave natural da instância de metadados. Ela precisa ser tagName se BUCKET_NAME corresponder a um bucket de tag. Se BUCKET_NAME corresponder a um bucket de registro e a chave natural for omitida, ela será definida automaticamente como o hash do valor.
• METADATA_INSTANCE_OBJECT pelo objeto da instância de metadados. O objeto da instância de metadados precisa estar em conformidade com o esquema definido para BUCKET_NAME e BUCKET_VERSION.

Console

Abra a seção 'TAGS DA NUVEM' do menu superior da UI para criar uma instância de metadados. A visualização padrão mostra uma lista das tags disponíveis na instância do MDE:

A interface só oferece suporte à edição de buckets de metadados de tag. Outros tipos de instâncias de bucket só podem ser criados usando a API. Para criar uma instância de metadados de tag:

1. Clique no ícone 'AÇÕES' na tag selecionada da lista.

2. Selecione 'Visualizar / editar'.

   

3. No menu lateral 'Editar tag', localize a seção 'Metadados de tag' para editar ou adicionar uma nova instância de metadados.

4. Clique no selo do bucket que você quer implementar. Os atributos do bucket aparecem abaixo.

   

5. Modifique os atributos atuais ou adicione novos, conforme necessário. Esses atributos são editáveis e podem ser modificados.

6. Adicione os valores selecionados em cada caixa do formulário.

7. Depois que a instância for concluída, clique em 'SALVAR'.

8. A instância é validada em relação aos esquemas de bucket. Se a validação for bem-sucedida, a instância será armazenada e uma mensagem de sucesso será exibida. Essa instância se torna a instância válida atual que qualifica os novos registros recebidos para essa tag.

Criação de instâncias de metadados dinamicamente de analisadores

As instâncias de metadados podem ser criadas dinamicamente de analisadores quando você usa o método lookup by value de resolução de referências de instâncias de metadados. Quando você usa o método lookup by value e o valor da instância de metadados mais recente para a chave natural fornecida não existe, o MDE cria automaticamente uma nova instância de metadados para a chave natural do objeto de instância definido no registro proto. Consulte a documentação sobre como resolver o instance_id de metadados pelo valor da instância para mais detalhes.