Escenario: actualización de una instancia gemela digital a una versión compatible del modelo gemelo digital

Actualice una instancia de gemelo digital mediante la creación de una versión menor compatible del modelo de gemelo digital, la creación de un nuevo adaptador de gemelo digital para esa versión de modelo de gemelo digital y, a continuación, la actualización de la instancia de gemelo digital para utilizar el nuevo adaptador de gemelo digital sin suprimir la instancia de gemelo digital.

Utilice este escenario cuando un dispositivo de sustitución o actualizado envíe una unidad de carga útil aditiva, como un nuevo valor de telemetría, y desee mantener la continuidad para la instancia de gemelo digital existente. El modelo de gemelo digital sigue siendo el contrato para los datos normalizados. El adaptador gemelo digital asigna la carga útil del dispositivo entrante a ese contrato.

OCI IoT soporta la actualización de una instancia de gemelo digital activa a un adaptador de gemelo digital diferente cuando el nuevo adaptador de gemelo digital hace referencia a la misma versión de modelo de gemelo digital o a una versión menor superior compatible del mismo modelo de gemelo digital. Este escenario muestra cómo construir sobre un modelo gemelo digital HVAC base y cómo crear una nueva versión de modelo gemelo digital HVAC con un sensor adicional mientras se mantiene intacto el modelo gemelo digital anterior.

Los principales cambios de versión de modelo gemelo digital son incompatibles para este flujo de actualización. Las rebajas no están soportadas.

HVAC significa Calefacción, Ventilación y Aire Acondicionado, refiriéndose a los diferentes sistemas utilizados en los edificios para regular la temperatura interior, la humedad y la calidad general del aire.

Tareas

Revise las reglas de control de versiones de modelos gemelos digitales compatibles.
Cree el modelo gemelo digital de climatización base.
Cree el adaptador gemelo digital HVAC básico.
Cree la instancia de gemelo digital.
Enviar telemetría a la instancia de gemelo digital base.
Cree una versión de gemelo digital menor compatible.
Cree un adaptador gemelo digital para la nueva versión del modelo gemelo digital.
Actualice la instancia de gemelo digital para utilizar el nuevo adaptador de gemelo digital.
Validar telemetría de instancia de gemelo digital después del cambio de versión.
Revise las preguntas frecuentes.
Solución de problemas de cambio de versión del modelo gemelo digital.

Mejores prácticas

Adición de valores a un modelo gemelo digital existente: utilice los pasos de este escenario para crear una versión de DTMI menor para los cambios aditivos del modelo gemelo digital, por ejemplo, cambiar la versión número de 1 a 1.1, esto mantiene la versión principal de DTMI igual al actualizar una instancia de gemelo digital existente a un nuevo adaptador de gemelo digital, como se admite en la Especificación DTDL v3:
De dtmi:com:oracle:example:hvac;1 a dtmi:com:oracle:example:hvac;1.1
Creación de nuevos valores en el modelo de gemelo digital y, a continuación, creación de una nueva instancia de gemelo digital: utilice una nueva versión de DTMI mayor cuando necesite crear un modelo de gemelo digital con diferentes valores. Para este tipo de actualización, debe crear una nueva instancia de gemelo digital con un cambio de versión principal del nuevo modelo de gemelo digital, por ejemplo:
De dtmi:com:oracle:example:hvac;1 a dtmi:com:oracle:example:hvac;2
Se recomienda la herencia: para las actualizaciones menores, la adición de nuevos valores, se recomienda utilizar la herencia para los cambios aditivos del modelo de gemelo digital, como un modelo de gemelo digital que amplía la versión anterior del modelo de gemelo digital. En lugar de redefinir atributos básicos como @id, ubicación o estado del núcleo para cada nueva versión de modelo de gemelo digital, el nuevo modelo de gemelo digital hereda los valores automáticamente, lo que reduce los errores y ahorra tiempo de desarrollo.
Mantenga la telemetría, las propiedades, los comandos, las relaciones y los esquemas existentes compatibles. No cambie el nombre, elimine, limite ni cambie los elementos de contrato existentes durante una actualización secundaria.
Cree un nuevo adaptador gemelo digital para la nueva versión del modelo gemelo digital y mantenga el adaptador gemelo digital anterior disponible para el rollback hasta que se validen los dispositivos actualizados.
Pruebe las cargas útiles con telemetría representativa antes de una implementación de producción.

