Azure Digital Twins için veri geçmişi bağlantısı oluşturma

Veri geçmişi, Azure Veri Gezgini'de graf güncelleştirmelerini otomatik olarak geçmişe döndürmeye yönelik bir Azure Digital Twins özelliğidir. Bu veriler, zaman içinde ortamınız hakkında içgörüler elde etmek üzere Azure Veri Gezgini için Azure Digital Twins sorgu eklentisi kullanılarak sorgulanabilir.

Bu makalede, Azure Digital Twins ile Azure Veri Gezgini arasında çalışan bir veri geçmişi bağlantısının nasıl ayarlanacağı gösterilmektedir. Aşağıdakiler de dahil olmak üzere gerekli veri geçmişi kaynaklarını ayarlamak ve bağlamak için Azure CLI ve Azure portalını kullanır:

• Azure Digital Twins örneği
• olay hub'ı içeren bir Event Hubs ad alanı
• veritabanı içeren bir Azure Veri Gezgini kümesi

Ayrıca Azure Veri Gezgini'de geçmişe geçmiş grafik güncelleştirmelerini görmek için kullanabileceğiniz örnek bir ikiz grafiği içerir.

Önkoşullar

Ortamınızı Azure CLI’ye hazırlama

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

CLI oturumlarını ayarlama

CLI'da Azure Digital Twins ile çalışmaya başlamak için ilk yapmanız gereken oturum açmak ve cli bağlamını bu oturum için aboneliğinize ayarlamaktır. CLI pencerenizde şu komutları çalıştırın:

az login
az account set --subscription "<your-Azure-subscription-ID>"

Bu aboneliği Azure Digital Twins ile ilk kez kullanıyorsanız, Azure Digital Twins ad alanına kaydolmak için bu komutu çalıştırın. (Emin değilseniz, geçmişte yapmış olsanız bile yeniden çalıştırmanız sorun değildir.)

az provider register --namespace 'Microsoft.DigitalTwins'

Ardından Azure Digital Twins ve diğer IoT hizmetleriyle etkileşime yönelik komutları etkinleştirmek üzere Azure CLI için Microsoft Azure IoT Uzantısı'nı ekleyeceksiniz. Uzantının en son sürümüne sahip olduğunuzdan emin olmak için şu komutu çalıştırın:

az extension add --upgrade --name azure-iot

Artık Azure CLI'da Azure Digital Twins ile çalışmaya hazırsınız.

Kullanılabilir en üst düzey Azure Digital Twins komutlarının listesini görmek için istediğiniz zaman komutunu çalıştırarak az dt --help bunu doğrulayabilirsiniz.

CLI oturumu için yerel değişkenleri ayarlama

Bu makalede, veri geçmişi kaynaklarını oluşturmak için kullanabileceğiniz CLI komutları sağlanır. Bu komutları daha sonra kopyalayıp çalıştırmayı kolaylaştırmak için şimdi CLI oturumunuzda yerel değişkenleri ayarlayabilir ve sonra kaynaklarınızı oluştururken CLI komutlarında bu değişkenlere başvurabilirsiniz. Aşağıdaki komutlarda yer tutucuları (köşeli ayraçlarla <...> tanımlanır) güncelleştirin ve değişkenleri oluşturmak için bu komutları çalıştırın. Açıklamalarda açıklanan adlandırma kurallarını izlediğinden emin olun. Bu değerler daha sonra yeni kaynaklar oluşturulurken kullanılacaktır.

## General Setup
location="<your-resource-region>"
resourcegroup="<your-resource-group-name>"

## Azure Digital Twins Setup
# Instance name can contain letters, numbers, and hyphens. It must start and end with a letter or number, and be between 4 and 62 characters long.
dtname="<name-for-your-digital-twins-instance>"
# Connection name can contain letters, numbers, and hyphens. It must contain at least one letter, and be between 3 and 50 characters long.
connectionname="<name-for-your-data-history-connection>"

## Event Hub Setup
# Namespace can contain letters, numbers, and hyphens. It must start with a letter, end with a letter or number, and be between 6 and 50 characters long.
eventhubnamespace="<name-for-your-event-hub-namespace>"
# Event hub name can contain only letters, numbers, periods, hyphens and underscores. It must start and end with a letter or number.
eventhub="<name-for-your-event-hub>"

