Język zapytań usługi Azure Digital Twins
W tym artykule opisano podstawy języka zapytań i jego możliwości. Pamiętaj, że centrum usługi Azure Digital Twins jest grafem bliźniaczej reprezentacji bliźniaczej skonstruowanym na podstawie cyfrowych reprezentacji bliźniaczych i relacji. Ten graf można odpytować, aby uzyskać informacje o cyfrowych reprezentacjach bliźniaczych i relacjach, które zawiera. Te zapytania są zapisywane w niestandardowym języku zapytań przypominającym język SQL, nazywanym językiem zapytań usługi Azure Digital Twins. Ten język jest podobny do języka zapytań IoT Hub z wieloma porównywalnymi funkcjami.
Aby uzyskać bardziej szczegółowe przykłady składni zapytań i sposób uruchamiania żądań zapytań, zobacz Query the twin graph (Wykonywanie zapytań względem grafu bliźniaczej reprezentacji).
Informacje o zapytaniach
Możesz użyć języka zapytań usługi Azure Digital Twins, aby pobrać cyfrowe reprezentacje bliźniacze zgodnie z ich...
- Właściwości (w tym właściwości tagu)
- Modele
- Relacje
- Właściwości relacji
Aby przesłać zapytanie do usługi z poziomu aplikacji klienckiej, użyjesz interfejsu API zapytań usługi Azure Digital Twins. Jednym ze sposobów korzystania z interfejsu API jest użycie jednego z zestawów SDK dla usługi Azure Digital Twins.
Dokumentacja referencyjna
Odwołanie do języka zapytań można znaleźć w sekcji Dokumentacja po lewej stronie spisu treści dokumentacji usługi Azure Digital Twins. Możesz również przejść bezpośrednio do sekcji referencyjnych, korzystając z poniższych linków:
Zagadnienia dotyczące wykonywania zapytań
Podczas pisania zapytań dotyczących usługi Azure Digital Twins należy pamiętać o następujących kwestiach:
Pamiętaj wielkość liter: w przypadku wszystkich operacji zapytań usługi Azure Digital Twins uwzględniana jest wielkość liter, dlatego należy używać dokładnych nazw zdefiniowanych w modelach. Jeśli nazwy właściwości są błędnie napisane lub niepoprawnie oznaczone literą, zestaw wyników jest pusty bez zwracanych błędów.
Ucieczka pojedynczych cudzysłowów: jeśli tekst zapytania zawiera pojedynczy znak cudzysłowu w danych, cudzysłów musi zostać uniknięta znakiem
\. Oto przykład, który zajmuje się wartością właściwości D'Souza:SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
Uwaga
Po wprowadzeniu zmiany danych na grafie może wystąpić opóźnienie do 10 sekund, zanim zmiany zostaną odzwierciedlone w zapytaniach.
Interfejs API Usługi DigitalTwins odzwierciedla zmiany natychmiast, więc jeśli potrzebujesz natychmiastowej odpowiedzi, użyj żądania interfejsu API (DigitalTwins GetById) lub wywołania zestawu SDK (GetDigitalTwin), aby pobrać dane bliźniaczej reprezentacji zamiast zapytania.
Wykonywanie zapytań dotyczących danych z historizowaną reprezentacją bliźniaczą w czasie
Język zapytań usługi Azure Digital Twins służy tylko do wykonywania zapytań dotyczących obecnego stanu cyfrowych reprezentacji bliźniaczych i relacji.
Aby uruchamiać zapytania dotyczące zebranych w czasie danych wykresu bliźniaczej reprezentacji bliźniaczej, użyj funkcji historii danych, aby połączyć wystąpienie usługi Azure Digital Twins z klastrem usługi Azure Data Explorer. Spowoduje to automatyczne historizowanie aktualizacji grafu w usłudze Azure Data Explorer, gdzie można wykonywać zapytania przy użyciu wtyczki usługi Azure Digital Twins dla usługi Azure Data Explorer.
Następne kroki
Dowiedz się, jak pisać zapytania i wyświetlać przykłady kodu klienta w artykule Wykonywanie zapytań względem grafu reprezentacji bliźniaczej.