Inicio rápido: introducción a un escenario de ejemplo de Azure Digital Twins Explorer
En este inicio rápido, explorará un grafo de Azure Digital Twins precompilado con la ayuda de Azure Digital Twins Explorer. Esta herramienta permite visualizar e interactuar con datos de Azure Digital Twins en Azure Portal.
Con Azure Digital Twins, puede crear e interactuar con modelos en directo de entornos del mundo real, que pueden formar parte de soluciones de IoT más amplias. En primer lugar, los elementos individuales se modelan como gemelos digitales. A continuación, se conectan en un grafo de conocimiento que puede dar respuesta a eventos en directo y en el que se puede consultar información.
Deberá completar los pasos siguientes:
- Creación de una instancia de Azure Digital Twins y conexión a esta en Azure Digital Twins Explorer.
- Carga de los modelos precompilados y los datos del grafo para construir el escenario de ejemplo.
- Exploración del grafo del escenario que se crea.
- Realización de cambios en el grafo.
- Revisión de los aprendizajes de la experiencia.
El grafo de ejemplo de Azure Digital Twins con el que va a trabajar representa un edificio de dos plantas y dos salas. Floor0 contiene Room0 y Floor1 contiene Room1. El grafo será como el de esta imagen:
Nota
Este inicio rápido es para explorar un gráfico creado previamente para comprender cómo Azure Digital Twins representa los datos. Para que sea más fácil, esta guía de inicio rápido no trata la configuración de conexiones entre dispositivos de IoT Hub y sus representaciones gráficas. Para configurar un flujo de un extremo a otro conectado para el grafo, consulte los tutoriales: Conexión a una solución de un extremo a otro.
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. Use los vínculos y las instrucciones siguientes para descargar los tres archivos necesarios desde el repositorio digital-twins-explorer de GitHub. Más adelante, seguirá más instrucciones para cargarlos en Azure Digital Twins.
Room.json: se trata de un archivo de modelo que representa una sala de un edificio. Vaya al vínculo, 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 siguiente ventana Guardar como para guardar el archivo en algún lugar del equipo con el nombre Room.json.
Floor.json: se trata de un archivo de modelo que representa una planta de un edificio. Vaya al vínculo, 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 siguiente ventana Guardar como para guardar el archivo en la misma ubicación que el archivo Room.json, con el nombre Floor.json.
buildingScenario.xlsx: este archivo contiene un grafo de gemelos de salas y plantas, así relaciones entre ellos. Vaya al vínculo y seleccione el botón Descargar. El archivo se descargará en la ubicación de descarga predeterminada.
Configuración de Azure Digital Twins
El primer paso para trabajar con Azure Digital Twins es crear una instancia de Azure Digital Twins. Después de crear una instancia del servicio, puede conectarse a la instancia en Azure Digital Twins Explorer, que utilizará para trabajar con la instancia en todo este inicio rápido.
El resto de esta sección le guía a través de estos pasos.
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. Seleccione el botón Crear para crear una nueva instancia del servicio.
Rellene los campos de la pestaña Aspectos básicos de la configuración, incluida la 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.
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á una ventana Azure Digital Twins Explorer conectada a la instancia.
Cargar los datos de ejemplo
A continuación, importará los modelos de ejemplo y el grafo en Azure Digital Twins Explorer. Utilizará los archivos de modelo y el archivo de grafo que ha descargado en su máquina en la sección Requisitos previos.
Modelos
El primer paso en una solución de Azure Digital Twins es definir el vocabulario del entorno. Creará modelos personalizados que describan los tipos de entidad que existen en el entorno.
Cada modelo se escribe en un lenguaje de tipo JSON-LD, conocido como lenguaje de definición de gemelos digitales (DTDL). Cada modelo describe un único tipo de entidad en lo referente a sus propiedades, telemetría, relaciones y componentes. Más adelante, usará estos modelos como base para los gemelos digitales que representan instancias específicas de estos tipos.
Normalmente, cuando se crea un modelo, se realizan tres pasos:
- Escribir la definición del modelo. En el inicio rápido, este paso ya se ha hecho como parte de la solución de ejemplo.
- Validarlo para asegurarse de que la sintaxis sea precisa. En el inicio rápido, este paso ya se ha hecho como parte de la solución de ejemplo.
- Cargarlo en la instancia de Azure Digital Twins.
En este inicio rápido, los archivos del modelo ya se han escrito y validado. Están incluidos en la solución que descargó. En esta sección, se cargarán los dos modelos escritos previamente en la instancia para definir estos componentes de un entorno de edificio:
- Floor
- Sala
Carga de los modelos (archivos .json)
Siga estos pasos para cargar los modelos (los archivos .json que ha descargado anteriormente).
En el panel Modelos, seleccione el icono Upload a Model (Cargar un modelo) que muestra una flecha que apunta a una nube.
En la ventana Abrir que aparece, vaya a la que contiene los archivos Room.json y Floor.json que descargó anteriormente.
Seleccione Room.json y Floor.json, y seleccione Abrir para cargarlos.
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 los iconos de información View Model (Ver modelo) para ver el código DTDL subyacente.
Gemelos y grafo de gemelos
Ahora que se han cargado algunos modelos en la instancia de Azure Digital Twins, puede crear gemelos digitales basados en las definiciones de modelo.
Los gemelos digitales representan las entidades reales dentro del entorno empresarial. Pueden ser cosas como sensores de una granja, luces de un coche o, en este inicio rápido, salas de la planta de un edificio. Puede crear muchos gemelos de un tipo de modelo determinado, como varias salas que usen todas el modelo Room. Estos gemelos se conectan mediante relaciones en un grafo de gemelos que representa todo el entorno.
En esta sección, cargará los gemelos creados previamente que están conectados en un grafo creado previamente. El grafo contiene dos plantas y dos salas, conectadas en el siguiente diseño:
- Floor0
- Contains Room0
- Floor1
- Contains Room1
Importación del grafo (archivo .xlsx)
Siga estos pasos para importar el grafo (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 una descripción del grafo 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. Al terminar, aparecerá un cuadro de diálogo. Seleccione Close (Cerrar).
El grafo ya se ha cargado en Azure Digital Twins Explorer. Vuelva al panel Twin Graph (Grafo gemelo).
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).
Exploración del grafo
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 Floor0 contiene Room0, y el gemelo Floor1 contiene Room1.
Si usa un mouse, puede arrastrar trozos del grafo para moverlos.
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.
Estas son las propiedades de Room0:
Room0 tiene una temperatura de 70.
Estas son las propiedades de Room1:
Room1 tiene una temperatura de 80.
Consulta del grafo
Una de las principales características de Azure Digital Twins es la posibilidad de consultar el gráfico de gemelos de forma fácil y eficaz para responder a las preguntas sobre el entorno.
Una forma de consultar los gemelos en el grafo es mediante sus propiedades. La consulta basada en propiedades puede ayudar a responder a diversas preguntas. Por ejemplo, puede encontrar valores atípicos en el entorno que necesiten atención.
En esta sección, ejecutará una consulta que responda a la pregunta de cuántos gemelos de su entorno tienen una temperatura superior a 75.
Para ver la respuesta, ejecute la siguiente consulta en el panel Explorador de consultas.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Recuerde que, al ver las propiedades de los gemelos anteriores, Room0 tiene una temperatura de 70 y Room1 tiene una temperatura de 80. Por lo tanto, aquí solo aparece Room1 en los resultados.
Sugerencia
También se admiten otros operadores de comparación (<,>, = o !=) en la consulta anterior. Puede intentar conectar estos operadores, otros valores u otras propiedades de los gemelos a la consulta para tratar de responder a sus propias preguntas.
Edición de los datos del grafo
Azure Digital Twins Explorer se puede usar para editar las propiedades de los gemelos representados en el grafo. En esta sección, se va a elevar la temperatura de Room0 a 76.
Para empezar, vuelva a ejecutar la consulta siguiente para seleccionar todos los gemelos digitales. Se mostrará el grafo completo una vez más en el panel Twin Graph (Grafo gemelo).
SELECT * FROM DIGITALTWINS
Seleccione Room0 para mostrar su lista de propiedades en el panel Propiedades.
Las propiedades de esta lista son editables. Seleccione el valor de temperatura 70 para habilitar la entrada de un nuevo valor. Escriba 76 y seleccione el icono Save (Guardar) para actualizar la temperatura a 76.
Ahora verá la ventana Patch Information (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. Seleccione Close (Cerrar).
Ejecución de la consulta para ver el resultado
Para comprobar que el grafo ha registrado correctamente la actualización de la temperatura de Room0, 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, ambos gemelos deberían aparecer en el resultado.
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.
Después, ha explorado el grafo mediante:
- 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, incluso a medida que el entorno cambia.
En este inicio rápido, realizó la actualización de la temperatura manualmente. Es habitual en Azure Digital Twins conectar gemelos digitales a dispositivos IoT reales para que reciban actualizaciones automáticamente, en función de los datos de telemetría. 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.
Limpieza de recursos
Para la limpieza después de este inicio rápido, elija los recursos que desea quitar en función de lo que quiera hacer a continuación.
- Si tiene previsto seguir con 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 que ha configurado en este artículo, pero quiere borrar algunos o todos sus modelos, gemelos y relaciones, puede usar los comandos az dt de la CLI en una ventana de Azure Cloud Shell para eliminar los elementos que quiera quitar.
Si no necesita ninguno de los recursos que creó en este tutorial, puede eliminar la instancia de Azure Digital Twins y todos los demás recursos de este artículo con el comando az group delete. Esto permite eliminar todos los recursos de Azure de un grupo de recursos, así como el grupo en sí.
Importante
La eliminación de un grupo de recursos es irreversible. El grupo de recursos y todos los recursos contenidos en él se eliminan permanentemente. Asegúrese de no eliminar por accidente el grupo de recursos o los recursos equivocados.
Abra Azure Cloud Shell y ejecute el siguiente comando para eliminar el grupo de recursos y todo lo que contiene.
az group delete --name <your-resource-group>
También puede que desee eliminar la carpeta del proyecto de ejemplo de la máquina local.
Pasos siguientes
A continuación, siga con los tutoriales de Azure Digital Twins para crear su propio escenario de Azure Digital Twins y las herramientas de interacción.