All Products
Search
Document Center

Tablestore:Kueri informasi indeks pencarian

Last Updated:Jul 25, 2026

Tablestore SDK for Java mengambil skema, progres sinkronisasi data, informasi metering, dan status suatu indeks pencarian.

Prasyarat

Sebelum memulai, pastikan bahwa:

  • Anda telah menginstal Tablestore SDK for Java dan menginisialisasi klien.

  • Tabel dan indeks pencarian sudah tersedia.

Deskripsi

Panggil describeSearchIndex untuk mengambil konfigurasi dan status indeks pencarian dalam suatu tabel.

public DescribeSearchIndexResponse describeSearchIndex(DescribeSearchIndexRequest request)

Contoh berikut melakukan kueri terhadap example_index pada example_table dan mencetak status indeks, fase sinkronisasi, TTL, serta nama bidang.

String tableName = "example_table";
String indexName = "example_index";
DescribeSearchIndexRequest request = new DescribeSearchIndexRequest();
request.setTableName(tableName);
request.setIndexName(indexName);
request.setIncludeSyncStat(true);

DescribeSearchIndexResponse response = client.describeSearchIndex(request);
System.out.println(response.getIndexStatus().indexStatusEnum);
System.out.println(response.getSyncStat().getSyncPhase());
System.out.println(response.getTimeToLive());
for (FieldSchema fieldSchema : response.getSchema().getFieldSchemas()) {
    System.out.println(fieldSchema.getFieldName());
}

Parameter

DescribeSearchIndexRequest berisi parameter berikut:

Name

Type

Description

tableName (required)

String

Nama tabel.

indexName (required)

String

Nama indeks pencarian.

includeSyncStat (optional)

Boolean

Menentukan apakah akan mengembalikan progres sinkronisasi data. Nilai default: true. Jika parameter ini diatur ke false, syncStat dalam respons bernilai null.

Respons

DescribeSearchIndexResponse berisi bidang-bidang berikut:

Field

Type

Description

schema

IndexSchema

Panggil getSchema() untuk mengambil bidang indeks, pengaturan indeks, dan pengaturan presorting. Untuk struktur objeknya, lihat Buat indeks pencarian.

syncStat

SyncStat

Panggil getSyncStat() untuk mengambil progres sinkronisasi data. Jika includeSyncStat bernilai false, bidang ini bernilai null.

meteringInfo

MeteringInfo

Panggil getMeteringInfo() untuk mengambil informasi metering terbaru.

brotherIndexName

String

Panggil getBrotherIndexName() untuk mengambil nama indeks terkait. Jika indeks pencarian tidak memiliki indeks terkait, bidang ini bernilai null.

queryFlowWeight

List<QueryFlowWeight>

Panggil getQueryFlowWeight() untuk mengambil bobot traffic kueri. Jika tidak ada bobot yang dikonfigurasi, bidang ini bernilai null.

createTime

Long

Panggil getCreateTime() untuk mengambil waktu pembuatan indeks pencarian.

indexStatus

IndexStatus

Panggil getIndexStatus() untuk mengambil status dan deskripsi status indeks pencarian.

timeToLive

Integer

Panggil getTimeToLive() untuk mengambil TTL data indeks dalam detik. Nilai -1 menunjukkan bahwa data tidak kedaluwarsa.

Progres sinkronisasi data

syncStat bertipe SyncStat dan berisi bidang-bidang berikut:

Field

Type

Description

syncPhase

SyncPhase

Panggil getSyncPhase() untuk mengambil fase sinkronisasi. FULL menunjukkan sinkronisasi penuh, dan INCR menunjukkan sinkronisasi inkremental.

currentSyncTimestamp

Long

Panggil getCurrentSyncTimestamp() untuk mengambil timestamp sinkronisasi saat ini.

Informasi metering

meteringInfo bertipe MeteringInfo dan berisi bidang-bidang berikut:

Field

Type

Description

reservedThroughput

ReservedThroughput

Panggil getReservedThroughput().getCapacityUnit().getReadCapacityUnit() untuk mengambil throughput baca yang dicadangkan.

storageSize

long

Panggil getStorageSize() untuk mengambil ukuran penyimpanan indeks pada waktu metering terakhir.

rowCount

long

Panggil getRowCount() untuk mengambil jumlah total baris indeks pada waktu metering terakhir.

timestamp

long

Panggil getTimestamp() untuk mengambil timestamp metering terakhir.

Bobot traffic kueri

Setiap elemen dalam queryFlowWeight[] bertipe QueryFlowWeight dan berisi bidang-bidang berikut:

Field

Type

Description

indexName

String

Panggil getIndexName() untuk mengambil nama indeks pencarian.

weight

Integer

Panggil getWeight() untuk mengambil bobot traffic kueri. Nilai yang valid: 0 hingga 100.

Status indeks

indexStatus bertipe IndexStatus dan berisi bidang-bidang berikut:

Field

Type

Description

indexStatusEnum

IndexStatusEnum

Status indeks. Nilai yang valid: PENDING, FAILED, RUNNING, dan UNKNOWN.

statusDescription

String

Deskripsi status indeks.