azure_digital_twins_query_request-invoegtoepassing

De azure_digital_twins_query_request invoegtoepassing voert een Azure Digital Twins-query uit als onderdeel van een KQL-query (Kusto-querytaal). De invoegtoepassing wordt aangeroepen met de evaluate operator.

Met de invoegtoepassing kunt u query's uitvoeren op gegevens in zowel Azure Digital Twins als elke gegevensbron die toegankelijk is via KQL. U kunt bijvoorbeeld tijdreeksanalyses uitvoeren.

Zie Azure Digital Twins-queryinvoegtoepassing voor Azure Data Explorer voor meer informatie over de invoegtoepassing.

Syntax

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
AdtInstanceEndpoint	string	✔️	Het eindpunt van het Azure Digital Twins-exemplaar dat moet worden opgevraagd.
AdtQuery	string	✔️	De query die moet worden uitgevoerd op het Azure Digital Twins-eindpunt. Deze query is geschreven in een aangepaste SQL-achtige querytaal voor Azure Digital Twins, de Azure Digital Twins-querytaal. Zie Querytaal voor Azure Digital Twins voor meer informatie.

Verificatie en autorisatie

De azure_digital_twins_query_request invoegtoepassing gebruikt het Microsoft Entra-account van de gebruiker die de query uitvoert om te verifiëren. Als u een query wilt uitvoeren, moet een gebruiker ten minste de rol Azure Digital Twins-gegevenslezer krijgen. Informatie over het toewijzen van deze rol vindt u in Beveiliging voor Azure Digital Twins-oplossingen.

Voorbeelden

In de volgende voorbeelden ziet u hoe u verschillende Azure Digital Twins-query's kunt uitvoeren, waaronder query's die gebruikmaken van aanvullende Kusto-expressies.

Ophalen van alle dubbels in een Azure Digital Twins-exemplaar

In het volgende voorbeeld worden alle digitale dubbels in een Azure Digital Twins-exemplaar geretourneerd.

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

Projectie van dubbeleigenschappen als kolommen, samen met aanvullende Kusto-expressies

Het volgende voorbeeld retourneert het resultaat van de invoegtoepassing als afzonderlijke kolommen en voert vervolgens aanvullende bewerkingen uit met behulp van Kusto-expressies.

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

Uitvoer

TemperatureInC	Vochtigheid
21	48
49	34
80	32

Tijdreeksanalyse uitvoeren

U kunt de functie voor gegevensgeschiedenisintegratie van Azure Digital Twins gebruiken om updates van digitale dubbeleigenschappen te historiseren. Zie De updates voor historized dubbels weergeven in Azure Data Explorer