UNLOAD

La sentencia de consulta utilizada para seleccionar y recuperar datos de uno o más Timestream para tablas. LiveAnalytics

(SELECT column 1, column 2, column 3 from database.table
      where measure_name = "ABC" and timestamp between ago (1d) and now() )

TO 's3://bucket-name/folder'

o

TO 's3://access-point-alias/folder'

La cláusula TO en la instrucción UNLOAD especifica el destino de la salida de los resultados de la consulta. Debe proporcionar la ruta completa, incluido el nombre del bucket de Amazon S3 o Amazon S3 access-point-alias con la ubicación de la carpeta en Amazon S3 donde Timestream for LiveAnalytics escribe los objetos del archivo de salida. El bucket de S3 debe pertenecer a la misma cuenta y estar en la misma región. Además del conjunto de resultados de la consulta, Timestream for LiveAnalytics escribe los archivos de manifiesto y metadatos en la carpeta de destino especificada.

partitioned_by = ARRAY [col_name[,…] , (default: none)

La cláusula partitioned_by se usa en las consultas para agrupar y analizar los datos a un nivel granular. Al exportar los resultados de la consulta al bucket de S3, puede elegir dividir los datos en función de una o más columnas de la consulta seleccionada. Al particionar los datos, los datos exportados se dividen en subconjuntos según la columna de partición y cada subconjunto se almacena en una carpeta independiente. Dentro de la carpeta de resultados que contiene los datos exportados, se crea automáticamente una subcarpeta folder/results/partition column = partition value/. Sin embargo, tenga en cuenta que las columnas particionadas no se incluyen en el archivo de salida.

partitioned_by no es una cláusula obligatoria en la sintaxis. Si opta por exportar los datos sin ninguna partición, puede excluir la cláusula de la sintaxis.

Datos exportados particionados por columna de canales

format = [ '{ CSV | PARQUET }' , default: CSV

Las palabras clave para especificar el formato de los resultados de la consulta que se escriben en su bucket de S3. Puede exportar los datos como valores separados por comas (CSV) que usan coma (,) como delimitador predeterminado o en el formato Apache Parquet, un eficaz formato de almacenamiento en columnas abiertas para el análisis.

compression = [ '{ GZIP | NONE }' ], default: GZIP

Puede comprimir los datos exportados mediante el algoritmo de compresión GZIP o descomprimirlos si especifica la opción NONE.

encryption = [ '{ SSE_KMS | SSE_S3 }' ], default: SSE_S3

Los archivos de salida en Amazon S3 se cifran mediante la opción de cifrado que haya seleccionado. Además de sus datos, los archivos de manifiesto y metadatos también se cifran en función de la opción de cifrado que haya seleccionado. Actualmente, admitimos el cifrado SSE_S3 y SSE_KMS. SSE_S3 es un cifrado del lado del servidor en el que Amazon S3 cifra los datos mediante el cifrado estándar de cifrado avanzado (AES) de 256 bits. El SSE_KMS es un cifrado del lado del servidor para cifrar los datos mediante claves administradas por el cliente.

kms_key = '<string>'

La clave KMS es una clave definida por el cliente para cifrar los resultados de las consultas exportadas. Key Management Service (KMS) gestiona de forma segura la AWS clave AWS KMS y se utiliza para cifrar archivos de datos en Amazon S3.

field_delimiter ='<character>' , default: (,)

Al exportar los datos en formato CSV, este campo especifica un carácter ASCII único que se utiliza para separar campos en el archivo de salida, como un carácter de barra vertical (|), una coma (,) o una tabulación (\t). El delimitador predeterminado para los archivos CSV es un carácter de coma. Si un valor de los datos contiene el delimitador elegido, el delimitador aparecerá entre comillas. Por ejemplo, si el valor de sus datos contiene Time,stream, este valor se indicará como "Time,stream" en los datos exportados. El carácter de comilla utilizado por Timestream LiveAnalytics son comillas dobles («).

Evite especificar el carácter de retorno (ASCII 13, hexadecimal 0D, texto “\r”) o el carácter de salto de línea (ASCII 10, hexadecimal 0A, texto “\n”) como FIELD_DELIMITER si desea incluir encabezados en el CSV, ya que esto impedirá que muchos analizadores puedan analizar los encabezados correctamente en la salida CSV resultante.

escaped_by = '<character>', default: (\)

Al exportar los datos en formato CSV, este campo especifica el carácter que debe tratarse como un carácter de escape en el archivo de datos escrito en el bucket de S3. Esto ocurre en las siguientes situaciones:

include_header = 'true' , default: 'false'

Al exportar los datos en formato CSV, este campo le permite incluir los nombres de las columnas como la primera fila de los archivos de datos CSV exportados.

Los valores aceptados son “verdadero” y “falso” y el valor predeterminado es “falso”. Las opciones de transformación de texto, como escaped_by y field_delimiter, se aplican también a los encabezados.

max_file_size = 'X[MB|GB]' , default: '78GB'

Este campo especifica el tamaño máximo de los archivos que la instrucción UNLOAD crea en Amazon S3. La instrucción UNLOAD puede crear varios archivos, pero el tamaño máximo de cada archivo escrito en Amazon S3 será aproximadamente el que se especifique en este campo.

El valor debe estar comprendido entre 16 MB y 78 GB, ambos incluidos. Puede especificarlo en números enteros, como 12GB, o en decimales, como 0.5GB o 24.7MB. El valor predeterminado es 78 GB.

El tamaño real del archivo es aproximado cuando se está escribiendo el archivo, por lo que es posible que el tamaño real máximo no sea exactamente igual al número que especifique.