Hızlı Başlangıç - Kullanmaya başlayın bir senaryo ile Azure Digital Twins Explorer

Bu hızlı başlangıçta, Azure Digital Twins Explorer kullanarak önceden oluşturulmuş Azure Digital Twins grafı keşfedersiniz. Bu araç, veri kaynağı içindeki verilerle görselleştirerek Azure Digital Twins etkileşim Azure portal.

Bu Azure Digital Twins, daha geniş IoT çözümlerinin parçası olan gerçek dünya ortamlarının canlı modellerini oluşturabilir ve onlarla etkileşim kurabilirsiniz. İlk olarak, tek tek öğeleri dijital ikizler olarak modellersiniz. Ardından bunları canlı etkinliklere yanıt verilebilecek ve bilgi için sorgulanacak bir bilgi grafı içine bağlayabilirsiniz.

Aşağıdaki adımları tamamlayabilirsiniz:

1. Bir Azure Digital Twins örneği oluşturun ve Azure Digital Twins Explorer.
2. Upload oluşturmak için önceden oluşturulmuş modelleri ve graf verilerini içerir.
3. Oluşturulan senaryo grafiğini keşfedin.
4. Grafikte değişiklik yapın.
5. Deneyimden öğrendiklerinizi gözden geçirme.

Üzerinde Azure Digital Twins bir örnek grafik, iki kat ve iki odası olan bir binayı temsil eder. Floor0 room0, Floor1 ise Room1 içerir. Grafik şu görüntüye benzer:

Önkoşullar

Bu hızlı başlangıç için bir Azure aboneliğine ihtiyacınız olacak. Henüz bir tane yoksa şimdi ücretsiz bir tane oluşturun.

Ayrıca hızlı başlangıçta kullanılan örnek graf için malzemeleri de indirmeniz gerekir. digital-twins-explorerveri deposundan gerekli üç dosyayı indirmek için aşağıdaki bağlantıları ve GitHub kullanın. Daha sonra, daha fazla yönergeleri izleyerek bunları Azure Digital Twins.

• Room.json:Bu, bir binadaki bir odayı temsil eden bir model dosyasıdır. Bağlantıya gidin, ekranın herhangi bir yerine sağ tıklayın ve tarayıcınızın sağ tıklama menüsünde Farklı kaydet'i seçin. Aşağıdaki Farklı Kaydet penceresini kullanarak dosyayı makinenize Room.json adıyla kaydedin.

• Floor.json:Bu, bir binadaki zemini temsil eden bir model dosyasıdır. Bağlantıya gidin, ekranın herhangi bir yerine sağ tıklayın ve tarayıcınızın sağ tıklama menüsünde Farklı kaydet'i seçin. Dosyayı Floor.json adıyla Room.json ile aynı konuma kaydetmek için aşağıdaki Farklı Kaydet penceresini kullanın.

• buildingScenario.xlsx: Bu dosyada oda ve kat ikizlerinin grafı ve aralarındaki ilişkiler yer almaktadır. Bağlantıya gidin ve İndir düğmesini seçin. Bu, dosyayı varsayılan indirme konumunuz için indirir.

  

Azure Digital Twins'i ayarlama

Azure Digital Twins ile çalışmanın ilk adımı, Azure Digital Twins örneği oluşturmak. Hizmetin bir örneğini oluşturdukta, hızlı başlangıç Azure Digital Twins Explorer örneğiyle çalışmak için kullanabileceğiniz Azure Digital Twins Explorer örneğine bağlanabilirsiniz.

Bu bölümün geri kalanında bu adımlarda size yol veacağız.

Azure Digital Twins örneği oluşturma

Bu bölümde, Azure Digital Twins kullanarak yeni bir Azure portal. Portala gidin ve kimlik bilgilerinizle oturum açın.

1. Portala giriş için Azure hizmetleri giriş sayfası menüsünde Kaynak oluştur'a tıklayın.

   

2. Arama Azure Digital Twins arama kutusuna tıklayın ve sonuçlardan Azure Digital Twins hizmeti seçin. Hizmetin yeni bir örneğini oluşturmak için Oluştur düğmesini seçin.

   

