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

Veri geçmişi , Azure Veri Gezgini'ne yönelik grafik 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'nde geçmişe geçmiş graf güncelleştirmelerini görmek için kullanabileceğiniz örnek bir ikiz grafı içerir.

Tavsiye

Bu makalede Azure portalı kullanılıyor olsa da, geri kalan API'lerin 2022-05-31 sürümünü kullanarak veri geçmişiyle de çalışabilirsiniz.

Ö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'i kullanmaya başlama.

  

• 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. Azure CLI'yi docker kapsayıcısında ç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 kullanarak Azure'da kimlik doğrulaması.

  • İ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 ve yönetme.

  • Sürümü ve yüklü bağımlı kütüphaneleri 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.

Uyarı

Dilerseniz Azure Cloud Shell'i Bash ortamı yerine PowerShell ortamında da kullanabilirsiniz. Bu sayfadaki komutlar Bash ortamı için yazılmıştır, bu nedenle PowerShell'de çalıştırılması için bazı küçük ayarlamalar yapılması gerekebilir.

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>"

Tavsiye

Önceki komuttaki kimlik yerine abonelik adınızı da kullanabilirsiniz.

Bu aboneliği Azure Digital Twins ile ilk kez kullanıyorsanız, Azure Digital Twins ad alanına kaydolmak için aşağıdaki komutu çalıştırın. (Emin değilseniz, geçmişte bir süre çalıştırmış olsanız bile yeniden çalıştırmanızda problem yok.)

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ı ekleyebilirsiniz. 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 bu durumu 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. Değişkenleri oluşturmak için aşağıdaki komutlarda yer tutucuları (köşeli ayraçlarla <...> tanımlanır) güncelleştirin ve ardından 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ılır.

Uyarı

Bu komutlar Bash ortamı için yazılır. PowerShell CLI ortamı kullanmayı tercih ediyorsanız PowerShell için ayarlanabilirler.

## 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 are stored.
relationshiplifecycletablename="<name-for-your-relationship-lifecycle-events-table>"
# Enter a name for the table where twin create and delete events are stored.
twinlifecycletablename="<name-for-your-twin-lifecycle-events-table>"
# Optionally, enter a custom name for the table where twin property updates are stored. If not provided, the table is 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 yönetilen kimliği etkinleştirdiğinizden emin olun.

Azure Digital Twins örneğiniz yoksa, ilk kez 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 takılabilir, bunu aşağıdaki gibi değişkende dtname depolayın:

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

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

Sonraki adım bir Event Hubs ad alanı ve olay hub'ı oluşturmaktır. Bu hub, Azure Digital Twins örneğinden graf 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 kaynak üzerinde Azure Event Hubs Veri Sahibi rolünü tanırsınız.

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

Uyarı

Veri geçmişi ayarlanırken olay hub'ına yerel yetkilendirmenin etkinleştirilmesi gerekir. Olay hub'ınızda yerel yetkilendirmeyi devre dışı bırakmak istiyorsanız, bağlantıyı ayarladıktan sonra yetkilendirmeyi devre dışı bırakın. Ayrıca, bu makalenin devamındaki Veri geçmişi kaynaklarına ağ erişimini kısıtlama başlığı altında açıklanan bazı izinleri ayarlamanız gerekir.

CLI

Gerekli kaynakları oluşturmak için aşağıdaki CLI komutlarını kullanın. Komutlar, $location yerel değişkenleri ayarlama bölümünde daha önce oluşturulmuş çeşitli yerel değişkenleri ($resourcegroup, $eventhubnamespace, $eventhubve ) kullanır.

Event Hubs ad alanı oluşturma:

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

Ad alanınızda bir olay hub'ı oluşturun:

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

Portal

Event Hubs ad alanı ve olay hub'ı oluşturmak için Azure portalını kullanarak olay hub'ı oluşturma başlığındaki yönergeleri izleyin. (Makale ayrıca yeni bir kaynak grubu oluşturma yönergelerini içerir. Event Hubs kaynakları için yeni bir kaynak grubu oluşturabilir veya bu adımı atlayabilir ve yeni Event Hubs kaynaklarınız için mevcut bir kaynak grubunu kullanabilirsiniz.)