Descripción de los archivos de este escenario

hvac-model.json: Modelo dual digital DTDL base para la telemetría de temperatura y humedad.
hvac-envelope.json: sobre adaptador doble digital base que extrae timeObserved.
hvac-routes.json: asignación de ruta de adaptador doble digital base para temperatura y humedad.
hvac-e-model.json: versión de modelo doble digital DTDL menor compatible que agrega telemetría de consumo de energía.
hvac-e-envelope.json: sobre de adaptador doble digital actualizado que acepta el campo de telemetría adicional.
hvac-e-routes.json: mapeo de ruta de adaptador doble digital actualizado para temperatura, humedad y consumo de energía.

Paso 1: Revisar las reglas de control de versiones compatibles del modelo gemelo digital

Al crear un modelo de gemelo digital, OCI IoT comprueba si ya existe un modelo de gemelo digital activo para la misma versión principal.

Si existe uno, un nuevo modelo gemelo digital de versión menor debe ser un aditivo estricto con un número de versión y valores compatibles. Cuando actualiza una instancia de gemelo digital para utilizar un adaptador de gemelo digital diferente, el adaptador debe hacer referencia a la misma versión de modelo de gemelo digital o a una versión secundaria superior compatible.

Las siguientes comprobaciones de compatibilidad se aplican entre la antigua versión de modelo gemelo digital y la nueva versión de modelo gemelo digital:

Al crear una interfaz de gemelo digital actualizada y una versión de modelo, la nueva versión secundaria debe ser exactamente la versión secundaria anterior más .1, por ejemplo:

De dtmi:com:oracle:example:hvac;1 a dtmi:com:oracle:example:hvac;1.1

Todos los valores @id de la interfaz, incluidos el esquema y la ruta, deben coincidir; la nueva versión secundaria, las únicas cosas que pueden ser nuevas, son el número de versión con incrementos menores y cualquier valor adicional que se agregue al modelo existente. Las actualizaciones solo son compatibles cuando la versión principal permanece constante y no se modifica.

Elemento DTDL	Regla de compatibilidad	Nota
`Interface`	Los valores `extends` existentes deben ser los mismos. Se permiten extensiones adicionales. Todo el contenido del modelo existente debe permanecer con el mismo nombre. Se permiten nuevos contenidos. Las recopilaciones de esquemas deben tener el mismo tamaño y las mismas rutas de ID de esquema.	La adición de esquemas de interfaz reutilizables no está soportada y se ha rechazado.
`Telemetry`	La telemetría existente debe mantener el mismo nombre, clase DTDL, tipos semánticos o adjuntos, ruta de acceso `@id`, unidad, esquema y restricciones de validación.	`comment`, `displayName` y `description` no se comparan.
`Property`	Las propiedades existentes deben mantener las mismas reglas de contenido, configuración de escritura, esquema, unidad y restricciones de validación.	Se aplica a las propiedades de la interfaz y las propiedades de la relación.
`Command`	Los comandos existentes deben permanecer. La presencia de solicitud y respuesta, los nombres, los esquemas y las restricciones de validación deben coincidir.	Agregar, eliminar o cambiar una solicitud o respuesta es incompatible.
`Relationship`	Las relaciones existentes deben mantener las mismas propiedades de escritura, destino, multiplicidad mínima, multiplicidad máxima y relación existente.	Se permiten nuevas propiedades de relación.
`Component`	El esquema de componente debe seguir siendo el mismo.	La interfaz de componente a la que se hace referencia no se compara de forma recursiva en esta comprobación.
`Schema`	El tipo de esquema concreto debe seguir siendo el mismo. Los esquemas `primitive`, `geospatial`, `array`, `enum`, `map`, `object` y `field` existentes deben conservar tipos compatibles y restricciones de validación.	Los cambios `Primitive-to-object`, `enum-to-map` y similares son incompatibles.
`Enum`	Los valores `enum` existentes deben permanecer con el mismo nombre y valor literal.	Se permiten nuevos valores `enum`.
`Object`	Los campos existentes deben permanecer. Cada esquema de campo existente y cada restricción de validación deben coincidir.	Se permiten nuevos campos `object`.
`Interface schemas`	Cada esquema reutilizable antiguo debe existir en el nuevo modelo de gemelo digital por el mismo esquema y ruta de DTMI y pasar su comparación específica de esquema.	La eliminación o el cambio de un esquema reutilizable existente no son compatibles. Se permiten nuevos esquemas reutilizables cuando están soportados.

