azure_digital_twins_query_request eklentisi

Eklenti, azure_digital_twins_query_request Kusto Sorgu Dili (KQL) sorgusunun parçası olarak bir Azure Digital Twins sorgusu çalıştırır. Eklenti işleciyle birlikte çağrılır evaluate .

Eklentiyi kullanarak hem Azure Digital Twins'deki verileri hem de KQL aracılığıyla erişilebilen herhangi bir veri kaynağını sorgulayabilirsiniz. Örneğin, zaman serisi analizi gerçekleştirebilirsiniz.

Eklenti hakkında daha fazla bilgi için bkz. Azure Veri Gezgini için Azure Digital Twins sorgu eklentisi.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad	Tür	Gerekli	Açıklama
AdtInstanceEndpoint	string	✔️	Sorgulanacak Azure Digital Twins örneği uç noktası.
AdtQuery	string	✔️	Azure Digital Twins uç noktasında çalıştırılacak sorgu. Bu sorgu, Azure Digital Twins için Azure Digital Twins sorgu dili olarak adlandırılan sql benzeri özel bir sorgu dilinde yazılır. Daha fazla bilgi için bkz. Azure Digital Twins için sorgu dili.

Kimlik doğrulaması ve yetkilendirme

Eklenti, azure_digital_twins_query_request kimlik doğrulaması için sorguyu çalıştıran kullanıcının Microsoft Entra hesabını kullanır. Bir sorguyu çalıştırmak için kullanıcıya en azından Azure Digital Twins Veri Okuyucusu rolü verilmelidir. Bu rolün nasıl atanacağıyla ilgili bilgileri Azure Digital Twins çözümleri için güvenlik bölümünde bulabilirsiniz.

Örnekler

Aşağıdaki örneklerde, ek Kusto ifadeleri kullanan sorgular da dahil olmak üzere çeşitli Azure Digital Twins sorgularını nasıl çalıştırabileceğiniz gösterilir.

Azure Digital Twins örneği içindeki tüm ikizleri alma

Aşağıdaki örnek, bir Azure Digital Twins örneği içindeki tüm dijital ikizleri döndürür.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

Ek Kusto ifadeleriyle birlikte sütunlar olarak ikiz özelliklerinin yansıtılma

Aşağıdaki örnek, eklentinin sonucunu ayrı sütunlar olarak döndürür ve ardından Kusto ifadelerini kullanarak ek işlemler gerçekleştirir.

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

Çıkış

TemperatureInC	Nem oranı
21	48
49	34
80	32

Zaman serisi analizi gerçekleştirme

Dijital ikiz özellik güncelleştirmelerini geçmişe kaydetmek için Azure Digital Twins'in veri geçmişi tümleştirme özelliğini kullanabilirsiniz. Geçmişe geçmiş ikiz güncelleştirmelerini görüntülemeyi öğrenmek için bkz. Azure'da geçmişe geçmiş ikiz güncelleştirmelerini görüntüleme Veri Gezgini