Gunakan indeks sekunder di konsol untuk mempercepat kueri data - Tablestore

Fitur indeks sekunder memungkinkan Anda melakukan kueri data berdasarkan kunci primer tabel data dan kolom indeks dari indeks sekunder yang dibuat untuk tabel tersebut, sehingga mempercepat kueri data. Saat membuat indeks sekunder, Anda dapat menetapkan kolom indeks atau kolom atribut indeks sekunder ke kolom pradefinisi yang telah ditentukan untuk tabel tempat indeks sekunder akan dibuat. Setelah indeks sekunder dibuat, Anda dapat menggunakannya untuk melakukan kueri data.

Prasyarat

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

Parameter TTL tabel data diatur ke -1, yang berarti data dalam tabel tidak pernah kedaluwarsa.
Jika Time to Live (TTL) tabel data bukan -1, tabel tersebut tidak mengizinkan pembaruan. Artinya, opsi Allow Updates diatur ke No.

Catatan

TTL indeks sekunder sama dengan TTL tabel data.

Langkah 1: (Opsional) Tambahkan kolom pradefinisi

Jika Anda ingin membuat indeks sekunder untuk suatu tabel tetapi tabel tersebut belum memiliki kolom pradefinisi atau kolom pradefinisi yang ada tidak memenuhi kebutuhan bisnis Anda, Anda dapat menambahkan atau menghapus kolom pradefinisi pada tabel tersebut.

Catatan

Anda juga dapat menambahkan kolom pradefinisi saat membuat tabel data. Untuk informasi selengkapnya, lihat Langkah 3: Buat tabel data.

Buka halaman Manage Table.
1. Login ke Tablestore console.
2. Pada halaman Overview, klik nama instans.
3. Pada tab Instance Details, di bagian Tables, klik nama tabel data.
Pada tab Basic Information, di bagian modul Advanced Features, yaitu bagian Pre-defined Column, klik Add Pre-Defined Column.
Pada kotak dialog Add Pre-Defined Column, klik Add Pre-Defined Column, lalu masukkan nama dan pilih tipe data untuk kolom pradefinisi tersebut.
- Konvensi penamaan kolom pradefinisi: Nama harus terdiri dari 1 hingga 255 byte dan dapat berisi huruf, angka, serta garis bawah (_). Nama harus dimulai dengan huruf atau garis bawah (_).
- Anda dapat memilih STRING, INTEGER, BINARY, FLOAT, atau BOOLEAN sebagai tipe data. Jika kolom pradefinisi digunakan sebagai kolom indeks, pilih STRING, INTEGER, atau BINARY.
Catatan
Anda dapat mengklik Add Pre-Defined Column untuk menambahkan beberapa kolom. Untuk menghapus kolom yang tidak diinginkan, klik ikon di sampingnya.
Klik OK.

Kolom pradefinisi yang Anda tambahkan akan ditampilkan dalam daftar kolom pradefinisi.

Jika ingin menghapus kolom pradefinisi dari daftar tersebut, klik ikon di kolom Remove Pre-Defined Column.

Langkah 2: Buat indeks sekunder

Anda dapat membuat indeks sekunder untuk mempercepat kueri data. Indeks sekunder terdiri dari global secondary index dan local secondary index. Pilih salah satu sesuai kebutuhan bisnis Anda.

Catatan

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

Buka halaman Manage Table.
1. Login ke Tablestore console.
2. Pada halaman Overview, klik nama instans.
3. Pada tab Instance Details, di bagian Tables, klik nama tabel data.
Pada tab Indexes, klik Create a secondary index.

Pada kotak dialog Create Index, konfigurasikan indeks sekunder.