Paso 2: Crear el modelo básico HVAC Digital Twin

Cree el modelo gemelo digital base con telemetría de temperatura y humedad.

Utilice la consola para crear el modelo gemelo digital de climatización base en el dominio de IoT.

En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
Seleccione el separador Modelos gemelos digitales y, a continuación, seleccione Crear.
Cargue o pegue el JSON de DTDL desde hvac-model.json.
Seleccione Crear.

hvac-model.json

{
  "@context": [
    "dtmi:dtdl:context;3"
  ],
  "@id": "dtmi:com:oracle:example:hvac;1",
  "@type": "Interface",
  "displayName": "HVAC",
  "description": "A digital twin model for HVAC",
  "contents": [
    {
      "@type": "Telemetry",
      "name": "temperature",
      "schema": "integer"
    },
    {
      "@type": "Telemetry",
      "name": "humidity",
      "schema": "integer"
    }
  ]
}

Utilice el comando oci iot digital-twin-model create para crear el modelo gemelo digital HVAC base en el dominio de IoT.

oci iot digital-twin-model create \
  --iot-domain-id <iot-domain-OCID> \
  --spec file://hvac-model.json

hvac-model.json

{
  "@context": [
    "dtmi:dtdl:context;3"
  ],
  "@id": "dtmi:com:oracle:example:hvac;1",
  "@type": "Interface",
  "displayName": "HVAC",
  "description": "A digital twin model for HVAC",
  "contents": [
    {
      "@type": "Telemetry",
      "name": "temperature",
      "schema": "integer"
    },
    {
      "@type": "Telemetry",
      "name": "humidity",
      "schema": "integer"
    }
  ]
}

Ejecute la operación CreateDigitalTwinModel para crear el modelo gemelo digital de climatización base en el dominio de IoT.
Utilice la misma carga útil de DTDL que se muestra en hvac-model.json al llamar a la API.

Paso 3: Crear el adaptador gemelo digital HVAC base

Cree un adaptador gemelo digital que haga referencia a la versión básica del modelo gemelo digital HVAC y asigne la carga útil del dispositivo a los campos de telemetría de modelo gemelo digital.

Utilice la consola para crear el adaptador gemelo digital HVAC base y cargar o pegar el sobre de entrada y enrutar JSON.
1. En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
2. Seleccione el separador Adaptadores gemelos digitales y, a continuación, seleccione Crear.
3. Introduzca un nombre y una descripción opcional para el adaptador gemelo digital HVAC base.
4. Seleccione el modelo gemelo digital HVAC base con el DTMI dtmi:com:oracle:example:hvac;1.
5. Active Especificar sobre de entrada y rutas y, a continuación, cargue o pegue hvac-envelope.json y hvac-routes.json.
6. Seleccione Crear.
hvac-envelope.json
{ "referenceEndpoint": "/telemetry", "referencePayload": { "dataFormat": "JSON", "data": { "time": 1773768299143534, "temp": 0, "hum": 0 } }, "envelopeMapping": { "timeObserved": "$.time" } }
hvac-routes.json
[ { "condition": "*", "payloadMapping": { "$.temperature": "$.temp", "$.humidity": "$.hum" } } ]

Utilice el comando oci iot digital-twin-adapter create para crear el adaptador gemelo digital HVAC base.