3. Yeni örneğiniz için Abonelik, Kaynak grubu, Konum ve Kaynak adı dahil olmak üzere kurulumun Temel sekmesindeki alanları doldurun. Örnekteki verileri Azure Digital Twins izinleri vermek için Veri Sahibi Rolü Ata kutusunu işaretleyin.

   Not

   Veri Sahibi Azure Digital Twins Ata kutusu gri ise, Kaynaklara kullanıcı erişimini yönetmek için Azure aboneliğiniz üzerinde izinlere sahip olmadığınız anlamına gelir. Bu bölümde örneği oluşturmaya devam edersiniz ve ardından bu hızlı başlangıçların geri kalanını tamamlamadan önce gerekli izinlere sahip birinin size örnekte bu rolü ataması gerekir.

   Bu gereksinimi karşılamaya yönelik ortak roller Sahip, Hesap yöneticisi veya Kullanıcı Erişimi Yöneticisi ve Katkıda Bulunan rolleridir.

4. Örneğinizi oluşturmayı tamamlamak için Gözden Geçir + Oluştur'a seçin.

   

5. Girdiğiniz ayrıntıları gösteren bir özet sayfası görüntülenir. Oluştur'ı seçerek örneği onaylayın ve oluşturun.

Bu sizi örneğin dağıtım durumunu takip etmek için Genel Bakış sayfasına alır.

Örneği Azure Digital Twins Explorer

Örnek dağıtımı tamamlandığında Kaynağa git düğmesini kullanarak portalda örneğin Genel Bakış sayfasına gidin.

Ardından Aç (önizleme) Azure Digital Twins Explorer düğmesini seçin.

Bu, Azure Digital Twins Explorer bağlı bir uygulama penceresi açar.

Upload malzemelerini kullanarak

Daha sonra örnek modelleri ve grafı içeri aktararak Azure Digital Twins Explorer. Önkoşullar bölümünde makinenize indirdiğiniz model dosyalarını ve grafik dosyasını kullanabilirsiniz.

Modeller

Bir çözümde ilk Azure Digital Twins ortamınız için sözlük tanımlamaktır. Ortamınız içinde var olan varlık türlerini açıklayan özel modeller oluşturabilirsiniz.

Her model, Dijital İkiz Tanımlama Dili (DTDL) olarak adlandırılan JSON-LD gibi bir dilde yazılır. Her model özellikleri, telemetri, ilişkiler ve bileşenleri bakımından tek bir varlık türünü açıklar. Daha sonra bu modelleri bu türlerin belirli örneklerini temsil eden dijital ikizler için temel olarak kullanacağız.

Genellikle, bir model oluşturdukta üç adımı tamamlarsiniz:

1. Model tanımını yazın. Hızlı başlangıçta, bu adım örnek çözümün bir parçası olarak zaten yapılır.
2. Söz dizimin doğru olduğundan emin olmak için bunu doğrular. Hızlı başlangıçta, bu adım örnek çözümün bir parçası olarak zaten yapılır.
3. Upload örneğinize Azure Digital Twins.

Bu hızlı başlangıçta model dosyaları sizin için yazılmış ve doğrulanmış durumdadır. Bunlar indirdiğiniz çözüme dahil edilir. Bu bölümde, bir bina ortamının şu bileşenlerini tanımlamak için örneğinize önceden yazılmış iki modeli yükleyebilirsiniz:

• Floor
• Oda

Upload (.json dosyaları)

Modelleri (daha önce indirdiğiniz .json dosyaları) karşıya yüklemek için bu adımları izleyin.

1. Modeller panelinde buluta işaret Upload gösteren bir Model simgesi seçin.

   

2. Görüntülenen Aç penceresinde, daha önce indirdiğiniz Room.json ve Floor.json dosyalarını içeren klasöre gidin.

3. Room.json ve Floor.json'u seçin ve aç'ı seçerek ikisini de karşıya yükleyin.

Azure Digital Twins Explorer model dosyalarını dosya örneğinize Azure Digital Twins. Modeller panelinde görünür ve kolay adlarını ve tam model kimliklerini görüntülemeleri gerekir. Model bilgilerini görüntüle simgelerini seçerek arkalarında DTDL kodunu görebilirsiniz.

İkizler ve ikiz grafiği

Örnek örneğinize bazı modeller yük Azure Digital Twins model tanımlarını takip edecek dijital ikizler eklemeye devam edersiniz.