Daha sonra kullanabilmek için bu kaynaklara verdiğiniz adları unutmayın.

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ı 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.

Önemli

Kümede genel ağ erişiminin etkinleştirildiğinden emin olun. Azure Veri Gezgini kümesinde genel ağ erişimi devre dışı bırakılmışsa, Azure Digital Twins tabloları ve diğer gerekli yapıtları yapılandıramaz ve veri geçmişi kurulumu başarısız olur.

CLI

Gerekli kaynakları oluşturmak için aşağıdaki CLI komutlarını kullanın. Komutlar, $location yerel değişkenleri ayarlama bölümünde daha önce oluşturulmuş çeşitli yerel değişkenleri ($resourcegroup, $clustername, $databasenameve ) kullanır.

Henüz sahip değilseniz CLI oturumunuza Kusto uzantısını ekleyerek başlayın.

az extension add --name kusto

Ardından Kusto kümesini oluşturun. Aşağıdaki komutun yürütülmesi 5-10 dakika sürer ve geliştirici katmanında bir E2a v4 kümesi oluşturur. Bu küme türü, altyapı ve veri yönetimi kümesi için tek bir düğüme sahiptir ve geliştirme ve test senaryoları için geçerlidir. Azure Veri Gezgini'ndeki katmanlar ve üretim iş yükünüz için doğru seçenekleri belirleme hakkında daha fazla bilgi için bkz. Azure Veri Gezgini kümeniz ve Azure Veri Gezgini Fiyatlandırması için doğru işlem SKU'su seçme.

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

Yeni Kusto kümenizde bir veritabanı oluşturun (daha önce belirtilen küme adını ve aynı konumda kullanarak). Bu veritabanı bağlamsallaştırılmış Azure Digital Twins verilerini depolamak için kullanılır. Aşağıdaki komut, geçici silme süresi 365 gün ve sık erişimli önbellek süresi 31 gün olan bir veritabanı oluşturur. Bu komut için kullanılabilen seçenekler hakkında daha fazla bilgi için bkz. az kusto database create.

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

Portal

Azure Veri Gezgini kümesi ve kümede veritabanı oluşturmak için Azure Veri Gezgini kümesi ve veritabanı oluşturma başlığındaki yönergeleri izleyin.

Daha sonra kullanabilmeniz için bu kaynaklar için belirttiğiniz adları unutmayın.

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 bir veri geçmişi bağlantısı oluşturun.

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

CLI

Azure Veri Gezgini'nde veri geçmişi bağlantısı ve tablolar oluşturmak için bu bölümdeki komutunu kullanın. komutu her zaman geçmişe geçmiş ikiz özellik güncelleştirmeleri için bir tablo oluşturur ve ilişki yaşam döngüsü ve ikiz yaşam döngüsü olayları için tabloları oluşturmaya yönelik parametreler içerir.

Uyarı

Varsayılan olarak, bu komut tüm kaynakların Azure Digital Twins örneğiyle aynı kaynak grubunda olduğunu varsayar. Bu komutun parametre seçeneklerini kullanarak farklı kaynak gruplarında yer alan kaynakları belirtebilirsiniz.

Aşağıdaki komut, CLI oturumu için yerel değişkenleri ayarlama bölümünde daha önce oluşturulmuş yerel değişkenleri kullanır ve...

• Azure Veri Gezgini'ndeki ilişki yaşam döngüsü ve ikiz yaşam döngüsü tablolarının adları (bu parametreler, bu olay türlerinin geçmişe geçişini yapmak istemiyorsanız isteğe bağlıdır, ancak bu olay türlerini geçmişe kaydetmek istiyorsanız gereklidir)
• İkiz özellik olay tablosunun adını belirtmek için isteğe bağlı bir parametredir (bu değer sağlanmazsa, bu tablo varsayılan olarak AdtPropertyEvents olarak adlandırılır). Başka bir ad belirtmek istemiyorsanız, çalıştırmadan önce parametresini komuttan kaldırın --adx-property-events-table .
• İkiz özelliklerin tamamen silindiği olaylar için geçmiş kaydı açma amacıyla isteğe bağlı parametre --adx-record-removals

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

