Gunakan indeks sekunder di konsol Tablestore untuk mempercepat kueri data - Tablestore

Fitur indeks sekunder memungkinkan Anda mengkueri data berdasarkan kunci utama tabel dan kolom indeks dari indeks sekunder yang dibuat. Ini mempercepat proses kueri data. Saat membuat indeks sekunder, Anda dapat menetapkan kolom indeks atau atribut ke kolom yang telah ditentukan sebelumnya sesuai dengan kebutuhan bisnis Anda. Setelah pembuatan indeks sekunder, Anda dapat langsung menggunakannya untuk mengkueri data.

Prasyarat

Tabel data dengan parameter Max Versions disetel ke 1 telah dibuat. Salah satu kondisi berikut harus dipenuhi oleh parameter TTL tabel data:

Parameter TTL tabel data disetel ke -1, yang berarti data dalam tabel tidak pernah kedaluwarsa.
Jika parameter TTL tabel data tidak disetel ke -1, parameter Allow Updates harus disetel ke No.

Catatan

TTL indeks sekunder sama dengan TTL tabel data.

Langkah 1: (Opsional) Tambahkan kolom yang telah ditentukan sebelumnya

Jika Anda membuat indeks sekunder untuk tabel yang tidak memiliki kolom yang telah ditentukan sebelumnya atau jika kolom tersebut tidak memenuhi persyaratan bisnis Anda, Anda dapat menambahkan atau menghapus kolom yang telah ditentukan sebelumnya.

Catatan

Anda juga dapat menambahkan kolom yang telah ditentukan sebelumnya saat membuat tabel data. Untuk informasi lebih lanjut, lihat Langkah 3: Buat tabel data.

Buka halaman Manage Table.
1. Masuk ke konsol Tablestore.
2. Di halaman Overview, klik nama instance.
3. Di bagian Tables tab Instance Details, klik nama tabel data yang ingin dikelola.
Di bagian Pre-defined Column modul Advanced Features pada tab Basic Information, klik Add Pre-defined Column.
Di kotak dialog Add Pre-Defined Column, klik + Add di samping Kolom yang Ditentukan Sebelumnya. Tentukan nama untuk kolom tersebut dan pilih tipe data dari daftar drop-down.
- Konvensi penamaan untuk kolom yang telah ditentukan sebelumnya: Nama harus memiliki panjang 1 hingga 255 byte dan dapat berisi huruf, angka, serta garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_).
- Kolom yang telah ditentukan sebelumnya mendukung tipe data berikut: STRING, INTEGER, BINARY, FLOAT, dan BOOLEAN. Jika Anda ingin menggunakan kolom sebagai kolom indeks dari indeks sekunder, pilih STRING, INTEGER, atau BINARY dari daftar drop-down.
Catatan
Setelah Anda klik Add Pre-Defined Column, Anda dapat menambahkan beberapa kolom secara batch. Anda juga dapat mengklik ikon di samping kolom untuk menghapusnya.
Klik OK.
Kolom yang telah ditentukan sebelumnya akan muncul dalam daftar kolom.
Untuk menghapus kolom dari daftar, klik ikon di kolom Hapus Kolom yang Ditentukan Sebelumnya.

Langkah 2: Buat indeks sekunder

Anda dapat membuat indeks sekunder dan menggunakannya untuk mempercepat kueri data. Indeks sekunder mencakup indeks global dan lokal. Pilih jenis indeks berdasarkan kebutuhan bisnis Anda.

Catatan

Anda dapat membuat indeks sekunder saat membuat tabel data. Untuk informasi lebih lanjut, lihat Langkah 3: Buat tabel data.

Buka halaman Manage Table.
1. Masuk ke konsol Tablestore.
2. Di halaman Overview, klik nama instance.
3. Di bagian Tables tab Instance Details, klik nama tabel data yang ingin dikelola.
Di tab Indexes, klik Create Secondary Index.

Dalam kotak dialog Create Index, konfigurasikan parameter-parameter berikut.

fig_20221020_indexsecondary001

Tabel berikut menjelaskan parameter.

Parameter	Deskripsi
Tipe Indeks	Tipe indeks. Nilai parameter ini disetel ke Secondary Index dan tidak dapat diubah.
Nama Instance	Nama instance. Anda tidak dapat mengubah nilai parameter ini.
Nama Tabel	Nama tabel data tempat Anda ingin membuat indeks sekunder. Anda tidak dapat mengubah nilai parameter ini.
Nama Indeks	Nama indeks sekunder yang ingin Anda buat. Penting Nama tersebut tidak boleh sama dengan nama tabel data dan tabel time series yang sudah ada.
Tipe Indeks	Tipe indeks sekunder. Nilai valid: Indeks Sekunder Global: Tablestore secara otomatis menyinkronkan data dari kolom yang diindeks dan kolom kunci utama tabel data ke kolom tabel indeks yang ingin Anda buat dalam mode asinkron. Kolom kunci utama pertama tabel indeks bisa menjadi kolom kunci utama atau kolom yang telah ditentukan sebelumnya dari tabel data. Indeks Sekunder Lokal: Tablestore secara otomatis menyinkronkan data dari kolom yang diindeks dan kolom kunci utama tabel data ke kolom tabel indeks yang ingin Anda buat dalam mode sinkron. Setelah data ditulis ke tabel data, Anda dapat langsung mengkueri data di tabel indeks. Kolom kunci utama pertama tabel indeks harus menjadi kolom kunci utama pertama tabel data.
Data yang Ada	Menentukan apakah akan menyertakan data yang ada dari tabel data dalam indeks sekunder. Nilai valid: Sertakan Data yang Ada Kecualikan Data yang Ada