oci iot digital-twin-adapter create \
  --iot-domain-id <iot-domain-OCID> \
  --digital-twin-model-spec-uri "dtmi:com:oracle:example:hvac;1" \
  --inbound-envelope file://hvac-envelope.json \
  --inbound-routes file://hvac-routes.json

hvac-envelope.json

{
  "referenceEndpoint": "/telemetry",
  "referencePayload": {
    "dataFormat": "JSON",
    "data": {
      "time": 1773768299143534,
      "temp": 0,
      "hum": 0
    }
  },
  "envelopeMapping": {
    "timeObserved": "$.time"
  }
}

hvac-routes.json

[
  {
    "condition": "*",
    "payloadMapping": {
      "$.temperature": "$.temp",
      "$.humidity": "$.hum"
    }
  }
]

Ejecute la operación CreateDigitalTwinAdapter para crear el adaptador gemelo digital HVAC base en el dominio de IoT.
Utilice las mismas cargas útiles de rutas de entrada y sobre de entrada que se muestran en los archivos descargables.

Paso 4: Crear la instancia gemela digital

Cree una instancia de gemelo digital que utilice el adaptador de gemelo digital HVAC base. La clave externa es el nombre de usuario que el dispositivo utiliza cuando se conecta.

Use la consola para crear la instancia de gemelo digital para el dispositivo HVAC.
1. En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
2. Seleccione el separador Instancias gemelas digitales y, a continuación, seleccione Crear.
3. Introduzca LG HVAC 1 como nombre mostrado.
4. Seleccione el adaptador gemelo digital HVAC base creado en el Step 3.
5. Seleccione el ID de autenticación o pegue el OCID del certificado o secreto.
6. Introduzca hvac1 como clave externa.
7. Seleccione Crear.

Utilice el comando oci iot digital-twin-instance create para crear la instancia de gemelo digital.

oci iot digital-twin-instance create \
  --iot-domain-id <iot-domain-OCID> \
  --display-name "LG HVAC 1" \
  --auth-id <certificate-or-secret-OCID> \
  --digital-twin-adapter-id <base-digital-twin-adapter-OCID> \
  --external-key hvac1

Ejecute la operación CreateDigitalTwinInstance para crear la instancia de gemelo digital.
Utilice el OCID de adaptador de gemelo digital HVAC base y el ID de autenticación para las credenciales del dispositivo.

Paso 5: Enviar telemetría a la instancia básica de gemelo digital

Envíe una carga útil que coincida con la asignación del adaptador de gemelos digitales base y, a continuación, obtenga el contenido de la instancia de gemelos digitales para verificar la telemetría normalizada.

Utilice MQTTX para enviar telemetría a través de MQTTS.

mqttx pub \
  -t "data" \
  -m '{
    "temp": 70,
    "hum": 60
  }' \
  -u hvac1 \
  -P '<secret-contents>'

Utilice curl para enviar telemetría a través de HTTPS. En este ejemplo se utiliza la autenticación básica HTTP con la clave externa de la instancia de gemelo digital y el contenido del secreto de texto sin formato.
```
curl -i -u "hvac1:<secret-contents>" \
  -H "Content-Type: application/json" \
  -X POST \
  "https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/data" \
  -d '{
    "temp": 70,
    "hum": 60
  }'
```

Obtenga el contenido de la instancia de gemelo digital para verificar los últimos valores normalizados.

En el separador Instancias de gemelos digitales, abra la página de detalles de la instancia de gemelo digital para LG HVAC 1 y revise los valores de contenido más recientes.
Utilice el comando oci iot digital-twin-instance get-content para obtener contenido de la instancia de gemelo digital.
```
oci iot digital-twin-instance get-content \
  --digital-twin-instance-id <lg-hvac-1-OCID>
```
Ejecute la operación GetDigitalTwinInstanceContent para obtener contenido de la instancia de gemelo digital.

Paso 6: Crear una versión compatible del modelo gemelo digital HVAC menor

Cree una versión de gemelo digital menor compatible que extends el modelo de gemelo digital HVAC base y agregue telemetría para el consumo de energía. La versión principal sigue siendo 1 y la versión secundaria aumenta a 1.1.

