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

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

İpucu

Bu makalede Azure portal kullansa da, geri kalan API'lerin 2022-05-31 sürümünü kullanarak da veri geçmişiyle ç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'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yi 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 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.

Not

Dilerseniz Bash ortamı yerine PowerShell ortamında Azure Cloud Shell de 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 oturum ayarlama

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

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

İpucu

Yukarıdaki komutta yer alan 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 bu komutu çalıştırın. (Emin değilseniz, geçmişte bir süre yapmış olsanız bile yeniden çalıştırmanız sorun olmaz.)

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.

Not

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 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, yönetilen kimlikle örnek oluşturma bölümündeki yönergeleri izleyerek sistem tarafından atanan yönetilen kimlikle ilk kez bir Azure Digital Twins örneği oluşturun.

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

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

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

Not

Veri geçmişi ayarlanırken olay hub'ına yerel yetkilendirmenin etkinleştirilmesi gerekir. Olay hub'ınızda yerel yetkilendirmenin devre dışı bırakılmasını 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 bölümünde açıklanan bazı izinleri ayarlamanız gerekir.

CLI

Gerekli kaynakları oluşturmak için aşağıdaki CLI komutlarını kullanın. Komutlar, CLI oturumu için yerel değişkenleri ayarlama bölümünde daha önce oluşturulmuş birkaç yerel değişken ($location, $resourcegroup, $eventhubnamespaceve $eventhub) 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 kullanarak olay hub'ı oluşturma başlığındaki yönergeleri izleyin. (Makalede ayrıca yeni bir kaynak grubu oluşturma yönergeleri de yer alır. Event Hubs kaynakları için yeni bir kaynak grubu oluşturabilir veya bu adımı atlayıp yeni Event Hubs kaynaklarınız için mevcut bir kaynak grubunu kullanabilirsiniz.)

Daha sonra kullanabilmeniz 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 verileri 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ü (küme kapsamında da olabilir) ve veritabanındaki Yönetici rolü 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ılırsa, 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, CLI oturumu için yerel değişkenleri ayarlama bölümünde daha önce oluşturulmuş birkaç yerel değişken ($location, $resourcegroup, $clusternameve $databasename) kullanır.

Henüz yoksa 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 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 (yukarıdan ve aynı konumdaki küme adını kullanarak). Bu veritabanı bağlamsal Azure Digital Twins verilerini depolamak için kullanılacaktı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 kaynaklara verdiğ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 azure Veri Gezgini veritabanınızda 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 üç 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.

CLI

Azure Veri Gezgini'da veri geçmişi bağlantısı ve tablolar oluşturmak için bu bölümdeki komutu kullanın. komutu her zaman geçmişe geçmiş ikiz özellik olayları 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.

Not

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ındaki kaynakları belirtebilirsiniz.

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

• Azure Veri Gezgini'da ilişki yaşam döngüsü ve ikiz yaşam döngüsü tablolarının adları (bu olay türlerinin geçmişe geçişini yapmak istemiyorsanız bu parametreler isteğe bağlıdır, ancak bu olay türlerinin geçmişlerini değiştirmek istiyorsanız gereklidir)
• İkiz özellik olay tablosunun adını belirtmek için isteğe bağlı bir parametre (bu değer sağlanmazsa, bu tablo varsayılan olarak AdtPropertyEvents olarak adlandırılır)
• İkiz özellik silme işlemleri için geçmişe dönüştürmeyi açmak için isteğe bağlı parametre --adx-record-removals (özellikleri tamamen kaldıran olaylar)

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

Yukarıdaki komutu yürütürken, veri geçmişi bağlantınızı sizin adınıza ayarlamak için gereken 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:

