ALTER TABLE SET TBLPROPERTIES - Amazon Athena
SyntaxParameterBeispiele

ALTER TABLE SET TBLPROPERTIES

Fügt benutzerdefinierte oder vordefinierte Metadateneigenschaften zu einer Tabelle hinzu und legt deren zugewiesene Werte fest. Um die Eigenschaften in einer Tabelle anzuzeigen, verwenden Sie den Befehl SHOW TBLPROPERTIES.

Apache Hive Verwaltete Tabellen werden nicht unterstützt, so dass die Einstellung 'EXTERNAL'='FALSE' keine Auswirkungen hat.

Syntax

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

Parameter

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

Gib die Metadateneigenschaften, die als property_name hinzugefügt werden, und den jeweiligen Wert als property value an. Wenn property_name bereits vorhanden ist, wird der Wert auf den neu angegebenen property_value festgelegt.

Die folgenden vordefinierten Tabelleneigenschaften haben besondere Verwendungszwecke.

Vordefinierte Eigenschaft Beschreibung
classification Gibt den Datentyp für an AWS Glue. Mögliche Werte sind csv, parquet, orc, avro, oder json. Tabellen, die für Athena in der CloudTrail-Konsole erstellt wurden, fügen cloudtrail als einen Wert für die Eigenschaft classification hinzu. Weitere Informationen finden Sie im Abschnitt TBLPROPERTIES von CREATE TABLE.
has_encrypted_data Gibt an, ob der durch LOCATION angegebene Datensatz verschlüsselt ist. Weitere Informationen finden Sie im Abschnitt TBLPROPERTIES von CREATE TABLE und Tabellen basierend auf verschlüsselten Datensätzen in Amazon S3 erstellen.
orc.compress Gibt ein Komprimierungsformat für Daten im ORC-Format an. Weitere Informationen finden Sie unter ORC SerDe.
parquet.compression Legt ein Komprimierungsformat für Daten im Parquet-Format fest. Weitere Informationen finden Sie unter Parquet SerDe.
write.compression Gibt ein Komprimierungsformat für Daten in den Textdatei- oder JSON-Formaten an. Verwenden Sie für die Formate Parquet und ORC die Eigenschaften parquet.compression bzw. orc.compress.
compression_level Gibt eine zu verwendende Komprimierungsstufe an. Diese Eigenschaft gilt nur für die ZSTD-Komprimierung. Mögliche Werte liegen zwischen 1 und 22. Der Standardwert ist 3. Weitere Informationen finden Sie unter ZSTD-Komprimierungsstufen verwenden.
projection.* Benutzerdefinierte Eigenschaften, die in der Partitionsprojektion verwendet werden, damit Athena weiß, welche Partitionsmuster zu erwarten sind, wenn eine Abfrage für eine Tabelle ausgeführt wird. Weitere Informationen finden Sie unter Partitionsprojektion mit Amazon Athena verwenden.
skip.header.line.count Ignoriert Kopfzeilen in Daten, wenn Sie eine Tabelle definieren. Weitere Informationen finden Sie unter Ignorieren von Kopfzeilen.
storage.location.template Gibt eine benutzerdefinierte Amazon-S3-Pfadvorlage für projizierte Partitionen an. Weitere Informationen finden Sie unter Partitionsprojektions einrichten.

Beispiele

Im folgenden Beispiel wird den Tabelleneigenschaften eine Kommentarnotiz hinzugefügt.

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

Im folgenden Beispiel wird die Tabelle existing_table so geändert, dass das Parquet-Dateiformat mit ZSTD-Komprimierung und ZSTD-Komprimierungsstufe 4 verwendet wird.

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