ALTER TABLE SET TBLPROPERTIES - Amazon Athena
SinopsisParámetrosEjemplos

ALTER TABLE SET TBLPROPERTIES

Agrega propiedades de metadatos personalizadas o predefinidas a una tabla y establece sus valores asignados. Para ver las propiedades de una tabla, utilice el comando SHOW TBLPROPERTIES.

No se admiten las tablas administradas por Apache Hive, por lo que el valor 'EXTERNAL'='FALSE' no tiene ningún efecto.

Sinopsis

ALTER TABLE table_name SET TBLPROPERTIES ('property_name' = 'property_value' [ , ... ])

Parámetros

SET TBLPROPERTIES ('property_name' = 'property_value' [ , ... ])

Especifica las propiedades de metadatos que se añaden como property_name y el valor de cada una como property value. Si property_name ya existe, su valor está establecido en el property_value recién especificado.

Las siguientes propiedades de tabla predefinidas tienen usos especiales.

Propiedad predefinida Descripción
classification Indica el tipo de datos para AWS Glue. Los valores posibles son csv, parquet, orc, avro o json. Las tablas creadas para Athena en la consola de CloudTrail añaden cloudtrail como valor a la propiedad classification. Para obtener más información, consulte la sección TBLPROPERTIES de CREATE TABLE.
has_encrypted_data Indica si el conjunto de datos especificado por LOCATION está cifrado. Para obtener más información, consulte la sección TBLPROPERTIES de CREATE TABLE y Creación de tablas basadas en conjuntos de datos cifrados en Amazon S3.
orc.compress Especifica un formato de compresión para los datos en formato ORC. Para obtener más información, consulte El SerDe de ORC.
parquet.compression Especifica un formato de compresión para los datos en formato Parquet. Para obtener más información, consulte El SerDe de Parquet.
write.compression Especifica un formato de compresión para datos en formato de archivo de texto o JSON. Para los formatos Parquet y ORC, utilice las propiedades parquet.compression y orc.compress, respectivamente.
compression_level Especifica el nivel de compresión que se debe utilizar. Esta propiedad solo se aplica a la compresión ZSTD. Los valores posibles están comprendidos entre 1 y 22. El valor predeterminado es 3. Para obtener más información, consulte Uso de niveles de compresión de ZSTD.
projection.* Las propiedades personalizadas utilizadas en la proyección de particiones permiten a Athena saber qué patrones de partición esperar cuando ejecuta una consulta en la tabla. Para obtener más información, consulte Uso de proyección de particiones con Amazon Athena.
skip.header.line.count Omite los encabezados de los datos cuando se define una tabla. Para obtener más información, consulte Ignorar encabezados.
storage.location.template Especifica una plantilla de ruta de Amazon S3 personalizada para las particiones proyectadas. Para obtener más información, consulte Configuración de la proyección de particiones.

Ejemplos

En el siguiente ejemplo se agrega una nota de comentario a las propiedades de tabla.

ALTER TABLE orders 
SET TBLPROPERTIES ('notes'="Please don't drop this table.");

En el siguiente ejemplo se modifica la tabla existing_table para que utilice el formato de archivo Parquet con compresión ZSTD y nivel 4 de compresión ZSTD.

ALTER TABLE existing_table 
SET TBLPROPERTIES ('parquet.compression' = 'ZSTD', 'compression_level' = 4)