Önceki komutu yürütürken, sizin yerinize veri geçmişi bağlantınızı ayarlamak için gerekli izinleri atama seçeneği verilir (gerekli izinleri zaten atadıysanız, bu istemleri atlayabilirsiniz). Bu izinler Azure Digital Twins örneğinizin yönetilen kimliğine verilir. Gerekli en düşük roller şunlardır:

• Azure Event Hubs olay hub'ında Veri Sahibi
• Katkıda bulunanın kapsamı en az belirtilen veritabanıyla belirlenmiştir (kapsamı küme olarak da belirlenebilir)
• Yönetici rolüyle (tablo oluşturma/yönetim için) belirtilen veritabanı kapsamına sahip veritabanı sorumlusu ataması

Normal veri düzlemi işlemi için bu roller, isterseniz tek bir Azure Event Hubs Veri Gönderen rolüne düşürülebilir.

Portal

Azure portalında Azure Digital Twins örneğine giderek başlayın (portal arama çubuğuna adını girerek örneği bulabilirsiniz). Ardından aşağıdaki adımları tamamlayın.

1. "Instance menüsü Bağlantı Çıkışları bölümünden Veri geçmişi'ni seçin."

   Bağlantı oluştur'u seçin. Bunun yapılması, veri geçmişi bağlantısı oluşturma işlemini başlatır.

2. (BAZI KULLANICILAR)Azure Digital Twins örneğiniz için etkinleştirilmiş bir yönetilen kimliğiniz yoksa, veri geçmişi bağlantısının ilk adımı olarak örnek için Kimlik özelliğini açmanızı isteyen bu sayfayı görürsünüz.

   

   Zaten etkinleştirilmiş bir yönetilen kimliğiniz varsa, kurulumunuz bu adımı atlar ve bir sonraki sayfayı hemen görürsünüz.

3. Gönder sayfasında, daha önce oluşturduğunuz Event Hubs kaynaklarının ayrıntılarını girin.

   sonrakiseçin.

4. Mağaza sayfasında, daha önce oluşturduğunuz Azure Veri Gezgini kaynaklarının ayrıntılarını girin. İkiz özellik güncelleştirmelerini depolayan tablo için özel bir ad seçebilir veya AdtPropertyEvents'in varsayılan tablo adını kullanmak için bunu boş bırakabilir ve ikiz özellik silmelerinin (özellikleri tamamen kaldıran olaylar) geçmiş verilere dahil edilip edilmeyeceğini seçebilirsiniz. İlişki yaşam döngüsünü ve ikiz yaşam döngüsü olaylarını geçmişe almak istiyorsanız, bu tablolar için özel adlar girin.

   sonrakiseçin.

5. İzin sayfasında, Azure Digital Twins örneğinize Event Hubs ve Azure Veri Gezgini kaynaklarına bağlanma izni vermek için tüm onay kutularını seçin. Zaten eşit veya daha yüksek izinlere sahipseniz, bu adımı atlayabilirsiniz.

   sonrakiseçin.

6. Gözden geçir ve oluştur sayfasında kaynaklarınızın ayrıntılarını gözden geçirin ve Bağlantı oluştur'u seçin.

Bağlantı oluşturma işlemi tamamlandığında Azure Digital Twins örneğinin Veri geçmişi sayfasına geri dönersiniz. Bu sayfada oluşturduğunuz veri geçmişi bağlantısının ayrıntıları gösterilir.

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 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.

Uyarı

