Förstå Digital Twins-objektmodeller och diagram för rumslig intelligens

Viktigt

En ny version av Azure Digital Twins-tjänsten har släppts. Mot bakgrund av den nya tjänstens utökade funktioner har den ursprungliga Azure Digital Twins-tjänsten (som beskrivs i den här dokumentationsuppsättningen) dragits tillbaka.

Om du vill visa dokumentationen för den nya tjänsten går du till den aktiva Dokumentationen om Azure Digital Twins.

Azure Digital Twins är en Azure IoT-tjänst som driver omfattande virtuella representationer av fysiska miljöer och associerade enheter, sensorer och personer. Det förbättrar utvecklingen genom att organisera domänspecifika begrepp i användbara modeller. Modellerna ligger sedan inom ett diagram med rumslig intelligens. Sådana begrepp modellerar troget relationer och interaktioner mellan personer, utrymmen och enheter.

Digital Twins-objektmodeller beskriver domänspecifika begrepp, kategorier och egenskaper. Modeller är fördefinierade av användare som vill skräddarsy lösningen efter sina specifika behov. Tillsammans utgör dessa fördefinierade Digital Twins-objektmodeller en ontologi. En smart byggnads ontologi beskriver regioner, lokaler, våningar, kontor, zoner, konferensrum och fokusrum. En ontologi för energinät beskriver olika kraftverk, understationer, energiresurser och kunder. Med Digital Twins-objektmodeller och ontologier kan olika scenarier och behov anpassas.

Med Digital Twins-objektmodeller och en ontologi på plats kan du fylla i en rumslig graf. Rumsliga grafer är virtuella representationer av de många relationer mellan utrymmen, enheter och personer som är relevanta för en IoT-lösning. Det här diagrammet visar ett exempel på en rumslig graf som använder en smart byggnads ontologi.

Den rumsliga grafen sammanför utrymmen, enheter, sensorer och användare. Var och en är kopplad till varandra på ett sätt som modellerar den verkliga världen. I det här exemplet har plats 43 fyra våningar, var och en med många olika områden. Användare är associerade med sina arbetsstationer och får åtkomst till delar av diagrammet. En administratör har behörighet att göra ändringar i den rumsliga grafen, medan en besökare har behörighet att endast visa vissa byggnadsdata.

Digital Twins-objektmodeller

Digital Twins-objektmodeller stöder följande huvudkategorier av objekt:

• Blanksteg är virtuella eller fysiska platser, Tenanttill exempel , Customer, Regionoch Venue.
• Enheter är virtuella eller fysiska utrustningsdelar, till exempel AwesomeCompany Device och Raspberry Pi 3.
• Sensorer är objekt som identifierar händelser, AwesomeCompany Temperature Sensor till exempel och AwesomeCompany Presence Sensor.
• Användare identifierar personer och deras egenskaper.

Andra objektkategorier är:

• Resurser är kopplade till ett utrymme och representerar vanligtvis Azure-resurser som ska användas av objekt i den rumsliga grafen, IoTHubtill exempel .
• Blobar är anslutna till objekt (till exempel blanksteg, enheter, sensorer och användare). De används som filer med mime-typ och metadata, mapstill exempel , picturesoch manuals.
• Utökade typer är utökningsbara uppräkningar som utökar entiteter med specifika egenskaper, till exempel SpaceType och SpaceSubtype.
• Ontologier representerar en uppsättning utökade typer, Defaulttill exempel , Building, BACnetoch EnergyGrid.
• Egenskapsnycklar och värden är anpassade egenskaper för utrymmen, enheter, sensorer och användare. De kan användas tillsammans med inbyggda egenskaper, till exempel DeltaProcessingRefreshTime som nyckel och 10 som värde.
• Roller är uppsättningar med behörigheter som tilldelats användare och enheter i den rumsliga grafen, Space Administratortill exempel , User Administratoroch Device Administrator.
• Rolltilldelningar är associationen mellan en roll och ett objekt i den rumsliga grafen. En användare eller ett huvudnamn för tjänsten kan till exempel beviljas behörighet att hantera ett utrymme i den rumsliga grafen.
• Säkerhetsnyckelarkiv tillhandahåller säkerhetsnycklar för alla enheter i hierarkin under ett visst utrymmesobjekt så att enheten kan kommunicera säkert med Digital Twins.
• Användardefinierade funktioner (UDF: er) tillåter anpassningsbar sensortelemetribearbetning i den rumsliga grafen. En UDF kan till exempel:
  • Ange ett sensorvärde.
  • Utför anpassad logik baserat på sensoravläsningar och ange utdata till ett blanksteg.
  • Bifoga metadata till ett blanksteg.
  • Skicka meddelanden när fördefinierade villkor uppfylls. För närvarande kan UDF:er skrivas i JavaScript.
