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 tüm veri kaynakları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.

Sözdizimi

evaluateazure_digital_twins_query_request ( AdtInstanceEndpoint , AdtQuery )

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

Parametreler

Ad	Tür	Zorunlu	Açıklama
AdtInstanceEndpoint	string	✔️	Sorgulanacak Azure Digital Twins örnek 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. Sorgu ç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 bilgiler Azure Digital Twins çözümleri için Güvenlik bölümünde bulunabilir.

Ö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österilmektedir.

Azure Digital Twins örneği içindeki tüm ikizlerin alınması

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ütun olarak ikiz özelliklerinin projeksiyonu

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

Çıktı

TemperatureInC	Nem
21	48
49	34
80	32

Zaman serisi analizi gerçekleştirme

Dijital ikiz özellik güncelleştirmelerini geçmişe almak 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