Bağlantı kurulduktan sonra Azure Veri Gezgini kümenizdeki varsayılan ayarlar yaklaşık 10 dakika veya daha kısa bir veri alımı gecikme süresiyle sonuçlanır. Akış alımını (10 saniyeden kısa gecikme süresi) etkinleştirerek veya bir veri toplama politikasını kullanarak bu gecikmeyi azaltabilirsiniz. Azure Veri Gezgini alım gecikmesi hakkında daha fazla bilgi için bkz. Uçtan uca alım gecikmesi.

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. Bu kısıtlamalar arasında kaynaklarınız için yerel erişimi devre dışı bırakma ve ağ erişimini azaltmaya yönelik diğer önlemler yer alır.

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 daha az ağ erişimine ihtiyaç duyduğunda veri geçmişi bağlantınızın düzgün ayarlandığından emin olmak için aşağıdaki adımları sırayla gerçekleştirin:

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ı için 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 menüdeki Veritabanları'nı kullanarak veri geçmişi veritabanına giderek veri bağlantısını güncelleştirebilirsiniz. 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ğiniz, olay hub'ınız 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 EYLEMDE BULUNAMADı" iletisiyle karşılaşırsınız. Azure Digital Twins tabloları ve diğer gerekli yapıtları yapılandıramadığından, Azure Veri Gezgini kümesinde genel ağ erişimi devre dışı bırakıldıysa veri geçmişi kurulumu başarısız olur.
• (CLI kullanıcıları) "Azure Digital Twins örnek bağlantısı oluşturulamadı." hatasıyla karşılaşırsanız. Veritabanında tablo ve eşleme kuralı oluşturulamıyor. Azure Veritabanı Gezgini izinlerinizi denetleyin ve kimlik bilgilerinizi yenilemek için komutunu çalıştırın az login . Azure Veri Gezgini kümenizdeki İzinler'in altına kendinizi AllDatabasesAdmin olarak ekleyerek hatayı düzeltin.
• (Cloud Shell kullanıcıları) Cloud Shell kullanıyorsanız ve "MSI'ye bağlanılamadı" hatasıyla karşılaşıyorsanız. 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 olan 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. Host adı, örneğinizin portal sayfasında bulunabilir ve şu biçimdedir: <Azure-Digital-Twins-instance-name>.api.<region-code>.digitaltwins.azure.net.
• 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 işlem ayrıca ikiz ve ilişki oluşturma olayları üretir, bunlar sırasıyla ikiz ve ilişki yaşam döngüsü olayları olarak Azure Veri Gezgini'nde tarihsel olaylar olarak kaydedilir.

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 pencere sürekli olarak Azure Veri Gezgini'ne geçmiş ikiz özellik güncelleme olayları üretir.

Azure Veri Gezgini'nde 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üleyebileceğiniz gösterilmektedir.

Azure portalından başlayın ve daha önce oluşturduğunuz Azure Veri Gezgini kümesine gidin. Sorgu görünümünü açmak için soldaki menüden Veri'nin altındaki Sorgu bölmesini 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: biri ikiz özellik güncelleştirme olayları, biri ilişki yaşam döngüsü olayları ve biri ikiz yaşam döngüsü 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ı kullanırsı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 tutucu vardır ve tablonun veri alımını toplu moduna değiştirerek, canlı simülasyondan her 10 saniyede bir veri almasını sağlar.

.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.

Uyarı

Alınan verilerin ilk veri paketinin görünmesi 5 dakika kadar sürebilir.

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

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

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

Sonuçlarda, her tablodaki öğe sayısının sıfırdan büyük olduğunu ve özellik güncelleştirmesinin, ilişki yaşam döngüsünün ve ikizlerin yaşam döngüsü olaylarının ilgili tablolarına kaydedildiğini görmelisiniz.

İkiz mülk güncellemeleri tablosunu keşfedin

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.

Aşağıdaki sorguyu kullanarak örnek Oslo süt ürünleri fabrikasındaki tüm tuz makinesi ikizlerinin çıkışını grafikleyin. Bu Kusto sorgusu, Azure Digital Twins eklentisini kullanarak ilgi çekici ikizleri seçer, bu ikizleri Azure Veri Gezgini'ndeki veri geçmişi zaman serisine göre birleştirir ve ardından sonuçları grafikler. Yer tutucu <ADT-instance-host-name> 'yı örneğinizin ana bilgisayar adıyla, ve <table-name> 'yi de ikiz özellik güncelleştirme tablonuzun adıyla değiştirdiğinizden 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'nde veri görmüyorsanız, geçmişe alma veri akışı düzgün çalışmıyor demektir. Event Hubs ad alanınızı Azure portalında görüntüleyerek sorunu araştırabilirsiniz. Portal, ad alanına ve ad alanından çıkan ileti akışını gösteren grafikler görüntüler. Bu görüntü, 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'ne giden iletileri doğrulamanızı sağlar.

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.