Tablestore：Pengurutan dan Halaman

Skenario

Pengurutan pra-indeks

Secara default, data dalam indeks pencarian diurutkan berdasarkan pengaturan pra-pengurutan yang ditentukan oleh parameter IndexSort. Saat menggunakan indeks pencarian untuk mengkueri data, pengaturan ini menentukan urutan default hasil kueri.

Saat membuat indeks pencarian, Anda dapat menentukan pengaturan pra-pengurutan dengan mengonfigurasi parameter IndexSort. Jika tidak ditentukan, data diurutkan berdasarkan nilai kunci utama.

Tentukan metode pengurutan saat mengkueri data

Pengurutan hanya dapat diaktifkan untuk bidang dengan parameter enableSortAndAgg disetel ke true.

Anda dapat menentukan metode pengurutan untuk setiap kueri. Kueri berbasis indeks pencarian mendukung beberapa metode pengurutan yang dapat digunakan berdasarkan prioritas.

ScoreSort

sort: {
    sorters: [
        {
            scoreSort: {
                order: TableStore.SortOrder.SORT_ORDER_ASC
            }
        }
    ]
}

PrimaryKeySort

Gunakan PrimaryKeySort untuk mengurutkan hasil kueri berdasarkan nilai kunci utama.

sort: {
    sorters: [
        {
            primaryKeySort: {
                order: TableStore.SortOrder.SORT_ORDER_DESC // Urutkan hasil kueri secara menurun. 
                //order: TableStore.SortOrder.SORT_ORDER_ASC // Urutkan hasil kueri secara naik. 
            }
        }
    ]
}

FieldSort

Gunakan FieldSort untuk mengurutkan hasil kueri berdasarkan nilai satu atau lebih kolom tertentu.

sort: {
    sorters: [
        {
            fieldSort: {
                fieldName: "Col_Keyword",
                order: TableStore.SortOrder.SORT_ORDER_DESC
            }
        }
    ]
}

sort: {
    sorters: [
        {
            fieldSort: {
                fieldName: "Col_Keyword",
                order: TableStore.SortOrder.SORT_ORDER_DESC
            }
        },
        {
            fieldSort: {
                fieldName: "Col_Long",
                order: TableStore.SortOrder.SORT_ORDER_DESC
            }
        }
    ]
}

GeoDistanceSort

Gunakan GeoDistanceSort untuk mengurutkan hasil kueri berdasarkan lokasi geografis.

sort: {
    sorters: [
        {
            geoDistanceSort: {
                fieldName: "Col_Geo_Point",
                points: ["0,0"],// Tentukan pasangan koordinat titik pusat. 
                order: TableStore.SortOrder.SORT_ORDER_ASC // Hasil kueri dikembalikan dalam urutan naik berdasarkan jarak antara lokasi geografis dan titik pusat. 
            }
        }
    ]
}

Untuk contoh kode terperinci, lihat Search.

Tentukan metode halaman

Anda dapat mengonfigurasi parameter limit dan offset atau menggunakan token untuk membagi halaman baris dalam respons.

Konfigurasikan parameter limit dan offset

Jika Anda tidak menentukan nilai untuk parameter limit dan offset, nilai default digunakan. Nilai default parameter limit adalah 10, sedangkan nilai default parameter offset adalah 0.

/**
 * Set offset ke 90 dan limit ke 10 untuk memindai data dari baris 90 hingga baris 99. 
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 90,
        limit: 10, 
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true // Tentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default: false. 
    },
    columnToGet: { // Tentukan kolom yang ingin Anda kembalikan. Anda dapat menyetel parameter columnToGet ke RETURN_SPECIFIED untuk mengembalikan kolom tertentu, RETURN_ALL untuk mengembalikan semua kolom, atau RETURN_NONE untuk mengembalikan hanya kolom kunci utama. 
        returnType: TableStore.ColumnReturnType.RETURN_ALL
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

Gunakan token

Kami merekomendasikan penggunaan token untuk halaman karena metode ini tidak memiliki batasan pada kedalaman halaman.

Jika Tablestore tidak dapat membaca semua data yang memenuhi kondisi kueri, Tablestore mengembalikan nextToken. Anda dapat menggunakan nextToken untuk melanjutkan membaca data berikutnya.

Secara default, Anda hanya dapat mundur saat menggunakan token. Namun, Anda dapat menyimpan dan menggunakan token sebelumnya untuk maju karena token valid selama kueri.

Saat menggunakan token, metode pengurutan sama dengan metode yang digunakan dalam permintaan sebelumnya. Tablestore mengurutkan data berdasarkan parameter IndexSort secara default atau berdasarkan metode yang Anda tentukan. Anda tidak dapat menentukan metode pengurutan atau mengonfigurasi parameter offset saat menggunakan token. Data dikembalikan halaman demi halaman secara berurutan, yang dapat menghasilkan kueri lambat.

/**
 * Gunakan token untuk membagi halaman baris dalam respons dalam mode sinkron dan asinkron. 
 */
var params = {
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10,
        token: null,// Peroleh nextToken sebagai titik awal untuk memindai halaman berikutnya. Tipe data adalah aliran byte. 
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true
    },
    columnToGet: {
        returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
        returnNames: ["pic_tag", "pic_description", "time_stemp", "pos"]
    }
};

/**
 * Gunakan token untuk membagi halaman baris dalam respons dalam mode sinkron. 
 */
(async () => { // Bagi halaman baris dalam mode sinkron. 
  try {
    var data = await client.search(params);
    console.log('success:', JSON.stringify(data, null, 2));

    while (data.nextToken && data.nextToken.length) { // Jika nextToken dikembalikan, Tablestore melanjutkan membaca data berikutnya. 

      // Simpan token. 
      //1) Konversikan token (nextToken) sebagai data biner dalam objek Buffer ke string yang dikodekan Base64 dan simpan string tersebut. 
      //2) Anda dapat mengonversi string Base64 yang disimpan ke data biner dengan membuat objek Buffer untuk menggunakan nextToken sebagai parameter. 
      var nextToken = data.nextToken.toString("base64");
      var token =  Buffer.from(nextToken, "base64");

      params.searchQuery.token = token;// Perbarui nilai token untuk mengembalikan lebih banyak hasil. 
      data = await client.search(params);
      console.log('token success:', JSON.stringify(data, null, 2));
    }
  } catch (error) {
      console.log(error);
  }
})()

/**
 * Gunakan token untuk membagi halaman baris dalam respons dalam mode asinkron. 
 */
client.search(params, function (err, data) { 
    console.log('success:', JSON.stringify(data, null, 2));

    if (data.nextToken && data.nextToken.length) {

        // Simpan token. 
        //1) Konversikan token (nextToken) sebagai data biner dalam objek Buffer ke string yang dikodekan Base64 dan simpan string tersebut. 
        //2) Anda dapat mengonversi string Base64 yang disimpan ke data biner dengan membuat objek Buffer untuk menggunakan nextToken sebagai parameter. 
        var nextToken = data.nextToken.toString("base64");
        var token =  Buffer.from(nextToken, "base64");

        params.searchQuery.token = token;// Perbarui nilai token untuk mengembalikan lebih banyak hasil. 
        client.search(params, function (err, data) {
            console.log('token success:', JSON.stringify(data, null, 2));
        });
    }
});