## Azure Data Explorer Setup
# Cluster name can contain only lowercase alphanumeric characters. It must start with a letter, and be between 4 and 22 characters long.
clustername="<name-for-your-cluster>"  
# Database name can contain only alphanumeric, spaces, dash and dot characters, and be up to 260 characters in length.
databasename="<name-for-your-database>"

# Enter a name for the table where relationship create and delete events will be stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events will be stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates will be stored. If not provided, the table will be named AdtPropertyEvents.
twinpropertytablename="<name-for-your-twin-property-events-table>"

Yönetilen kimlikle Azure Digital Twins örneği oluşturma

Zaten bir Azure Digital Twins örneğiniz varsa, bunun için sistem tarafından atanan bir yönetilen kimliği etkinleştirdiğinizden emin olun.

Azure Digital Twins örneğiniz yoksa, sistem tarafından atanan yönetilen kimliğe sahip bir Azure Digital Twins örneği oluşturmak için Yönetilen kimlikle örneği oluşturma başlığındaki yönergeleri izleyin.

Ardından örnekte Azure Digital Twins Veri Sahibi rolünüz olduğundan emin olun. Yönergeleri Kullanıcı erişim izinlerini ayarlama bölümünde bulabilirsiniz.

Örneğinizin adını yerel CLI değişkenlerinize eklemek isterseniz, bu makaleden kopyalanan sonraki komutlara otomatik olarak eklenecektir, bunu aşağıdaki gibi değişkende dtname depolayın:

dtname="<name-of-your-instance>"

Event Hubs ad alanı ve olay hub'ı oluşturma

Sonraki adım bir Event Hubs ad alanı ve olay hub'ı oluşturmaktır. Bu hub, Azure Digital Twins örneğinden grafik yaşam döngüsü ve özellik güncelleştirme bildirimleri alır ve ardından iletileri hedef Azure Veri Gezgini kümesine iletir.

Daha sonra veri geçmişi bağlantısı kurulumunun bir parçası olarak, Azure Digital Twins örneğine olay hub'ı kaynağında Azure Event Hubs Veri Sahibi rolünü verirsiniz.

Event Hubs ve özellikleri hakkında daha fazla bilgi için Event Hubs belgelerine bakın.

az eventhubs namespace create --name $eventhubnamespace --resource-group $resourcegroup --location $location

az eventhubs eventhub create --name $eventhub --resource-group $resourcegroup --namespace-name $eventhubnamespace

Kusto (Azure Veri Gezgini) kümesi ve veritabanı oluşturma

Ardından, Azure Digital Twins'den veri almak için bir Kusto (Azure Veri Gezgini) kümesi ve veritabanı oluşturun.

Daha sonra veri geçmişi bağlantısı kurulumunun bir parçası olarak, Azure Digital Twins örneğine en azından veritabanında Katkıda Bulunan rolünü (küme kapsamında da olabilir) ve veritabanındaki Yönetici rolünü verirsiniz.

az extension add --name kusto

az kusto cluster create --cluster-name $clustername --sku name="Dev(No SLA)_Standard_E2a_v4" tier="Basic" --resource-group $resourcegroup --location $location --type SystemAssigned

az kusto database create --cluster-name $clustername --database-name $databasename --resource-group $resourcegroup --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=$location

Veri geçmişi bağlantısını ayarlama

Gerekli kaynakları oluşturduğunuza göre bu bölümdeki komutunu kullanarak Azure Digital Twins örneği, olay hub'ı ve Azure Veri Gezgini kümesi arasında veri geçmişi bağlantısı oluşturun.

Bu komut ayrıca sırasıyla ikiz özellik güncelleştirmelerini, ikiz yaşam döngüsü olaylarını ve ilişki yaşam döngüsü olaylarını depolamak için Azure Veri Gezgini veritabanınızda üç tablo oluşturur. Bu geçmişe geçmiş veri türleri ve bunlara karşılık gelen Azure Veri Gezgini tabloları hakkında daha fazla bilgi için bkz. Veri türleri ve şemalar.

az dt data-history connection create adx --dt-name $dtname --cn $connectionname --adx-cluster-name $clustername --adx-database-name $databasename --eventhub $eventhub --eventhub-namespace $eventhubnamespace --adx-property-events-table $twinpropertytablename --adx-twin-events-table $twinlifecycletablename --adx-relationship-events-table $relationshiplifecycletablename --adx-record-removals true

