Azure Digital Twins Gezgini'ni kullanma (önizleme)
Azure Digital Twins Gezgini (önizleme), Azure Digital Twins'i görselleştirmeye ve Azure Digital Twins ile çalışmaya yönelik bir araçtır. Bu makalede Azure Digital Twins Gezgini'nin özellikleri ve bunların Azure Digital Twins örneğinizdeki verileri yönetmek için nasıl kullanılacağı açıklanmaktadır. Tıklamaları veya klavye kısayollarını kullanarak Azure Digital Twins Gezgini ile etkileşim kurabilirsiniz.
Erişim
Azure Digital Twins Gezgini'ne erişmenin ana yolu Azure portalından geçmektir.
Azure Digital Twins örneği için Azure Digital Twins Gezgini'ni açmak için önce portal arama çubuğunda adını arayarak portaldaki örneğe 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.
Uygulama içindeki bağlamları değiştirme
Uygulamaya girdikten sonra, üst araç çubuğundan örnek adını seçerek gezgine bağlı olan örneği de değiştirebilirsiniz.
Bunu yaptığınızda Azure Digital Twins URL'si kalıcı olur ve bu örnekten sonra başka bir Azure Digital Twins örneğinin https:// ana bilgisayar adını girebilirsiniz.
Not
Şu anda, uygulama içindeki bağlamlar arasında geçiş yapma özelliği kişisel Microsoft Hesapları (MSA) için kullanılamaz. MSA kullanıcılarının gezgine Azure portalında seçilen örnekten erişmesi gerekir veya ortama doğrudan bağlantı yoluyla belirli bir örneğe bağlanabilir.
Dijital ikiz grafınızı sorgulama
Sorgu Gezgini panelini kullanarak grafiğinizde sorgu çalıştırabilirsiniz.
Çalıştırmak istediğiniz sorguyu girin. Bir sorguyu birden çok satıra girmek istiyorsanız, sorgu kutusuna yeni bir satır eklemek için SHIFT + ENTER tuşlarını kullanabilirsiniz.
sorgu sonuçlarını İkiz Grafik panelinde görüntülemek için Sorguyu Çalıştır düğmesini seçin.
Not
İlişki içeren sorgu sonuçları yalnızca sonuçlarda en az bir ikiz varsa İkiz Grafı panelinde işlenebilir. Azure Digital Twins'de yalnızca ilişki döndüren sorgular mümkün olsa da, bunları yalnızca Çıkış panelini kullanarak Azure Digital Twins Gezgini'nde görüntüleyebilirsiniz.
Yer paylaşımlı sorgu sonuçları
Sonuçların, panelin içeriğini yeni sorgu sonuçlarıyla tamamen değiştirmek yerine, İkiz Grafik panelinde gösterilen sonuçlardan vurgulanmasını istiyorsanız, sorgunuzu çalıştırmadan önce Katman sonuçları kutusunu işaretleyebilirsiniz.
Sorgu sonucu şu anda İkiz Graf panelinde gösterilmemekte olan bir öğe içeriyorsa, öğe mevcut görünüme eklenir.
Sorguları kaydetme ve yeniden çalıştırma
Sorgular tarayıcınızdaki yerel depolama alanına kaydedilerek kolayca seçilebilir ve yeniden çalıştırılabilir.
Not
Yerel tarayıcı depolama alanı, kaydedilen sorguların kaydettiğiniz sorgu dışında diğer tarayıcılarda kullanılamayacağı ve yerel depolama alanı temizlenene kadar süresiz olarak tarayıcı depolama alanında kalacakları anlamına gelir.
Bir sorguyu kaydetmek için sorgu kutusuna girin ve panelin sağ tarafındaki Kaydet simgesini seçin. İstendiğinde kaydedilen sorgu için bir ad girin.
Sorgu kaydedildikten sonra, kolayca yeniden çalıştırmak için Kaydedilen Sorgular açılan menüsünden seçim yapabilirsiniz.
Kaydedilen sorguyu silmek için, Kaydedilen Sorgular açılan menüsü açıkken sorgunun adının yanındaki X simgesini seçin.
İpucu
Büyük graflarda yalnızca sınırlı bir alt kümeyi sorgulamak ve sonra grafiğin kalan kısmını gerektiği gibi yüklemek önerilir. İlişkili ek düğümleri almak için İkiz Graf panelinde bir ikize çift tıklayabilirsiniz.
İkiz Grafını Keşfetme
İkiz Graf paneli örneğinizdeki ikizleri ve ilişkileri keşfetmenizi sağlar.
İkiz verileri keşfetmek için bu paneli kullanabilirsiniz.
İkiz Graf paneli, graf görüntüleme deneyiminizi özelleştirmek için çeşitli yetenekler de sağlar:
- İkiz görüntüleme özelliğini değiştirme
- İkiz grafik düzenini düzenleme
- İkiz grafı genişletmeyi denetleme
- İkiz grafik öğelerini gösterme ve gizleme
- İkiz grafik öğelerini filtreleme ve vurgulama
İkiz verilerini keşfetme
İkiz Grafik panelinde görüntülenen sorgu sonucundaki ikizleri ve ilişkileri görmek için Sorgu Gezgini'ni kullanarak bir sorgu çalıştırın.
İpucu
Tüm ikizleri ve ilişkileri görüntülemek için sorgu şeklindedir SELECT * FROM digitaltwins.
İkiz ve ilişki özelliklerini görüntüleme
bir ikizin veya ilişkinin özellik değerlerini görüntülemek için, İkiz Grafı'nda ikizi veya ilişkiyi seçin ve İkiz Özellikleri veya İlişki Özellikleri panelini genişletmek için Geçiş özelliği denetçisi düğmesini kullanın. Bu panel, öğeyle ilişkili tüm özellikleri ve bunların değerlerini görüntüler. Ayrıca henüz ayarlanmamış özellikler için varsayılan değerleri de içerir.
Veri türü simgeleri
İkiz Özellikleri ve İlişki Özellikleri panellerinde gösterilen özelliklerin her biri, DTDL modelindeki alanın türünü gösteren bir simgeyle görüntülenir. İlişkili türü görüntülemek için bir simgenin üzerine gelebilirsiniz.
Aşağıdaki tabloda olası veri türleri ve ilgili simgeleri gösterilmektedir. Tablo ayrıca DTDL v3 Dil Açıklaması'nda her veri türünden şema açıklamasına bağlantılar içerir.
| Simge | Veri türü |
|---|---|
 |
