referensi API SQLQuery - Tablestore

Mengambil data menggunakan pernyataan SQL.

Sintaks permintaan

message SQLQueryRequest {
    required string query = 1;
    optional SQLPayloadVersion version = 2;
    optional int64 sql_version = 3;
}

Parameter	Tipe	Diperlukan	Deskripsi
query	string	Ya	Pernyataan SQL.
version	SQLPayloadVersion	Tidak	Format pengkodean data yang dikembalikan.
sql_version	int64	Tidak	Versi protokol SQL. Nilai valid: 0: mengembalikan waktu dan tanggal sebagai string terenkripsi. 1: mengembalikan waktu dan tanggal sebagai integer terenkripsi.

Sintaks respons

message SQLQueryResponse {
    repeated TableConsumedCapacity consumes = 1;
    optional bytes rows = 2;
    optional SQLPayloadVersion version = 3;
    optional SQLStatementType type = 4;
}

Parameter	Tipe	Diperlukan	Deskripsi
consumes	repeated TableConsumedCapacity	Ya	Jumlah unit kapasitas (CUs) yang digunakan oleh operasi. Untuk informasi lebih lanjut, lihat Konsumsi CU.
rows	bytes	Tidak	Data baris yang dikembalikan. Nilainya dienkripsi dalam format yang Anda tentukan.
version	SQLPayloadVersion	Ya	Format pengkodean data yang dikembalikan.
type	SQLStatementType	Ya	Tipe pernyataan SQL.

Menggunakan SDK Tablestore

Tablestore SDK for Java: Kueri SQL
Tablestore SDK for Go: Kueri SQL
Tablestore SDK for Python: Kueri SQL
Tablestore SDK for Node.js: Kueri SQL
Tablestore SDK for .NET: Kueri SQL
Tablestore SDK for PHP: Kueri SQL

Konsumsi CU

Penggunaan fitur kueri SQL tidak dikenakan biaya. Namun, Anda akan dikenakan biaya untuk operasi seperti pemindaian tabel dan kueri berbasis indeks yang dilakukan saat menggunakan fitur ini.

Throughput baca yang dikonsumsi saat mengeksekusi satu pernyataan SQL adalah jumlah throughput baca dari operasi pada tabel dan indeks. Jumlah CU baca yang dikonsumsi dibulatkan ke atas berdasarkan rumus berikut: Jumlah CU baca yang dikonsumsi = (Ukuran data di semua kolom kunci utama baris + Ukuran data di kolom atribut yang dibaca) / 4 KB.
Jika permintaan habis waktu dan hasilnya tidak terdefinisi, CU mungkin atau mungkin tidak dikonsumsi.
Jika kode status HTTP 5xx dikembalikan, yang menunjukkan kesalahan internal, operasi tidak mengonsumsi CU. Untuk kesalahan lain, satu CU baca dikonsumsi.