Bahasa kueri Azure Digital Twins

Artikel ini menjelaskan dasar-dasar bahasa kueri dan kemampuannya. Ingatlah bahwa pusat Azure Digital Twins adalah twin graph, yang dibentuk dari digital twins dan hubungan. Grafik ini dapat ditanyakan untuk mendapatkan informasi tentang kembar digital dan hubungan yang dimilikinya. 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 kembar digital 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 bawah 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
  • IKAT
  • MANA
• Fungsi
• Operator
• Kata kunci tercadang

Pertimbangan dalam melakukan kueri

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

• Ingat perbedaan antara huruf besar dan kecil: Semua operasi kueri Azure Digital Twins sensitif terhadap huruf besar dan kecil, jadi berhati-hatilah untuk menggunakan nama yang tepat sesuai definisi dalam model. Jika nama properti salah eja atau terdapat kesalahan dalam penggunaan huruf besar/kecil, maka kumpulan hasilnya akan kosong tanpa ada kesalahan yang dilaporkan.

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

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

• Jika Anda menggunakan Azure CLI untuk menjalankan kueri, Anda mungkin perlu keluar dari karakter tambahan tertentu untuk memenuhi persyaratan berbagai shell. Untuk informasi selengkapnya, lihat Menggunakan karakter khusus dalam shell yang berbeda

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.

Meminta data kembar yang tercatat secara sejarah seiring 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.