Escenario: Trabajar con gemelos digitales IoT
Para configurar sus gemelos digitales, puede trabajar con las instancias, los adaptadores, las relaciones y los modelos de gemelos digitales.
Utilice estos conceptos para trabajar con recursos gemelos digitales.
Cuando recibe datos no estructurados, debe crear una instancia de gemelo digital. No es necesario un modelo y un adaptador gemelo digital. Consulte Escenario: Envío de datos no estructurados mediante HTTP.
Cuando recibe datos estructurados, debe crear una instancia gemela digital, un modelo y un adaptador.
- Modelos de gemelo digital: un modelo de gemelo digital define la semántica de un gemelo digital y se basa en las especificaciones de DTDL v3. Un gemelo digital utiliza un identificador de modelo de gemelo digital (DTMI) como identificador único.
Por ejemplo:
dtmi:com:yourcompany:iot:example;1 - Adaptadores gemelos digitales: traduce datos a modelos gemelos digitales para instantáneas de datos y, si se configuran, captura datos históricos. Los datos transferidos al adaptador de gemelo digital son un objeto JSON que contiene los datos y la asignación. Los adaptadores gemelos digitales son necesarios para datos estructurados.
- Formato de adaptador predeterminado: si el dispositivo se puede programar para enviar datos en el formato con el que desea trabajar, cree un adaptador gemelo digital predeterminado. Para ver un ejemplo específico, consulte Escenario: Envío de datos estructurados en un formato predeterminado mediante HTTP.
- Formato de adaptador personalizado: si el dispositivo no se puede programar para enviar datos en el formato con el que desea trabajar, cree un adaptador gemelo digital personalizado. Para ver un ejemplo específico, consulte Escenario: Envío de datos estructurados en un formato personalizado mediante HTTP.
- Relaciones digitales gemelas: conecta varias instancias digitales gemelas. Si una relación de gemelo digital se vincula a una instancia de gemelo digital, puede crear un gráfico del gemelo digital y sus relaciones con otras instancias de gemelo digital. Para ver un ejemplo específico, consulte Escenario: Consulta de una relación gemela digital.
Nota
Según la interfaz que utilice, las cargas útiles, las asignaciones de adaptadores, los modelos gemelos digitales, los atributos y las propiedades de los archivos utilizan una convención de mayúsculas/minúsculas diferente. Por ejemplo, la interfaz de API utiliza
Según la interfaz que utilice, las cargas útiles, las asignaciones de adaptadores, los modelos gemelos digitales, los atributos y las propiedades de los archivos utilizan una convención de mayúsculas/minúsculas diferente. Por ejemplo, la interfaz de API utiliza
camelCase y la interfaz de CLI utiliza un formato hyphenated-lowercase. La CLI puede aceptar el formato camelCase o hyphenated-lowercase para el modelo de gemelo digital y los archivos de adaptador de gemelo digital, y utiliza hyphenated-lowercase para los comandos y parámetros. Por ejemplo: - API:
digitalTwinInstanceId - CLI:
digital-twin-instance-id
Conceptos gemelos digitales
Cuando trabaje con sus recursos de gemelos digitales, utilice estos conceptos clave:
- Referencia de archivos JSON para adaptadores y especificaciones de modelos gemelos digitales: según el sistema operativo, puede que tenga una sintaxis ligeramente diferente con comillas, barras diagonales o la ubicación del archivo de forma predeterminada. Cuando carga un adaptador mediante la CLI, puede utilizar archivos JSON para especificar la asignación de datos. Consulte Gestión de entrada y salida de la CLI y Uso de un archivo JSON para entrada compleja.
- Datos de muestra: para configurar y probar la configuración, al crear una instancia de gemelo digital si no incluye una clave externa, se genera automáticamente. Utilice esta clave externa como nombre de usuario del dispositivo para publicar datos.
- Digital Twin Model and Adapter Options: cree un modelo de gemelo digital para definir mediante las especificaciones de DTDL v3 y cree un adaptador de gemelo digital para normalizar los datos del dispositivo para que se ajusten al modelo de gemelo digital.
- Clave externa y autenticación: para probar la configuración de IoT, utilice un secreto de almacén con autenticación básica para ingerir datos de muestra. Cuando envíe datos mediante la instancia de gemelo digital, especifique el nombre de usuario del dispositivo como
--external-keyy--auth-idcomo contraseña del dispositivo.--auth-idpuede ser un secreto de almacén o un certificado mTLS, ya sea un secreto o el OCID del certificado se puede asociar a la instancia de gemelo digital al crear la instancia de gemelo digital o actualizar la instancia de gemelo digital. - Clave externa y certificado mTLS: si utiliza un certificado mTLS en lugar del secreto de almacén, la clave externa debe ser el nombre común del certificado. Para encontrar el nombre común del certificado, puede mostrar los certificados y acceder a los detalles del certificado.
- Relaciones: las instancias de enlace Relaciones Digitales Gemelas suelen ser un origen y un destino, así como una ruta de contenido definida por las relaciones del modelo gemelo digital, por ejemplo,
servedBy.