Tablestore:Pengurutan dan halaman

Gunakan ScoreSort untuk mengurutkan hasil berdasarkan skor relevansi BM25, secara ascending atau descending.

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

PrimaryKeySort

Mengurutkan hasil berdasarkan kunci primer.

Gunakan PrimaryKeySort untuk mengurutkan hasil berdasarkan nilai kunci primer.

sort: {
    sorters: [
        {
            primaryKeySort: {
                order: TableStore.SortOrder.SORT_ORDER_DESC // Urutkan secara descending.
                //order: TableStore.SortOrder.SORT_ORDER_ASC // Urutkan secara ascending.
            }
        }
    ]
}

FieldSort

Gunakan FieldSort untuk mengurutkan hasil berdasarkan nilai satu atau beberapa kolom.

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

Mengurutkan hasil berdasarkan jarak dari titik geografis.

Gunakan GeoDistanceSort untuk mengurutkan hasil berdasarkan jarak dari titik geografis pusat.

sort: {
    sorters: [
        {
            geoDistanceSort: {
                fieldName: "Col_Geo_Point",
                points: ["0,0"],// Tentukan pasangan koordinat titik pusat.
                order: TableStore.SortOrder.SORT_ORDER_ASC // Kembalikan hasil dalam urutan jarak ascending.
            }
        }
    ]
}

Untuk contoh lengkap, lihat Search di GitHub.

Konfigurasikan parameter limit dan offset

Jika Anda tidak mengatur parameter limit dan offset, limit akan default ke 10 dan offset akan default ke 0.

Gunakan offset dan limit untuk langsung menuju halaman tertentu. Metode ini mendukung set hasil hingga 100.000 baris.

/**
 * Atur offset ke 90 dan limit ke 10 untuk mengambil baris 90–99.
 */
client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 90,
        limit: 10,
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true // Kembalikan jumlah total baris yang cocok. Default: false.
    },
    columnToGet: {
        // RETURN_ALL: kembalikan semua kolom.
        // RETURN_SPECIFIED: kembalikan kolom tertentu.
        // RETURN_NONE: kembalikan hanya kolom kunci primer.
        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

Halaman berbasis token direkomendasikan untuk halaman dalam karena tidak memiliki batas kedalaman.

Jika respons tidak berisi semua data yang cocok, server mengembalikan nextToken.

Secara default, halaman berbasis token hanya memungkinkan Anda maju melalui hasil. Namun, karena token tetap valid selama proses kueri, Anda dapat menyimpan cache token sebelumnya untuk kembali ke halaman sebelumnya.

Halaman berbasis token mengembalikan hasil per halaman menggunakan kursor (NextToken). Setiap respons mencakup token untuk halaman berikutnya. Token valid selama durasi kueri, sehingga simpan cache token sebelumnya untuk kembali ke halaman sebelumnya.

Saat melakukan halaman dengan token, urutan pengurutan sama seperti permintaan sebelumnya, baik menggunakan IndexSort default maupun pengurutan kustom. Oleh karena itu, Anda tidak dapat mengatur parameter Sort saat menggunakan token. Anda juga tidak dapat mengatur offset, karena hanya dapat membaca data secara berurutan.

Contoh berikut menunjukkan halaman berbasis token dalam mode sinkron dan asinkron. Keduanya menggunakan objek params awal yang sama.

var params = {
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10,
        token: null, // Atur ke nextToken dari respons sebelumnya untuk mengambil halaman berikutnya.
        query: {
            queryType: TableStore.QueryType.MATCH_ALL_QUERY
        },
        getTotalCount: true
    },
    columnToGet: {
        returnType: TableStore.ColumnReturnType.RETURN_SPECIFIED,
        returnNames: ["pic_tag", "pic_description", "time_stemp", "pos"]
    }
};

/**
 * Mode sinkron: tunggu setiap halaman sebelum mengambil yang berikutnya.
 */
(async () => {
  try {
    var data = await client.search(params);
    console.log('success:', JSON.stringify(data, null, 2));

    while (data.nextToken && data.nextToken.length) {
      // Encode token biner sebagai Base64 untuk penyimpanan atau transfer,
      // lalu decode kembali ke biner sebelum meneruskannya sebagai token berikutnya.
      var nextToken = data.nextToken.toString("base64");
      var token = Buffer.from(nextToken, "base64");

      params.searchQuery.token = token;
      data = await client.search(params);
      console.log('token success:', JSON.stringify(data, null, 2));
    }
  } catch (error) {
      console.log(error);
  }
})()

/**
 * Mode asinkron: gunakan callback untuk mengambil halaman berikutnya.
 */
client.search(params, function (err, data) {
    console.log('success:', JSON.stringify(data, null, 2));

    if (data.nextToken && data.nextToken.length) {
        // Encode dan decode token dengan cara yang sama seperti pada mode sinkron.
        var nextToken = data.nextToken.toString("base64");
        var token = Buffer.from(nextToken, "base64");

        params.searchQuery.token = token;
        client.search(params, function (err, data) {
            console.log('token success:', JSON.stringify(data, null, 2));
        });
    }
});