Azure Digital Twins sorgu dili

Bu makalede sorgu dilinin temelleri ve özellikleri açıklanmaktadır. Azure Digital Twins'in merkezinin dijital ikizler ve ilişkilerden oluşan bir ikiz grafiği olduğunu hatırlayın. Bu grafik, içerdiği dijital ikizler ve ilişkiler hakkında bilgi almak için sorgulanabilir. Bu sorgular, Azure Digital Twins sorgu dili olarak adlandırılan özel ve SQL benzeri bir sorgu diliyle yazılır. Bu dil, birçok benzer özelliğe sahip IoT Hub sorgu diline benzer.

Sorgu söz dizimi ve sorgu isteklerini çalıştırma hakkında daha ayrıntılı örnekler için bkz . İkiz grafını sorgulama.

Sorgular hakkında

Azure Digital Twins sorgu dilini kullanarak dijital ikizleri belirli kriterlere göre sorgulayabilirsiniz.

• Özellikler (etiket özellikleri dahil)
• Modeller
• İlişkiler
  • İlişkilerin özellikleri

İstemci uygulamasından hizmete sorgu göndermek için Azure Digital Twins Sorgu API'sini kullanacaksınız. API'yi kullanmanın bir yolu, Azure Digital Twins için SDK'lardan birini kullanmaktır.

Başvuru belgeleri

Sorgu dili referansına, Azure Digital Twins belgelerinin solundaki içindekiler tablosunda Referans bölümünde ulaşabilirsiniz. Aşağıdaki bağlantıları kullanarak doğrudan başvuru bölümlerine de gidebilirsiniz:

• Maddeler
  • SEÇMEK
  • KİMDEN
  • MAÇ
  • BİRLEŞTİRMEK
  • NEREDE
• İşlevler
• İşleçler
• Rezerve edilmiş anahtar sözcükler

Sorgulama için dikkat edilmesi gerekenler

Azure Digital Twins için sorgu yazarken aşağıdaki noktaları göz önünde bulundurun:

• Büyük/küçük harf duyarlılığını unutmayın: Tüm Azure Digital Twins sorgu işlemleri büyük/küçük harfe duyarlıdır, bu nedenle modellerde tanımlanan tam adları kullanmaya dikkat edin. Özellik adları yanlış yazılmış veya yanlış büyük/küçük harfle yazılmışsa, sonuç kümesi boş olur ve hiçbir hata döndürülmez.

• Verilerinizde tek tırnak karakteri varsa, bu tırnak karakterinin \ karakteriyle kaçış yapılması gerekir. D'Souza özellik değeriyle ilgilenen bir örnek aşağıda verilmiştir:

  SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
  

• Sorguları çalıştırmak için Azure CLI kullanıyorsanız, çeşitli kabukların gereksinimlerini karşılamak için bazı ek karakterlerden kurtulmanız gerekebilir. Daha fazla bilgi için bkz. Farklı kabuklarda özel karakterler kullanma

Not

Grafiğinizdeki verilerde değişiklik yaptıktan sonra değişikliklerin sorgulara yansıtılması için 10 saniyeye kadar gecikme süresi olabilir.

DigitalTwins API'sinde değişiklikler hemen yansıtılır. Bu nedenle anlık yanıta ihtiyacınız varsa sorgu yerine ikizi veri almak için API isteği (DigitalTwins GetById) veya SDK çağrısı (GetDigitalTwin) kullanın.

Zaman içinde geçmiş ikiz verilerini sorgulama

Azure Digital Twins sorgu dili yalnızca dijital ikizlerinizin ve ilişkilerinizin mevcut durumunu sorgulamak içindir.

Zaman içinde toplanan geçmişe dayalı ikiz grafı verilerinde sorgu çalıştırmak için veri geçmişi özelliğini kullanarak Azure Digital Twins örneğinizi bir Azure Veri Gezgini kümesine bağlayın. Bu işlem, Azure Veri Gezgini'nde Azure Digital Twins eklentisi kullanılarak sorgulanabilecek graf güncellemelerini otomatik olarak arşivler.

Sonraki adımlar

İkiz grafını sorgulama bölümünde sorgu yazmayı ve istemci kodu örneklerini görmeyi öğrenin.