Azure Digital Twins sorgu dili

Bu makalede sorgu dilinin temelleri ve özellikleri açıklanmaktadır. Azure Digital Twins'in merkezinin, dijital ikizlerden ve ilişkilerden oluşan 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, karşılaştırılabilir birçok ö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...

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

Bir istemci 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 SDK'larından birini kullanmaktır.

Başvuru belgeleri

Sorgu dili başvurusu, Azure Digital Twins belgelerinin sol içindekiler tablosunda başvuru bölümünde bulunabilir . Aşağıdaki bağlantıları kullanarak doğrudan başvuru bölümlerine de gidebilirsiniz:

• Yan tümceler
  • SELECT
  • KAYNAK
  • MAÇ
  • KATILIN
  • NEREDE
• İşlevler
• İşleçler
• Ayrılmış 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 tam olarak tanımlanan adları kullanmaya dikkat edin. Özellik adları yanlış yazılmışsa veya yanlış yazılmışsa sonuç kümesi boş olur ve hiçbir hata döndürülür.

• Tek tırnaklardan kaçış: Sorgu metninizde verilerde tek tırnak karakteri varsa, tırnak işaretinden karakterle birlikte \ kaçış karakteri alınması gerekir. Aşağıda D'Souza özellik değeriyle ilgilenen bir örnek verilmiştir:

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

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ıt almanız gerekiyorsa sorgu yerine ikizi verilerini almak için API isteği (DigitalTwins GetById) veya SDK çağrısı (GetDigitalTwin) kullanın.

Zaman içinde geçmişe 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 geçmiş ikiz grafı verileri üzerinde 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, Azure Veri Gezgini için graf güncelleştirmelerini otomatik olarak geçmişe döndürür ve burada Azure Veri Gezgini için Azure Digital Twins eklentisi kullanılarak sorgulanabilir.

Sonraki adımlar

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