Bahasa kueri Azure Digital Twins

Artikel ini menjelaskan dasar-dasar bahasa kueri dan kemampuannya. Ingatlah bahwa pusat Azure Digital Twins adalah twin graph, yang dibuat dari digital twins dan hubungan. Grafik ini dapat dikueir untuk mendapatkan informasi tentang digital twins dan hubungan yang dimuatnya. Kueri ini ditulis dalam bahasa kueri seperti SQL khusus, yang disebut sebagai bahasa kueri Azure Digital Twins. Bahasa ini mirip dengan bahasa kueri IoT Hub dengan banyak fitur yang sebanding.

Untuk contoh sintaks kueri yang lebih detail dan cara menjalankan permintaan kueri, lihat Membuat kueri grafik kembar.

Tentang pertanyaan

Anda dapat menggunakan bahasa kueri Azure Digital Twins untuk mengambil digital twins sesuai dengan...

• Properti (termasuk properti tag)
• Model
• Hubungan
  • Properti hubungan

Untuk mengirimkan kueri ke layanan dari aplikasi klien, Anda perlu menggunakan API Kueri Azure Digital Twins. Salah satu cara untuk menggunakan API adalah melalui salah satu SDK untuk Azure Digital Twins.

Dokumentasi rujukan

Referensi bahasa kueri dapat ditemukan di Referensi di daftar isi kiri untuk dokumentasi Azure Digital Twins. Anda juga dapat langsung masuk ke bagian referensi menggunakan tautan di bawah ini:

• Klausul
  • PILIH
  • DARI
  • PERTANDINGAN
  • IKUTI
  • DI MANA
• Fungsi
• Operator
• Kata Kunci yang Dicadangkan

Pertimbangan untuk mengkueri

Saat menulis kueri untuk Azure Digital Twins, perhatikan pertimbangan berikut:

• Ingat sensitivitas huruf besar-kecil: Semua operasi kueri Azure Digital Twins peka huruf besar-kecil, jadi berhati-hatilah untuk menggunakan nama persis yang ditentukan dalam model. Jika nama properti salah eja atau salah huruf, kumpulan hasil kosong tanpa kesalahan yang dikembalikan.

• Keluar dari tanda kutip tunggal: Jika teks kueri Anda menyertakan karakter tanda kutip tunggal dalam data, tanda kutip harus dikeluarkan dengan karakter \. Berikut adalah contoh yang berhubungan dengan nilai properti D'Souza:

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

Catatan

Setelah mengubah data di grafik Anda, terdapat kemungkinan latensi hingga 10 detik sebelum perubahan tersebut tercermin dalam kueri.

API DigitalTwins mencerminkan perubahan secara langsung, jadi jika Anda memerlukan respons instan, gunakan permintaan API (DigitalTwins GetById) atau panggilan SDK (GetDigitalTwin) untuk mendapatkan data kembar, alih-alih kueri.

Mengkueri data kembar historis dari waktu ke waktu

Bahasa kueri Azure Digital Twins hanya untuk mengkueri status saat ini dari kembar digital dan hubungan Anda.

Untuk menjalankan kueri pada data grafik kembar historis yang dikumpulkan dari waktu ke waktu, gunakan fitur riwayat data untuk menyambungkan instans Azure Digital Twins Anda ke kluster Azure Data Explorer. Ini akan secara otomatis menguraikan pembaruan grafik ke Azure Data Explorer, di mana mereka dapat dikueri menggunakan plugin Azure Digital Twins untuk Azure Data Explorer.

Langkah berikutnya

Pelajari cara menulis kueri dan lihat contoh kode klien di Mengkueri grafik kembar.