• Olay hub'ına Veri Sahibi Azure Event Hubs
• Katkıda bulunan kapsamı en az belirtilen veritabanı olarak belirlenmiştir (kapsamı küme olarak da belirlenebilir)
• Rol Yönetici (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

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

1. Örneğin menüsünün Çıkışları Bağla bölümünden Veri geçmişi'ni seçin.

   Bağlantı oluştur'u seçin. Bunu yaptığınızda veri geçmişi bağlantısı oluşturma işlemi başlatılı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'i 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.

   İleri’yi seç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 depolayacak tablo için özel bir ad seçebilir veya AdtPropertyEvents varsayılan tablo adını kullanmak için bunu boş bırakabilir ve ikiz özellik silmelerinin (özellikleri tamamen kaldıran olaylar) geçmişe geçmiş verilere eklenip eklenmeyeceğini seçebilirsiniz. İkiz yaşam döngüsünü ve ilişki yaşam döngüsü olaylarını geçmişe kaydetmek istiyorsanız, bu tablolar için özel adlar girin.

   İleri’yi seç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.

   İleri’yi seç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 yönlendirilirsiniz ve 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 ileride ihtiyaç duyduğu tek rol, Event Hubs kaynağındaki Veri Göndereni'ni (veya Azure Event Hubs Veri Sahibi gibi bu izinleri içeren daha yüksek bir rolü) Azure Event Hubs.

Not

Bağlantı kurulduktan sonra Azure Veri Gezgini kümenizdeki varsayılan ayarlar yaklaşık 10 dakika veya daha kısa bir veri alımı gecikmesine neden olur. Akış alımını (10 saniyeden kısa gecikme süresi) veya bir alma toplu işlemi ilkesini etkinleştirerek bu gecikme süresini azaltabilirsiniz. Azure Veri Gezgini alma 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. Buna, ağ erişimini azaltmaya yönelik diğer önlemlerin 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ğiştirmeniz gerekir.

Kaynaklarınıza daha az ağ erişimi gerektiğinde 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 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 aşağıda 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ığı bir hatayla karşılaşırsınız ve "Kaynak bir iç sunucu hatası nedeniyle ACT yapılamadı" 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. 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ı. 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ığından, bunu dijital ikizlerinizdeki verilerle test edebilirsiniz.

Azure Digital Twins örneğinizde grafik güncelleştirmelerini etkin olarak alan ikizleriniz varsa (ikiz özellik güncelleştirmeleri veya öğeleri oluşturarak veya silerek grafiğin 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 ve ikiz özellik güncelleştirmeleri oluşturacak bir örnek graf ayarlamak için bu bölümden 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 şirketi için pastörizasyon işlemlerini modeller.

Başlangıç olarak tarayıcınızda Azure Digital Twins Veri Simülatörü'ni açı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 tesisi'ni seçin.

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

Ortamınızda modeller, ikizler ve ilişkiler oluşturulduktan sonra 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 tarihlenecek olan ikiz ve ilişki oluşturma olayları da oluşturur.

Simülasyon hazır olduğunda Benzetimi başlat düğmesi etkinleştirilir. Sanal verileri 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'a geçmiş olacak ikiz özellik güncelleştirme olaylarını sürekli olarak oluşturur.

Veri akışını doğrulama

Verilerin veri geçmişi işlem hattından aktığını doğrulamak için Azure Digital Twins Gezgini'nde veri geçmişi doğrulamasını kullanabilirsiniz.

1. Azure Digital Twins Gezgini'ne gidin ve doğru örneğe bağlı olduğundan emin olun.

2. Grafikte görselleştirilecek geçmişe geçmiş ikiz özelliğini seçmek için Geçmişe geçmiş özellikleri doğrulama ve keşfetme bölümündeki yönergeleri kullanın.

Grafikte verilerin doldurulduğunu görüyorsanız Bu, Azure Digital Twins güncelleştirme olaylarının Azure Veri Gezgini başarıyla depolandığı anlamına gelir.

Grafikte veri görmüyorsanız , geçmişe alma veri akışı düzgün çalışmıyor. Azure portal Event Hubs ad alanınızı görüntüleyerek sorunu araştırabilirsiniz. Bu ad alanına ileti akışını gösteren grafikler görüntülenir. 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.

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

Veri geçmişi akışının Azure Veri Gezgini'a veri gönderdiğini doğruladığınıza göre, 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 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 ve 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: biri 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 üzere tabloda sorgu çalıştırmak için bu tablo adlarını kullanacaksınız.

İlişki ve ikiz yaşam döngüsü güncelleştirmelerini doğrulama

İlişki ve ikiz yaşam döngüsü olaylarını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 alabilmesi için tablonun alımını toplu moda değiştirir.

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

Sorgu penceresine komutu yapıştırın ve yer tutucusunu 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 alım modunu güncelleştirmek için işlemi aşağıdaki komutla tekrarlayın.

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

Ardından aşağıdaki komutları sorgu penceresine ekleyin ve çalıştırın. Her komut, ilişki yaşam döngüsü olayları tablosunun veya ikiz yaşam döngüsü olayları tablosunun adı için bir yer tutucu içerir ve komutlar tablolardaki öğe sayısını verir.

Not

Alınan verilerin ilk toplu işleminin görünmesi 5 dakika kadar sürebilir.

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

<twin-lifecycle-events-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ü ve ikiz yaşam döngüsü olaylarının ilgili tablolarında geçmişe alındığını görmeniz gerekir.

İkiz özelliği güncelleştirme tablosunu doğrulama ve keşfetme

Bu bölümde, ikiz özellik güncelleştirmelerinin ilgili tabloya geçmişlendiğini doğrulayacak ve gelen verilerle biraz daha araştırma yapacaksınız.

Aşağıdaki komutu çalıştırarak başlayın. Komutun ikizi özellik güncelleştirme tablosunun adı için bir yer tutucusu vardır ve tablonun alımını toplu moda değiştirerek canlı benzetimden 10 saniyede bir veri alır.

.alter table <twin-property-updates-table-name> policy ingestionbatching @'{"MaximumBatchingTimeSpan":"00:00:10", "MaximumNumberOfItems": 500, "MaximumRawDataSizeMB": 1024}'

Ardından, sorgu penceresine aşağıdaki komutu ekleyin ve Azure Veri Gezgini'ın tabloya ikiz güncelleştirmeleri geldiğini doğrulamak için komutunu çalıştırın.

Not

Alınan verilerin ilk toplu işleminin görünmesi 5 dakika kadar sürebilir.

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

Sonuçlarda tablodaki öğe sayısının 0'dan büyük olduğunu ve ikizi özellik güncelleştirme olaylarının tabloda tarihlendiğini görmeniz gerekir.

Tablodaki 100 kaydı görüntülemek için aşağıdaki komutu ekleyip çalıştırabilirsiniz:

<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ı grafiğini 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 veri geçmişi zaman serisine karşı birleştirir ve ardından sonuçların grafiğini oluşturur. 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.

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ünlerinin performansını nasıl izleyebilebileceğinizi gösteren daha fazla örnek sorgu görüntüleyebilirsiniz.

Süt ürünlerinin 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.