Hızlı Başlangıç - Azure Digital Twins Gezgini'nde örnek bir senaryoyla çalışmaya başlama
Bu hızlı başlangıçta, Azure Digital Twins'in verileri nasıl temsil ettiği ve fiziksel bir binanın dijital ikiz grafiğiyle etkileşim kurmanın nasıl bir şey olduğunu gösteren Azure Digital Twins'e giriş niteliğindedir. Azure portal sitesini ve Bir web tarayıcısında Azure Digital Twins verilerini görselleştirmeye ve bunlarla etkileşime geçişe yönelik bir araç olan Azure Digital Twins Gezgini'ni kullanacaksınız.
Bu hızlı başlangıçta, Bina, Kat ve Oda kavramlarını dijital olarak tanımlayan önceden oluşturulmuş örnek modellere göz atacak ve bu model tanımlarını kullanarak fiziksel bir binadaki belirli zeminleri ve odaları temsil eden dijital ikizler oluşturacaksınız. Bu ikizler, birbirleriyle ilişkilerini yansıtan bir sanal ikiz grafiğine bağlanarak örnek binanın tam bir dijital gösterimini oluşturur. Üzerinde çalışacağınız grafik, iki katlı ve her katta oda bulunan bir binayı temsil eder. Grafik şu görüntüye benzer olacaktır:
Bu makaledeki grafiği keşfetmek için kullanacağınız adımlar şunlardır:
- Bir Azure Digital Twins örneği oluşturun ve bunu Azure Digital Twins Gezgini'nde açın.
- Örnek senaryoyu oluşturmak için önceden oluşturulmuş modelleri ve grafik verilerini karşıya yükleyin. El ile bir ikiz daha ekleyin.
- IoT verilerini değiştirme simülasyonu ve sonuçları görmek için grafı sorgulama.
- Deneyimden öğrendiklerinizi gözden geçirin.
Not
Kolaylık olması için bu hızlı başlangıç, modellenmiş ortamdaki IoT cihazlarından veya diğer veri kaynaklarından canlı veri akışı ayarlamayı kapsamaz. İkiz grafınızı yönlendiren sanal bir uçtan uca veri akışı ayarlamak için öğreticilere geçin: Uçtan uca çözüm Bağlan. Hizmetler arasındaki veri akışı ve Azure Digital Twins'i daha geniş bir IoT çözümüyle tümleştirme hakkında daha fazla bilgi için bkz . Veri girişi ve çıkışı.
Önkoşullar
Bu hızlı başlangıcı tamamlamak için bir Azure aboneliğine ihtiyacınız olacaktır. Henüz bir tane yoksa, şimdi ücretsiz bir tane oluşturun.
Ayrıca hızlı başlangıçta kullanılan örnek grafın malzemelerini de indirmeniz gerekir. Gerekli dosyaları indirmek için aşağıdaki yönergeleri kullanın. Daha sonra, bunları Azure Digital Twins'e yüklemek için daha fazla yönergeyi izleyeceksiniz.
Model dosyaları. Aşağıdaki her bağlantıya gidin, ekranda herhangi bir yere sağ tıklayın ve tarayıcınızın sağ tıklama menüsünden Farklı kaydet'i seçin. Dosyayı makinenizde bir yere kaydetmek için Farklı Kaydet penceresini kullanın.
- Building.json: Bu, bir binayı dijital olarak tanımlayan bir model dosyasıdır. Binaların kat içerebileceğini belirtir.
- Floor.json: Bu, bir katı dijital olarak tanımlayan bir model dosyasıdır. Zeminlerin oda içerebileceğini belirtir.
- Room.json: Bu, bir odayı dijital olarak tanımlayan bir model dosyasıdır. Sıcaklık özelliği vardır.
buildingScenario.xlsx: Bu elektronik tablo, zeminleri ve odaları olan belirli bir binayı temsil eden beş dijital ikiz de dahil olmak üzere örnek ikiz grafiğinin verilerini içerir. İkizler genel modelleri temel alır ve hangi öğelerin birbirini içerdiğini gösteren ilişkilerle bağlanır. Tarayıcı ayarlarınıza bağlı olarak, bu bağlantının seçilmesi buildingScenario.xlsx dosyasını otomatik olarak varsayılan indirme konumunuza indirebilir veya dosyayı tarayıcınızda indirme seçeneğiyle açabilir. Microsoft Edge'de bu indirme seçeneği şöyle görünür:
İpucu
Bu dosyalar GitHub'daki Azure Digital Twins Gezgini deposundan alınıyor. Diğer örnek dosyalar, gezgin kodu ve daha fazlası için depoyu ziyaret edebilirsiniz.
Azure Digital Twins'i ayarlama
Azure Digital Twins ile çalışmanın ilk adımı, tüm grafik verilerinizi barındıracak bir Azure Digital Twins örneği oluşturmaktır. Bu bölümde hizmetin bir örneğini oluşturacak ve Azure Digital Twins Gezgini'nde açacaksınız.
Azure Digital Twins örneği oluşturma
Bu bölümde, Azure portalını kullanarak yeni bir Azure Digital Twins örneği oluşturacaksınız. Portala gidin ve kimlik bilgilerinizle oturum açın.
Portala girdikten sonra, Azure hizmetleri giriş sayfası menüsünde Kaynak oluştur'u seçerek başlayın.
Arama kutusunda Azure Digital Twins'i arayın ve sonuçlardan Azure Digital Twins hizmetini seçin.
Plan alanını Azure Digital Twins olarak bırakın ve Hizmetin yeni bir örneğini oluşturmaya başlamak için Oluştur düğmesini seçin.
Aboneliğiniz, Kaynak grubunuz, yeni örneğiniz için bir Kaynak adı ve Bölge dahil olmak üzere kurulumun Temel Bilgiler sekmesindeki alanları doldurun. Örneğinizdeki verileri yönetmek için kendinize izin vermek için Azure Digital Twins Veri Sahibi Rolü Ata kutusunu işaretleyin.
Not
Azure Digital Twins Veri Sahibi Rolü Ata kutusu griyse, Azure aboneliğinizde kaynaklara kullanıcı erişimini yönetme izniniz olmadığı anlamına gelir. Bu bölümde örneği oluşturmaya devam edebilirsiniz ve bu hızlı başlangıcın geri kalanını tamamlamadan önce gerekli izinlere sahip birinin size örnekte bu rolü atamasını sağlayabilirsiniz.
Bu gereksinimi karşılayan yaygın roller Sahip, Hesap yöneticisi veya Kullanıcı Erişimi Yönetici istrator ve Katkıda Bulunan birleşimidir.
Örneğinizi oluşturmayı tamamlamak için Gözden Geçir + Oluştur'u seçin.
Girdiğiniz ayrıntıları gösteren bir özet sayfası görürsünüz. Oluştur'u seçerek örneği onaylayın ve oluşturun.
Bu işlem sizi örneğin dağıtım durumunu izleyen bir Genel Bakış sayfasına götürür.
Sayfanın dağıtımınızın tamamlandığını söylemesini bekleyin.
Azure Digital Twins Gezgini'nde örnek açma
Dağıtım tamamlandıktan sonra kaynağa git düğmesini kullanarak portalda örneğin Genel Bakış sayfasına gidin.
Ardından Azure Digital Twins Gezgini'ni aç (önizleme) düğmesini seçin.
Bu işlem Azure Digital Twins Gezgini'ni yeni bir sekmede açar. Explorer'ı ilk kez kullanıyorsanız, temel özelliklerini özetleyen bir hoş geldiniz modalini görürsünüz.
Azure Digital Twins Gezgini örneğinize otomatik olarak bağlanabilir. Aksi takdirde azure digital twins URL'sini belirtmenizi isteyen aşağıdaki ekranı görürsünüz. (Ekranınızda bu kutuyu görmüyorsanız Azure Digital Twins Gezgini bu adımı otomatik olarak tamamlamıştır.)
Bu kutuyu görürseniz, alana https:// girin ve ardından örneğinizin ana bilgisayar adını girin (bu, örneğin portaldaki Genel Bakış sayfasında bulunabilir). Bu değerler birlikte örnek URL'sini oluşturur. Örneğine bağlanmak için Kaydet'i seçin.
Önemli
Azure Digital Twins Gezgini özel uç noktaları desteklemez . Azure Digital Twins Gezgini'ni genel erişimi devre dışı bırakmak için Özel Bağlantı kullanan bir Azure Digital Twins örneğiyle kullanmak istiyorsanız Azure Digital Twins Gezgini kod tabanını bulutta özel olarak dağıtabilirsiniz. Bunun nasıl yapılacağını açıklayan yönergeler için bkz . Azure Digital Twins Gezgini: Bulutta çalıştırma.
Örnek senaryoyu oluşturma
Ardından örnek modelleri ve ikiz grafını ayarlamak için Azure Digital Twins Gezgini'ni kullanacaksınız. İlk olarak, Önkoşullar bölümünde makinenize indirdiğiniz model dosyalarını ve ikiz graf dosyasını içeri aktaracaksınız. Ardından el ile bir ikiz daha oluşturarak senaryoyu tamamlayacaksınız.
Modeller
Azure Digital Twins grafı oluşturmanın ilk adımı, ortamınız için kelime dağarcığını tanımlamaktır. Modeller , ortamınızda var olan her varlık türü için genel tanımlardır. Bu örnek bina senaryosu bir bina, zemin ve odalar içerdiği için Bir Bina'nın ne olduğunu açıklayan bir model tanımına, Floor'ın ne olduğunu açıklayan bir model tanımına ve Oda'nın ne olduğunu açıklayan bir model tanımına ihtiyacınız olacaktır. Daha sonra, belirli binaları, zeminleri ve odaları temsil eden bu modellerin örnekleri olan dijital ikizler oluşturabilirsiniz.
Azure Digital Twins modelleri, JSON-LD'ye benzer bir veri nesnesi dili olan Digital Twin Definition Language (DTDL) ile yazılır. Her model özellikleri, ilişkileri ve bileşenleri açısından tek bir varlık türünü açıklar.
Bu hızlı başlangıçta model dosyaları sizin için zaten yazılmıştır. Önkoşullar bölümünde Building.json, Floor.json ve Room.jsonindirdiğinize göre şimdi bunları Azure Digital Twins Gezgini'ni kullanarak Azure Digital Twins örneğine yükleyeceksiniz.
Modelleri karşıya yükleme (.json dosyaları)
Azure Digital Twins Gezgini'nde, Bina, Kat ve Oda modellerini (daha önce indirdiğiniz .json dosyaları) karşıya yüklemek için bu adımları izleyin.
Modeller panelinde, yukarıyı gösteren bir ok gösteren Modeli Karşıya Yükle simgesini seçin.
Açılan Aç penceresinde, makinenizde indirilen .json dosyalarını içeren klasöre gidin.
Building.json, Floor.json ve Room.json seçin ve tümünü bir kerede karşıya yüklemek için Aç'ı seçin.
Azure Digital Twins Gezgini bu model dosyalarını Azure Digital Twins örneğine yükler. Modeller panelinde görünerek kolay adlarını ve tam model kimliklerini görüntülemeleri gerekir.
Her model türünü tanımlayan DTDL kodunu görmek için modellerin seçeneklerinden herhangi birinden Modeli Görüntüle'yi seçebilirsiniz.
İkizler ve ikiz grafı
Azure Digital Twins örneğinize bazı model tanımları yüklendiğine göre, ortamınızdaki öğeler için dijital ikizler oluşturmak için bu tanımları kullanabilirsiniz.
Çözümünüzdeki her dijital ikiz, fiziksel ortamdaki bir varlığı temsil eder. Tümü Oda modelini kullanan birden çok oda ikizleri gibi aynı model türünü temel alan birçok ikiz oluşturabilirsiniz. Bu hızlı başlangıçta, bina için bir dijital ikize ve binadaki her kat ve oda için dijital ikize ihtiyacınız olacak. İkizler, ilişkilerle tam yapı ortamını temsil eden bir ikiz grafiğine bağlanır.
Bu bölümde, bina ikizleri, iki kat ikizleri ve iki oda ikizlerini içeren önceden oluşturulmuş bir grafiği karşıya yükleyeceksiniz.
Grafiği içeri aktarma (.xlsx dosyası)
Azure Digital Twins Gezgini'nde örnek grafiği ( daha önce indirdiğiniz .xlsx dosyası) içeri aktarmak için bu adımları izleyin.
İkiz Graf panelinde, buluta işaret eden bir ok gösteren Grafı İçeri Aktar simgesini seçin.
Aç penceresinde, daha önce indirdiğiniz buildingScenario.xlsx dosyasına gidin. Bu dosya örnek grafın ikiz ve ilişki verilerini içerir. Aç'ı seçin.
Birkaç saniye sonra Azure Digital Twins Gezgini, yüklenecek grafiğin önizlemesini gösteren İçeri Aktarma görünümünü açar.
Grafı içeri aktarma işlemini tamamlamak için grafik önizleme panelinin sağ üst köşesindeki Kaydet simgesini seçin.
Azure Digital Twins Gezgini, istenen ikizleri ve aralarındaki ilişkileri oluşturmak için karşıya yüklenen dosyayı kullanır. Devam etmeden önce içeri aktarma işleminin başarılı olduğunu gösteren aşağıdaki iletişim kutusunu gördüğünüzden emin olun.
Kapat'ı seçin.
Graf artık Azure Digital Twins Gezgini'ne yüklendi ve İkiz Grafik paneli yeniden yüklenecek. Boş görünür.
Grafiği görmek için Azure Digital Twins Gezgini penceresinin üst kısmındaki Sorgu Gezgini panelinde Sorgu çalıştır düğmesini seçin.
Bu eylem, tüm dijital ikizleri seçmek ve görüntülemek için varsayılan sorguyu çalıştırır. Azure Digital Twins Gezgini hizmetten tüm ikizleri ve ilişkileri alır. İkiz Graf panelinde onlar tarafından tanımlanan grafiği çizer. Artık örnek senaryonun karşıya yüklenen grafiğini görebilirsiniz.
Daireler ("düğümler") dijital ikizleri temsil eder. Çizgiler ilişkileri temsil eder. BuildingA ikizi Floor0 ve Floor1 ikizlerini "içerir", Floor0 ikiz "içerir" Room0 ve Floor1 ikiz "içerir" Room1. Fare kullanıyorsanız, öğeler arasında gezinmek için grafiğe tıklayıp sürükleyebilirsiniz.
Başka bir ikiz ekleme
Dijital ikiz grafiği oluşturulduktan sonra yapısını düzenlemeye devam edebilirsiniz. Bu örnek binanın Floor1'inde yakın zamanda başka bir oda inşa edildiğini düşünün. Bu bölümde, yeni odayı temsil etmek için grafiğe yeni bir ikiz ekleyeceksiniz.
Oluşturmak istediğiniz ikiz türünü tanımlayan modeli seçerek başlayın. Soldaki Modeller panelinde Oda modeli için seçenekler menüsünü açın. Bu model türünün yeni bir örneğini oluşturmak için İkiz Oluştur'u seçin.
Yeni İkiz adı için Room2 girin ve Kaydet'i seçin. Bu, henüz grafın geri kalanıyla ilişkiler tarafından bağlanmamış yeni bir dijital ikiz oluşturur.
Ardından Floor1'in Room2 içerdiğini göstermek için bir ilişki ekleyeceksiniz. Grafikte Floor1 ve Room2'yi aynı anda seçmek için CTRL/CMD veya SHIFT tuşlarını kullanın. İkiz de seçildiğinde, Oda2'ye sağ tıklayın ve İlişki ekle'yi seçin.
Bu, Floor1 ile Room2 arası bir "içerir" ilişkisinin ayrıntılarıyla önceden doldurulmuş bir İlişki Oluştur iletişim kutusunu açar. Kaydet'i seçin.
Artık Room2 grafikte bağlantılıdır. Fare kullanıyorsanız, grafikteki ikizleri tıklayıp sürükleyerek istediğiniz bir yapılandırmaya yerleştirebilirsiniz.
İkiz özelliklerini görüntüleme
İkiz özelliklerini ve değerlerinin listesini İkiz Özellikleri panelinde görmek için bir ikiz seçebilirsiniz.
Room0'un özellikleri aşağıdadır. Room0'un sıcaklığı 70 olduğuna dikkat edin.
Room1'in özellikleri aşağıdadır. Room1'in sıcaklığı 80 olduğuna dikkat edin.
Bu ikiz el ile oluşturulduğundan Room2'nin henüz özellikleri için ayarlanmış değerleri yok. Özellik değerlerini ayarlamak için alanları nem 50 ve sıcaklık 72 olacak şekilde düzenleyin. Kaydet simgesini seçin.
IoT verilerini değiştirme sorgusu
Azure Digital Twins'de, SQL stili Azure Digital Twins sorgu dilini kullanarak ortamınızla ilgili soruları yanıtlamak için ikiz grafınızı sorgulayabilirsiniz. Grafiğinizdeki ikizleri sorgulamanın bir yolu özellikleridir. Özelliklere göre sorgulama, ortamınız hakkındaki soruları yanıtlamaya veya aykırı değerleri tanımlamaya yardımcı olabilir. Tamamen bağlı, veri temelli bir senaryoda, ortamınızdaki algılayıcılardan veya diğer bağlı veri kaynaklarından gelen IoT verilerine yanıt olarak ikizlerinizin özellikleri sık sık değişir. Bu hızlı başlangıçta, değişen bir algılayıcı okumasının benzetimini yapmak için değerleri el ile değiştireceksiniz.
Ortamınızda sıcaklığı 75'in üzerinde olan ikiz sayısını görmek için bir sorgu çalıştırarak başlayın. Sorgu Gezgini panelinde aşağıdaki sorguyu çalıştırın.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Room0'un sıcaklık okumasının 70, Room1'in sıcaklık okumasının 80, Room2'nin ise sıcaklık okumasının 72 olduğunu daha önce ikiz özelliklerini görüntüleyerek hatırlayın. Bina ve kat ikizlerinin sıcaklık özelliği yoktur. Bu nedenlerden dolayı, burada sonuçlarda yalnızca Room1 gösterilir.
İpucu
Diğer karşılaştırma işleçleri (<,>, =veya !=) sorgularda da desteklenir. Kendi sorularınızı yanıtlamayı denemek için bu işleçleri, farklı değerleri veya farklı ikiz özelliklerini sorguya eklemeyi deneyebilirsiniz.
Sıcaklık verilerini düzenleme
Tam olarak bağlı bir Azure Digital Twins çözümünde, grafiğinizdeki ikizler gerçek IoT cihazlarından ve diğer veri kaynaklarından canlı güncelleştirmeler alır ve gerçek dünya ortamınızla eşitlenmiş durumda kalmak için özelliklerini otomatik olarak güncelleştirir. Bu hızlı başlangıçta kolaylık olması için, Room0'un sıcaklık okumasını el ile 76 olarak ayarlamak için burada Azure Digital Twins Gezgini'ni kullanacaksınız.
İlk olarak, tüm dijital ikizleri seçmek için aşağıdaki sorguyu yeniden çalıştırın. Bu işlem, ikiz graf panelinde grafiğin tamamını yeniden görüntüler.
SELECT * FROM DIGITALTWINS
İkiz Özellikleri panelinde özellik listesini açmak için Room0'ı seçin.
Sıcaklık değerini 70'ten 76'ya değiştirin ve sıcaklığı güncelleştirmek için Kaydet simgesini seçin.
Başarılı bir özellik güncelleştirmesinin ardından, güncelleştirmeyi yapmak için Azure Digital Twins API'leriylearka planda kullanılan düzeltme eki kodunu gösteren bir Düzeltme Eki Bilgileri kutusu görürsünüz.
Düzeltme eki bilgilerini kapatın .
Yeni sonucu görmek için sorgulama
Room0'un yeni sıcaklığının grafiğe yansıtılmış olduğunu görmek için, ortamdaki tüm ikizleri 75'in üzerinde bir sıcaklığa sahip olmak için sorguyu daha önce yeniden çalıştırın.
SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75
Room0'un sıcaklığı 70'ten 76'ya değiştirildiğine göre, sonuçta hem Room0 hem de Room1 gösterilmelidir.
Öğrenmeleri gözden geçirme ve bağlamsallaştırma
Bu hızlı başlangıçta bir Azure Digital Twins örneği oluşturdunuz ve örnek bir senaryoyla doldurmak için Azure Digital Twins Explorer'ı kullandınız. Dijital ikizi el ile de eklediniz.
Ardından grafiği keşfettiniz ve...
- Senaryo hakkındaki bir soruyu yanıtlamak için sorgu kullanma.
- Dijital ikizdeki bir özelliği düzenleme.
- Güncelleştirmenizin sonucunda yanıtın nasıl değiştiğini görmek için sorguyu yeniden çalıştırın.
Bu alıştırmanın amacı, özellikle IoT ortamları değişmeye devam ettikçe ortamınızla ilgili soruları yanıtlamak için Azure Digital Twins grafiğini nasıl kullanabileceğinizi göstermektir.
Bu hızlı başlangıçta sıcaklık güncelleştirmesini el ile yaptınız. Azure Digital Twins'de, cihaz telemetri verilerine göre güncelleştirmeleri otomatik olarak almaları için dijital ikizleri gerçek IoT cihazlarına bağlamak yaygındır. Ayrıca diğer veri kaynaklarını bağlayarak farklı sistemlerdeki verileri tümleştirebilir ve ikizlerin nasıl güncelleştirilebileceğine ilişkin kendi mantığınızı tanımlayabilirsiniz. Bu şekilde, ortamınızın gerçek durumunu her zaman yansıtan canlı bir grafik oluşturabilirsiniz. Ortamınızda gerçek zamanlı olarak neler olduğu hakkında bilgi almak için sorguları kullanabilirsiniz.
Ayrıca daha fazla içgörü elde etmek ve ortam simülasyonları gerçekleştirmek için Azure Digital Twins verilerini geçmiş izleme, veri analizi ve yapay zeka hizmetlerine aktarabilirsiniz. Azure Digital Twins'i IoT çözümlerinizle tümleştirmek geçmişi daha etkili bir şekilde izlemenize, bugünü denetlemenize ve geleceği tahmin etmenize yardımcı olabilir.
Kaynakları temizleme
Bu hızlı başlangıçtan sonra temizlemek için, bir sonraki adımda ne yapmak istediğinize bağlı olarak kaldırmak istediğiniz Azure Digital Twins kaynaklarını seçin.
- Azure Digital Twins hızlı başlangıçları ve öğreticileri aracılığıyla devam etmek istiyorsanız, bu hızlı başlangıçtaki örneği bu makaleler için yeniden kullanabilirsiniz ve kaldırmanız gerekmez.
Bu makaledeki Azure Digital Twins örneğini kullanmaya devam etmek, ancak tüm modellerini, ikizlerini ve ilişkilerini temizlemek istiyorsanız aşağıdaki az dt job delete CLI komutunu çalıştırın:
az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -yBu öğelerden yalnızca bazılarını silmek istiyorsanız, yalnızca kaldırmak istediğiniz öğeleri seçmeli olarak silmek için az dt twin relationship delete, az dt twin delete ve az dt model delete komutlarını kullanabilirsiniz.
Azure Digital Twins örneğinize artık ihtiyacınız yoksa Azure portalını kullanarak silebilirsiniz.
Portalda örneğin Genel Bakış sayfasına geri dönün. (Bu sekmeyi zaten kapattıysanız Azure portalı arama çubuğunda adını arayarak ve arama sonuçlarından seçerek örneği yeniden bulabilirsiniz.)
Tüm modelleri ve ikizleri de dahil olmak üzere örneği silmek için Sil'i seçin.
Örnek proje dosyalarını yerel makinenizden de silmek isteyebilirsiniz.
Sonraki adımlar
Azure Digital Twins senaryolarını 3B bir ortamda görselleştirmek için sonraki hızlı başlangıca geçin.
Alternatif olarak SDK'lar, ikiz grafı oluşturma ve olay akışı kurulumu hakkında daha ayrıntılı bilgi edinmek için öğreticilere atlayabilirsiniz.