Gunakan indeks pencarian untuk mengambil indeks Lastpoint - Tablestore

Tambahkan indeks pencarian ke indeks Lastpoint untuk menjalankan filter multidimensi, kueri geografis, dan agregasi pada data deret waktu terbaru—kueri yang tidak dapat dilakukan hanya dengan indeks Lastpoint.

Mengapa menggunakan indeks pencarian pada indeks Lastpoint

Indeks Lastpoint hanya menyimpan titik data terbaru untuk setiap deret waktu. Misalnya, dalam skenario Internet of Vehicles (IoV), indeks Lastpoint berisi satu baris per kendaraan—berupa koordinat GPS terbaru, kecepatan, status, dan jarak tempuh.

Tabel berikut menunjukkan contoh data indeks Lastpoint untuk armada kendaraan:

_#h	_m_name	_data_source	_tags	_time	gps	speed	status	total_mileage	remaining_mileage
4c#PlatformA#07	Platform A	sensor1	["region=hangzhou","car_model=sedan","number_plate=ZheA D7512*","color=white"]	1730423400000000	30.245853,120.178564	0	Idle	20000	450
25#PlatformA#ae	Platform A	sensor2	["region=hangzhou","car_model=suv","number_plate=ZheC 72B2*","color=black"]	1730779800000000	30.245853,120.213654	80	Active	15050	250
b2#PlatformB#4b	Platform B	sensor3	["region=hangzhou","car_model=sedan","number_plate=ZheB 121*9","color=blue"]	1730862600000000	30.246022,120.124460	0	Idle	18230	270

