ALTER TABLE SET TBLPROPERTIES - Amazon Athena
SyntaxParameterBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 in der CloudTrail Konsole für Athena erstellt wurden, cloudtrail werden als Wert für die classification Eigenschaft hinzugefügt. 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 Erstellen Sie Tabellen auf der Grundlage verschlüsselter Datensätze in Amazon S3.
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 Parkett 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 Verwenden Sie ZSTD Kompressionsstufen.
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 Verwenden Sie die Partitionsprojektion mit Amazon Athena.
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 Richten Sie die Partitionsprojektion ein.

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)