Dijital TWINS nesne modellerini ve uzamsal zeka grafiğini anlamaUnderstand Digital Twins object models and spatial intelligence graph

Azure dijital TWINS, fiziksel ortamların ve ilişkili cihazların, sensörlerin ve kişilerin kapsamlı sanal sunumlarını destekleyen bir Azure IoT hizmetidir.Azure Digital Twins is an Azure IoT service that powers comprehensive virtual representations of physical environments and associated devices, sensors, and people. Etki alanına özgü kavramları yararlı modellerle düzenleyerek geliştirmeyi geliştirir.It improves development by organizing domain-specific concepts into helpful models. Modeller daha sonra bir uzamsal zeka grafiği içinde bulunur.The models are then situated within a spatial intelligence graph. Bu tür kavramlar, kişiler, boşluklar ve cihazlar arasındaki ilişkileri ve etkileşimleri modelleyin.Such concepts faithfully model the relationships and interactions between people, spaces, and devices.

Dijital TWINS nesne modelleri, etki alanına özgü kavramları, kategorileri ve özellikleri anlatmaktadır.Digital Twins object models describe domain-specific concepts, categories, and properties. Modeller, çözümü belirli gereksinimlerine uyarlamak isteyen kullanıcılar tarafından önceden tanımlanmıştır.Models are predefined by users who want to tailor the solution to their specific needs. Birlikte, bu önceden tanımlanmış dijital TWINS nesne modelleri bir _ontology_yapar.Together, these predefined Digital Twins object models make up an ontology. Akıllı bina ontology bölgeleri, havalandırma, zeminler, ofisleri, bölgeleri, konferans odalarını ve odak odalarını açıklar.A smart building's ontology describes regions, venues, floors, offices, zones, conference rooms, and focus rooms. Energy Grid ontology çeşitli güç istasyonları, alt istasyonlar, enerji kaynakları ve müşteriler hakkında da açıklanmaktadır.An energy grid ontology describes various power stations, substations, energy resources, and customers. Dijital TWINS nesne modelleriyle ve ontoloda, farklı senaryolar ve gereksinimler özelleştirilebilir.With Digital Twins object models and ontologies, diverse scenarios and needs can be customized.

Dijital TWINS nesne modelleriyle ve bir ontology yerinde, _uzamsal bir grafiği_doldurabilirsiniz.With Digital Twins object models and an ontology in place, you can populate a spatial graph. Uzamsal grafikler, bir IoT çözümüyle ilgili olan boşluklar, cihazlar ve kişiler arasındaki birçok ilişkinin sanal temsilleridir.Spatial graphs are virtual representations of the many relationships between spaces, devices, and people that are relevant to an IoT solution. Bu diyagramda, akıllı bina ontology kullanan bir uzamsal grafiğe örnek gösterilmektedir.This diagram shows an example of a spatial graph that uses a smart building's ontology.

Dijital TWINS uzamsal grafik oluşturmaDigital Twins spatial graph building

Uzamsal grafik, boşluk, cihaz, algılayıcı ve Kullanıcı gibi bir araya getirir.The spatial graph brings together spaces, devices, sensors, and users. Her biri gerçek dünyayı modelleyen bir şekilde birbirine bağlanır.Each is linked together in a way that models the real world. Bu örnekte, mekan 43, her biri birçok farklı alana sahip dört katça sahiptir.In this sample, venue 43 has four floors, each with many different areas. Kullanıcılar iş istasyonlarıyla ilişkilendirilir ve grafiğin bölümlerine erişim sağlar.Users are associated with their workstations and given access to portions of the graph. Bir yöneticinin uzamsal grafiğinde değişiklik yapma hakkı vardır. Bu, bir ziyaretçi yalnızca belirli bina verilerini görüntüleme haklarına sahiptir.An administrator has the rights to make changes to the spatial graph, while a visitor has rights to only view certain building data.

Dijital TWINS nesne modelleriDigital Twins object models