Dijital ikizler, iş ortamınız içindeki gerçek varlıkları temsil eder. Bunlar bir çiftliğe yönelik algılayıcılar, araba lambaları veya bu hızlı başlangıçta bina zemini üzerinde bulunan oda gibi şeyler olabilir. Oda modelini kullanan birden çok oda gibi herhangi bir model türünde birçok ikiz oluşturabilirsiniz. Bunları ilişkilerle, ortamın tamamını temsil eden bir ikiz grafı içine bağlayabilirsiniz.

Bu bölümde, önceden oluşturulmuş bir grafiye bağlı önceden oluşturulmuş ikizleri karşıya yükleyebilirsiniz. Graf, aşağıdaki düzende bağlanmış iki kat ve iki oda içerir:

• Floor0
  • Room0 içerir
• Floor1
  • Oda1 içerir

Grafiği içeri aktarma (.xlsx dosyası)

Grafiği (daha önce indirdiğiniz veri .xlsx için bu adımları izleyin.

1. İkiz Graph panelinde, buluta işaret Graph ok gösteren İçeri Aktar simgesini seçin.

   

2. Aç penceresinde daha önce indirdiğiniz buildingScenario.xlsx dosyasına gidin. Bu dosya, örnek grafiğin açıklamasını içerir. Aç’ı seçin.

   Birkaç saniye sonra Azure Digital Twins Explorer grafiğin önizlemesini gösteren bir İçeri Aktarma görünümü açılır.

3. Graf yüklemesini onaylamak için grafik önizleme panelinin sağ üst köşesindeki Kaydet simgesini seçin.

   

4. Azure Digital Twins Explorer istenen ikizleri ve aralarındaki ilişkileri oluşturmak için karşıya yüklenen dosyayı kullanacağız. Tamamlandığında bir iletişim kutusu görüntülenir. Kapat’ı seçin.

   

5. Grafik artık Azure Digital Twins Explorer. twin Graph paneline geri dönebilirsiniz.

   

6. Grafiği görmek için sorgu penceresinin üst kısmında bulunan Sorgu Gezgini panelinde sorguyu çalıştır Azure Digital Twins Explorer 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 Explorer tüm ikizleri ve ilişkileri hizmetten alır. İkizler tarafından tanımlanan grafı ikiz Graph çizer.

Grafı keşfetme

Artık örnek senaryonun karşıya yüklenen grafiğini görebilirsiniz.

Daireler ("düğümler") dijital ikizleri temsil eder. Satırlar ilişkileri temsil ediyor. Floor0 ikizi Room0, Floor1 ikizi ise Room1'i içerir.

Fare kullanıyorsanız graf parçalarını sürükleyerek hareket ettirebilirsiniz.

İkiz özelliklerini görüntüleme

Özellikleri ve değerlerinin listesini Özellikler panelinde görmek için bir ikiz seçebilirsiniz.

Room0'ın özellikleri şu şekildedir:

Room0'ın sıcaklığı 70'tir.

Room1'in özellikleri şu şekildedir:

Room1'in sıcaklığı 80'tir.

Grafiği sorgulama

Bu özelliğin Azure Digital Twins, ortamınız hakkında soruları yanıtlamak için ikiz grafını kolayca ve verimli bir şekilde sorgulama özelliğidir.

Grafınıza ikizleri sorgulamanın bir yolu, özelliklerine göre sorgulamaktır. Özellikleri temel alarak sorgulamak çeşitli soruları yanıtlamaya yardımcı olabilir. Örneğin, ortamınıza dikkat gerektiren outliers bulabilirsiniz.

Bu bölümde, ortamınıza kaç ikizin sıcaklığının 75'in üzerinde olduğu sorusunu yanıtlamak için bir sorgu çalıştıracaksınız.

Yanıtı görmek için Sorgu Gezgini panelinde aşağıdaki sorguyu çalıştırın.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Daha önce ikizi özelliklerini görüntüleyen Oda0'ın sıcaklığının 70, Room1'in sıcaklığının 80 olduğunu hatırlayın. Bu nedenle buradaki sonuçlarda yalnızca Room1 yer ayaz.

Grafikte verileri düzenleme

Grafı Azure Digital Twins Explorer ikizlerin özelliklerini düzenlemek için Azure Digital Twins Explorer'yi kullanabilirsiniz. Bu bölümde Room0'ın sıcaklığını 76'ya yükseltin.

Başlamak için aşağıdaki sorguyu yeniden çalıştırarak tüm dijital ikizleri seçin. Bu, tam grafı twin Graph görüntüler.

SELECT * FROM DIGITALTWINS

Özellikler panelinde özellik listesini getirmek için Oda0'ı seçin.

Bu listede yer alan özellikler düzenlenebilir. Yeni bir değer girmeyi etkinleştirmek için 70 sıcaklık değerini seçin. Sıcaklığı 76 olarak güncelleştirmek için 76 girin ve Kaydet simgesini seçin.

Şimdi, düzeltme eki kodunun güncelleştirme yapmak için uygulama api'leriyle arka Azure Digital Twins göründüğü bir Düzeltme Eki Bilgileri penceresi görüntülenir. Kapat’ı seçin.

Sonucu görmek için sorgu

Grafın Room0 için sıcaklık güncelleştirmenizi başarıyla kaydeden olduğunu doğrulamak için, ortamdaki tüm ikizleri 75'in üzerinde bir sıcaklıkla almak için daha önceki sorguyu yeniden çalıştırabilirsiniz.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

Room0'ın sıcaklığı 70'den 76'ya değiştirilene kadar her iki ikizin de sonuçta ortaya çıktı olması gerekir.

Öğrenmeleri gözden geçirme ve bağlamsal hale geçirme

Bu hızlı başlangıçta bir Azure Digital Twins örneği Azure Digital Twins Explorer örnek bir senaryoyla doldurmak için bu örneği kullandık.

Ardından grafı şu şekilde keşfedersiniz:

• Senaryoyla ilgili bir soruyu yanıtlamak için sorgu kullanma.
• Dijital ikizde 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ırma.

Bu alıştırmanın amacı, ortam değişmeye devam etti Azure Digital Twins bile ortamınız hakkında soruları yanıtlamak için Azure Digital Twins grafını nasıl kullanabileceğinizi göstermektir.

Bu hızlı başlangıçta sıcaklık güncelleştirmesini el ile yaptınız. Telemetri verilerine Azure Digital Twins güncelleştirmeleri otomatik olarak almaları için dijital ikizleri gerçek IoT cihazlarına bağlamak yaygın bir durumdur. Bu şekilde, ortamınızı her zaman gerçek durumunu yansıtan bir canlı grafik de derlemeniz gerekir. Sorguları kullanarak ortamınıza gerçek zamanlı olarak neler olduğu hakkında bilgi edinebilirsiniz.

Kaynakları temizleme

Bu hızlı başlangıçtan sonra temizlemek için, bir sonraki adıma göre hangi kaynakları kaldırmak istediğinize göre seçin.

• öğreticilerine devam Azure Digital Twins planlıyorsanız, bu hızlı başlangıçtaki örneği bu makaleler için yeniden kullanabilirsiniz ve kaldırmanız gerek yok.

• Bu makalede ayar istediğiniz Azure Digital Twins örneğini kullanmaya devam etmek, ancak modellerinin, ikizlerinin ve ilişkilerinin bir bölümü veya hepsini temizlemek için, kaldırmak istediğiniz öğeleri silmek için bir Azure Cloud Shell penceresinde az dt CLI komutlarını kullanabilirsiniz.

• Bu öğreticide oluşturduğunuz kaynaklara ihtiyacınız yoksa az group delete komutuyla Azure Digital Twins örneğini ve diğer tüm kaynakları bu makaleden silebilirsiniz. Bu, kaynak grubunun yanı sıra bir kaynak grubunda yer alan tüm Azure kaynaklarını siler.

  Önemli

  Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun.

  komutunu Azure Cloud Shellve kaynak grubunu ve içerdiği her şeyi silmek için aşağıdaki komutu çalıştırın.

  az group delete --name <your-resource-group>
  

Ayrıca, örnek proje klasörünü yerel makineden silmek de istiyor olabilir.

Sonraki adımlar

Ardından, kendi senaryo ve etkileşim Azure Digital Twins oluşturmak için Azure Digital Twins öğreticilerine devam edin.