As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
PrepareQuery
Uma operação síncrona que permite enviar uma consulta com parâmetros a serem armazenados pelo Timestream para execução posterior. O Timestream só suporta o uso desta operação com ValidateOnly definido como. true
Sintaxe da Solicitação
{
"QueryString": "string",
"ValidateOnly": boolean
}Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- QueryString
-
A string de consulta Timestream que você deseja usar como uma instrução preparada. Nomes de parâmetros podem ser especificados no caractere
@da string de consulta, seguido por um identificador.Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 262144.
Obrigatório: Sim
- ValidateOnly
-
Ao definir esse valor como
true, o Timestream só validará se a string de consulta é uma consulta Timestream válida e não armazenará a consulta preparada para uso posterior.Tipo: booliano
Obrigatório: não
Sintaxe da Resposta
{
"Columns": [
{
"Aliased": boolean,
"DatabaseName": "string",
"Name": "string",
"TableName": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"Parameters": [
{
"Name": "string",
"Type": {
"ArrayColumnInfo": {
"Name": "string",
"Type": "Type"
},
"RowColumnInfo": [
{
"Name": "string",
"Type": "Type"
}
],
"ScalarType": "string",
"TimeSeriesMeasureValueColumnInfo": {
"Name": "string",
"Type": "Type"
}
}
}
],
"QueryString": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- Columns
-
Uma lista de colunas de SELECT cláusulas da string de consulta enviada.
Tipo: matriz de objetos SelectColumn
- Parameters
-
Uma lista de parâmetros usados na sequência de caracteres de consulta enviada.
Tipo: matriz de objetos ParameterMapping
- QueryString
-
A sequência de caracteres de consulta que você deseja preparar.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 262144.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não está autorizado a realizar essa ação.
HTTPCódigo de status: 400
- InternalServerException
-
O serviço não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.
HTTPCódigo de status: 400
- InvalidEndpointException
-
O endpoint solicitado não era válido.
HTTPCódigo de status: 400
- ThrottlingException
-
A solicitação foi negada devido à limitação da solicitação.
HTTPCódigo de status: 400
- ValidationException
-
Solicitação inválida ou malformada.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
