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 posterior ejecución. Timestream solo admite el uso de esta operación si está establecido en. ValidateOnly 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 JSON formato.
- QueryString
-
La cadena de consulta de Timestream que desea 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 Timestream válida 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 de 200. HTTP
El servicio devuelve los siguientes datos en JSON formato.
- Columns
-
Una lista de columnas de SELECT cláusulas de la cadena de consulta enviada.
Tipo: matriz de objetos SelectColumn
- Parameters
-
Una lista de los parámetros utilizados en la cadena de consulta enviada.
Tipo: matriz de objetos ParameterMapping
- QueryString
-
La cadena de consulta que desea 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 está autorizado a realizar esta acción.
HTTPCódigo de estado: 400
- InternalServerException
-
El servicio no pudo procesar completamente esta solicitud debido a un error interno del servidor.
HTTPCódigo de estado: 400
- InvalidEndpointException
-
El punto final solicitado no era válido.
HTTPCódigo de estado: 400
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
HTTPCódigo de estado: 400
- ValidationException
-
Solicitud no válida o con formato incorrecto.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