Utilice la consola para crear la versión de modelo gemelo digital HVAC menor compatible en el dominio de IoT.
1. En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
2. Seleccione el separador Modelos gemelos digitales y, a continuación, seleccione Crear.
3. Cargue o pegue el JSON de DTDL desde hvac-e-model.json.
4. Seleccione Crear.
hvac-e-model.json
{ "@context": [ "dtmi:dtdl:context;3" ], "@id": "dtmi:com:oracle:example:hvac;1.1", "@type": "Interface", "extends": "dtmi:com:oracle:example:hvac;1", "displayName": "HVACe", "description": "A digital twin model for HVACe", "contents": [ { "@type": "Telemetry", "name": "energyConsumption", "schema": "integer" } ] }

Utilice el comando oci iot digital-twin-model create para crear la versión de modelo gemelo digital HVAC menor compatible.

oci iot digital-twin-model create \
  --iot-domain-id <iot-domain-OCID> \
  --spec file://hvac-e-model.json

hvac-e-model.json

{
  "@context": [
    "dtmi:dtdl:context;3"
  ],
  "@id": "dtmi:com:oracle:example:hvac;1.1",
  "@type": "Interface",
  "@extends": "dtmi:com:oracle:example:hvac;1",
  "displayName": "HVACe",
  "description": "A digital twin model for HVACe",
  "contents": [
    {
      "@type": "Telemetry",
      "name": "energyConsumption",
      "schema": "integer"
    }
  ]
}

Ejecute la operación CreateDigitalTwinModel para crear la versión de modelo gemelo digital HVAC menor compatible en el dominio de IoT.
Utilice la misma carga útil de DTDL que se muestra en hvac-e-model.json al llamar a la API.

Paso 7: Crear un adaptador gemelo digital para la nueva versión del modelo gemelo digital

Cree un nuevo adaptador gemelo digital que haga referencia a la versión de modelo gemelo digital HVAC menor compatible y asigne el campo de telemetría adicional.

Utilice la consola para crear el adaptador gemelo digital de climatización actualizado y cargar o pegar el sobre de entrada y enrutar JSON.
1. En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
2. Seleccione el separador Adaptadores gemelos digitales y, a continuación, seleccione Crear.
3. Introduzca un nombre y una descripción opcional para el adaptador gemelo digital HVAC actualizado.
4. Seleccione la versión del modelo gemelo digital HVAC con el DTMI dtmi:com:oracle:example:hvac;1.1.
5. Active Especificar sobre de entrada y rutas y, a continuación, cargue o pegue hvac-e-envelope.json y hvac-e-routes.json.
6. Seleccione Crear.
hvac-e-envelope.json
{ "referenceEndpoint": "/telemetry", "referencePayload": { "dataFormat": "JSON", "data": { "time": 1773768299143534, "temp": 0, "hum": 0, "ec": 0 } }, "envelopeMapping": { "timeObserved": "$.time" } }
hvac-e-routes.json
[ { "condition": "*", "payloadMapping": { "$.temperature": "$.temp", "$.humidity": "$.hum", "$.energyConsumption": "$.ec" } } ]

Utilice el comando oci iot digital-twin-adapter create para crear el adaptador gemelo digital de HVAC actualizado.

oci iot digital-twin-adapter create \
  --iot-domain-id <iot-domain-OCID> \
  --digital-twin-model-spec-uri "dtmi:com:oracle:example:hvac;1.1" \
  --inbound-envelope file://hvac-e-envelope.json \
  --inbound-routes file://hvac-e-routes.json

hvac-e-envelope.json

{
  "referenceEndpoint": "/telemetry",
  "referencePayload": {
    "dataFormat": "JSON",
    "data": {
      "time": 1773768299143534,
      "temp": 0,
      "hum": 0,
      "ec": 0
    }
  },
  "envelopeMapping": {
    "timeObserved": "$.time"
  }
}

hvac-e-routes.json

[
  {
    "condition": "*",
    "payloadMapping": {
      "$.temperature": "$.temp",
      "$.humidity": "$.hum",
      "$.energyConsumption": "$.ec"
    }
  }
]