Pilih kolom kunci utama untuk indeks sekunder berdasarkan urutan tipe indeks yang Anda tentukan lalu klik Add Primary Key Column. Ulangi langkah ini setiap kali Anda memilih kolom kunci utama.
Anda hanya dapat menetapkan kolom kunci utama ke kolom yang telah ditentukan sebelumnya dengan tipe STRING, INTEGER, atau BINARY.
Pilih kolom yang telah ditentukan sebelumnya sebagai kolom atribut untuk indeks sekunder dan klik Add Pre-defined Column. Ulangi langkah ini setiap kali Anda memilih kolom yang telah ditentukan sebelumnya.

Klik OK.
Indeks sekunder yang Anda buat akan muncul dalam daftar indeks.

Langkah 3: Kueri data

Anda dapat menggunakan kueri baris tunggal atau kueri rentang untuk tabel indeks guna mengambil data yang diperlukan.

Lakukan kueri rentang

Buka halaman Manage Table.
1. Masuk ke konsol Tablestore.
2. Di halaman Overview, klik nama instance.
3. Di bagian Tables tab Instance Details, klik nama tabel data yang ingin dikelola.
Di tab Indexes, temukan indeks yang ingin digunakan untuk kueri dan klik Query di kolom Actions.
Di kotak dialog Search, tentukan kondisi kueri.
1. Atur parameter Modes ke Range Search.
2. Secara default, sistem mengembalikan semua kolom atribut. Untuk mengembalikan kolom tertentu, matikan All Columns dan tentukan kolom atribut yang ingin dikembalikan. Pisahkan beberapa kolom dengan koma (,).
3. Konfigurasikan parameter Kolom Kunci Utama Awal dan Kolom Kunci Utama Akhir.
  Penting
  Jika Anda menetapkan parameter Mode ke Pencarian Rentang, rentang yang ditentukan oleh nilai awal dan akhir di kolom kunci utama kanan hanya berlaku jika nilai awal dan akhir sama di setiap kolom kunci utama paling kiri. Jika nilai awal dan akhir di kolom kunci utama paling kiri berbeda, rentang yang ditentukan oleh nilai awal dan akhir di kolom kunci utama kanan tidak berlaku.
  Rentang yang didukung untuk kueri rentang adalah interval terbuka kiri, tertutup kanan.
4. Pertahankan nilai default parameter Max Versions.
5. Atur parameter Sequence ke Forward Search atau Backward Search.
Klik OK.
Data yang memenuhi kondisi kueri akan muncul dalam daftar data.

Lakukan kueri baris tunggal

Buka halaman Manage Table.
1. Masuk ke konsol Tablestore.
2. Di halaman Overview, klik nama instance.
3. Di bagian Tables tab Instance Details, klik nama tabel data yang ingin dikelola.
Di tab Indexes, temukan indeks yang ingin digunakan untuk kueri dan klik Query di kolom Actions.
Di kotak dialog Search, tentukan kondisi kueri.
1. Atur parameter Modes ke Get Row.
2. Secara default, sistem mengembalikan semua kolom atribut. Untuk mengembalikan kolom tertentu, matikan All Columns dan tentukan kolom atribut yang ingin dikembalikan. Pisahkan beberapa kolom dengan koma (,).
3. Konfigurasikan parameter Primary Key Value dari baris yang ingin dikueri.
  Integritas dan akurasi nilai kunci utama memengaruhi hasil kueri.
4. Pertahankan nilai default parameter Max Versions.
Klik OK.
Jika baris yang ingin dikueri termasuk dalam tabel indeks, Tablestore mengembalikan data dari baris tersebut. Jika tidak, tidak ada data yang dikembalikan.

FAQ

Referensi

Anda dapat menggunakan indeks sekunder melalui SDK Tablestore atau CLI Tablestore. Untuk informasi lebih lanjut, lihat Gunakan indeks sekunder global dengan menggunakan SDK Tablestore dan Indeks sekunder.
Untuk kueri data yang lebih efisien dan fleksibel, Anda dapat menggunakan fitur indeks pencarian. Fitur ini menyediakan berbagai metode kueri, termasuk kueri Boolean, pencarian teks lengkap, kueri awalan, dan kueri fuzzy. Untuk informasi lebih lanjut, lihat Ikhtisar.