Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Criar um tipo

Este guia descreve como criar um novo tipo no Manufacturing Data Engine (MDE). É possível criar um tipo usando a API de configuração ou a interface da Web do MDE.

Antes de começar

Entre outras configurações, os tipos permitem definir o escopo de contextualização para registros desse tipo, ou seja, os buckets de metadados que podem ou precisam ser usados para contextualizar registros. Se você quiser associar um bucket de metadados a um tipo, primeiro crie o bucket. Para mais informações, consulte Como criar um bucket de metadados.

Nomeação de tipos

Ao criar um tipo, o nome precisa ser exclusivo em uma implantação do MDE. Os nomes de tipos não podem conter espaços ou caracteres especiais, como &, @ ou %.

Criar um tipo

Para criar um tipo com uma associação de bucket de metadados e especificações de armazenamento típicas, use o terminal ou a interface do console.

REST

Execute a seguinte solicitação de API REST:

POST /configuration/v1/types

{
  "archetype": "ARCHETYPE NAME",
  "name": "TYPE_NAME",
  "metadataBuckets": [
    {
      "bucketName": "BUCKET_NAME",
      "version": "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:

ARCHETYPE: nome do arquétipo. Um de DISCRETE_DATA_SERIES, CLUSTERED_DISCRETE_DATA_SERIES, NUMERIC_DATA_SERIES, CLUSTERED_NUMERIC_DATA_SERIES, CONTINUOUS_DATA_SERIES, CLUSTERED_CONTINUOUS_DATA_SERIES.
TYPE_NAME: nome do tipo a ser criado.
BUCKET_NAME: nome do bucket a ser associado a esse tipo.
BUCKET_VERSION: versão do bucket a ser associada a esse tipo.

Console

Para criar um novo tipo usando o console, abra a guia da seção Tipo.
Todos os tipos disponíveis na instância do MDE estão listados nesta 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 após a criação do tipo.
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 uma versão mais antiga 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 no 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. É possível 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.

Cada novo tipo provisiona a própria infraestrutura para armazenar tags e registros para todos os coletores de dados quando é criado. Por exemplo, um novo tipo vai criar uma tabela no BigQuery com o novo tipo e vai preencher automaticamente o esquema correspondente ao arquétipo. Enquanto o tipo é provisionado, ele aparece como Non Active.

Para criar um novo tipo, clique em Adicionar novo tipo. O formulário a seguir vai aparecer:
Para definir um novo tipo , forneça o nome e o arquétipo. Depois que o tipo é criado, o nome e o arquétipo não podem ser alterados. Todos os tipos precisam ter nomes exclusivos diferentes. Os arquétipos precisam ser selecionados na lista de arquétipos disponíveis. Não é possível criar ou modificar arquétipos porque eles fazem parte da configuração do sistema.
Abra a seção Esquema de dados para definir, se necessário, o JSON schema que define o campo de dados do novo tipo:
O esquema de dados precisa ser um JSON Schema válido ou não será aceito. Esse esquema de dados não é aplicado como parte dos pipelines de ingestão. Em versões futuras do MDE, o objeto de dados nas mensagens recebidas será validado em relação ao esquema de dados do tipo. O esquema de dados oferece visibilidade sobre a estrutura do campo de dados disponível nos diferentes coletores de dados. Cada especificação de esquema de dados também precisa ser definida de acordo com as características do arquétipo.
Conclua a definição do novo tipo definindo os buckets de metadados associados ao tipo abrindo a seção Buckets de metadados:
Para adicionar um bucket de metadados ao tipo, clique em ADICIONAR.
Escolha na lista de buckets de metadados disponíveis aqueles que você quer adicionar. Somente a versão mais recente desses buckets é mostrada. As versões do bucket de metadados podem ser atualizadas mais tarde criando uma nova versão do tipo. Um novo selo aparece na seção "Metadados" depois que os buckets são adicionados.
Defina as configurações de armazenamento padrão abrindo a seção Configurações de armazenamento do formulário. Nessa seção, há um botão de alternância para cada coletor de dados disponível nessa instância do MDE.
Selecione cada coletor em que as tags pertencentes a esse tipo serão armazenadas por padrão. A especificação de armazenamento é herdada pelas tags quando elas são criadas. A especificação de armazenamento pode ser modificada no nível da tag a qualquer momento.
Para concluir a definição de um novo tipo , selecione quais transformações estão associadas a ele abrindo a seção Transformar e conectar.
Selecione as transformações a serem associadas ao tipo e defina os parâmetros de acordo com Como configurar uma transformação.
Depois que todos os parâmetros forem adicionados, salve o novo tipo clicando em CRIAR. Se algum dos parâmetros estiver incorreto, uma mensagem de erro será mostrada. Se a operação for bem-sucedida, uma mensagem de confirmação será mostrada.