Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
PrepareQuery
Operación sincrónica que permite enviar una consulta con parámetros para que Timestream los almacene para su ejecución posterior. Timestream solo admite el uso de esta operación con ValidateOnly se establece en true.
Sintaxis de la solicitud
{
"QueryString": "string",
"ValidateOnly": boolean
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- QueryString
-
La cadena de consulta de Timestream que quiere utilizar como sentencia preparada. Los nombres de los parámetros se pueden especificar en la cadena de consulta
@seguida de un identificador.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.
Obligatorio: sí
- ValidateOnly
-
Al establecer este valor en
true, Timestream solo validará que la cadena de consulta sea una consulta válida de Timestream y no almacenará la consulta preparada para su uso posterior.Tipo: Booleano
Obligatorio: no
Sintaxis de la respuesta
{
"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 respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- Columns
-
Una lista de las columnas de la cláusula SELECT de la cadena de consulta que se envió.
Tipo: matriz de objetos SelectColumn
- Parameters
-
Una lista de los parámetros utilizados en la cadena de consulta que se envió.
Tipo: matriz de objetos ParameterMapping
- QueryString
-
La cadena de consulta que quiere preparar.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 262144 caracteres.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No cuenta con los permisos necesarios para acceder a la configuración de la cuenta.
Código de estado HTTP: 400
- InternalServerException
-
Se produjo un error de servidor interno al procesar la solicitud.
Código de estado HTTP: 400
- InvalidEndpointException
-
El punto de conexión solicitado no es válido.
Código de estado HTTP: 400
- ThrottlingException
-
La solicitud se retrasó debido a una cantidad excesiva de solicitudes.
Código de estado HTTP: 400
- ValidationException
-
Solicitud no válida o con formato incorrecto.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
