Inicio rápido: introducción a un escenario de ejemplo de Azure Digital Twins Explorer
Este inicio rápido es una introducción a Azure Digital Twins, en la que se muestra cómo Azure Digital Twins representa los datos y se muestra cómo interactuar con el grafo de gemelos digitales de un edificio físico. Usará el sitio de Azure Portal y Azure Digital Twins Explorer, que es una herramienta para visualizar e interactuar con los datos de Azure Digital Twins en un explorador web.
En este inicio rápido, analizará los modelos de ejemplo pregenerados que definen digitalmente los conceptos de un edificio, un piso y una sala, y usará estas definiciones de modelo para crear gemelos digitales que representen pisos y salas específicos de un edificio físico. Estos gemelos individuales se conectarán a un grafo de gemelos virtual que refleje sus relaciones entre sí, formando una representación digital completa del edificio de ejemplo. El grafo con el que trabajará representa un edificio de dos plantas. Cada una de las plantas contiene salas. El grafo será como el de esta imagen:
Estos son los pasos que usará para explorar el grafo de este artículo:
- Creación de una instancia de Azure Digital Twins y conexión a esta en Azure Digital Twins Explorer.
- Cargar modelos creados previamente y datos de grafos para construir el escenario de ejemplo. Agregue uno o más gemelos manualmente.
- Simule el cambio de datos de IoT y consulte el grafo para ver los resultados.
- Revisión de los aprendizajes de la experiencia.
Nota
Para simplificar, esta guía de inicio rápido no trata la configuración de un flujo de datos dinámico desde dispositivos IoT dentro del entorno modelado ni desde otros orígenes de datos. Para configurar un flujo de datos de un extremo a otro simulado para el gemelo del grafo, consulte los tutoriales: Conexión a una solución de un extremo a otro. Para más información sobre el flujo de datos entre los servicios y la integración de Azure Digital Twins en una solución de IoT más amplia, consulte Entrada y salida de datos.
Requisitos previos
Necesitará una suscripción de Azure para completar esta guía de inicio rápido. Si aún no tiene una, cree una gratis .
También deberá descargar los materiales del grafo de ejemplo usado en el inicio rápido. Utilice las siguientes instrucciones para descargar los archivos necesarios. Más adelante, seguirá más instrucciones para cargarlos en Azure Digital Twins.
Archivos de modelo. Vaya a cada vínculo a continuación, haga clic con el botón derecho en cualquier lugar de la pantalla y seleccione Guardar como en el menú contextual del explorador. Use la ventana Guardar como para guardar el archivo en algún lugar del equipo.
- Building.json: se trata de un archivo de modelo que define digitalmente un edificio. Especifica que los edificios pueden contener plantas.
- Floor.json: se trata de un archivo de modelo que define digitalmente una planta. Especifica que los pisos pueden contener salas.
- Room.json: se trata de un archivo de modelo que define digitalmente una sala. Tiene una propiedad de temperatura.
buildingScenario.xlsx: esta hoja de cálculo contiene los datos de un grafo de gemelos de ejemplo, incluidos cinco gemelos digitales que representan un edificio específico con suelos y salas. Los gemelos se basan en los modelos genéricos y se conectan con relaciones que indican qué elementos se contienen entre sí. En función de la configuración del explorador, al seleccionar este vínculo puede descargar el archivo buildingScenario.xlsx automáticamente en la ubicación de descarga predeterminada, o bien puede abrirlo en el explorador con una opción para descargar. Este es el aspecto de esa opción de descarga en Microsoft Edge:
Sugerencia
Estos archivos son del repositorio Azure Digital Twins Explorer en GitHub. Puede visitar el repositorio para ver otros archivos de ejemplo, código del explorador, etc.
Configuración de Azure Digital Twins
El primer paso para trabajar con Azure Digital Twins es crear una instancia de Azure Digital Twins que contenga todos los datos de grafos. En esta sección, creará una instancia del servicio y la abrirá en Azure Digital Twins Explorer.
Creación de una instancia de Azure Digital Twins
En esta sección, creará una instancia de Azure Digital Twins mediante Azure Portal. Vaya al portal e inicie sesión con sus credenciales.
Una vez en el portal, seleccione Crear un recurso en el menú de la página principal de servicios de Azure, para comenzar.
Busque Azure Digital Twins en el cuadro de búsqueda y elija el servicio Azure Digital Twins en los resultados.
Deje el campo Plan establecido en Azure Digital Twins y seleccione el botónCrear para empezar a crear una nueva instancia del servicio.
Rellene los campos de la pestaña Aspectos básicos de la configuración, incluida su suscripción, el grupo de recursos, la ubicación y un nombre de recurso para la nueva instancia. Active la casilla Assign Azure Digital Twins Data Owner Role (Asignar el rol Propietario de datos de Azure Digital Twins) para concederse permisos para administrar los datos de la instancia.
Nota
Si la casilla Assign Azure Digital Twins Data Owner Role (Asignar el rol Propietario de datos de Azure Digital Twins) está en gris, significa que no tiene permisos en la suscripción de Azure para administrar el acceso de los usuarios a los recursos. Puede seguir creando la instancia en esta sección y, a continuación, debe hacer que alguien con los permisos necesarios le asigne este rol en la instancia antes de completar el resto de esta guía de inicio rápido.
Los roles comunes que cumplen este requisito son propietario, administrador de cuentas o la combinación de administrador de acceso de usuarios y colaborador.
Seleccione Review + Create (Revisar y crear) para terminar de crear la instancia.
Verá una página de resumen que muestra los detalles que ha escrito. Para confirmar y crear la instancia, seleccione Create (Crear).
Esto le llevará a una página de información general que hace un seguimiento del estado de implementación de la instancia.
Espere a que la página diga que la implementación ha finalizado.
Abra la instancia en Azure Digital Twins Explorer.
Cuando termine la implementación de la instancia, use el botón Go to resource (Ir al recurso) para ir a la página de información general de la instancia en el portal.
A continuación, seleccione el botón Azure Digital Twins Explorer (versión preliminar) .
Se abrirá Azure Digital Twins Explorer en una nueva pestaña. Si es la primera vez que usa el Explorador, verá un modal de bienvenida que resume sus características clave.
Azure Digital Twins Explorer podría conectarse automáticamente a su instancia. Si no, verá la pantalla siguiente que le pide especificar una URL de Azure Digital Twins. (Si no ve este cuadro en la pantalla, Azure Digital Twins Explorer ya ha completado este paso automáticamente).
Si ve este cuadro, escriba https:// en el campo, seguido del nombre de host de la instancia (se puede encontrar de nuevo en la página Información general de la instancia en el portal). Estos valores juntos conforman la dirección URL de la instancia. Seleccione Save (Guardar) para conectarse a la instancia.
Importante
Azure Digital Twins Explorer no admite puntos de conexión privados. Si quiere usar Azure Digital Twins Explorer con una instancia de Azure Digital Twins que usa Private Link para deshabilitar el acceso público, puede implementar el código base de Azure Digital Twins Explorer de forma privada en la nube. Para obtener instrucciones sobre cómo hacerlo, consulte Azure Digital Twins Explorer: Running in the cloud (Azure Digital Twins Explorer: Ejecución en la nube).
Compilación del escenario de ejemplo
A continuación, usará Azure Digital Twins Explorer para configurar los modelos de ejemplo y el grafo de gemelos. Comenzará importando los archivos de modelo y el archivo de grafo de gemelos que ha descargado en su máquina en la sección Requisitos previos. A continuación, finalizará el escenario mediante la creación de un gemelo más manualmente.
Modelos
El primer paso en la creación de un grafo de Azure Digital Twins es definir el vocabulario del entorno. Los modelos son definiciones genéricas para cada tipo de entidad que existe en el entorno. Este escenario de creación de ejemplo contiene un edificio, suelos y salas, por lo que necesitará una definición de modelo que describa lo que es un edificio, una definición de modelo que describa lo que es una planta y una definición de modelo que describa lo que es una sala. Más adelante, puede crear gemelos digitales que son instancias de estos modelos, que representan edificios, pisos y salas específicos.
Los modelos de Azure Digital Twins se escriben en lenguaje de definición de gemelos digitales (DTDL), un lenguaje de objetos de datos similar a JSON-LD. Cada modelo describe un único tipo de entidad en términos de sus propiedades, relaciones y componentes.
En este inicio rápido, los archivos del modelo ya se han escrito para usted. Descargó Building.json, Floor.json y Room.json en la sección Requisitos previos y ahora los cargará en la instancia de Azure Digital Twins mediante Azure Digital Twins Explorer.
Carga de los modelos (archivos .json)
En Azure Digital Twins Explorer, siga estos pasos para cargar los modelos building, Floor y Room (los archivos .json que descargó anteriormente).
En el panel Models (Modelos), seleccione el icono Upload a Model (Cargar un modelo) que muestra una flecha que apunta hacia arriba.
En la ventana Abrir que aparece, vaya a la carpeta que contiene los archivos .json descargados en el equipo.
Seleccione Building.json, Floor.json y Room.json y Seleccione Abrir para cargarlos todos a la vez.
Azure Digital Twins Explorer cargará estos archivos del modelo en su instancia de Azure Digital Twins. Deberían aparecer en el panel Modelos con los nombres descriptivos y los identificadores del modelo completos.
Puede seleccionar Ver modelo en cualquiera de las opciones de los modelos para ver el código DTDL que define cada tipo de modelo.
Gemelos y grafo de gemelos
Ahora que se han cargado algunas definiciones de modelo en la instancia de Azure Digital Twins, puede usar estas definiciones para crear gemelos digitales para los elementos del entorno.
Cada gemelo digital de la solución representa una entidad del entorno físico. Puede crear muchos gemelos basados en el mismo tipo de modelo, como varios gemelos de sala que usan el modelo Sala. En este inicio rápido, necesitará un gemelo digital para el edificio y un gemelo digital para cada planta y sala del edificio. Los gemelos se conectarán con relaciones en un grafo gemelo que representa el entorno de creación completo.
En esta sección, cargará un grafo creado previamente que contiene un gemelo de edificio, dos gemelos de planta y dos gemelos de sala.
Importación del grafo (archivo .xlsx)
En Azure Digital Twins Explorer, siga estos pasos para importar el gráfico de ejemplo (el archivo .xlsx que descargó anteriormente).
En el panel Twin Graph (Grafo gemelo), seleccione el icono Import Graph (Importar grafo) que muestra una flecha que apunta a una nube.
En la ventana Abrir, vaya al archivo buildingScenario.xlsx que descargó anteriormente. Este archivo contiene datos gemelos y de relación para el gráfico de ejemplo. seleccione Open(Abrir).
Al cabo de unos segundos, Azure Digital Twins Explorer abre una vista Import (Importar) que muestra una vista previa del grafo que se va a cargar.
Para confirmar la carga del grafo, seleccione el icono Guardar situado en la esquina superior derecha del cuadro panel de vista previa del grafo.
Azure Digital Twins Explorer usará el archivo cargado para crear los gemelos solicitados y las relaciones entre ellos. Asegúrese de que ve el siguiente cuadro de diálogo que indica que la importación se ha realizado correctamente antes de pasar.
Seleccione Close (Cerrar).
El grafo ahora se ha cargado en Azure Digital Twins Explorer y el panel Twin Graph (Graph gemelo) se volverá a cargar. Aparecerá vacío.
Para ver el grafo, seleccione el botón Ejecutar consulta en el panel Explorador de consultas, cerca de la parte superior de la ventana de Azure Digital Twins Explorer.
Esta acción ejecuta la consulta predeterminada para seleccionar y mostrar todos los gemelos digitales. Azure Digital Twins Explorer recupera todos los gemelos y relaciones del servicio, y dibuja el grafo definido por ellos en el panel Twin Graph (Grafo gemelo). Ahora puede ver el grafo cargado del escenario de ejemplo.
Los círculos ("nodos" del grafo) representan los gemelos digitales. Las líneas representan las relaciones. El gemelo BuildingA "contiene" los gemelos Floor0 y Floor1, el gemelo Floor0 "contains" Room0 y el gemelo Floor1 "contains" Room1. Si usa un ratón, puede hacer clic y arrastrar los elementos del gráfico para desplazarlos.
Agregar otro gemelo
Puede seguir editando la estructura de un grafo de gemelos digitales una vez creado. Imagine que otra habitación se ha construido recientemente en Floor1 de este edificio de ejemplo. En esta sección, agregará un nuevo gemelo al grafo para representar la nueva sala.
Para empezar, seleccione el modelo que define el tipo de gemelo que desea crear. En el panel Modelos de la izquierda, abra el menú de opciones del modelo Room. Seleccione Crear un gemelo para crear una nueva instancia de este tipo de modelo.
Escriba Room2 como Nombre del nuevo gemelo y seleccione Guardar. Esto creará un nuevo gemelo digital, que aún no estará conectado mediante relaciones con el resto del gráfico.
A continuación, agregará una relación para mostrar que Floor1 contiene Room2. Use las teclas CTRL/CMD o MAYÚS para seleccionar simultáneamente Floor1 y Room2 en el gráfico. Cuando se seleccionan ambos gemelos, haga clic con el botón derecho en Room2 y elija Agregar relaciones.
Se abrirá el cuadro de diálogo Crear relación que se rellenará previamente con los detalles de una relación "contains" de Floor1 a Room2. Seleccione Guardar.
Ahora Room2 está conectado en el grafo. Si usa un mouse, puede hacer clic y arrastrar los gemelos en el gráfico para organizarlos en la configuración deseada.
Visualización de las propiedades de un gemelo
Puede seleccionar un gemelo para ver una lista de sus propiedades y valores en el panel Propiedades de los gemelos.
Estas son las propiedades de Room0. Observe que Room0 tiene una temperatura de 70.
Estas son las propiedades de Room1. Observe que Room1 tiene una temperatura de 80.
Room2 todavía no tiene valores establecidos para sus propiedades, ya que este gemelo se creó de forma manual. Para establecer sus valores de propiedad, edite los campos para que la humedad sea 50 y la temperatura sea 72. Seleccione el icono Save (Guardar).
Consulta del cambio de datos de IoT
En Azure Digital Twins, puede consultar el gráfico gemelo para responder preguntas sobre su entorno, mediante el lenguaje de consulta estilo SQL Azure Digital Twins. Una forma de consultar los gemelos en el grafo es mediante sus propiedades. Las consultas basadas en propiedades pueden ayudar a responder preguntas (o a identificar valores atípicos) sobre su entorno. En un escenario totalmente conectado, controlado por datos, las propiedades de los gemelos cambiarán con frecuencia en respuesta a los datos de IoT de los sensores del entorno u otros orígenes de datos conectados. En este inicio rápido, cambiará los valores manualmente para simular una lectura de sensor cambiante.
Empiece por ejecutar una consulta para ver cuántos gemelos de su entorno tienen una temperatura superior a 75. Ejecute la siguiente consulta en el panel Explorador de consultas.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Recuerde ver las propiedades de gemelos anteriores a que Room0 tiene una lectura de temperatura de 70, Room1 tiene una lectura de temperatura de 80 y Room2 tiene una lectura de temperatura de 72. Los gemelos edificio y planta no tienen ninguna propiedad de temperatura. Por lo tanto, aquí solo aparece Room1 en los resultados.
Sugerencia
También se admiten en consultas otros operadores de comparación (<,>, = o !=). Puede intentar conectar estos operadores, otros valores u otras propiedades de los gemelos a la consulta para tratar de responder a sus propias preguntas.
Editar datos de temperatura
En una solución de Azure Digital Twins totalmente conectada, los gemelos del gráfico reciben actualizaciones en directo de dispositivos IoT reales y otros orígenes de datos y actualizar sus propiedades automáticamente para que permanezcan sincronizados con su entorno real. Por motivos de simplicidad en este inicio rápido, usará Azure Digital Twins Explorer aquí para establecer manualmente la lectura de temperatura de Room0 en 76.
Para empezar, vuelva a ejecutar la consulta siguiente para seleccionar todos los gemelos digitales. Se mostrará el grafo completo de nuevo en el panel Twin Graph (Grafo gemelo).
SELECT * FROM DIGITALTWINS
Seleccione Room0 para mostrar su lista de propiedades en el panel Propiedades de los gemelos.
Cambie el valor de temperatura de 70 a 76 y seleccione el icono Guardar para actualizar la temperatura.
Después de guardarlo correctamente, verá la ventana de información de revisión que muestra el código de revisión que se usó en segundo plano con las API de Azure Digital Twins para realizar la actualización.
Cierre la información del parche.
Consulta para ver el nuevo resultado
Para ver la nueva temperatura de Room0 reflejada en el grafo, vuelva a ejecutar la consulta anterior para obtener todos los gemelos del entorno con una temperatura superior a 75.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Ahora que se ha cambiado la temperatura de Room0 de 70 a 76, deberían aparecer en el resultado tanto Room0 como Room1.
Revisión y contextualización del aprendizaje
En este inicio rápido, ha creado una instancia de Azure Digital Twins y utilizado Azure Digital Twins Explorer para rellenarla con un escenario de ejemplo. También ha agregado manualmente un gemelo digital.
Después, ha explorado el gráfico, incluyendo...
- El uso de una consulta para responder a una pregunta sobre el escenario.
- La edición de una propiedad en un gemelo digital.
- La ejecución de la consulta de nuevo para ver cómo ha cambiado la respuesta como resultado de la actualización.
La intención de este ejercicio es demostrar cómo puede usar el grafo de Azure Digital Twins para responder a preguntas sobre el entorno, especialmente a medida que cambian los entornos IoT.
En este inicio rápido, realizó la actualización de la temperatura manualmente. Es habitual que Azure Digital Twins conecte gemelos digitales a dispositivos IoT reales para que reciban actualizaciones automáticamente, en función de los datos de telemetría del dispositivo. También puede conectar otros orígenes de datos, integrar datos de diferentes sistemas y definir su propia lógica de actualización de los gemelos. De este modo, puede crear un grafo dinámico que siempre refleje el estado real del entorno. Puede usar consultas para obtener información sobre lo que ocurre en su entorno en tiempo real.
También puede exportar datos de Azure Digital Twins a servicios históricos de seguimiento, análisis de datos e inteligencia artificial para permitir una mayor información y realizar simulaciones de entorno. La integración de Azure Digital Twins en sus soluciones de IoT puede ayudarle a realizar un seguimiento más eficaz del pasado, a controlar el presente y a predecir el futuro.
Limpieza de recursos
Para hacer limpieza después de este inicio rápido, elija los recursos de Azure Digital Twins que quiere quitar en función de los pasos que quiera dar a continuación.
- Si tiene previsto seguir con las guías de inicio rápido y los tutoriales de Azure Digital Twins, puede reutilizar la instancia de este inicio rápido en esos artículos; no es necesario eliminarla.
Si quiere seguir usando la instancia de Azure Digital Twins de este artículo, pero borrar todos sus modelos, gemelos y relaciones, ejecute el siguiente comando de CLI az dt job deletion:
az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -ySi solo desea eliminar algunos de estos elementos, puede usar los comandos az dt twin relationship delete, az dt twin delete y az dt model delete para eliminar de forma selectiva solo los elementos que desea quitar.
Si ya no necesita la instancia Azure Digital Twins, puede eliminarla mediante Azure Portal.
Vuelva a la página Información general de la instancia en el portal. (Si ya ha cerrado esa pestaña, puede volver a encontrar la instancia buscando su nombre en la barra de búsqueda de Azure Portal y seleccionándolo en los resultados de la búsqueda).
Seleccione Eliminar para eliminar la instancia, incluidos todos sus modelos y gemelos.
También puede que desee eliminar los archivos del proyecto de ejemplo de la máquina local.
Pasos siguientes
Vaya al siguiente inicio rápido para visualizar un escenario de Azure Digital Twins en un entorno 3D.
O bien, vaya directamente a los tutoriales para profundizar en los SDK, la creación de grafos gemelos y la configuración del flujo de eventos.