Veri geçmişi bağlantısını ayarladıktan sonra isteğe bağlı olarak Event Hubs ve Azure Veri Gezgini kaynaklarına erişmek için Azure Digital Twins örneğine verilen rolleri kaldırabilirsiniz. Veri geçmişini kullanmak için, örneğin ileride ihtiyaç duyduğu tek rol Event Hubs kaynağındaki Azure Event Hubs Veri Göndereni (veya Azure Event Hubs Veri Sahibi gibi bu izinleri içeren daha yüksek bir rol) rolüdür.

Veri geçmişi kaynaklarına ağ erişimini kısıtlama

Ağ erişimini veri geçmişindeki kaynaklara (Azure Digital Twins örneğiniz, olay hub'ınız veya Azure Veri Gezgini kümeniz) kısıtlamak istiyorsanız, veri geçmişi bağlantısını ayarladıktan sonra bu kısıtlamaları ayarlamanız gerekir. Buna, ağ erişimini azaltmaya yönelik diğer ölçülerin yanı sıra kaynaklarınız için yerel erişimi devre dışı bırakma dahildir.

Veri geçmişi kaynaklarınızın birbiriyle iletişim kuradığından emin olmak için Azure Veri Gezgini veritabanının veri bağlantısını sistem tarafından atanan yönetilen kimliği kullanacak şekilde de değiştirmeniz gerekir.

Kaynaklarınızın daha az ağ erişimine ihtiyacı olduğunda veri geçmişi bağlantınızın düzgün ayarlandığından emin olmak için aşağıdaki adımların sırasını izleyin.

1. Veri geçmişi kaynaklarınızda (Azure Digital Twins örneğiniz, olay hub'ınız ve Azure Veri Gezgini kümeniz) yerel yetkilendirmenin etkinleştirildiğinden emin olun
2. Veri geçmişi bağlantısını oluşturma
3. Azure Veri Gezgini veritabanının veri bağlantısını sistem tarafından atanan yönetilen kimliği kullanacak şekilde güncelleştirin. Azure portalında, Azure Veri Gezgini kümesine gidip veri geçmişi veritabanına gitmek için menüdeki Veritabanları'nı kullanarak bunu yapabilirsiniz. Veritabanı menüsünde Veri bağlantıları'nı seçin. Veri geçmişi bağlantınızın tablo girişinde, Sistem tarafından atanan seçeneğini belirleyebileceğiniz Yönetilen kimlik ata seçeneğini görmeniz gerekir.
4. Artık Azure Digital Twins örneğinizdeki, olay hub'ınızın veya Azure Veri Gezgini kümenizdeki erişim ayarlarını değiştirerek yerel yetkilendirmeyi devre dışı bırakabilir veya istediğiniz kaynaklar için diğer ağ kısıtlamalarını ayarlayabilirsiniz.

Bağlantı kurulumu sorunlarını giderme

Veri geçmişi bağlantısı kurarken karşılaşabileceğiniz birkaç yaygın hata ve bunların nasıl çözüleceğini burada bulabilirsiniz.

• Azure Veri Gezgini kümeniz için genel ağ erişimi devre dışı bırakıldıysa, hizmetin veri geçmişi bağlantısını oluşturamadığına ilişkin bir hatayla karşılaşırsınız ve "Kaynak bir iç sunucu hatası nedeniyle ACT yapamadı" iletisiyle karşılaşırsınız. Azure Digital Twins tabloları ve diğer gerekli yapıtları yapılandıramayacağından, Azure Veri Gezgini kümesinde genel ağ erişimi devre dışı bırakılırsa veri geçmişi kurulumu başarısız olur.
• (CLI kullanıcıları) "Azure Digital Twins örnek bağlantısı oluşturulamadı. Veritabanında tablo ve eşleme kuralı oluşturulamadı. Azure Veritabanı Gezgini izinlerinizi denetleyin ve kimlik bilgilerinizi yenilemek için komutunu çalıştırınaz login." hatasını çözmek için kendinizi Bir AllDatabases olarak ekleyin Yönetici Azure Veri Gezgini kümenizdeki İzinler bölümüne ekleyin.
• (Cloud Shell kullanıcıları) Cloud Shell kullanıyorsanız ve "MSI'ye bağlanılamadı. Lütfen MSI'nin doğru yapılandırıldığından emin olun", bunun yerine komutu yerel bir Azure CLI yüklemesi ile çalıştırmayı deneyin.

Örnek ikiz grafı ile doğrulama

Artık veri geçmişi bağlantınız ayarlandıysa dijital ikizlerinizdeki verilerle test edebilirsiniz.

Azure Digital Twins örneğinizde grafik güncelleştirmelerini etkin bir şekilde alan ikizleriniz varsa (ikiz özellik güncelleştirmeleri veya öğeleri oluşturarak veya silerek grafın yapısını değiştirme güncelleştirmeleri dahil), bu bölümü atlayabilir ve sonuçları kendi kaynaklarınızı kullanarak görselleştirebilirsiniz.

Aksi takdirde, ikiz ve ilişki yaşam döngüsü olaylarına tabi tutulacak bir örnek graf ayarlamak ve ikiz özellik güncelleştirmeleri oluşturmak için bu bölüm boyunca devam edin.

Azure Digital Twins Veri Simülatörü'ni kullanarak bu senaryo için örnek bir grafik ayarlayabilirsiniz. Azure Digital Twins Veri Simülatörü, Azure Digital Twins örneğinizde ikizler ve ilişkiler oluşturur ve özellik güncelleştirmelerini sürekli olarak ikizlere iletir.

Örnek grafik oluşturma

Azure Digital Twins Veri Simülatörü'ni kullanarak örnek bir ikiz grafı sağlayabilir ve ona özellik güncelleştirmeleri gönderebilirsiniz. Burada oluşturulan ikiz grafı, bir süt ürünleri şirketi için pastörizasyon işlemlerini modeller.

Tarayıcınızda Azure Digital Twins Veri Simülatörünü açarak başlayın. Şu alanları ayarlayın:

• Örnek URL'si: Azure Digital Twins örneğinizin ana bilgisayar adını girin. Ana bilgisayar adı örneğinizin portal sayfasında bulunabilir ve gibi <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.netbir biçime sahiptir.
• Simülasyon Türü: Açılan menüden Süt ürünleri tesisi'ni seçin.

Ortam Oluştur'a tıklayın.

Ortamınızda modeller, ikizler ve ilişkiler oluşturulurken ekranda onay iletileri görürsünüz. Bu, sırasıyla azure Veri Gezgini ikiz ve ilişki yaşam döngüsü olayları olarak geçmişe alınabilecek ikiz ve ilişki oluşturma olayları da oluşturur.

Simülasyon hazır olduğunda Benzetimi başlat düğmesi etkinleştirilir. Simülasyon verilerini Azure Digital Twins örneğine göndermek için ekranı aşağı kaydırın ve Benzetimi başlat'ı seçin. Azure Digital Twins örneğinizdeki ikizleri sürekli güncelleştirmek için bu tarayıcı penceresini masaüstünüzde ön planda tutun ve diğer tarayıcı eylemlerini ayrı bir pencerede tamamlayın. Bu, Azure Veri Gezgini'de geçmişe aktarılacak ikiz özellik güncelleştirme olaylarını sürekli olarak oluşturur.

Azure Veri Gezgini'da geçmişe geçmiş güncelleştirmeleri görüntüleme

Bu bölümde simülatör tarafından oluşturulan ve Azure Veri Gezgini tablolarında depolanan üç geçmişe geçmiş güncelleştirme türünün nasıl görüntülendiğini göreceksiniz.

Azure portalından başlayın ve daha önce oluşturduğunuz Azure Veri Gezgini kümesine gidin. Veritabanı görünümünü açmak için soldaki menüden Veritabanları bölmesini seçin. Bu makale için oluşturduğunuz veritabanını bulun ve yanındaki onay kutusunu seçin, ardından Sorgu'yu seçin.

Ardından, veri geçmişi tablolarının adını görmek için sol bölmedeki kümeyi ve veritabanını genişletin. Üç tane olmalıdır: bir ilişki yaşam döngüsü olayları, biri ikiz yaşam döngüsü olayları ve biri ikiz özellik güncelleştirme olayları için. Geçmişe geçmiş verileri doğrulamak ve görüntülemek için tablolarda sorgu çalıştırmak için bu tablo adlarını kullanacaksınız.

Tablo girdilerini doğrulama

Olayların veritabanında geçmişe alındığını doğrulamak için aşağıdaki komutu kopyalayarak başlayın. İlişki yaşam döngüsü olayları tablosunun adı için bir yer tutucusu vardır ve her 10 saniyede bir canlı simülasyondan veri almak için tablonun alımını toplu moda dönüştürür.

.alter table <relationship-lifecycle-events-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

Komutu sorgu penceresine yapıştırın ve yer tutucuyu ilişki olayları tablonuzun adıyla değiştirin. Komutunu çalıştırmak için Çalıştır düğmesini seçin.

İkiz yaşam döngüsü olayları tablosunun adını ve ardından diğer tabloların alım modunu güncelleştirmek için özellik güncelleştirme tablosunu kullanarak komutu iki kez daha tekrarlayın.

Ardından, aşağıdaki komutları sorgu penceresine ekleyin ve çalıştırın. Her komut, tablolardan birinin adı için bir yer tutucu içerir ve komutlar tablolardaki öğe sayısını verir.

<relationship-lifecycle-events-table-name>
| count

<twin-lifecycle-events-table-name>
| count

<twin-property-updates-table-name>
| count

Sonuçlarda, her tablodaki öğe sayısının 0'dan büyük olduğunu ve ilişki yaşam döngüsünün, ikiz yaşam döngüsünün ve özellik güncelleştirme olaylarının ilgili tablolarında geçmişe alındığını görmeniz gerekir.

İkiz özellik güncelleştirmeleri tablosunu keşfetme

Bu bölümde, tabloda yer alan ikiz özellik güncelleştirme verileriyle biraz daha araştırma yapacaksınız.

İlk olarak, aşağıdaki komutu çalıştırarak tablodaki 100 kaydı görüntüleyin:

<twin-property-updates-table-name>
| limit 100

Ardından, bağlamsal zaman serisi verilerini görmek için ikizlerinizin verilerini temel alan bir sorgu çalıştırın.

Örnek Oslo süt ürünleri fabrikasındaki tüm tuz makinesi ikizlerinin çıkışını grafik olarak görüntülemek için aşağıdaki sorguyu kullanın. Bu Kusto sorgusu, Azure Digital Twins eklentisini kullanarak ilgi çekici ikizleri seçer, bu ikizleri Azure Veri Gezgini'daki veri geçmişi zaman serisine göre birleştirir ve ardından sonuçları grafikler. Yer tutucuyu <ADT-instance-host-name> örneğinizin ana bilgisayar adıyla ve yer tutucuyu <table-name> da ikiz özellik olayları tablonuzun adıyla değiştirdiğinden emin olun.

let ADTendpoint = "https://<ADT-instance-host-name>";
let ADTquery = ```SELECT SALT_MACHINE.$dtId as tid
FROM DIGITALTWINS FACTORY 
JOIN SALT_MACHINE RELATED FACTORY.contains 
WHERE FACTORY.$dtId = 'OsloFactory'
AND IS_OF_MODEL(SALT_MACHINE , 'dtmi:assetGen:SaltMachine;1')```;
evaluate azure_digital_twins_query_request(ADTendpoint, ADTquery)
| extend Id = tostring(tid)
| join kind=inner (<table-name>) on Id
| extend val_double = todouble(Value)
| where Key == "OutFlow"
| render timechart with (ycolumns = val_double)

Sonuçlar, zaman içinde değişen taşma sayılarını göstermelidir.

Bağlantı sorunlarını giderme

Azure Veri Gezgini'da veri görmüyorsanız, geçmişe alma veri akışı düzgün çalışmıyor. Event Hubs ad alanınızı Azure portalında görüntüleyerek sorunu araştırabilirsiniz. Bu, ad alanına ileti akışını gösteren grafikler görüntüler. Bu, akışın hangi bölümünün çalışmadığını belirlemenize yardımcı olmak için hem Azure Digital Twins'den gelen iletilerin akışını hem de Azure Veri Gezgini giden iletileri doğrulamanıza olanak tanır.

Sonraki adımlar

Süt ürünleri senaryosunu keşfetmeye devam etmek için GitHub'da makine türü, fabrika, bakım teknisyeni ve bu parametrelerin çeşitli bileşimlerine göre süt ürünleri işleminin performansını nasıl izleyebilebileceğinizi gösteren daha fazla örnek sorgu görüntüleyebilirsiniz.

Süt ürünleri işleminin performansını görselleştiren Grafana panoları oluşturmak için Bkz. Azure Digital Twins, Azure Veri Gezgini ve Grafana ile pano oluşturma.

Azure Veri Gezgini için Azure Digital Twins sorgu eklentisini kullanma hakkında daha fazla bilgi için bkz. Azure Veri Gezgini eklentisiyle sorgulama ve bu blog gönderisi. Eklenti hakkında daha fazla bilgiyi burada da okuyabilirsiniz: Azure Veri Gezgini eklentisiyle sorgulama.