Dijital TWINS nesne modelleri bu nesne ana kategorilerini destekler:Digital Twins object models support these main categories of objects:

  • Boşluk , sanal veya fiziksel konumlardır; örneğin, Tenant, Customer, Region ve Venue.Spaces are virtual or physical locations, for example, Tenant, Customer, Region, and Venue.
  • Cihazlar , örneğin AwesomeCompany Device ve Raspberry Pi 3 gibi sanal veya fiziksel donanım parçalarından oluşur.Devices are virtual or physical pieces of equipment, for example, AwesomeCompany Device and Raspberry Pi 3.
  • Algılayıcılar , örneğin AwesomeCompany Temperature Sensor ve AwesomeCompany Presence Sensor gibi olayları algılayan nesnelerdir.Sensors are objects that detect events, for example, AwesomeCompany Temperature Sensor and AwesomeCompany Presence Sensor.
  • Kullanıcılar , iştları ve bunların özelliklerini belirler.Users identify occupants and their characteristics.

Diğer nesne kategorileri şunlardır:Other categories of objects are:

  • Kaynaklar bir alana iliştirilir ve genellikle uzamsal grafikteki nesneler tarafından kullanılacak Azure kaynaklarını temsil eder; örneğin, IoTHub.Resources are attached to a space and typically represent Azure resources to be used by objects in the spatial graph, for example, IoTHub.
  • Bloblar nesnelere (boşluklar, cihazlar, algılayıcılar ve kullanıcılar gibi) eklenir.Blobs are attached to objects (such as spaces, devices, sensors, and users). MIME türü ve meta veriler (örneğin, maps, pictures ve manuals) dosyaları olarak kullanılırlar.They're used as files with mime type and metadata, for example, maps, pictures, and manuals.
  • Genişletilmiş türler , belirli özelliklere sahip varlıkları geliştiren Genişletilebilir numaralandırmalar, örneğin SpaceType ve SpaceSubtype.Extended types are extensible enumerations that augment entities with specific characteristics, for example SpaceType and SpaceSubtype.
  • Ontolo, bir genişletilmiş türler kümesini temsil eder, örneğin, Default, Building, BACnet ve EnergyGrid.Ontologies represent a set of extended types, for example, Default, Building, BACnet, and EnergyGrid.
  • Özellik anahtarları ve değerleri , boşlukların, cihazların, sensörların ve kullanıcıların özel özelliklerdir.Property keys and values are custom characteristics of spaces, devices, sensors, and users. Bunlar, yerleşik özelliklerle birlikte kullanılabilir; Örneğin, anahtar olarak DeltaProcessingRefreshTime ve değer olarak 10.They can be used along with built-in characteristics, for example, DeltaProcessingRefreshTime as key and 10 as value.
  • Roller , uzamsal grafikteki kullanıcılara ve cihazlara atanan izin kümeleridir; örneğin, Space Administrator, User Administrator ve Device Administrator.Roles are sets of permissions assigned to users and devices in the spatial graph, for example, Space Administrator, User Administrator, and Device Administrator.
  • Rol atamaları , uzamsal grafikteki bir rol ve bir nesne arasındaki ilişkidir.Role assignments are the association between a role and an object in the spatial graph. Örneğin, bir kullanıcı veya hizmet sorumlusu, uzamsal grafikteki bir alanı yönetmek için izin verebilir.For example, a user or a service principal can be granted permission to manage a space in the spatial graph.
  • Güvenlik anahtarı depoları , cihazın dijital TWINS ile güvenli bir şekilde iletişim kurmasına izin vermek için belirli bir alan nesnesinin altındaki hiyerarşideki tüm cihazlar için güvenlik anahtarlarını sağlar.Security key stores provide the security keys for all devices in the hierarchy under a given space object to allow the device to securely communicate with Digital Twins.
  • Kullanıcı tanımlı işlevler (UDF 'ler), uzamsal grafik içinde özelleştirilebilir algılayıcı telemetri işlemesine izin verir.User-defined functions (UDFs) allow customizable sensor telemetry processing within the spatial graph. Örneğin, bir UDF şunları yapabilir:For example, a UDF can:
    • Bir algılayıcı değeri ayarlayın.Set a sensor value.
    • Algılayıcı okumaları temelinde özel mantık gerçekleştirin ve çıktıyı bir boşluk olarak ayarlayın.Perform custom logic based on sensor readings, and set the output to a space.
    • Bir alana meta veriler ekleyin.Attach metadata to a space.
    • Önceden tanımlanmış koşullar karşılandığında bildirim gönder.Send notifications when predefined conditions are met. Şu anda, UDF 'ler JavaScript 'te yazılabilir.Currently, UDFs can be written in JavaScript.
  • Eşleştiriciler , belirli bir telemetri iletisi Için hangi UDF 'leri çalıştırılacağını belirleyen nesnelerdir.Matchers are objects that determine which UDFs are executed for a given telemetry message.
  • Uç noktalar telemetri Iletilerinin ve dijital TWINS olaylarının yönlendirilebileceği konumlardır; örneğin, Event Hub, Service Bus ve Event Grid.Endpoints are the locations where telemetry messages and Digital Twins events can be routed, for example, Event Hub, Service Bus, and Event Grid.

Uzamsal zeka grafıSpatial intelligence graph

Uzamsal grafik, dijital TWINS nesne modelinde tanımlanan boşlukların, cihazların ve kişilerin hiyerarşik grafiktir.Spatial graph is the hierarchical graph of spaces, devices, and people defined in the Digital Twins object model. Uzamsal grafik devralma, filtreleme, geçiş, ölçeklenebilirlik ve genişletilebilirliği destekler.The spatial graph supports inheritance, filtering, traversing, scalability, and extensibility. Bir REST API koleksiyonu ile uzamsal grafınızı yönetebilir ve bunlarla etkileşim kurabilirsiniz.You can manage and interact with your spatial graph with a collection of REST APIs.

Aboneliğinizde bir dijital TWINS hizmeti dağıtırsanız, kök düğümün genel yöneticisi olursunuz.If you deploy a Digital Twins service in your subscription, you become the global administrator of the root node. Böylece, tüm yapıya otomatik olarak tam erişim hakkı vermiş olursunuz.You're then automatically granted full access to the entire structure. Boşluk API 'sini kullanarak grafikte boşluk sağlayın.Provision spaces in the graph by using the Space API. Algılayıcı API 'sini kullanarak cihaz API 'sini ve algılayıcıları kullanarak hizmetleri sağlayın.Provision services by using the Device API and sensors by using the Sensor API. Açık kaynak araçları , grafiği toplu olarak sağlamak için de kullanılabilir.Open source tools also are available to provision the graph in bulk.

Grafik devralma.Graph inheritance. Devralma, bir üst düğümden altındaki tüm düğümlere yönelik olan izinler ve özellikler için geçerlidir.Inheritance applies to the permissions and properties that descend from a parent node to all nodes beneath it. Örneğin, bir rol belirli bir düğümdeki bir kullanıcıya atandığında, Kullanıcı o rolün verilen düğüm ve altındaki her düğüm için bu izinlere sahip olur.For example, when a role is assigned to a user on a given node, the user has that role's permissions to the given node and every node below it. Belirli bir düğüm için tanımlanan her özellik anahtarı ve genişletilmiş tür, bu düğümün altındaki tüm düğümler tarafından devralınır.Each property key and extended type defined for a given node is inherited by all the nodes beneath that node.

Grafik filtreleme.Graph filtering. Filtreleme, istek sonuçlarının kapsamını daraltmak için kullanılır.Filtering is used to narrow down request results. Kimlikler, ad, türler, alt türler, üst boşluk ve ilişkili alanlarla filtreleyebilirsiniz.You can filter by IDs, name, types, subtypes, parent space, and associated spaces. Ayrıca, algılayıcı veri türlerine, özellik anahtarlarına ve değerlerine, geçiş, MinLevel, maxlevelve diğer OData filtre parametrelerine göre de filtre uygulayabilirsiniz.You also can filter by sensor data types, property keys and values, traverse, minLevel, maxLevel, and other OData filter parameters.

Grafik geçişi.Graph traversing. Uzamsal grafiği derinliğine ve enine göre çapraz geçiş yapabilirsiniz.You can traverse the spatial graph through its depth and breadth. Derinlemesine geçiş, MinLevelve maxlevelparametrelerini kullanarak grafik yukarıdan aşağıya veya alt alta çapraz geçiş yapın.For depth, traverse the graph top-down or bottom-up by using the parameters traverse, minLevel, and maxLevel. Bir üst alana veya alt öğelerinden birine doğrudan bağlı eşdüzey düğümleri almak için grafiği gezin.Traverse the graph to get sibling nodes directly attached to a parent space or one of its descendants for breadth. Bir nesneyi sorgulayıp, GET API 'lerinin içerme parametresini kullanarak bu nesneyle ilişkiler içeren ilgili tüm nesneleri alabilirsiniz.When you query an object, you can get all related objects that have relationships to that object by using the includes parameter of the GET APIs.

Grafik ölçeklenebilirliği.Graph scalability. Dijital TWINS, grafik ölçeklenebilirliğini garanti eder, böylece gerçek dünyada iş yüklerinizi işleyebilir.Digital Twins guarantees graph scalability, so it can handle your real-world workloads. Dijital TWINS, büyük ölçekli emlak, altyapı, cihaz, sensör, telemetri ve daha fazlasını temsil etmek için kullanılabilir.Digital Twins can be used to represent large portfolios of real estate, infrastructure, devices, sensors, telemetry, and more.

Grafik genişletilebilirliği.Graph extensibility. Temel alınan dijital TWINS nesne modellerini yeni türler ve ontolode ile özelleştirmek için genişletilebilirlik kullanın.Use extensibility to customize the underlying Digital Twins object models with new types and ontologies. Ayrıca, dijital TWINS verileriniz Genişletilebilir Özellikler ve değerlerle de zenginleştirilebilir.Your Digital Twins data also can be enriched with extensible properties and values.

Uzamsal zeka grafik yönetimi API 'LeriSpatial intelligence graph Management APIs

Azure Portaldijital TWINS 'i dağıttıktan sonra, yönetim API 'lerinin Swagger URL 'si otomatik olarak oluşturulur.After you deploy Digital Twins from the Azure portal, the Swagger URL of the Management APIs is automatically generated. Genel bakış bölümündeki Azure Portal aşağıdaki biçimde gösterilir.It's displayed in the Azure portal in the Overview section with the following format.

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
AdıName Şununla değiştirReplace with
YOUR_INSTANCE_NAMEYOUR_INSTANCE_NAME Dijital TWINS örneğinizin adıThe name of your Digital Twins instance
YOUR_LOCATIONYOUR_LOCATION Örneğinizin barındırıldığı sunucu bölgesiWhich server region your instance is hosted on

Tam URL biçimi bu görüntüde görünür.The full URL format appears in this image.

Dijital TWINS Portal Yönetim API 'SIDigital Twins portal Management API

Uzamsal zeka grafiklerini kullanma hakkında daha fazla bilgi için Azure Digital TWINS yönetim API 'Leri gizli Önizleme sayfasını ziyaret edin.For more details on how to use spatial intelligence graphs, visit the Azure Digital Twins Management APIs sneak preview.

İpucu

API özelliği kümesini göstermek için Swagger gizli dizi önizlemesi sağlanır.A Swagger sneak preview is provided to demonstrate the API feature set. Docs.westcentralus.azuresmartspaces.net/Management/Swaggeradresinde barındırılır.It's hosted at docs.westcentralus.azuresmartspaces.net/management/swagger.

Swagger kullanmahakkında daha fazla bilgi edinin.Learn more about how to use Swagger.

Tüm API çağrılarının kimliği, OAuthkullanılarak yapılmalıdır.All API calls must be authenticated by using OAuth. API 'Ler Microsoft REST API yönergeleri kurallarınıizler.The APIs follow Microsoft REST API Guidelines conventions. Koleksiyonları döndüren API 'lerin çoğu OData sistem sorgu seçeneklerini destekler.Most of the APIs that return collections support OData system query options.

Sonraki adımlarNext steps