Ejecute la operación CreateDigitalTwinAdapter para crear el adaptador gemelo digital de HVAC actualizado en el dominio de IoT.
Utilice las mismas cargas útiles de rutas de entrada y sobre de entrada que se muestran en los archivos descargables.

Paso 8: Actualizar la instancia gemela digital para utilizar el nuevo adaptador gemelo digital

Actualice la instancia de gemelo digital existente para hacer referencia al adaptador de gemelo digital para la versión de gemelo digital menor compatible. La instancia de gemelo digital mantiene la misma identidad, clave externa y continuidad de datos mientras comienza a aceptar cargas útiles para el nuevo contrato de modelo de gemelo digital.

Nota

Utilice una nueva instancia de gemelo digital en lugar de actualizar la instancia de gemelo digital existente cuando el modelo de gemelo digital de sustitución utilice una nueva versión principal, elimine elementos existentes, cambie el nombre de los campos, reduzca las restricciones o, de lo contrario, cambie el contrato de modelo de gemelo digital de forma no aditiva.

Utilice la consola para actualizar la instancia de gemelo digital existente para utilizar el adaptador de gemelo digital de HVAC actualizado.
1. En la página de lista Dominios de IoT, abra el dominio de IoT con el que desea trabajar.
2. Seleccione el separador Instancias gemelas digitales.
3. Abra la página de detalles de la instancia de gemelo digital para LG HVAC 1.
4. Seleccione Editar.
5. Cambie el adaptador de gemelo digital al adaptador de gemelo digital de climatización actualizado creado en el Step 7.
6. Guarde los cambios.

Utilice el comando oci iot digital-twin-instance update para actualizar la instancia de gemelo digital.

oci iot digital-twin-instance update \
  --digital-twin-instance-id <lg-hvac-1-OCID> \
  --digital-twin-adapter-id <upgraded-digital-twin-adapter-OCID>

Ejecute la operación UpdateDigitalTwinInstance para actualizar la instancia de gemelo digital.
Defina el ID del adaptador de gemelo digital en el OCID del adaptador de gemelo digital de HVAC actualizado.

Paso 9: Validar la telemetría de instancia gemela digital después de la actualización

Envíe una carga útil que incluya el nuevo campo de telemetría y verifique que el contenido de la instancia de gemelo digital incluya los valores asignados por el adaptador de gemelo digital actualizado.

Si la validación falla, compare el DTMI del modelo gemelo digital, el adaptador gemelo digital --digital-twin-model-spec-uri, la asignación de sobre y la asignación de carga útil de ruta. El adaptador de gemelo digital actualizado debe hacer referencia a la versión de gemelo digital menor compatible y asignar campos de carga útil a los nombres definidos por ese modelo de gemelo digital.

Utilice MQTTX para enviar telemetría a través de MQTTS.

mqttx pub \
  -t "data" \
  -m '{
    "temp": 70,
    "hum": 60,
    "ec": 38
  }' \
  -u hvac1 \
  -P '<secret-contents>'

Utilice curl para enviar telemetría a través de HTTPS. En este ejemplo se utiliza la autenticación básica HTTP con la clave externa de la instancia de gemelo digital y el contenido del secreto de texto sin formato.

curl -i -u "hvac1:<secret-contents>" \
  -H "Content-Type: application/json" \
  -X POST \
  "https://<domain-short-id>.device.iot.<region>.oci.oraclecloud.com/data" \
  -d '{
    "temp": 70,
    "hum": 60,
    "ec": 38
  }'

Paso opcional: Obtener contenido

Obtenga el contenido de la instancia de gemelo digital para verificar los últimos valores normalizados.

En el separador Instancias de gemelos digitales, abra la página de detalles de la instancia de gemelo digital para LG HVAC 1 y revise los valores de contenido más recientes.
Utilice el comando oci iot digital-twin-instance get-content para obtener contenido de la instancia de gemelo digital.
```
oci iot digital-twin-instance get-content \
  --digital-twin-instance-id <lg-hvac-1-OCID>
```
Ejecute la operación GetDigitalTwinInstanceContent para obtener contenido de la instancia de gemelo digital.

