Scenario: lavorare con IoT Digital Twins
Per impostare i gemelli digitali, è possibile utilizzare istanze, adattatori, relazioni e modelli dei gemelli digitali.
Utilizza questi concetti per lavorare con le risorse digital twin.
Quando ricevi dati non strutturati, devi creare un'istanza digital twin. Non sono necessari un modello e un adattatore digital twin. Vedere Scenario: invio di dati non strutturati mediante HTTP.
Quando si ricevono dati strutturati, è necessario creare un'istanza gemella digitale, un modello e un adattatore.
- Modelli gemelli digitali: un modello gemello digitale definisce la semantica di un gemello digitale e si basa sulle specifiche DTDL v3. Un gemello digitale utilizza un Digital Twin Model Identifier (DTMI) come identificativo univoco.
Ad esempio:
dtmi:com:yourcompany:iot:example;1 - Adattatori gemelli digitali: consente di tradurre i dati in modelli gemelli digitali per gli snapshot di dati e, se configurati, acquisisce i dati storici. I dati passati all'adattatore digital twin sono un oggetto JSON contenente i dati e il mapping. Per i dati strutturati sono necessari adattatori gemelli digitali.
- Formato adattatore predefinito: se il dispositivo può essere programmato per inviare i dati nel formato che si desidera utilizzare, creare un adattatore digital twin predefinito. Per un esempio specifico, vedere Scenario: invio di dati strutturati in un formato predefinito mediante HTTP.
- Formato adattatore personalizzato: se il dispositivo non può essere programmato per inviare i dati nel formato che si desidera utilizzare, creare un adattatore digital twin personalizzato. Per un esempio specifico, vedere Scenario: invio di dati strutturati in un formato personalizzato mediante HTTP.
- Relazioni digital twin: connette più istanze digital twin. Se una relazione gemello digitale si collega a un'istanza gemello digitale, è possibile creare un grafico del gemello digitale e delle relative relazioni con altre istanze gemelli digitali. Per un esempio specifico, vedere Scenario: Query a Digital Twin Relationship.
Nota
A seconda dell'interfaccia utilizzata per i payload, i mapping degli adattatori, i modelli gemelli digitali, gli attributi e le proprietà nei file utilizzano una convenzione di inclusione diversa. Ad esempio, l'interfaccia API utilizza
A seconda dell'interfaccia utilizzata per i payload, i mapping degli adattatori, i modelli gemelli digitali, gli attributi e le proprietà nei file utilizzano una convenzione di inclusione diversa. Ad esempio, l'interfaccia API utilizza
camelCase e l'interfaccia CLI utilizza un formato hyphenated-lowercase. L'interfaccia CLI può accettare il formato camelCase o hyphenated-lowercase per il modello gemello digitale e i file dell'adattatore gemello digitale e utilizza hyphenated-lowercase per comandi e parametri. Ad esempio: - API:
digitalTwinInstanceId - CLI:
digital-twin-instance-id
Concetti sui gemelli digitali
Quando si lavora con le risorse dei gemelli digitali, utilizzare questi concetti chiave:
- Riferire i file JSON per le specifiche e gli adattatori del modello digital twin: a seconda del sistema operativo in uso, è possibile che la sintassi sia leggermente diversa con virgolette, barre o posizione del file per impostazione predefinita. Quando si carica un adattatore utilizzando l'interfaccia CLI, è possibile utilizzare i file JSON per specificare il mapping dei dati. Vedere Gestione dell'input e dell'output CLI e Utilizzo di un file JSON per l'input complesso.
- Dati di esempio: per impostare e sottoporre a test la configurazione, quando si crea un'istanza digital twin se non si include una chiave esterna, questa viene generata automaticamente. Utilizzare questa chiave esterna come nome utente del dispositivo per inviare i dati.
- Opzioni per modello e adattatore Digital Twin: creare un modello gemello digitale per definire utilizzando le specifiche DTDL v3 e creare un adattatore gemello digitale per normalizzare i dati del dispositivo in base al modello gemello digitale.
- Chiave esterna e autenticazione: per eseguire il test della configurazione IoT, utilizzare un segreto vault con l'autenticazione di base per includere dati di esempio. Quando si inviano dati utilizzando l'istanza digital twin, specificare il nome utente per il dispositivo come
--external-keye--auth-idcome password del dispositivo.--auth-idpuò essere un segreto vault o un certificato mTLS, sia esso segreto o OCID del certificato può essere associato all'istanza digital twin quando si crea l'istanza digital twin o si aggiorna l'istanza digital twin. - Chiave esterna e certificato mTLS: se si utilizza un certificato mTLS anziché il segreto del vault, la chiave esterna deve essere il nome comune del certificato. Per trovare il nome comune del certificato, è possibile elencare i certificati e andare ai dettagli del certificato.
- Relazioni: le istanze dei collegamenti Relazioni gemelle digitali sono in genere un'origine e una destinazione, nonché un percorso di contenuto definito dalle relazioni del modello gemello digitale, ad esempio
servedBy.