fig_20221020_indexsecondary001

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
Index Type	Jenis indeks. Nilai ini selalu Secondary Index.
Instance Name	Nama instans. Anda tidak dapat mengubah nilai parameter ini.
Table Name	Nama tabel data tempat Anda ingin membuat indeks sekunder. Anda tidak dapat mengubah nilai parameter ini.
Index Name	Nama indeks sekunder yang ingin Anda buat. Penting Nama tersebut tidak boleh sama dengan nama tabel data atau tabel deret waktu yang sudah ada.
Index Type	Jenis indeks sekunder. Nilai yang valid: Global Secondary Index: Tablestore secara otomatis menyinkronkan data dari kolom yang diindeks dan kolom kunci primer tabel data ke kolom tabel indeks yang ingin Anda buat dalam mode asinkron. Kolom kunci primer pertama pada tabel indeks dapat berupa kolom kunci primer atau kolom pradefinisi dari tabel data. Local Secondary Index: Tablestore secara otomatis menyinkronkan data dari kolom yang diindeks dan kolom kunci primer tabel data ke kolom tabel indeks yang ingin Anda buat dalam mode sinkron. Setelah data ditulis ke tabel data, Anda dapat langsung melakukan kueri data tersebut di tabel indeks. Kolom kunci primer pertama pada tabel indeks harus merupakan kolom kunci primer pertama dari tabel data.
Existing Data	Menentukan apakah data yang sudah ada di tabel data disertakan dalam indeks sekunder. Nilai yang valid: Include Existing Data Exclude Existing Data

Pilih kolom kunci primer dalam urutan yang diinginkan dan klik Add Primary Key Column untuk setiap kolom.

Hanya kolom pradefinisi dengan tipe data STRING, INTEGER, dan BINARY yang dapat digunakan sebagai kolom kunci primer.
Pilih kolom pradefinisi yang akan digunakan sebagai kolom atribut, lalu klik Add Pre-defined Column.

Klik OK.

Indeks sekunder yang Anda buat akan ditampilkan dalam daftar indeks.

Langkah 3: Lakukan kueri data

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

Lakukan kueri rentang

Buka halaman Manage Table.
1. Login ke Tablestore console.
2. Pada halaman Overview, klik nama instans.
3. Pada tab Instance Details, di bagian Tables, klik nama tabel data.
Pada tab Indexes, temukan tabel indeks target dan klik Query di kolom Actions.
Pada kotak dialog Search, atur kondisi kueri.
1. Atur Mode ke Range Search.
2. Secara default, semua kolom dikembalikan. Untuk mengembalikan kolom atribut tertentu, matikan Get All Columns dan masukkan nama kolom yang dipisahkan dengan koma (,).
3. Konfigurasikan parameter Start Primary Key Column dan End Primary Key Column.
  Penting
  
  Jika Anda mengatur parameter Mode ke Range Search, rentang yang ditentukan oleh nilai awal dan akhir pada kolom kunci primer paling kanan hanya berlaku jika nilai awal dan akhir pada setiap kolom kunci primer paling kiri sama. Jika nilai awal dan akhir pada kolom kunci primer paling kiri berbeda, rentang yang ditentukan oleh nilai awal dan akhir pada kolom kunci primer paling kanan tidak berlaku.
  
  Rentang yang didukung untuk kueri rentang adalah interval terbuka-kiri dan tertutup-kanan.
4. Pertahankan nilai default parameter Max Versions.
5. Atur arah pengurutan hasil kueri ke Forward Search atau Backward Search.
Klik OK.

Data yang memenuhi kondisi kueri akan ditampilkan dalam daftar data.

Lakukan kueri baris tunggal

Buka halaman Manage Table.
1. Login ke Tablestore console.
2. Pada halaman Overview, klik nama instans.
3. Pada tab Instance Details, di bagian Tables, klik nama tabel data.
Pada tab Indexes, temukan tabel indeks target dan klik Query di kolom Actions.
Pada kotak dialog Search, atur kondisi kueri.
1. Atur Mode ke Get Row.
2. Secara default, semua kolom dikembalikan. Untuk mengembalikan kolom atribut tertentu, matikan Get All Columns dan masukkan nama kolom yang dipisahkan dengan koma (,).
3. Masukkan Primary Key Value untuk baris target.
  
  Integritas dan akurasi nilai kunci primer memengaruhi hasil kueri.
4. Pertahankan nilai default parameter Max Versions.
Klik OK.

Jika baris yang ingin Anda kueri termasuk dalam tabel indeks, Tablestore akan mengembalikan data baris tersebut. Jika baris yang ingin Anda kueri tidak termasuk dalam tabel indeks, tidak ada data yang dikembalikan.

FAQ

Referensi

Anda dapat menggunakan indeks sekunder melalui SDK Tablestore atau CLI Tablestore. Untuk informasi selengkapnya, lihat Use global secondary index by using Tablestore SDK dan Secondary index.
Jika Anda ingin melakukan kueri data dengan cara 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 selengkapnya, lihat Ikhtisar.