ALTER TABLE SET TBLPROPERTIES - Amazon Athena
ResumoParâmetrosExemplos

ALTER TABLE SET TBLPROPERTIES

Adiciona propriedades de metadados personalizadas ou predefinidas a uma tabela e define seus valores atribuídos. Para ver as propriedades em uma tabela, use o comando SHOW TBLPROPERTIES.

As tabelas gerenciadas do Apache Hive não são permitidas, portanto, a definição de 'EXTERNAL'='FALSE' não tem efeito.

Resumo

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

Parâmetros

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

Especifica as propriedades de metadados a serem adicionadas como property_name e o valor para cada uma como property value. Se property_name já existir, o valor será definido como o property_value recém-especificado.

As propriedades de tabela predefinidas a seguir têm usos especiais.

Propriedade predefinida Descrição
classification Indica o tipo de dados de AWS Glue. Os valores possíveis são csv, parquet, orc, avro ou json. As tabelas criadas para o Athena no console do CloudTrail adicionam cloudtrail como um valor para a propriedade classification. Para obter mais informações, consulte a seção TBLPROPERTIES de CREATE TABLE.
has_encrypted_data Indica se o conjunto de dados especificado por LOCATION está criptografado. Para obter mais informações, consulte a seção TBLPROPERTIES de CREATE TABLE e Criar tabelas baseadas em conjuntos de dados criptografados no Amazon S3.
orc.compress Especifica o formato de compactação de dados no formato ORC. Para ter mais informações, consulte ORC SerDe.
parquet.compression Especifica o formato de compactação de dados no formato Parquet. Para ter mais informações, consulte Parquet SerDe.
write.compression Especifica o formato de compressão de dados nos formatos de arquivo de texto ou JSON. Para os formatos Parquet e ORC, use as propriedades parquet.compression e orc.compress, respectivamente.
compression_level Especifica um nível de compressão a ser usado. Essa propriedade se aplica apenas à compressão ZSTD. Os valores possíveis são de 1 a 22. O valor padrão é 3. Para ter mais informações, consulte Usar níveis de compactação ZSTD.
projection.* As propriedades personalizadas usadas na projeção da partição que permitem que o Athena saiba quais padrões de partição esperar ao executar uma consulta em uma tabela. Para ter mais informações, consulte Usar projeção de partições com o Amazon Athena.
skip.header.line.count Ignora os cabeçalhos nos dados quando você define uma tabela. Para ter mais informações, consulte Ignorar cabeçalhos.
storage.location.template Especifica um modelo de caminho personalizado do Amazon S3 para partições projetadas. Para ter mais informações, consulte Configurar a projeção de partições.

Exemplos

O exemplo a seguir adiciona uma nota de comentário às propriedades da tabela.

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

O exemplo a seguir modifica a tabela existing_table para usar o formato de arquivo Parquet com compactação ZSTD nível 4.

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