• Matchare är objekt som avgör vilka UDF:er som körs för ett visst telemetrimeddelande.
• Slutpunkter är de platser där telemetrimeddelanden och Digital Twins-händelser kan dirigeras, Event Hubtill exempel , Service Busoch Event Grid.

Diagram för spatial intelligens

Rumslig graf är den hierarkiska grafen över utrymmen, enheter och personer som definierats i Digital Twins-objektmodellen. Den rumsliga grafen stöder arv, filtrering, bläddring, skalbarhet och utökningsbarhet. Du kan hantera och interagera med din rumsliga graf med en samling REST-API:er.

Om du distribuerar en Digital Twins-tjänst i din prenumeration blir du global administratör för rotnoden. Du beviljas sedan automatiskt fullständig åtkomst till hela strukturen. Etablera blanksteg i diagrammet med hjälp av API:et Space. Etablera tjänster med hjälp av enhets-API:et och sensorer med hjälp av sensor-API:et. Verktyg med öppen källkod är också tillgängliga för att etablera grafen i bulk.

Diagramarv. Arv gäller för de behörigheter och egenskaper som härstammar från en överordnad nod till alla noder under den. När en roll till exempel tilldelas en användare på en viss nod har användaren den rollens behörigheter till den angivna noden och varje nod under den. Varje egenskapsnyckel och utökad typ som definierats för en viss nod ärvs av alla noder under noden.

Graffiltrering. Filtrering används för att begränsa begäranderesultat. Du kan filtrera efter ID:er, namn, typer, undertyper, överordnat utrymme och tillhörande blanksteg. Du kan också filtrera efter sensordatatyper, egenskapsnycklar och värden, bläddringar, minLevel, maxLevel och andra OData-filterparametrar.

Diagrambläddring. Du kan bläddra i den rumsliga grafen genom dess djup och bredd. För djup bläddrar du igenom grafen uppifrån och ned eller nedifrån och upp med hjälp av parametrarna traverse, minLevel och maxLevel. Bläddra i diagrammet för att få syskonnoder direkt kopplade till ett överordnat utrymme eller någon av dess underordnade för bredd. När du kör frågor mot ett objekt kan du hämta alla relaterade objekt som har relationer till objektet med hjälp av parametern include för GET-API:erna.

Grafskalbarhet. Digital Twins garanterar grafskalbarhet, så att det kan hantera dina verkliga arbetsbelastningar. Digital Twins kan användas för att representera stora portföljer med fastigheter, infrastruktur, enheter, sensorer, telemetri med mera.

Grafextensibilitet. Använd utökningsbarhet för att anpassa de underliggande Digital Twins-objektmodellerna med nya typer och ontologier. Dina Digital Twins-data kan också berikas med utökningsbara egenskaper och värden.

API:er för diagramhantering med rumslig intelligens

När du har distribuerat Digital Twins från Azure Portal genereras Swagger-URL:en för hanterings-API:erna automatiskt. Den visas i Azure Portal i avsnittet Översikt med följande format.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger

Name	Ersätt med
YOUR_INSTANCE_NAME	Namnet på Digital Twins-instansen
YOUR_LOCATION	Den serverregion som instansen finns i

Det fullständiga URL-formatet visas i den här bilden.

Mer information om hur du använder diagram för rumslig intelligens finns i förhandsversionen av Azure Digital Twins Management-API:er.

Tips

En Swagger-förhandsversion tillhandahålls för att demonstrera API-funktionsuppsättningen. Den finns på docs.westcentralus.azuresmartspaces.net/management/swagger.

Läs mer om hur du använder Swagger.

Alla API-anrop måste autentiseras med OAuth. API:erna följer microsofts riktlinjer för REST API. De flesta API:er som returnerar samlingar stöder OData-systemfrågealternativ.

Nästa steg

• Om du vill veta mer om enhetsanslutning och hur du skickar telemetrimeddelanden till Digital Twins läser du Azure Digital Twins-enhetsanslutning och ingress för telemetri.

• Mer information om begränsningar och begränsningar för hanterings-API:et finns i Hantering och begränsningar för Azure Digital Twins API.