boolean |
 |
component |
 |
Tarih |
 |
Datetime |
 |
Süre |
 |
enum |
 |
Harita |
 |
Çift, kayan, tamsayı ve uzun gibi sayısal türler |
 |
object |
 |
string |
 |
Zaman |
Hatalar
İkiz özellikleri paneli, ikiz veya bazı özellikleri artık modeliyle eşleşmiyorsa hata iletileri görüntüler.
Her biri kendi hata iletisini veren iki olası hata senaryosu vardır:
- İkiz tarafından kullanılan bir veya birden çok model eksik. Sonuç olarak, bu modelle ilişkili tüm özellikler, İkiz Özellikleri panelinde "eksik" olarak işaretlenir. Bu hata, model ikiz oluşturulduktan sonra silindiyse oluşabilir.
- İkizdeki bazı özellikler ikizin modelinin bir parçası değildir. İkiz Özellikleri panelinde yalnızca bu özellikler "eksik" olarak işaretlenir. Bu hata, özellikler ayarlandıktan sonra ikizin modeli değiştirildiğinde veya değiştirildiğinde ve özellikler artık modelin en son sürümünde mevcut değilse oluşabilir.
Bu hata iletilerinin her ikisi de aşağıdaki ekran görüntüsünde gösterilmiştir:
Geçmişe geçmiş özellikleri doğrulama ve keşfetme
Azure Digital Twins örneğinizde veri geçmişi etkinleştirilmişse Azure Digital Twins Gezgini'nde geçmişe geçmiş verilerini doğrulayabilir ve keşfedebilirsiniz. Grafikte geçmişe geçmiş verileri görselleştirmek veya tablodaki ham değerleri görüntülemek için aşağıdaki adımları izleyin.
İkiz Graf görüntüleyicisinden, geçmişe geçmiş özelliklerini görüntülemek istediğiniz bir ikiz seçerek bunu İkiz Özellikleri panelinde açın. Panelin sağ üst köşesindeki Zaman serisi simgesini seçerek Veri geçmişi gezginini açın.
İkizin hangi geçmiş özelliklerini görüntüleyebileceğinizi seçme seçeneklerini ortaya çıkarmak için soldan ikiz adını seçin. İkiz Kimliği alanı, ikiz seçimiyle önceden doldurulur. Bu alanın yanındaki Özellikleri denetle simgesini seçerek ikiz verilerini görüntüleyebilir veya Gelişmiş ikiz arama simgesini seçerek özellik değerlerini sorgulayabilirsiniz.
Özellik alanında, geçmiş verilerini görüntülemek istediğiniz özelliği seçin. Özellik sayısal değilse ancak sayısal değerlerden oluşuyorsa, grafikte görselleştirilebilmeleri için bu verileri sayılara dönüştürmeye çalışmak için Özellik değerini sayıya dönüştür seçeneğini kullanın.
Not
Liste yanıt vermediğinden açılan listeden bir özellik seçemiyorsanız bu, örneğinizdeki bir modelde hata olduğu anlamına gelebilir. Örneğin, bir modelin özniteliklerinde benzersiz olmayan sabit listesi değerlerinin olması bu özelliği bozar. Böyle bir durumda model tanımlarınızı gözden geçirin ve tüm özelliklerin geçerli olduğundan emin olun.
Zaman serisi için bir Etiket seçin ve Güncelleştir'i seçin.
Bu, seçilen özellik için geçmişe ayrılmış değerlerin grafik görünümünü yükler. Grafik görünümü ile tablo görünümü arasında geçiş yapmak için grafiğin üzerindeki sekmeleri kullanabilirsiniz.
Görselleştirmeye daha fazla özellik eklemek için soldaki Zaman serisi ekle düğmesini kullanın.
Veri geçmişi gezgininden çıkmak ve ana Azure Digital Twins Gezgini'ne dönmek için Kapat'ı seçin.
Grafikte geçmişi görüntüleme
Geçmişe geçmiş özelliklerin Grafik görünümü, özellik değerlerini zaman içinde çizgi grafikte nokta olarak gösterir.
Grafik ayarlarını denetlemek için grafiğin üzerindeki simgeleri kullanabilirsiniz.
- Grafiğe dahil edilen verilerin zaman aralığını değiştirme.
- birden çok zaman serisinin bağımsız olarak mı yoksa paylaşılan bir y ekseninde mi gösterileceğini seçme. Eksenler için Bağımsız'ın seçilmesi, her zaman serisinin grafiğe ölçeklendirileceği ve ölçek için kendi ekseninin korunacağı anlamına gelir. Paylaşılan eksenlerin seçilmesi, tüm zaman serisi verilerinin aynı eksene ölçeklendirileceği anlamına gelir.
- grafik için toplama mantığını seçme. Özelliğin grafikte gösterilebilenden daha fazla veri noktası olduğunda, veriler ortalama, en düşük veya en yüksek işlevler kullanılarak sınırlı sayıda veri noktası halinde toplanır.
Ayrıca Azure Veri Gezgini'da sorguyu açma düğmesi de vardır. Burada zaman serisi verilerini daha ayrıntılı incelemek için geçerli sorguyu görüntüleyebilir ve değiştirebilirsiniz.
Tablodaki geçmişi görüntüleme
Geçmişe geçmiş özelliklerin Tablo görünümü, bir tablodaki özellik değerlerini ve bunların zaman damgalarını gösterir.
Tablo ayarlarını denetlemek için tablonun üst kısmındaki simgeleri kullanabilirsiniz.
- tabloya dahil edilen verilerin zaman aralığını değiştirme.
- bağımsız analiz için tablo verilerini indirme.
bir ikizin ilişkilerini görüntüleme
Ayrıca, belirli bir ikiz (gelen ve giden ilişkiler dahil) içeren tüm ilişkilerin kodunu hızla görüntüleyebilirsiniz.
Grafikte bir ikize sağ tıklayın ve İlişkileri al'ı seçin. Bunu yaptığınızda, tüm gelen ve giden ilişkilerin JSON gösterimini görüntüleyen bir İlişki Bilgileri kalıcı olarak gösterilir.
İkiz görüntüleme özelliğini değiştirme
İkiz grafınızdaki ikizleri tanımlamak için görüntülemek istediğiniz özelliği yapılandırabilirsiniz. Varsayılan değerdir $dtId , ancak model kümenizde bulunan özelliklerden (her ikizde bulunmayan özelliklerden bile) birini seçebilirsiniz.
Görüntüleme özelliğini değiştirmek için İkiz Görünen Ad Özelliği Seç açılan menüsünü kullanın. Açılan menü, özelliğini içeren model sayısına göre sıralanır.
Her ikizde mevcut olmayan bir özellik seçerseniz, grafikte bu özelliğe sahip olmayan tüm ikizler yıldız (*) ve ardından değerleriyle $dtId birlikte görüntülenir.
İkiz grafik düzenini düzenleme
İkizleri, İkiz Grafiği ekranında tıklayıp sürükleyerek farklı yapılandırmalara yeniden düzenleyebilirsiniz.
Ayrıca, Düzen Seç menüsündeki seçeneklerden grafa çeşitli düzen algoritmalarından birini uygulayabilirsiniz.
İkiz grafı genişletmeyi denetleme
İkiz Grafik panelinde bir sorgu sonucunu görüntülerken, grafiğin ilişkilerini ve ilişkili ikizlerini getirmesini ve görünümde henüz mevcut değilse görüntülemesini sağlamak için bir ikize çift tıklayabilirsiniz. Kaç ikiz getirileceğini belirlemek için bir boyut ve yön ayarlayarak bu genişletmeyi özelleştirebilirsiniz.
Genişletecek katman sayısını ayarlamak için Genişletme Düzeyi seçeneğini kullanın. Bu sayı, seçili ikizden kaç ilişki katmanı getirildiğini gösterir.
Genişletirken hangi ilişki türlerinin izleyebileceğinizi belirtmek için Genişletme Yönü düğmesini kullanın. Bunu yaptığınızda gelen, giden veya hem gelen hem de giden ilişkiler arasından seçim yapmanıza olanak tanır.
İkiz grafik öğelerini gösterme ve gizleme
İkizleri veya ilişkileri grafik görünümünden gizleme seçeneğini değiştirebilirsiniz.
İkizi veya ilişkiyi gizlemek için, İkiz Grafik penceresinde bu çifte sağ tıklayın. Bunu yaptığınızda, öğeyi veya diğer ilgili öğeleri gizleme seçeneklerini içeren bir menü açılır.
Grafikte aynı türde birden çok öğeyi birden çok seçmek için CTRL/CMD veya SHIFT tuşlarını kullanarak aynı anda birden çok ikiz veya ilişkiyi de gizleyebilirsiniz. Burada, gizleme seçeneklerini görmek için aynı sağ tıklama işlemini izleyin.
Bazı ikizler gizlendikten sonra tüm ikizleri göstermeye dönmek için Tümünü Göster düğmesini kullanın. Tüm ilişkileri göstermeye dönmek için Tüm İlişkileri Göster düğmesini kullanın.
İkiz grafik öğelerini filtreleme ve vurgulama
Bu Filtre simgesini seçerek grafikte görünen ikizleri ve ilişkileri metne göre filtreleyebilirsiniz:
Ayrıca, bu Vurgula simgesini seçerek grafikte görünen ikizleri ve ilişkileri metne göre vurgulayabilirsiniz :
İkizleri ve grafı yönetme
Azure Digital Twins Gezgini, örneğinizdeki ikizleri ve ilişkileri yönetmek için çeşitli yollar sağlar.
Bu bölümde aşağıdaki yönetim etkinliklerinin nasıl gerçekleştirildiği açıklanmaktadır:
- İkizlerin ve ilişkilerin düz listesini görüntüleme
- İlk özelliklere sahip veya olmayan ikizler oluşturma
- İkizler arasında ilişki oluşturma
- İkiz ve ilişki özelliklerini düzenleme
- İkizleri ve ilişkileri silme
İkizlerin ve ilişkilerin görüntüleme deneyimi hakkında bilgi için bkz . İkizleri ve İkiz Grafını keşfetme.
İkizlerin ve ilişkilerin düz listesini görüntüleme
İkizler panelinde ikizlerinizin ve ilişkili ilişkilerinin düz bir listesi gösterilir. İkizleri ada göre arayabilir ve gelen ve giden ilişkileriyle ilgili ayrıntılar için bunları genişletebilirsiniz.
İkiz oluşturma
Modeller panelinde model tanımından yeni bir dijital ikiz oluşturabilirsiniz.
Bir modelden ikiz oluşturmak için bu modeli listede bulun ve model adının yanındaki menü noktaları seçin. Ardından İkiz Oluştur'u seçin. Yeni ikiz için benzersiz olması gereken bir ad girmeniz istenir. Ardından ikizi kaydederek grafiğinize ekleyin.
İkizinize özellik değerleri eklemek için bkz . İkiz ve ilişki özelliklerini düzenleme.
İlişki oluşturma
İki ikiz arasında ilişki oluşturmak için, İkiz Grafiği penceresinde ilişkinin kaynak ikizini seçerek başlayın. Ardından, ilişkinin hedefi olarak ikinci bir ikiz seçerken CTRL/CMD veya SHIFT tuşunu basılı tutun.
İki ikiz aynı anda seçildikten sonra, hedef ikize sağ tıklayarak aralarında ilişki ekle seçeneğini içeren bir menü açın.
Bunu yaptığınızda, ilişkinin kaynak ikizi ve hedef ikizi ile doldurulmuş İlişki Oluştur iletişim kutusu açılır (bunları değiştirmek için İlişki Değiştir simgesini de kullanabilirsiniz). DTDL modeline göre kaynak ikizin sahip olabileceği ilişki türlerini içeren bir İlişki açılan menüsü vardır. İlişki türü için bir seçenek belirleyin ve Yeni ilişkiyi kaydet'i seçin.
İkiz ve ilişki özelliklerini düzenleme
bir ikizin veya ilişkinin özellik değerlerini görüntülemek için, İkiz Grafiğindeki öğeyi seçin ve İkiz Özellikleri veya İlişki Özellikleri panelini genişletmek için Geçiş özelliği denetçisi düğmesini kullanın.
Yazılabilir özellikleri doğrudan düzenlemek için bu paneli kullanabilirsiniz. Değerlerini satır içi olarak güncelleştirin ve kaydetmek için panelin üst kısmındaki Değişiklikleri kaydet düğmesini seçin. Güncelleştirme kaydedildiğinde, ekranda güncelleştirme API'sinin uyguladığı JSON Düzeltme Eki işlemini gösteren kalıcı bir pencere görüntülenir.
İpucu
İkiz Özellikleri ve İlişki Özellikleri panellerinde gösterilen özelliklerin her biri, DTDL modelindeki alanın türünü gösteren bir simgeyle görüntülenir. Tür simgeleri hakkında daha fazla bilgi için bkz . Veri türü simgeleri.
İkizleri ve ilişkileri silme
İkizi veya ilişkiyi silmek için, İkiz Grafiği penceresinde çifte sağ tıklayın. Bunu yaptığınızda öğeyi silme seçeneğine sahip bir menü açılır.
CTRL/CMD veya SHIFT tuşlarını kullanarak grafikte aynı türde birden çok öğeyi birden çok kez seçerek aynı anda birden çok ikiz veya birden çok ilişkiyi silebilirsiniz. Buradan, öğeleri silmek için aynı sağ tıklama işlemini izleyin.
Üst araç çubuğundaki Tüm İkizleri Sil düğmesini kullanarak örneğinizdeki tüm ikizleri aynı anda silmeyi de seçebilirsiniz.
Modelleri ve Model Grafını keşfetme
Modeller hem Azure Digital Twins Gezgini ekranının sol tarafındaki Modeller panelinde hem de ekranın ortasındaki Model Grafı panelinde görüntülenebilir.
Modeller paneli:
Model Grafı paneli:
Not
Azure Digital Twins Gezgini şu anda DTDL v2 modellerini tam olarak destekler ve DTDL v3 modelleri için sınırlı işlevselliği destekler. Azure Digital Twins Gezgini'nde DTDL v3 modelleri Modeller panelinde görüntülenebilir ve DTDL v3 modelleri ile oluşturulan ikizler görüntülenebilir ve düzenlenebilir (dizi özellikleri olanlar dahil). Ancak DTDL v3 modelleri Model Grafı panelinde gösterilmez ve Azure Digital Twins Gezgini kullanılarak içeri aktarılamaz . DTDL v3 modellerini örneğinize aktarmak için API'ler ve SDK'lar veya Azure CLI gibi başka bir geliştirici arabirimi kullanın.
Modellerinizi görüntülemek için bu panelleri kullanabilirsiniz.
Model Grafı paneli, graf görüntüleme deneyiminizi özelleştirmek için çeşitli yetenekler de sağlar:
- Model grafı düzenini düzenleme
- Model grafı öğelerini filtreleme ve vurgulama
- Graflardaki modelleri temsil etmek için model görüntülerini karşıya yükleme
Modelleri görüntüleme
Model panelinde örneğinizdeki modellerin düz bir listesini görüntüleyebilirsiniz. Bu liste, paneldeki Arama çubuğu kullanılarak aranabilir.
Model Grafı panelini kullanarak örneğinizdeki modellerin grafik gösterimini ve bunları birbirine bağlayan ilişkileri, devralmayı ve bileşenleri görüntüleyebilirsiniz.
Not
Azure Digital Twins Gezgini şu anda DTDL v2 modellerini tam olarak destekler ve DTDL v3 modelleri için sınırlı işlevselliği destekler. Azure Digital Twins Gezgini'nde DTDL v3 modelleri Modeller panelinde görüntülenebilir ve DTDL v3 modelleri ile oluşturulan ikizler görüntülenebilir ve düzenlenebilir (dizi özellikleri olanlar dahil). Ancak DTDL v3 modelleri Model Grafı panelinde gösterilmez ve Azure Digital Twins Gezgini kullanılarak içeri aktarılamaz . DTDL v3 modellerini örneğinize aktarmak için API'ler ve SDK'lar veya Azure CLI gibi başka bir geliştirici arabirimi kullanın.
Model tanımını görüntüleme
Modelin tam tanımını görmek için Modeller bölmesinde bu modeli bulun ve model adının yanındaki menü noktalarına tıklayın. Ardından Modeli Görüntüle'yi seçin. Bunu yaptığınızda, modelin ham DTDL tanımını gösteren bir Model Bilgileri kalıcı görüntülenir.
Modelin tam tanımını Model Grafı'nda seçerek ve Model Ayrıntıları panelini genişletmek için Model ayrıntılarını aç/kapat düğmesini kullanarak da görüntüleyebilirsiniz. Bu panelde model için tam DTDL kodu da görüntülenir.
Model grafı düzenini düzenleme
Model Grafı ekranına tıklayıp sürükleyerek modelleri farklı yapılandırmalarda yeniden düzenleyebilirsiniz.
Düzen Seç menüsündeki seçeneklerden model grafiğine çeşitli düzen algoritmalarından birini de uygulayabilirsiniz.
Model grafı öğelerini filtreleme ve vurgulama
Model Grafı'nda görünen model başvurusu türlerini filtreleyebilirsiniz. Bu menüdeki anahtarlar aracılığıyla başvuru türlerinden birinin kapatılması, bu başvuru türünün grafikte görüntülenmesini engeller.
Bu Filtre simgesini seçerek grafikte görüntülenen modelleri ve başvuruları metne göre de filtreleyebilirsiniz:
Bu Vurgu simgesini seçerek grafikte görüntülenen modelleri ve başvuruları metne göre vurgulayabilirsiniz :
Model görüntülerini karşıya yükleme
Model Grafı ve İkiz Graf görünümlerinde farklı modelleri temsil etmek için özel görüntüleri karşıya yükleyebilirsiniz. Tek tek modeller için veya aynı anda birkaç model için görüntüleri karşıya yükleyebilirsiniz.
Not
Bu görüntüler yerel tarayıcı depolama alanında depolanır. Bu, görüntüleri kaydettiğiniz tarayıcı dışında diğer tarayıcılarda kullanılamayacağı ve yerel depolama temizlenene kadar süresiz olarak tarayıcı depolama alanında kalacakları anlamına gelir.
Tek bir modelin görüntüsünü karşıya yüklemek için Modeller panelinde bu modeli bulun ve model adının yanındaki menü noktalarına tıklayın. Ardından Model Görüntüsünü Karşıya Yükle'yi seçin. Görüntülenen dosya seçici kutusunda, makinenizde bu model için karşıya yüklemek istediğiniz görüntü dosyasına gidin. Karşıya yüklemek için Aç'ı seçin.
Model görüntülerini toplu olarak da yükleyebilirsiniz.
İlk olarak, karşıya yüklemeden önce görüntü dosyası adlarını ayarlamak için aşağıdaki yönergeleri kullanın. Bunun yapılması, Azure Digital Twins Gezgini'nin karşıya yüklemeden sonra görüntüleri otomatik olarak doğru modellere atamasını sağlar.
- Model kimliği değeriyle başlayın (örneğin,
dtmi:example:Floor;1) - ":" örneklerini "_" ile değiştirin (örnek olur
dtmi_example_Floor;1) - ";" örneklerini "-" ile değiştirin (örnek olur
dtmi_example_Floor-1) - Dosyanın bir görüntü uzantısına sahip olduğundan emin olun (örnek gibi
dtmi_example_Floor-1.pngolur)
Not
Yukarıdaki ölçütleri kullanarak mevcut modelle eşleşmeyen bir görüntüyü karşıya yüklemeye çalışırsanız, görüntü karşıya yüklenmez veya depolanmaz.
Ardından, görüntüleri aynı anda karşıya yüklemek için Modeller panelinin üst kısmındaki Model Görüntülerini Karşıya Yükle simgesini kullanın. Dosya seçici kutusunda karşıya yüklenecek görüntü dosyalarını seçin.
Modelleri yönetme
Tüm model kümesinde veya tek tek modellerde yönetim etkinlikleri gerçekleştirmek için Azure Digital Twins Gezgini ekranının sol tarafındaki Modeller panelini kullanabilirsiniz.
Bu panelle aşağıdaki model yönetimi etkinliklerini tamamlayabilirsiniz:
- Modelleri Azure Digital Twins örneğine yükleme
- Modeli örneğinizden silme
- Tüm modellerin listesini bu panele yeniden yüklemek için modelleri yenileyin
Modellerin görüntüleme deneyimi hakkında bilgi için bkz . Modelleri ve Model Grafını keşfetme.
Modelleri karşıya yükleme
Model dosyalarını tek tek seçerek veya model dosyaları klasörünün tamamını aynı anda karşıya yükleyerek makinenizden modelleri karşıya yükleyebilirsiniz. Birçok modelin kodunu içeren bir JSON dosyası yüklüyorsanız toplu model karşıya yükleme sınırlamalarını gözden geçirmeyi unutmayın.
Not
Azure Digital Twins Gezgini şu anda DTDL v2 modellerini tam olarak destekler ve DTDL v3 modelleri için sınırlı işlevselliği destekler. Azure Digital Twins Gezgini'nde DTDL v3 modelleri Modeller panelinde görüntülenebilir ve DTDL v3 modelleri ile oluşturulan ikizler görüntülenebilir ve düzenlenebilir (dizi özellikleri olanlar dahil). Ancak DTDL v3 modelleri Model Grafı panelinde gösterilmez ve Azure Digital Twins Gezgini kullanılarak içeri aktarılamaz . DTDL v3 modellerini örneğinize aktarmak için API'ler ve SDK'lar veya Azure CLI gibi başka bir geliştirici arabirimi kullanın.
Tek tek seçilen bir veya daha fazla modeli karşıya yüklemek için Yukarı ok gösteren Model yükle simgesini seçin.
Görüntülenen dosya seçici kutusunda makinenizde karşıya yüklemek istediğiniz modellere gidin. Karşıya yüklemek için bir veya daha fazla JSON modeli dosyası seçebilir ve Aç'ı seçebilirsiniz.
İçindeki her şey dahil olmak üzere bir model klasörünü karşıya yüklemek için, Dosya klasörünü gösteren Modeller dizinini karşıya yükle simgesini seçin.
Görüntülenen dosya seçici kutusunda makinenizde JSON model dosyalarını içeren bir klasöre gidin. Bu üst düzey klasörü ve tüm içeriğini karşıya yüklemek için Aç'ı seçin.
Önemli
Model, ilişki veya bileşen tanımlarken olduğu gibi tanımında başka bir modele başvuruyorsa, bunu kullanan modeli karşıya yüklemek için başvuruda bulunılan modelin örnekte mevcut olması gerekir. Modelleri tek tek karşıya yüklüyorsanız bu, kullanan modelleri karşıya yüklemeden önce başvuruda bulunan modeli karşıya yüklemeniz gerektiği anlamına gelir. Modelleri toplu olarak karşıya yüklüyorsanız, bunların tümünü aynı içeri aktarmada seçebilirsiniz ve Azure Digital Twins bunları karşıya yükleme sırasını çıkarsar. Ancak, aynı dosyaya 50'den fazla model yüklüyorsanız toplu model karşıya yükleme sınırlamalarına bakın.
Toplu model yükleme sınırlamaları
Bu bölümdeki sınırlamalar, aynı anda Azure Digital Twins Gezgini'ne yüklenen tek bir JSON dosyasında yer alan modeller için geçerlidir.
Tek bir JSON dosyasına kaç model ekleyebileceğiniz konusunda bir sınır olmasa da, 50'den fazla model içeren dosyalar için dikkat edilmesi gereken özel noktalar vardır. Aynı model dosyasına 50'den fazla model yüklüyorsanız şu ipuçlarını izleyin:
- Aynı dosyada tanımlanan diğer modellerden devralan modeller varsa, bunları listenin sonuna yakın bir yere yerleştirin.
- Bileşenlerle aynı dosyada tanımlanan diğer modellere başvuran modeller varsa, bunları listenin sonuna yakın bir yere yerleştirin.
- Bir modelin aynı dosyada tanımlanan başka bir modele başvurduğunu (devralma yoluyla veya bileşen olarak), başvuruyu içeren modelin başvuruda bulunılan model tanımından daha sonra listede geldiğini doğrulayın.
Bu, karşıya yükleme işlemi sırasında model bağımlılıklarının doğru çözümlenmesine yardımcı olur.
Modelleri silme
Tek tek modelleri veya örneğinizdeki tüm modelleri tek seferde silmek için Modeller panelini kullanabilirsiniz.
Tek bir modeli silmek için bu modeli listede bulun ve model adının yanındaki menü noktalarına tıklayın. Ardından Modeli Sil'i seçin.
Örneğinizdeki tüm modelleri aynı anda silmek için Modeller panelinin üst kısmındaki Tüm Modelleri Sil simgesini seçin.
Modelleri yenileme
Azure Digital Twins Gezgini'ni açtığınızda Modeller paneli ortamınızdaki tüm kullanılabilir modelleri otomatik olarak göstermelidir.
Ancak istediğiniz zaman paneli el ile yenileyebilir ve Azure Digital Twins örneğinizdeki tüm modellerin listesini yeniden yükleyebilirsiniz. Bunu yapmak için Modelleri yenile simgesini seçin.
Grafı içeri/dışarı aktarma
İkiz Graf panelinde, grafik özelliklerini içeri ve dışarı aktarma seçenekleriniz vardır.
Grafı içeri aktarma
Örneğinize ikizler, ilişkiler ve modeller eklemek için içeri aktarma özelliğini kullanabilirsiniz. Bu özellik aynı anda çok sayıda ikiz, ilişki ve/veya model oluşturmak için yararlı olabilir.
Not
Graf içeri aktarma dosyanızda modeller varsa bunlar toplu model karşıya yükleme sınırlamalarına tabi olacaktır.
İçeri aktarma dosyası oluşturma
Grafı içeri aktarmanın ilk adımı, eklemek istediğiniz ikizleri ve ilişkileri temsil eden bir dosya oluşturmaktır.
İçeri aktarma dosyası şu iki biçimden birinde olabilir:
- Grafik dışarı aktarmada oluşturulan JSON tabanlı biçim. Bu biçim ikizler, ilişkiler ve/veya modeller içerebilir.
- Bu bölümün geri kalanında açıklanan özel Excel tabanlı biçim . Bu biçim ikizleri ve ilişkileri karşıya yüklemenizi sağlar.
Excel'de içeri aktarma dosyası oluşturma
Excel'de ikizleri ve ilişkileri Azure Digital Twins Gezgini'ne yükleyebilen özel bir grafik oluşturmak için aşağıdaki biçimi kullanın.
Her satır oluşturulacak bir öğeyi temsil eder: ikiz, ilişki veya ikiz ile karşılık gelen ilişkinin birleşimi. İkiz veya ilişki verilerini yapılandırmak için aşağıdaki sütunları kullanın. Sütun adları özelleştirilebilir, ancak bu sırada kalmalıdır.
| ModelKimliği | Kimlik | İlişki (kaynak) | İlişki Adı | Başlatma Verileri |
|---|---|---|---|---|
| (İsteğe bağlı) Yeni ikiz için kullanılacak modelin DTMI kimliği. Bu model tanımı örnekte zaten mevcut olmalıdır. Bu satırın yalnızca ilişki oluşturmasını istiyorsanız (ikiz olmadan) bu sütunu bir satır için boş bırakabilirsiniz. |
(Gerekli) İkiz için benzersiz kimlik. Bu satırda yeni bir ikiz oluşturuluyorsa, bu değer yeni ikizin kimliği olacaktır. Satırda ilişki bilgileri varsa, bu kimlik ilişkinin hedefi olarak kullanılır. |
(İsteğe bağlı) Yeni bir ilişki için kaynak ikiz olması gereken ikizin kimliği. Bu satırın yalnızca bir ikiz (ilişki yok) oluşturmasını istiyorsanız, bu sütunu bir satır için boş bırakabilirsiniz. |
(İsteğe bağlı) Oluşturulacak yeni ilişkinin adı. İlişki yönü C sütunundaki ikizden B sütunundaki ikize doğru olacaktır. |
(İsteğe bağlı) oluşturulacak ikiz için özellik ayarlarını içeren bir JSON dizesi. Özellikler, A sütunundan modelde tanımlananlarla eşleşmelidir. |
aşağıda, iki kat ve iki odadan oluşan küçük bir grafik oluşturan .xlsx örnek bir dosya verilmiş.
Bu dosyayı ve diğer .xlsx grafik örneklerini GitHub'daki Azure Digital Twins Explorer deposunda görüntüleyebilirsiniz.
Not
.xlsx açıklanan özellikler ve ilişkiler, ilgili ikizler için model tanımlarında tanımlananlarla eşleşmelidir.
Dosyayı Azure Digital Twins Gezgini'ne aktarma
Makinenizde içeri aktarılmaya hazır bir dosyanız olduğunda, İkiz Grafik panelinde Grafı İçeri Aktar simgesini seçin.
Görüntülenen dosya seçici kutusunda, makinenizde karşıya yüklemek istediğiniz grafik dosyasına (.xlsx veya .json) gidin ve karşıya yüklemek için Aç'ı seçin.
Azure Digital Twins, içeri aktarılacak grafiğin önizlemesini gösteren bir İçeri Aktarma paneli açar. Onaylamak için panelin sağ üst köşesindeki Kaydet simgesini seçin.
İçeri aktarma başarılı olursa, karşıya yüklenen modellerin, ikizlerin ve ilişkilerin sayısını kalıcı bir pencere görüntüler.
Grafı ve modelleri dışarı aktarma
Modelleri, ikizleri ve ilişkileri içeren kısmi veya eksiksiz grafikleri dışarı aktarmak için dışarı aktarma özelliğini kullanabilirsiniz. Dışarı aktarma, ikizleri ve ilişkileri hem en son sorgu sonuçlarından hem de örnekteki tüm modellerden makinenize indirebileceğiniz JSON tabanlı bir biçime serileştirir.
Başlamak için, indirmek istediğiniz ikizleri ve ilişkileri seçen bir sorgu çalıştırmak için Sorgu Gezgini panelini kullanın. Bunun yapılması, bunları İkiz Grafik panelinde doldurur.
İpucu
Tüm ikizleri ve ilişkileri görüntülemek için sorgu şeklindedir SELECT * FROM digitaltwins.
İkiz Graf paneli grafiğin indirmek istediğiniz bölümünü gösterdikten sonra Grafı Dışarı Aktar simgesini seçin.
Bu eylem, İkiz Grafik kutusunda İndir bağlantısını etkinleştirir. Sorgu sonucunun JSON tabanlı bir gösterimini ve örneğinizdeki tüm modelleri makinenize indirmek için seçin.
İpucu
Bu dosya, içeri aktarma özelliği aracılığıyla düzenlenebilir ve/veya Azure Digital Twins'e yeniden yüklenebilir.
Ortamınıza ve belirli bir sorguya bağlanma
İş üzerinde işbirliği yapmak için Azure Digital Twins Explorer ortamınızın bağlantısını başkalarıyla paylaşabilirsiniz. Bu bölümde, isteğe bağlı olarak bağlantı açıldığında çalıştırılacak belirli bir sorgu içerebilen Azure Digital Twins Explorer ortamınıza nasıl bağlantı oluşturulacağı açıklanmaktadır. Bu bölümde, ikiz verilerinizle etkileşim kurmak için alıcının sahip olması gereken izinler de açıklanır.
Alıcı erişim gereksinimleri
Alıcının bağlantıyı açması ve örneği Azure Digital Twins Gezgini'nde görüntülemesi için Azure hesabında oturum açması ve örneğe Azure Digital Twins Veri Okuyucusu erişimi olmalıdır (Güvenlik bölümünde Azure Digital Twins rolleri hakkında daha fazla bilgi edinebilirsiniz).
Alıcının grafikte ve verilerde değişiklik yapabilmesi için örnekte Azure Digital Twins Veri Sahibi rolüne sahip olması gerekir.
Belirli bir sorguyla ortama bağlantı oluşturma
Azure Digital Twins Gezgini ortamınıza belirli bir sorgu içeren bir bağlantı oluşturmak için, Sorgu Gezgini'ne yakalamak istediğiniz sorguyu girin ve ardından Paylaş düğmesini seçerek tam bağlantıyı kopyalayın.
Yukarıdaki ekran görüntüsündeki örnek ve sorgu için Paylaş düğmesi şu bağlantıyı oluşturur: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins%20T%20WHERE%20T.InFlow%20%3E%2070&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. Bağlantı, Azure Digital Twins örneğinin kiracı kimliğini ve konak adını ve biçimlendirilmiş sorgu metnini içerir.
Birinin örneğinize ve bu sorguya erişmesine izin vermek için bu URL'yi paylaşabilirsiniz. Bağlantıyla Azure Digital Twins Gezgini'ni açtıklarında, sorgunun sonuçları İkiz Grafik panelinde otomatik olarak doldurulur.
Belirli bir sorgu olmadan ortama bağlantı oluşturma
Azure Digital Twins Gezgini ortamınıza belirli bir sorgu eklenmemiş bir bağlantıyı paylaşmak için, bağlantıyı örneğinize kopyalamak için Paylaş düğmesini kullanarak başlayın.
Ardından, sorgu parametresini sonuçtan el ile kaldırın.
Örneğin, yukarıdaki ekran görüntüsündeki Paylaş düğmesi şu bağlantıyı oluşturur: https://explorer.digitaltwins.azure.net/?query=SELECT%20*%20FROM%20digitaltwins&tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>. URL'yi query=SELECT%20*%20FROM%20digitaltwins&https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-instance-host-name>oluşturmak için bölümünü kaldırabilirsiniz.
Ardından, birinin örneğinize erişmesine izin vermek için bu URL'yi paylaşın. Bağlantıyla Azure Digital Twins Gezgini'ni açtıklarında örneğinize bağlanırlar ve önceden doldurulmuş sorgu sonuçlarını görmezler.
Erişilebilirlik ve gelişmiş ayarlar
Deneyiminizi özelleştirmek veya daha erişilebilir hale getirmek için Azure Digital Twins Gezgini için çeşitli gelişmiş ayarları etkinleştirebilirsiniz.
Azure Digital Twins Gezgini'nde gezinmek için kullanılabilecek klavye kısayollarının listesini görüntülemek için sağ üst araç çubuğundaki Klavye Kısayolları simgesini kullanabilirsiniz.
Sağ üst araç çubuğundaki Ayarlar dişlisinin altında erişilebilen çeşitli gelişmiş özellikler vardır:
- İstekli Yükleme: Bir sorgu, sorgu sonuçlarına dahil olmayan diğer ikizlere ilişkisi olan ikizleri döndürdüğünde, bu özellik grafı işlemeden önce "eksik" ikizleri yükler.
- Önbelleğe Alma: Bu özellik etkinleştirildiğinde Azure Digital Twins Gezgini, sorgu performansını geliştirmek için ilişkilerin ve modellerin yerel önbelleğini bellekte tutar. Bu önbellekler, hem ilgili öğelerdeki tüm yazma işlemlerinde hem de tarayıcı yenilemesinde temizlenir. Bu özellik varsayılan olarak kapalıdır.
- Konsol: Bu özellik, grafikle çalışmak için basit kabuk işlevlerini kullanabilen bir konsol penceresinin görüntülenmesini sağlar.
- Çıkış: Bu özellik, işlemlerin tanılama izlemesini gösteren bir çıkış penceresinin görüntülenmesini sağlar.
- Yüksek Karşıtlık: Bu özellik, Azure Digital Twins Gezgini'nin renklerini değiştirerek daha yüksek karşıtlıkla görünmelerini sağlar.
Azure Digital Twins Gezgini'ni (Sorgu Gezgini, İkizler, Modeller, İkiz Grafiği, Model Grafı) oluşturan panellerin konumlarını düzenleyerek panel düzenini özelleştirebilirsiniz. Bir paneli farklı bir konuma taşımak için panel adına tıklayıp basılı tutun ve yeni istenen konuma sürükleyin.
Tarayıcı penceresi yenilendikten sonra panel konumları sıfırlanır.
Sonraki adımlar
Azure Digital Twins ikiz grafiği için sorgu yazma hakkında bilgi edinin: