VACUUM

VACUUMerwartet, dass sich die Iceberg-Daten in einem Amazon S3 S3-Ordner und nicht in einem Amazon S3 S3-Bucket befinden. Wenn sich Ihre Iceberg-Daten beispielsweise beis3://DOC-EXAMPLE-BUCKET/statt bei befindens3://DOC-EXAMPLE-BUCKET/myicebergfolder/, schlägt die VACUUM Anweisung fehl und es wird die Fehlermeldung GENERIC_ INTERNAL _ERROR: Pfad fehlt im Dateisystemverzeichnis: angezeigt. s3://DOC-EXAMPLE-BUCKET

Damit VACUUM Sie Datendateien löschen können, muss Ihre Rolle zur Abfrageausführung über s3:DeleteObject Berechtigungen für den Bucket verfügen, in dem sich Ihre Iceberg-Tabellen, Metadaten, Snapshots und Datendateien befinden. Wenn die Berechtigung nicht vorhanden ist, ist die VACUUM Abfrage erfolgreich, aber die Dateien werden nicht gelöscht.

Um eine Tabelle auszuführenVACUUM, deren Name mit einem Unterstrich beginnt (z. B._mytable), schließen Sie den Tabellennamen wie im folgenden Beispiel in Backticks ein. Wenn Sie dem Tabellennamen einen Datenbanknamen voranstellen, schließen Sie den Datenbanknamen nicht in Backticks ein. Beachten Sie, dass doppelte Anführungszeichen nicht anstelle von Backticks funktionieren.

Dieses Verhalten ist spezifisch fürVACUUM. Die INSERT INTO Anweisungen CREATE und erfordern keine Backticks für Tabellennamen, die mit Unterstrichen beginnen.

VACUUM `_mytable`
VACUUM my_database.`_mytable` 

Entfernt Snapshots, die älter sind als die durch die vacuum_max_snapshot_age_seconds-Tabelleneigenschaft angegebene Zeitdauer. Standardmäßig ist diese Eigenschaft auf 432 000 Sekunden (5 Tage) festgelegt.

Entfernt Snapshots, die nicht innerhalb des Aufbewahrungszeitraums liegen und die die in der vacuum_min_snapshots_to_keep-Tabelleneigenschaft angegebene Anzahl überschreiten. Der Standardwert ist 1.

Sie können diese Tabelleneigenschaften in Ihrer CREATE TABLE-Anweisung angeben. Nachdem die Tabelle erstellt wurde, können Sie diese mit der FESTGELEGTE TABELLENEIGENSCHAFTEN ÄNDERN-Anweisung aktualisieren.

Entfernt alle Metadaten und Datendateien, die aufgrund des Entfernens des Snapshots nicht mehr erreichbar sind. Sie können die Anzahl der alten Metadatendateien, die beibehalten werden sollen, konfigurieren, indem Sie die vacuum_max_metadata_files_to_keep-Tabelleneigenschaft festlegen. Der Standardwert lautet 100.

Entfernt verwaiste Dateien, die älter sind als die in der vacuum_max_snapshot_age_seconds-Tabelleneigenschaft angegebene Zeit. Verwaiste Dateien sind Dateien im Datenverzeichnis der Tabelle, die nicht mehr Teil des Tabellenstatus sind.