Preguntas más frecuentes

En esta sección de preguntas frecuentes se describen las actualizaciones de modelos gemelos digitales compatibles y las unidades de carga útil aditiva.

¿Qué es una unidad de carga útil aditiva?: Una unidad de carga útil aditiva mantiene los campos de carga útil existentes y agrega nuevos campos sin cambiar los nombres de campo, los tipos de dato, el significado, las unidades o las restricciones existentes. En este escenario, la carga útil base { "temp": 70, "hum": 60 } se convierte en { "temp": 70, "hum": 60, "ec": 38 }. La carga útil es aditiva porque temp y hum todavía significan lo mismo y el dispositivo solo agrega ec para el consumo de energía.
¿Cómo se relaciona una unidad de carga útil aditiva con la versión de modelo gemelo digital?: La carga útil del dispositivo y el modelo gemelo digital deben evolucionar juntos. La nueva versión del modelo gemelo digital agrega energyConsumption al tiempo que mantiene la telemetría temperature y humidity existente compatible. El adaptador gemelo digital actualizado asigna el nuevo campo de carga útil ec al nuevo campo de modelo gemelo digital energyConsumption.
¿Qué no es aditivo?: Un cambio no es aditivo si cambia el nombre de un campo existente, elimina un campo existente, cambia un tipo de esquema, cambia unidades o significado, reduce las restricciones de validación, cambia la solicitud de comando o los contratos de respuesta, o se mueve a una versión de modelo gemelo digital principal diferente. Por ejemplo, el cambio de hum a humidityPct o el cambio de temp de un entero a una cadena no es aditivo.
¿Pueden los dispositivos antiguos seguir enviando la carga útil original?: Sí, los dispositivos antiguos pueden seguir enviando los campos originales si la asignación de adaptadores gemelos digitales actualizados aún los maneja. El nuevo campo solo se rellena cuando el dispositivo actualizado lo envía y el adaptador gemelo digital lo asigna al nuevo campo de modelo gemelo digital.

Solución de problemas

Se ha rechazado la solicitud de creación de modelo gemelo digital

La nueva versión del modelo gemelo digital menor puede haber cambiado un elemento de contrato existente en lugar de agregar solo contenido nuevo. Comparar los modelos gemelos digitales DTDL antiguos y nuevos. La telemetría, las propiedades, los comandos, las relaciones, los esquemas y las restricciones de validación existentes deben ser compatibles.

Se ha rechazado la solicitud de actualización de instancia de gemelo digital

El nuevo adaptador gemelo digital puede hacer referencia a una versión de modelo gemelo digital incompatible, una versión principal diferente o una versión anterior. Confirme que el adaptador gemelo digital utiliza la misma versión de modelo gemelo digital o la siguiente versión menor superior compatible, como dtmi:com:oracle:example:hvac;1.1.

La actualización se realiza correctamente, pero el nuevo campo no se almacena

Es posible que la instancia de gemelos digitales siga utilizando el adaptador de gemelos digitales antiguo, o que la asignación de rutas actualizada no asigne el nuevo campo de carga útil. Verifique el OCID del adaptador de gemelo digital de la instancia digital y compruebe que hvac-e-routes.json asigna $.energyConsumption a $.ec.

Falta la telemetría existente después de la actualización

La asignación de adaptadores gemelos digitales actualizada puede haber borrado las asignaciones de carga útil existentes o cambiado la ruta de carga útil. Mantenga las asignaciones existentes para temperature y humidity y, a continuación, agregue la nueva asignación para energyConsumption.

Los dispositivos antiguos fallan después de que la instancia de gemelo digital se mueva al adaptador de gemelo digital actualizado

El adaptador gemelo digital actualizado puede requerir el nuevo campo o dejar de admitir la unidad de carga útil original. Haga que la asignación de adaptadores gemelos digitales sea tolerante a las cargas útiles que no incluyen el nuevo campo, o mueva los dispositivos en grupos más pequeños después de validar cada unidad de carga útil del dispositivo.

Documentación de Oracle Cloud Infrastructure