Consulta dados usando instruções SQL.
Sintaxe da solicitação
message SQLQueryRequest {
required string query = 1;
optional SQLPayloadVersion version = 2;
optional int64 sql_version = 3;
}|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
query |
string |
Sim |
Instrução SQL. |
|
version |
Não |
Formato de codificação dos dados retornados. |
|
|
sql_version |
int64 |
Não |
Versão do protocolo SQL. Valores válidos:
|
Sintaxe da resposta
message SQLQueryResponse {
repeated TableConsumedCapacity consumes = 1;
optional bytes rows = 2;
optional SQLPayloadVersion version = 3;
optional SQLStatementType type = 4;
}|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
consumes |
repeated TableConsumedCapacity |
Sim |
Número de unidades de capacidade (CUs) consumidas pela operação. Para mais informações, consulte Consumo de CU. |
|
rows |
bytes |
Não |
Dados das linhas retornadas. O valor vem codificado no formato especificado. |
|
version |
Sim |
Formato de codificação dos dados retornados. |
|
|
type |
Sim |
Tipo das instruções SQL. |
Uso dos SDKs do Tablestore
Consumo de CU
O recurso de consulta SQL não gera cobrança direta. No entanto, operações como varredura de tabelas e consultas baseadas em índices geram taxas durante o uso desse recurso.
O throughput de leitura consumido na execução de uma única instrução SQL corresponde à soma do throughput de leitura gasto em operações específicas na tabela e no índice. A quantidade de CUs de leitura consumidas é arredondada para cima conforme a fórmula: CUs de leitura consumidas = (Tamanho dos dados em todas as colunas de chave primária da linha + Tamanho dos dados nas colunas de atributo lidas) / 4 KB.
Se a solicitação atingir o tempo limite e os resultados ficarem indefinidos, o consumo de CUs poderá ou não ocorrer.
Um código de status HTTP 5xx indica erro interno e a operação não consome CUs. Outros erros consomem uma CU de leitura.