Tanpa indeks pencarian, Anda hanya dapat mengambil baris berdasarkan kunci primernya (_#h). Untuk menjawab pertanyaan seperti "kendaraan mana yang saat ini idle dengan jarak tempuh tersisa lebih dari 300 km", Anda harus memindai semua baris dan melakukan filter di lapisan aplikasi—proses yang lambat dan mahal dalam skala besar.

Indeks pencarian yang dibangun di atas indeks Lastpoint mendukung indeks terbalik dan penyimpanan kolom, sehingga memungkinkan:

Kueri non-primary key — filter berdasarkan kolom atribut apa pun, seperti status kendaraan atau jarak tempuh tersisa
Kueri pencarian Boolean, fuzzy, dan teks lengkap — gabungkan kondisi dengan operator AND, OR, dan NOT
Kueri geografis — temukan catatan dalam area geografis tertentu
Kueri vektor tetangga terdekat (KNN) — pencarian kemiripan pada bidang vektor
Agregasi — hitung statistik max, min, count, dan group-by pada titik data terbaru

Catatan
Topik ini menyediakan skenario contoh penggunaan indeks pencarian untuk mengambil indeks Lastpoint. Untuk informasi selengkapnya, lihat Lampiran: Skenario contoh. Jika Anda ingin mempelajari lebih lanjut tentang fitur dan kemampuan indeks pencarian, lihat Indeks pencarian.

Prasyarat

Sebelum memulai, pastikan bahwa:

Indeks Lastpoint telah dibuat untuk tabel deret waktu. Untuk informasi selengkapnya, lihat Membuat indeks LastPoint.

Mengelola indeks pencarian dan mengkueri data

Kelola indeks pencarian dan kueri data di bagian LastPoint Index pada halaman Manage Time Series Table.

Membuat indeks pencarian

Buka halaman Instance Management.
1. Login ke Konsol Tablestore.
2. Pada bilah navigasi atas, pilih kelompok sumber daya dan wilayah.
3. Pada halaman Overview, klik nama instans atau klik Manage Instance di kolom Actions.
Buka halaman Manage Time Series Table.
1. Pada halaman Instance Management, klik tab Time Series Tables.
2. Pada tab Time Series Tables, klik nama tabel deret waktu atau klik Manage Data di kolom Actions.

Buat indeks pencarian untuk indeks Lastpoint.

Pada bagian LastPoint Index di tab Basic Information, klik Create Search Index di kolom Search Index dari indeks Lastpoint.

Pada kotak dialog Create Search Index, konfigurasikan parameter untuk indeks pencarian.

Pertahankan nama indeks default atau masukkan nama sesuai kebutuhan Anda.
Pilih metode pembuatan skema.
Penting
Nilai Field Name dan Field Type harus sesuai dengan nama dan tipe bidang di indeks Lastpoint. Untuk pemetaan antara tipe bidang di indeks Lastpoint dan indeks pencarian, lihat Tipe data.
- Jika Anda mengatur Schema Generation Type ke Manual, masukkan nama bidang, pilih tipe bidang, dan tentukan apakah akan mengaktifkan Array.
- Jika Anda mengatur Schema Generation Type ke Auto Generate, sistem akan menggunakan bidang-bidang di indeks Lastpoint sebagai bidang indeks. Pilih tipe bidang dan tentukan apakah akan mengaktifkan Array sesuai kebutuhan Anda.
Catatan
Kolom virtual memungkinkan Anda memetakan kolom tabel ke satu atau beberapa kolom virtual dalam indeks pencarian tanpa mengubah skema tabel. Gunakan kolom virtual untuk mempercepat kueri atau menerapkan metode tokenisasi yang berbeda. Untuk informasi selengkapnya, lihat Kolom virtual.

Untuk mengonfigurasi time to live (TTL), routing key, dan pengaturan pre-sorting, aktifkan Advanced Settings. Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
Routing key	Bidang routing yang digunakan untuk mengontrol distribusi data. Pilih satu atau beberapa kolom kunci primer. Catatan dengan nilai bidang routing yang sama ditempatkan dalam partisi data yang sama. Dalam kebanyakan kasus, satu bidang routing sudah cukup. Jika Anda menentukan beberapa bidang, nilai-nilainya digabungkan untuk membentuk kunci partisi.
Time to live	Periode retensi data dalam indeks pencarian. Satuan: detik. Nilai default: -1 (data tidak pernah kedaluwarsa). TTL harus minimal 86.400 detik (satu hari) atau -1. Tablestore secara otomatis menghapus data yang melebihi TTL.
Pre-sorting	Urutan pengurutan default untuk data yang dikembalikan. Nilai yang valid: Default (diurutkan berdasarkan kunci primer) dan Custom (diurutkan berdasarkan bidang yang Anda tentukan). Penting Indeks pencarian yang berisi bidang Nested tidak mendukung pre-sorting.

Klik OK.

Mengkueri data menggunakan indeks pencarian

Pada bagian LastPoint Index di tab Basic Information, klik Manage Data di kolom Search Index dari indeks Lastpoint.
Pada kotak dialog Search, kueri data.
1. Secara default, sistem mengembalikan semua kolom. Untuk mengembalikan kolom atribut tertentu, matikan All Columns untuk parameter Columns to Return dan masukkan kolom atribut yang diinginkan. Pisahkan beberapa kolom dengan koma (,).
  
  Catatan
  Semua kolom kunci primer dari indeks Lastpoint selalu dikembalikan.
2. Pilih operator logika: And, Or, atau Not.
  
  And mengembalikan baris yang memenuhi semua kondisi. Or dengan satu kondisi mengembalikan baris yang memenuhi kondisi tersebut; dengan beberapa kondisi, Or mengembalikan baris yang memenuhi setidaknya satu kondisi. Not mengembalikan baris yang tidak memenuhi kondisi yang ditentukan.
3. Pilih bidang indeks, klik Add, dan konfigurasikan parameter Query Type dan Value.
  
  Catatan
  Untuk menentukan beberapa nilai untuk suatu bidang, klik Add lagi untuk bidang yang sama dan atur Value yang berbeda.
4. Pengurutan dinonaktifkan secara default. Untuk mengurutkan hasil berdasarkan bidang tertentu, aktifkan Sort, tambahkan bidang pengurutan, dan konfigurasikan urutan pengurutan.
5. Pengumpulan statistik dinonaktifkan secara default. Untuk mengumpulkan statistik pada suatu bidang, aktifkan Collect Statistics, tambahkan bidang-bidang tersebut, dan konfigurasikan pengaturan statistik.
6. Klik Yes.
  
  Hasil kueri dan statistik ditampilkan di bagian LastPoint Index pada tab Basic Information.

Mengelola indeks pencarian

Tabel berikut menjelaskan operasi yang dapat Anda lakukan pada indeks pencarian.

Operasi

Deskripsi

Lihat detail indeks pencarian

Untuk melihat informasi dasar, informasi metering, routing key, bidang indeks, dan detail pre-sorting dari indeks pencarian:

Pada halaman Manage Time Series Table, klik tab Basic Information.
Pada bagian LastPoint Index, klik Index Details di kolom Search Index dari indeks Lastpoint.
Pada panel Index Details, tinjau informasi indeks.

Hapus indeks pencarian

Hapus indeks pencarian jika tidak lagi diperlukan.

Pada halaman Manage Time Series Table, klik tab Basic Information.
Pada bagian LastPoint Index, klik Delete di kolom Search Index dari indeks Lastpoint.
Pada kotak dialog Delete Search Index, konfirmasi informasi indeks dan klik OK.

Integrasi SDK

Gunakan SDK Tablestore berikut untuk bekerja dengan indeks pencarian pada indeks Lastpoint:

Penagihan

Membuat indeks Lastpoint gratis. Penyimpanan dan operasi baca pada data indeks Lastpoint dikenai biaya. Untuk informasi selengkapnya, lihat Item yang dikenai biaya pada model TimeSeries.
Mengkueri indeks Lastpoint melalui indeks pencarian dikenai biaya indeks pencarian. Untuk informasi selengkapnya, lihat Item yang dikenai biaya pada indeks pencarian.

FAQ

Lampiran: Skenario contoh

Dalam skenario Internet of Vehicles (IoV), sensor kendaraan melaporkan data deret waktu ke cloud. Aplikasi menyimpan, mengkueri, dan menganalisis data ini untuk kasus penggunaan seperti pemantauan status kendaraan, penentuan posisi armada, dan tampilan lintasan.

Tabel berikut menunjukkan contoh data dalam tabel deret waktu.

Catatan

Dalam contoh ini, _m_name, _data_source, dan _tags adalah pengenal deret waktu yang menentukan nama pengukuran, sumber data, dan informasi tag, secara berturut-turut. _time adalah timestamp pelaporan data. gps, speed, status, total_mileage, dan remaining_mileage adalah bidang data deret waktu yang menentukan koordinat GPS, kecepatan, status kendaraan, total jarak tempuh, dan jarak tempuh tersisa, secara berturut-turut.

_m_name	_data_source	_tags	_time	gps	speed	status	total_mileage	remaining_mileage
Platform A	sensor1	["region=hangzhou","car_model=sedan","number_plate=ZheA D7512*","color=white"]	1730422800000000	30.245853,120.178564	0	Idle	20000	450
Platform A	sensor1	["region=hangzhou","car_model=sedan","number_plate=ZheA D7512*","color=white"]	1730423400000000	30.245853,120.178564	0	Idle	20000	450
Platform A	sensor2	["region=hangzhou","car_model=suv","number_plate=ZheC 72B2*","color=black"]	1730779200000000	30.245278,120.150269	50	Active	15000	300
Platform A	sensor2	["region=hangzhou","car_model=suv","number_plate=ZheC 72B2*","color=black"]	1730779800000000	30.245853,120.213654	80	Active	15050	250
Platform B	sensor3	["region=hangzhou","car_model=sedan","number_plate=ZheB 121*9","color=blue"]	1730862000000000	30.246013,120.124470	60	Active	18200	300
Platform B	sensor3	["region=hangzhou","car_model=sedan","number_plate=ZheB 121*9","color=blue"]	1730862600000000	30.246022,120.124460	0	Idle	18230	270

Tablestore secara otomatis menyinkronkan titik data terbaru untuk setiap deret waktu ke indeks Lastpoint. Data indeks Lastpoint yang dihasilkan ditunjukkan dalam tabel pada bagian sebelumnya.

Berdasarkan persyaratan kueri berikut, buat indeks pencarian pada indeks Lastpoint untuk memanfaatkan kemampuan kuerinya secara penuh.

Temukan kendaraan yang saat ini idle dengan jarak tempuh tersisa lebih dari 300 km.
Temukan kendaraan dalam area geografis tertentu.
Temukan kecepatan maksimum di antara kendaraan yang saat ini aktif.

Buat indeks pencarian dengan bidang-bidang berikut: gps, speed, status, dan remaining_mileage.
Gunakan indeks pencarian untuk mengkueri data. Tabel berikut memetakan setiap persyaratan ke implementasinya.

Persyaratan kueri	Implementasi
Temukan kendaraan yang saat ini idle dengan jarak tempuh tersisa lebih dari 300 km	Gunakan kueri tepat pada `status` (nilai: "Idle") dikombinasikan dengan kueri rentang pada `remaining_mileage` (nilai > 300).
Temukan kendaraan dalam area geografis tertentu	Gunakan kueri geografis pada bidang `gps` untuk mengembalikan baris dalam koordinat target.
Temukan kecepatan maksimum di antara kendaraan yang saat ini aktif	Gunakan kueri cocok pada `status` (nilai: "Active") dengan agregasi max pada bidang `speed`.