Język zapytań usługi Azure Digital Twins

W tym artykule opisano podstawy języka zapytań i jego możliwości. Pamiętaj, że sednem usługi Azure Digital Twins jest graf bliźniaczy, zbudowany z cyfrowych bliźniaków 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ń usługi IoT Hub z wieloma porównywalnymi funkcjami.

Aby uzyskać bardziej szczegółowe przykłady składni zapytań i sposób ich uruchamiania, zobacz 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

Dokumentacja języka zapytań znajduje się 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:

• Klauzule
  • Wybierz
  • Z
  • MECZ
  • DOŁĄCZYĆ
  • GDZIE
• Funkcje
• Operatorzy
• Zastrzeżone słowa kluczowe

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 o wrażliwości na wielkość liter: We wszystkich operacjach zapytań usługi Azure Digital Twins uwzględniana jest precyzyjna 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 z niewłaściwą wielkością liter, zestaw wyników jest pusty, a błędy nie są zwracane.

• Escapowanie pojedynczych apostrofów: jeśli tekst zapytania zawiera pojedynczy znak apostrofu w danych, apostrof musi zostać uniknięty znakiem \. Oto przykład, który dotyczy wartości D'Souza:

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

• Jeśli używasz interfejsu wiersza polecenia platformy Azure do uruchamiania zapytań, może być konieczne zastosowanie znaków ucieczki dla niektórych dodatkowych znaków, aby spełnić wymagania różnych konsoli. Aby uzyskać więcej informacji, zobacz Używanie znaków specjalnych w różnych powłokach

Uwaga

Po wprowadzeniu zmiany danych na grafie może wystąpić opóźnienie do 10 sekund, zanim zmiany zostaną odzwierciedlone w zapytaniach.

Interfejs API DigitalTwins odzwierciedla zmiany natychmiast, więc jeśli potrzebujesz natychmiastowej odpowiedzi, użyj żądania API (DigitalTwins GetById) lub wywołania SDK (GetDigitalTwin), aby pobrać dane cyfrowego bliźniaka, zamiast używać zapytania.

Wykonywanie zapytań dotyczących historyzowanych danych bliźniaczych w czasie

Język zapytań Azure Digital Twins służy tylko do zapytania bieżącego stanu cyfrowych bliźniaków i relacji.

Aby uruchamiać zapytania dotyczące danych historycznych bliźniaczych wykresów zbieranych z czasem, użyj funkcji historii danych, aby połączyć instancję usługi Azure Digital Twins z klastrem 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 Wykonywanie zapytań względem grafu bliźniaczego.