Cenário: Trabalhando com IoT Gêmeos Digitais
Para configurar seus gêmeos digitais, você pode trabalhar com as instâncias, adaptadores, relacionamentos e modelos de gêmeos digitais.
Use esses conceitos para trabalhar com recursos de gêmeos digitais.
Ao receber dados não estruturados, você deve criar uma instância de gêmeo digital. Um modelo de gêmeo digital e um adaptador não são necessários. Consulte Cenário: Envio de Dados Não Estruturados Usando HTTPs.
Ao receber dados estruturados, você deve criar uma instância gêmea digital, um modelo e um adaptador.
- Modelos de Gêmeos Digitais: Um modelo de gêmeos digitais define a semântica de um gêmeo digital e é baseado nas especificações DTDL v3. Um gêmeo digital usa um Digital Twin Model Identifier (DTMI) como um identificador exclusivo.
Por exemplo:
dtmi:com:yourcompany:iot:example;1 - Adaptadores Gêmeos Digitais: Traduza dados para modelos de gêmeos digitais para instantâneos de dados e, se configurado, captura dados historizados. Os dados transmitidos ao adaptador de gêmeos digitais são um objeto JSON que contém os dados e o mapeamento. Adaptadores de gêmeos digitais são necessários para dados estruturados.
- Formato de adaptador padrão: Se o dispositivo puder ser programado para enviar dados no formato com o qual você deseja trabalhar, crie um adaptador de gêmeo digital padrão. Para obter um exemplo específico, consulte Cenário: Enviando Dados Estruturados em um Formato Padrão usando HTTPs.
- Formato de adaptador personalizado: Se o dispositivo não puder ser programado para enviar dados no formato com o qual você deseja trabalhar, crie um adaptador de gêmeo digital personalizado. Para obter um exemplo específico, consulte Cenário: Enviando Dados Estruturados em um Formato Personalizado usando HTTPs.
- Relacionamentos de Gêmeos Digitais: conecta várias instâncias de gêmeos digitais. Se um relacionamento de gêmeo digital se vincular a uma instância de gêmeo digital, você poderá criar um gráfico do gêmeo digital e seus relacionamentos com outras instâncias de gêmeo digital. Para obter um exemplo específico, consulte Cenário: Consultar um Relacionamento Gêmeo Digital.
Observação
Dependendo da interface, você usa payloads, mapeamentos de adaptador, modelos de gêmeos digitais, atributos e propriedades em seus arquivos, use uma convenção de maiúsculas/minúsculas diferente. Por exemplo, a interface da API usa
Dependendo da interface, você usa payloads, mapeamentos de adaptador, modelos de gêmeos digitais, atributos e propriedades em seus arquivos, use uma convenção de maiúsculas/minúsculas diferente. Por exemplo, a interface da API usa
camelCase e a interface da CLI usa um formato hyphenated-lowercase. A CLI pode aceitar o formato camelCase ou hyphenated-lowercase para o modelo de gêmeo digital e os arquivos do adaptador de gêmeo digital e usa hyphenated-lowercase para comandos e parâmetros. Por exemplo: - API:
digitalTwinInstanceId - CLI:
digital-twin-instance-id
Conceitos de gêmeos digitais
Quando você trabalha com seus recursos de gêmeos digitais, use estes conceitos-chave:
- Arquivos JSON de referência para adaptadores e especificações de modelo de gêmeo digital: Dependendo do seu sistema operacional, você pode ter uma sintaxe ligeiramente diferente com aspas, barras ou localização do arquivo por padrão. Quando você faz upload de um adaptador usando a CLI, pode usar arquivos JSON para especificar o mapeamento de dados. Consulte Gerenciando Entrada e Saída da CLI e Usando um Arquivo JSON para Entrada Complexa.
- Dados de Amostra: Para configurar e testar sua configuração, quando você cria uma instância de gêmeo digital se não incluir uma chave externa, ela é gerada automaticamente. Use essa chave externa como o nome de usuário do dispositivo para publicar dados.
- Opções de Adaptador e Modelo Gêmeo Digital: Crie um modelo gêmeo digital para definir usando as Especificações DTDL v3 e crie um adaptador de gêmeo digital para normalizar os dados do dispositivo para caber no modelo de gêmeo digital.
- Chave Externa e Autenticação : Para testar sua configuração IoT, use um segredo do vault com autenticação básica para ingerir dados de amostra. Quando você envia dados usando a instância do gêmeo digital, especifique o nome de usuário do dispositivo como
--external-keye--auth-idcomo a senha do dispositivo. O--auth-idpode ser um segredo de vault ou um certificado mTLS, um segredo ou o OCID do certificado pode ser associado à instância de gêmeo digital quando você cria a instância de gêmeo digital ou atualiza a instância de gêmeo digital. - Chave Externa e certificado mTLS: Se você usar um certificado mTLS em vez do segredo do vault, a chave externa deverá ser o nome comum do certificado. Para localizar o nome comum do certificado, você poderá listar seus certificados e ir para os detalhes do certificado.
- Relacionamentos: As instâncias de link Relacionamentos Gêmeos Digitais geralmente são uma origem e um destino e também um caminho de conteúdo definido pelos relacionamentos do seu modelo de gêmeo digital, por exemplo,
servedBy.