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. # Wartung von S3 Tables Amazon S3 führt automatisch Wartungsarbeiten durch, um die Leistung Ihrer Tabellen in S3-Tabellen-Bucket zu verbessern. Die Wartung erfolgt auf der Ebene der Tabellen-Buckets und der einzelnen Tabellen und umfasst Folgendes: **Wartung auf Tabellen-Bucket-Ebene:** + **Entfernung unreferenzierter Dateien** — Bereinigt verwaiste Dateien, um die Speichernutzung und die Kosten zu optimieren. **Wartung auf Tabellenebene:** + **Dateikomprimierung** – Konsolidiert kleine Dateien, um die Abfrageleistung zu verbessern und die Speicherkosten zu senken. + **Verwaltung von Momentaufnahmen** – Verwaltet die Versionshistorie der Tabelle und verhindert eine übermäßige Zunahme der Metadaten. Diese Optionen sind standardmäßig aktiviert. Sie können diese Operationen mithilfe von Wartungskonfigurationsdateien bearbeiten oder deaktivieren. Zusätzlich zu diesen Optionen können Sie auch Einstellungen für das Ablaufen von Datensätzen für Tabellen aktivieren und konfigurieren. Mit dieser Option entfernt Amazon S3 automatisch Datensätze aus einer Tabelle, wenn die Datensätze ablaufen. **Topics** + [Status des Wartungsauftrags für S3 Tables](s3-tables-maintenance-status.md) + [Wartung von Tabellen-Buckets](s3-table-buckets-maintenance.md) + [Wartung von Tabellen](s3-tables-maintenance.md) + [Gültigkeitsdauer für Tabellen eintragen](s3-tables-record-expiration.md) + [Überlegungen und Einschränkungen für Wartungsarbeiten](s3-tables-considerations.md) # Status des Wartungsauftrags für S3 Tables Für Ihre S3 Tables oder Tabellen-Buckets werden regelmäßig Wartungsaufträge für S3 Tables ausgeführt. Sie können den Status dieser Jobs mit der `GetTableMaintenanceJobStatus`-API überprüfen. **Um den Status Ihrer Wartungsarbeiten abzurufen, verwenden Sie den AWS CLI** Im folgenden Beispiel wird der Status von Wartungsaufträgen mithilfe der `GetTableMaintenanceJobStatus`-API abgerufen. ``` aws s3tables get-table-maintenance-job-status \ --table-bucket-arn="arn:aws:s3tables:arn:aws::111122223333:bucket/amzn-s3-demo-bucket1" \ --namespace="mynamespace" \ --name="testtable" ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html) in der Referenz zum *AWS CLI -Befehl*. Bei Wartungsaufträgen für S3 Tables können Sie zwischen vier möglichen Status wechseln: + `Successful` + `Failed` + `Disabled` + `Not_Yet_Run` Jobs mit dem Status „Failed (Fehlgeschlagen)“ enthalten eine Fehlermeldung. Die folgende Liste beschreibt mögliche Fehlermeldungen. + Beim Versuch, die Tabelle zu lesen, ist eine Iceberg-Validierungsausnahme aufgetreten. Stellen Sie sicher, dass Ihre Tabelle lesbar ist, der Iceberg-Spezifikation entspricht und nur S3-Pfade enthält, die mit Ihrem S3-Table-Alias beginnen. + Das Iceberg Snapshot-Management unterstützt derzeit keine benutzerdefinierten Tags oder Verweise. + Die Konfiguration für die Wartung der Iceberg-Tabelle ist nicht mit 'history.expire 'kompatibel. max-snapshot-age-ms' und 'history.expire. min-snapshots-to-keep' Eigenschaften der Tabelle. + Die Verwaltung von Iceberg-Snapshots und das Entfernen nicht referenzierter Dateien werden nicht unterstützt, wenn die Tabelleneigenschaft 'gc.enabled' den Wert false hat. Stellen Sie sicher, dass diese Eigenschaft nicht gesetzt oder ausdrücklich auf true gesetzt ist. + Fehler beim Festschreiben aufgrund veralteter Metadaten. Die Wartung wird bei der nächsten sich bietenden Gelegenheit erneut versucht. + Unzureichender Zugriff für die Tabellenwartung. Stellen Sie sicher, dass der zum Verschlüsseln der Tabelle verwendete Schlüssel aktiv und vorhanden ist und über eine Ressourcenrichtlinie verfügt, die dem S3-Service-Prinzipal `maintenance.s3tables.amazonaws.com` Zugriff gewährt. **Anmerkung** Weitere Informationen zu AWS KMS Berechtigungen für S3-Tabellen finden Sie unter[Berechtigungsanforderungen für die SSE-KMS-Verschlüsselung von S3 Tables](s3-tables-kms-permissions.md). + Interner Fehler # Wartung von Tabellen-Buckets Amazon S3 bietet Wartungsvorgänge, die dazu dienen, die Verwaltung und Leistung Ihrer Tabellen-Buckets zu verbessern. Die folgende Option ist standardmäßig für alle Tabellen-Bucket aktiviert. Sie können diese Option bearbeiten oder deaktivieren, indem Sie eine Wartungskonfigurationsdatei für Ihren Tabellen-Bucket festlegen. Zur Bearbeitung dieser Konfiguration ist die Berechtigung `s3tables:PutTableBucketMaintenanceConfiguration` erforderlich. **Topics** + [Entfernung nicht referenzierter Dateien](#s3-table-bucket-maintenance-unreferenced) + [Überlegungen und Einschränkungen](#s3-tables-buckets-considerations-see-more) ## Entfernung nicht referenzierter Dateien Beim Entfernen von nicht referenzierten Dateien werden alle Objekte identifiziert und gelöscht, die von keinem Tabellen-Snapshot referenziert sind. Im Rahmen Ihrer Richtlinie zum Entfernen nicht referenzierter Dateien können Sie zwei Eigenschaften konfigurieren: `unreferencedDays` (standardmäßig 3 Tage) und `nonCurrentDays` (standardmäßig 10 Tage). Für jedes Objekt, das in Ihrer Tabelle nicht referenziert ist und das älter als die Eigenschaft `unreferencedDays` ist, markiert S3 das Objekt als nicht aktuell. S3 löscht Objekte, die nicht aktuell sind, nach der in der Eigenschaft `nonCurrentDays` angegebenen Anzahl von Tagen. **Anmerkung** Das Löschen von Objekten, die nicht aktuell sind, ist dauerhaft und es besteht keine Möglichkeit, diese Objekte wiederherzustellen. Um Objekte anzuzeigen oder wiederherzustellen, die als nicht aktuell markiert wurden, wenden Sie sich an AWS Support. Informationen zur Kontaktaufnahme finden Sie AWS Support unter [Kontakt AWS](https://aws.amazon.com/contact-us/) oder in der [AWS Support Dokumentation](https://aws.amazon.com/documentation/aws-support/). Das Feature zum Löschen nicht referenzierter Dateien bestimmt die Objekte, die aus Ihrer Tabelle gelöscht werden sollen, nur unter Beachtung der Referenzen zu dieser Tabelle. Außerhalb der Tabelle vorhandene Referenzen zu diesen Objekten hindern das Feature zum Löschen nicht referenzierter Dateien nicht daran, ein Objekt zu löschen. Wenn Sie das Entfernen von nicht referenzierten Dateien deaktivieren, hat dies keine Auswirkungen auf laufende Jobs. Die neue Konfiguration wird für den nächsten Job nach der Konfigurationsänderung wirksam. Weitere Informationen finden Sie in den Preisinformationen unter [Amazon S3 – Preise](https://aws.amazon.com/s3/pricing/). Sie können das Entfernen nicht referenzierter Dateien nur auf Tabellen-Bucket-Ebene konfigurieren. Diese Konfiguration gilt für jede Tabelle in Ihrem Bucket. **So konfigurieren Sie das Entfernen von Dateien, auf die nicht verwiesen wird, mithilfe des AWS CLI** Im folgenden Beispiel werden mithilfe der `PutTableBucketMaintenanceConfiguration`-API der Wert `unreferencedDays` auf 4 Tage und der Wert `nonCurrentDays` auf 10 Tage festgelegt. ``` aws s3tables put-table-bucket-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \ --type icebergUnreferencedFileRemoval \ --value '{"status":"enabled","settings":{"icebergUnreferencedFileRemoval":{"unreferencedDays":4,"nonCurrentDays":10}}}' ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-bucket-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-bucket-maintenance-configuration.html) in der Referenz zum *AWS CLI -Befehl*. ## Überlegungen und Einschränkungen Weitere Informationen zu zusätzlichen Überlegungen und Einschränkungen beim Entfernen von nicht referenzierten Dateien finden Sie unter [Überlegungen und Einschränkungen für Wartungsarbeiten](s3-tables-considerations.md). # Wartung von Tabellen S3 Tables bietet Wartungsvorgänge zur Verbesserung der Verwaltung und Leistung Ihrer einzelnen Tabellen an. Die folgenden Optionen sind standardmäßig für alle Tabellen in Tabellen-Buckets aktiviert. Sie können sie bearbeiten oder deaktivieren, indem Sie Wartungskonfigurationsdateien für Ihre S3 Table angeben. Für die Bearbeitung dieser Konfiguration sind die Berechtigungen `s3tables:GetTableMaintenanceConfiguration` und `s3tables:PutTableMaintenanceConfiguration` erforderlich. **Anmerkung** Sie können die automatisierten Wartungsvorgänge von S3 Tables an Ihren Tabellen anhand von CloudTrail Protokollen verfolgen. Weitere Informationen finden Sie unter[CloudTrail Verwaltungsereignisse für die Wartung von S3-Tabellen](s3-tables-logging.md#s3-tables-maintenance-events). **Topics** + [Verdichtung](#s3-tables-maintenance-compaction) + [Snapshot-Verwaltung](#s3-tables-maintenance-snapshot) + [Überlegungen und Einschränkungen](#s3-tables-considerations-see-more) ## Verdichtung Die Komprimierung wird auf Tabellenebene konfiguriert und kombiniert mehrere kleinere Objekte zu weniger größeren Objekten, um die Apache Iceberg Abfrageleistung zu verbessern. Beim Kombinieren von Objekten überträgt die Komprimierung auch die Auswirkungen von Löschungen auf Zeilenebene in Ihrer Tabelle. Die Verdichtung ist standardmäßig für alle Tabellen aktiviert, mit einer Standardziel-Dateigröße von 512 MB oder einem benutzerdefinierten Wert zwischen 64 MB und 512 MB. Die komprimierten Dateien werden als der neueste Snapshot Ihrer Tabelle geschrieben. **Anmerkung** Die Komprimierung wird nur für Apache Parquet-, Avro- und ORC-Dateitypen unterstützt. ### Strategien für eine Verdichtung Sie können aus mehreren Komprimierungsstrategien wählen, die die Abfrageleistung je nach Ihren Abfragemustern und der Sortierreihenfolge der Tabellen weiter erhöhen können. S3 Tables unterstützt die folgenden Verdichtungsstrategien für Tabellen: + **Auto (Standard)** + Amazon S3 wählt auf der Grundlage Ihrer Tabellensortierreihenfolge die beste Verdichtungsstrategie aus. Dies ist die Standardkomprimierungsstrategie für alle Tabellen. + Bei Tabellen, deren Metadaten eine definierte Sortierreihenfolge enthalten, wird `auto` automatisch eine `sort`-Verdichtung durchführen. + Bei Tabellen ohne Sortierreihenfolge wird `auto` standardmäßig die `binpack`-Verdichtung verwenden. + **Binpack** + Kombiniert kleine Dateien zu größeren Dateien und zielt in der Regel auf Größen über 100 MB ab. Dabei werden alle ausstehenden Löschungen angewendet. Dies ist die Standardkomprimierungsstrategie für unsortierte Tabellen. + **Sortierung** + Organisiert Daten auf der Grundlage festgelegter Spalten, die während der Verdichtung automatisch nach Hierarchie sortiert werden, wodurch die Abfrageleistung für gefilterte Vorgänge verbessert wird. Diese Strategie wird empfohlen, wenn Sie mit Ihren Abfragen häufig nach bestimmten Spalten filtern. Wenn Sie diese Strategie verwenden, wendet S3 Tables automatisch eine hierarchische Sortierung auf Spalten an, wenn a in den Tabelleneigenschaften definiert `sort_order` ist. + **Z-Reihenfolge** + Optimiert die Datenorganisation, indem mehrere Attribute zu einem einzigen Skalarwert zusammengefasst werden, der für die Sortierung verwendet werden kann, wodurch effizientes Abfragen über mehrere Dimensionen hinweg ermöglicht wird. Diese Strategie wird empfohlen, wenn Sie Daten über mehrere Dimensionen hinweg gleichzeitig abfragen müssen. Diese Strategie erfordert, dass Sie in den Eigenschaften Ihrer Iceberg-Tabelle mithilfe der `sort_order`-Tabelleneigenschaft eine Sortierreihenfolge festlegen. Die Verdichtung verursacht zusätzliche Kosten. Die Komprimierungsstrategien `z-order` und `sort` können höhere Kosten verursachen als `binpack`. Weitere Informationen finden Sie in den Preisinformationen unter [Amazon S3 – Preise](https://aws.amazon.com/s3/pricing/). ### Beispiele für eine Verdichtung Die folgenden Beispiele zeigen die Konfigurationen für eine Tabellendichtung. **Um die Zieldateigröße für die Komprimierung zu konfigurieren, verwenden Sie den AWS CLI** Die Mindestgröße der Zielkomprimierungsdatei beträgt 64 MB, die maximale Größe 512 MB. Im folgenden Beispiel wird die Zieldateigröße mithilfe der `PutTableMaintenanceConfiguration`-API auf 256 MB geändert. ``` aws s3tables put-table-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-bucket1 \ --type icebergCompaction \ --namespace mynamespace \ --name testtable \ --value='{"status":"enabled","settings":{"icebergCompaction":{"targetFileSizeMB":256}}}' ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) in der Referenz zum *AWS CLI -Befehl*. **Um die Verdichtungsstrategie zu konfigurieren, verwenden Sie AWS CLI** Das folgende Beispiel ändert die Komprimierungsstrategie mithilfe der `PutTableMaintenanceConfiguration`-API auf `sort`. Bei der Festlegung der Komprimierung können Sie zwischen folgenden Komprimierungsstrategien wählen: `auto`, `binpack`, `sort` oder `z-order` Um die Komprimierungsstrategie auf `sort` oder `z-order` festzulegen, müssen die folgenden Voraussetzungen erfüllt sein: + Eine in Ihren Iceberg-Tabelleneigenschaften definierte Sortierreihenfolge. + Die `s3tables:GetTableData` Erlaubnis. ``` aws s3tables put-table-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \ --type icebergCompaction \ --namespace mynamespace \ --name testtable \ --value='{"status":"enabled","settings":{"icebergCompaction":{"strategy":"sort"}}}' ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) in der Referenz zum *AWS CLI -Befehl*. **Um die Komprimierung zu deaktivieren, verwenden Sie AWS CLI** Im folgenden Beispiel wird die Komprimierung mithilfe der `PutTableMaintenanceConfiguration`-API deaktiviert. ``` aws s3tables put-table-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \ --type icebergCompaction \ --namespace mynamespace \ --name testtable \ --value='{"status":"disabled","settings":{"icebergCompaction":{"targetFileSizeMB":256}}}' ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) in der Referenz zum *AWS CLI -Befehl*. ## Snapshot-Verwaltung Die Snapshot-Verwaltung bestimmt die Anzahl der aktiven Snapshots für Ihre Tabelle. Sie basiert auf `MinimumSnapshots` (standardmäßig 1) und `MaximumSnapshotAge` (standardmäßig 120 Stunden). Auf der Basis dieser Konfigurationen lässt die Snapshot-Verwaltung Tabellen-Snapshots ablaufen und entfernt sie. Wenn ein Snapshot abläuft, markiert Amazon S3 alle Objekte, die nur von diesem Snapshot referenziert sind, als nicht aktuell. Diese veralteten Objekte werden nach Ablauf der Anzahl von Tagen gelöscht, die in Ihrer Richtlinie zur Entfernung nicht referenzierter Dateien als Eigenschaft `NoncurrentDays` festgelegt wurde. **Anmerkung** Das Löschen von Objekten, die nicht aktuell sind, ist dauerhaft und es besteht keine Möglichkeit, diese Objekte wiederherzustellen. Um Objekte anzuzeigen oder wiederherzustellen, die als nicht aktuell markiert wurden, wenden Sie sich an AWS Support. Informationen zur Kontaktaufnahme finden Sie AWS Support unter [Kontakt AWS](https://aws.amazon.com/contact-us/) oder in der [AWS Support Dokumentation](https://aws.amazon.com/documentation/aws-support/). Die Snapshot-Verwaltung bestimmt die Objekte, die aus Ihrer Tabelle gelöscht werden sollen, nur unter Beachtung der Referenzen zu dieser Tabelle. Verweise auf diese Objekte von außerhalb der Tabelle verhindern nicht, dass sie durch die Snapshot-Verwaltung gelöscht werden. **Anmerkung** Die Snapshot-Verwaltung unterstützt keine Aufbewahrungswerte, die Sie als Eigenschaften von Iceberg-Tabellen in der Datei `metadata.json` oder über den SQL-Befehl `ALTER TABLE SET TBLPROPERTIES` konfigurieren. Dies gilt auch für die verzweigungs- oder Tag-basierte Aufbewahrung. Die Snapshot-Verwaltung ist deaktiviert, wenn Sie eine verzweigungs- oder tagbasierte Aufbewahrungsrichtlinie oder eine Aufbewahrungsrichtlinie für die Datei `metadata.json` konfigurieren, die länger ist als die über die `PutTableMaintenanceConfiguration`-API konfigurierten Werte. In diesen Fällen lässt S3 Snapshots nicht ablaufen oder entfernen. Sie müssen die Snapshots manuell löschen oder die Eigenschaften aus Ihrer Iceberg-Tabelle entfernen, um Speichergebühren zu vermeiden. Sie können die Snapshot-Verwaltung nur auf Tabellenebene konfigurieren. Weitere Informationen finden Sie in den Preisinformationen unter [Amazon S3 – Preise](https://aws.amazon.com/s3/pricing/). ### Beispiele für Snapshot-Verwaltung Die folgenden Beispiele zeigen die Konfigurationen für die Snapshot-Verwaltung von Tabellen. **Um das Snapshot-Management mit dem zu konfigurieren AWS CLI** Im folgenden Beispiel werden mithilfe der `PutTableMaintenanceConfiguration`-API der Wert `MinimumSnapshots` auf 10 und der Wert `MaximumSnapshotAge` auf 2.500 Stunden festgelegt. ``` aws s3tables put-table-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \ --namespace my_namespace \ --name my_table \ --type icebergSnapshotManagement \ --value '{"status":"enabled","settings":{"icebergSnapshotManagement":{"minSnapshotsToKeep":10,"maxSnapshotAgeHours":2500}}}' ``` **Um die Snapshot-Verwaltung zu deaktivieren, verwenden Sie AWS CLI** Das folgende Beispiel deaktiviert die Snapshot-Verwaltung über die `PutTableMaintenanceConfiguration`-API. ``` aws s3tables put-table-maintenance-configuration \ --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \ --namespace my_namespace \ --name my_table \ --type icebergSnapshotManagement \ --value '{"status":"disabled","settings":{"icebergSnapshotManagement":{"minSnapshotsToKeep":1,"maxSnapshotAgeHours":120}}}' ``` Weitere Informationen finden Sie unter [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/put-table-maintenance-configuration.html) in der Referenz zum *AWS CLI -Befehl*. ## Überlegungen und Einschränkungen Weitere Informationen zu zusätzlichen Überlegungen und Einschränkungen bei der Komprimierung und Snapshot-Verwaltung finden Sie unter [Überlegungen und Einschränkungen für Wartungsarbeiten](s3-tables-considerations.md). **Anmerkung** S3 Tables wendet die row-group-default Parkettgröße von 128 MB an. # Gültigkeitsdauer für Tabellen eintragen Standardmäßig laufen Datensätze in Ihren S3-Tabellen nicht ab. Um die Speicherkosten für Ihre Tabellen zu minimieren, können Sie das Ablaufen von Datensätzen für die Tabellen aktivieren und konfigurieren. Mit dieser Option entfernt Amazon S3 automatisch Datensätze aus einer Tabelle, wenn die Datensätze ablaufen. Wenn Sie das Ablaufen von Datensätzen für eine Tabelle aktivieren, geben Sie an, wie viele Tage Datensätze in der Tabelle aufbewahrt werden sollen, bevor die Datensätze ablaufen. Dabei kann es sich um eine beliebige Anzahl von Tagen handeln, die von einem Tag bis zu 2.147.483.647 Tagen reichen. Um beispielsweise Tabellendatensätze für ein Jahr aufzubewahren, geben Sie Tage an. `365` Die Datensätze bleiben dann 365 Tage lang bestehen. Nach 365 Tagen laufen die Datensätze ab und Amazon S3 entfernt sie automatisch. Sie können den Ablauf von Datensätzen für AWS verwaltete Tabellen aktivieren und konfigurieren, in denen bestimmte Datensätze aus bestimmten AWS-Services, derzeit Amazon S3 Storage Lens und Amazon SageMaker Catalog, gespeichert werden. Optionen für das Ablaufen von Datensätzen sind derzeit für andere AWS verwaltete Tabellen nicht verfügbar. Die Ausnahme bilden Journaltabellen Amazon S3 S3-Metadaten. Journaltabellen verwenden unterschiedliche Einstellungen für das Ablaufen von Datensätzen, die Sie auf der Service-Ebene angeben. Informationen zum Konfigurieren des Ablaufs von Datensätzen für diesen Tabellentyp finden Sie unter[Ablauf von Journaltabellen-Datensätzen](metadata-tables-expire-journal-table-records.md). Beachten Sie, dass Optionen für das Ablaufen von Datensätzen für S3-Tabellen, die Sie erstellen, nicht verfügbar sind. Nachdem Sie den Ablauf von Datensätzen für eine Tabelle aktiviert haben, können Sie ihn jederzeit deaktivieren. Amazon S3 läuft dann nicht mehr ab und entfernt keine Datensätze mehr aus der Tabelle. **Topics** + [Funktionsweise](#s3-tables-record-expiration-how-it-works) + [Ablauf von Datensätzen konfigurieren](#s3-tables-record-expiration-configure) + [Überwachung des Ablaufs von Datensätzen](#s3-tables-record-expiration-monitor) + [Überlegungen](#s3-tables-expiration-considerations) ## So funktioniert das Ablaufen von Datensätzen Der Ablauf von Datensätzen entfernt automatisch Datensätze aus einer S3-Tabelle, wenn die Datensätze älter sind als die Anzahl von Tagen, die Sie in den Einstellungen für das Ablaufen von Datensätzen für die Tabelle angegeben haben. Um zu bestimmen, wann Datensätze ablaufen, verwendet Amazon S3 bestimmte Zeitstempel in den Datensätzen. Die Wahl der Zeitstempelspalte ergibt sich direkt aus dem Tabellenschema für eine Tabelle. Sie müssen nicht angeben, welche Zeitstempelspalte verwendet werden soll. Die Tabellen werden von verwaltet AWS und Amazon S3 wählt automatisch die entsprechende Spalte aus, die verwendet werden soll, wenn Sie das Ablaufen von Datensätzen für eine Tabelle aktivieren. Sie können Einstellungen für das Ablaufen von Datensätzen für AWS verwaltete Tabellen aktivieren und konfigurieren, die bestimmte Amazon S3 Storage Lens-Metriken oder spezifische Amazon SageMaker Catalog-Metadaten speichern. Optionen für das Ablaufen von Datensätzen sind für die folgenden AWS verwalteten Tabellen für diese Dienste verfügbar: + S3-Speicherlinse — `bucket_property_metrics``default_activity_metrics`,`default_storage_metrics`,`expanded_prefixes_activity_metrics`, und`expanded_prefixes_storage_metrics`. Um zu ermitteln, wann Datensätze in diesen Tabellen ablaufen, verwendet Amazon S3 das `report_time` Feld in den Datensätzen. + SageMaker Amazon-Katalog —`ASSET`. Um zu bestimmen, wann Datensätze in dieser Tabelle ablaufen, verwendet Amazon S3 das `snapshot_time` Feld in den Datensätzen. Nachdem Sie den Ablauf von Datensätzen für eine Tabelle aktiviert haben, startet Amazon S3 mit der Ausführung von Datensatzablaufjobs, die die folgenden Operationen für die Tabelle ausführen: 1. Identifizieren Sie Datensätze, die älter als die angegebene Ablaufeinstellung sind. 1. Erstellen Sie einen neuen Snapshot, der Verweise auf die abgelaufenen Datensätze ausschließt. Das Entfernen basiert auch auf dem Ablauf des Snapshots und den Einstellungen für das Entfernen nicht referenzierter Dateien in den Wartungskonfigurationseinstellungen für die Tabelle. Weitere Informationen zu diesen Einstellungen finden Sie unter[Wartung von Tabellen](s3-tables-maintenance.md). **Warnung** Amazon S3 läuft ab und entfernt Datensätze innerhalb von 24 bis 48 Stunden, nachdem die Datensätze ablaufen können. Tabellendatensätze werden aus dem letzten Snapshot entfernt. Daten und Speicherplatz für die Datensätze werden bei der Tabellenverwaltung entfernt. Tabellendatensätze können nach ihrem Ablauf nicht wiederhergestellt werden. ## Den Ablauf von Datensätzen für eine Tabelle konfigurieren Sie können die Einstellungen für das Ablaufen von Datensätzen für eine S3-Tabelle aktivieren, konfigurieren und anderweitig verwalten, indem Sie die Amazon S3 S3-Konsole, die Amazon S3 S3-REST-API, AWS Command Line Interface (AWS CLI) oder verwenden AWS SDKs. Bevor Sie versuchen, diese Aufgaben für eine Tabelle auszuführen, stellen Sie sicher, dass Sie über die folgenden AWS Identity and Access Management (IAM-) Berechtigungen verfügen: + `s3tables:GetTableRecordExpirationConfiguration`— Mit dieser Aktion können Sie auf die aktuellen Einstellungen für das Ablaufen von Datensätzen für Tabellen zugreifen. + `s3tables:PutTableRecordExpirationConfiguration`— Mit dieser Aktion können Sie Einstellungen für das Ablaufen von Datensätzen für Tabellen aktivieren, konfigurieren und deaktivieren. + `s3tables:GetTableRecordExpirationJobStatus`— Mit dieser Aktion können Sie den Status von Vorgängen zum Ablaufen von Datensätzen (Jobs) für Tabellen und die Zugriffsmetriken für die Vorgänge überwachen. In den folgenden Abschnitten wird erklärt, wie Sie die Einstellungen für das Ablaufen von Datensätzen für eine Tabelle mithilfe der Amazon S3 S3-Konsole und der aktivieren, konfigurieren und deaktivieren AWS CLI. Verwenden Sie den [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableRecordExpirationConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableRecordExpirationConfiguration.html)Vorgang, um diese Aufgaben mit der Amazon S3 S3-REST-API oder einem AWS SDK auszuführen. Weitere Informationen finden Sie unter [Entwickeln mit Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/API/developing-s3.html) in der *Amazon Simple Storage Service API-Referenz*. ### Verwenden der S3-Konsole Gehen Sie wie folgt vor, um die Einstellungen für das Ablaufen von Datensätzen für eine S3-Tabelle mithilfe der Konsole zu aktivieren und zu konfigurieren. 1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Wählen Sie im linken Navigationsbereich **Tabellen-Buckets** aus. 1. Wählen Sie auf der Seite **Tabellen-Buckets** den Bucket aus, in dem die Tabelle gespeichert ist. 1. Wählen Sie auf der Registerkarte **Tabellen** die Tabelle aus. 1. Wählen Sie auf der Registerkarte **Wartung** im Abschnitt **Ablauf des Datensatzes** die Option **Bearbeiten** aus. 1. Wählen Sie unter **Ablauf des Datensatzes** die Option **Aktivieren** aus. 1. Geben Sie für **Tage, nach denen Datensätze ablaufen**, die Anzahl der Tage ein, für die Datensätze in der Tabelle aufbewahrt werden sollen. Dies kann eine beliebige ganze Zahl im Bereich von 1 bis 2.147.483.647 sein. Um beispielsweise Datensätze für ein Jahr aufzubewahren, geben Sie ein. **365** **Warnung** Beachten Sie bei der Festlegung des geeigneten Aufbewahrungszeitraums für Datensätze in der Tabelle, dass Datensätze nach deren Ablauf nicht wiederhergestellt werden können. 1. Wählen Sie **Änderungen speichern ** aus. Um den Aufbewahrungszeitraum anschließend zu ändern, wiederholen Sie die vorherigen Schritte. Um anschließend den Ablauf von Datensätzen zu deaktivieren, wiederholen Sie die Schritte 1 bis 5. Wählen Sie dann für Schritt 6 die Option **Deaktivieren** aus. Wenn Sie die gewünschten Änderungen vorgenommen haben, wählen Sie **Save changes (Änderungen speichern)** aus. ### Mit dem AWS CLI Um die Einstellungen für das Ablaufen von Datensätzen für eine S3-Tabelle mithilfe von zu konfigurieren und zu verwalten AWS CLI, führen Sie den [https://docs.aws.amazon.com/cli/latest/reference/s3tables/put-table-record-expiration-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/s3tables/put-table-record-expiration-configuration.html)Befehl aus. Sie können damit beginnen, eine JSON-Datei zu erstellen, die die Einstellungen für das Ablaufen von Datensätzen enthält, die auf die Tabelle angewendet werden sollen. Das folgende Beispiel zeigt den Inhalt einer JSON-Datei, die das Ablaufen von Datensätzen für eine Tabelle aktiviert. Es gibt auch eine Aufbewahrungsfrist von 30 Tagen für Datensätze in der Tabelle an. Mit anderen Worten, es gibt an, dass Tabelleneinträge nach 30 Tagen ablaufen sollen. ``` { "status": "enabled", "settings": { "days": 30 { } ``` Um das vorherige Beispiel zu verwenden, ersetzen Sie das `user input placeholders` durch Ihre eigenen Informationen. **Warnung** Beachten Sie bei der Festlegung des geeigneten Aufbewahrungszeitraums für Datensätze in der Tabelle, dass Datensätze nach deren Ablauf nicht wiederhergestellt werden können. Um das Ablaufen von Datensätzen für eine Tabelle zu deaktivieren, geben Sie `disabled` für das `status` Feld einen Wert an und lassen Sie das `settings` Objekt aus der Datei weg. Beispiel: ``` { "status": "disabled" } ``` Nachdem Sie eine JSON-Datei mit den anzuwendenden Einstellungen erstellt haben, führen Sie den `put-table-record-expiration-configuration` Befehl aus. Geben Sie für den `table-arn` Parameter den Amazon-Ressourcennamen (ARN) der Tabelle an. Geben Sie für den `value` Parameter den Namen der Datei an, in der die Einstellungen gespeichert sind. Mit dem folgenden Befehl werden beispielsweise die Einstellungen für das Ablaufen von Datensätzen für eine Tabelle aktualisiert. Die Einstellungen werden in einer Datei mit dem Namen angegeben*`record-expiration-config.json`*. ``` aws s3tables put-table-record-expiration-configuration \ --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table \ --value file://./record-expiration-config.json ``` Um das vorherige Beispiel zu verwenden, ersetzen Sie die `user input placeholders` durch Ihre eigenen Informationen. ## Überwachen des Ablaufs von Datensätzen für eine Tabelle Um den Status und die Ergebnisse von Vorgängen zum Ablaufen von Datensätzen für Ihre S3-Tabellen zu überwachen, verwenden Sie den [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_GetTableRecordExpirationJobStatus.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_GetTableRecordExpirationJobStatus.html)Vorgang oder, falls Sie den verwenden AWS CLI, führen Sie den [https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-record-expiration-job-status.html](https://docs.aws.amazon.com/cli/latest/reference/s3tables/get-table-record-expiration-job-status.html)Befehl aus. Geben Sie in Ihrer Anfrage den Amazon-Ressourcennamen (ARN) der Tabelle an. Mit dem folgenden AWS CLI Befehl wird beispielsweise der Status von Vorgängen zum Ablaufen von Datensätzen für eine bestimmte Tabelle in einem Tabellen-Bucket abgerufen. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen. ``` aws s3tables get-table-record-expiration-job-status \ --table-arn arn:aws:s3tables:us-east-1:123456789012:bucket/amzn-s3-demo-table-bucket/table/amzn-s3-demo-table ``` Wenn Ihre Anfrage erfolgreich ist, erhalten Sie eine Antwort mit Informationen, z. B. wann Amazon S3 zuletzt Vorgänge zum Ablaufen von Datensätzen für die Tabelle ausgeführt hat, und den Status dieser Ausführung. Wenn die letzte Ausführung erfolgreich war, enthält die Antwort auch Verarbeitungsmetriken, z. B. die Anzahl der Datendateien und Datensätze, die entfernt wurden, und die Gesamtgröße der entfernten Daten. Wenn bei der letzten Ausführung Fehler aufgetreten sind, enthält die Antwort eine Fehlermeldung, in der beschrieben wird, warum die Ausführung fehlgeschlagen ist. ## Überlegungen Beachten Sie bei der Konfiguration und Verwaltung der Einstellungen für das Ablaufen von Datensätzen für Ihre AWS verwalteten S3-Tabellen Folgendes: + Das Ablaufen von Datensätzen ist nur für bestimmte AWS verwaltete Tabellen verfügbar AWS-Services, die mit Amazon S3 Storage Lens und Amazon SageMaker Catalog erstellt wurden. Darüber hinaus ist der Ablauf von Datensätzen nur für einzelne Tabellen und nicht für ganze Tabellen-Buckets verfügbar. + Um zu bestimmen, wann Datensätze ablaufen, verwendet Amazon S3 bestimmte Zeitstempel in den Tabellen. Diese Zeitstempel geben an, wann die Daten erstellt wurden, nicht wann Amazon S3 die Datensätze in eine Tabelle aufgenommen hat. Die verwendete Zeitstempelspalte hängt vom Service ab, der die Tabelle veröffentlicht: für S3 Storage Lens-Metriken das `report_time` Feld und für Amazon SageMaker Catalog-Metadaten das `snapshot_time` Feld. Sie können nicht angeben, welches Feld verwendet werden soll, da die Tabellen von AWS verwaltet werden. + Wenn es beim Export von Daten in eine Tabelle zu Verzögerungen kommt, kann es sein, dass Datensätze früher als erwartet ablaufen. Aus diesem Grund empfehlen wir, mögliche Verzögerungen bei der Datenaufnahme zu berücksichtigen, indem Sie in den Ablaufeinstellungen für Ihre Tabellen einen Puffer zur Aufbewahrungsdauer hinzufügen. + Datensätze laufen ab und werden innerhalb von 24 bis 48 Stunden entfernt, nachdem sie für den Ablauf in Frage kommen. Amazon S3 läuft nicht ab und entfernt Datensätze sofort, nachdem sie für den Ablauf in Frage kommen. + Datensätze können nicht wiederhergestellt werden, nachdem sie abgelaufen sind und entfernt wurden. # Überlegungen und Einschränkungen für Wartungsarbeiten Amazon S3 bietet Wartungsvorgänge, die dazu dienen, die Leistung Ihrer S3-Tabellen oder Tabellen-Buckets zu verbessern. Zu diesen Optionen gehören die Dateikomprimierung, die Snapshot-Verwaltung und die Entfernung nicht referenzierter Dateien. Im Folgenden werden die Einschränkungen und Überlegungen zu diesen Verwaltungsoptionen beschrieben. **Topics** + [Überlegungen zur Komprimierung](#s3-tables-compaction-considerations) + [Hinweise zur Snapshot-Verwaltung](#s3-tables-snapshot-considerations) + [Überlegungen zum Entfernen von nicht referenzierten Dateien](#s3-tables-unreferenced-file-removal-considerations) + [Betriebsbeschränkungen für S3-Tabellen und Tabellen-Buckets und ähnliches APIs](#s3-tables-maintenance-limits) ## Überlegungen zur Komprimierung Folgende Überlegungen betreffen die Komprimierung. Weitere Informationen zur Komprimierung finden Sie unter [Wartung von Tabellen](s3-tables-maintenance.md). + Die Komprimierung wird nur für Apache Parquet-, Avro- und ORC-Dateitypen unterstützt. + Die Komprimierung schreibt neue Dateien standardmäßig im Apache Parquet Format. Um Dateien stattdessen in Avro oder ORC Formate zu komprimieren, setzen Sie die `write.format.default` Tabelleneigenschaft auf `avro` oder`orc`. + Die Komprimierung unterstützt Datentypen nicht: `Fixed`. + Die Komprimierung unterstützt Komprimierungstypen nicht: `brotli`, `lz4` + Die Komprimierung erfolgt nach einem automatisierten Zeitplan. Wenn Sie Kosten im Zusammenhang mit der Komprimierung vermeiden möchten, können Sie sie mithilfe des [PutTableMaintenanceConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3Buckets_PutTableMaintenanceConfiguration.html)API-Vorgangs manuell für eine Tabelle deaktivieren. **Anmerkung** Apache Iceberg verwendet ein optimistisches Parallelitätsmodell zusammen mit Konflikterkennung, um Schreibtransaktionen zu vermitteln. Bei optimistischer Parallelität können Benutzer- und Komprimierungstransaktionen zu Konflikten führen, sodass Transaktionen fehlschlagen. Wenn Konflikte auftreten, werden die Komprimierungsaufträge bei einem Fehler erneut versucht. Es wird empfohlen, dass Ihre Pipelines auch Wiederholungslogik verwenden, um Transaktionen zu beheben, die aufgrund widersprüchlicher Vorgänge fehlschlagen. ## Hinweise zur Snapshot-Verwaltung Folgende Überlegungen betreffen die Snapshot-Verwaltung: Weitere Informationen zur Snapshot-Verwaltung finden Sie unter [Wartung von Tabellen](s3-tables-maintenance.md). + Snapshots werden nur aufbewahrt, wenn beide Kriterien erfüllt sind: die Mindestanzahl der aufzubewahrenden Snapshots und der festgelegte Aufbewahrungszeitraum. + Die Snapshot-Verwaltung löscht abgelaufene Snapshot-Metadaten aus Apache Iceberg, wodurch Zeitreiseabfragen für abgelaufene Snapshots verhindert und zugehörige Datendateien optional gelöscht werden. + Die Snapshot-Verwaltung unterstützt keine Aufbewahrungswerte, die Sie als Eigenschaften von Iceberg-Tabellen in der Datei `metadata.json` oder über den SQL-Befehl `ALTER TABLE SET TBLPROPERTIES` konfigurieren. Dies gilt auch für die verzweigungs- oder Tag-basierte Aufbewahrung. Die Snapshot-Verwaltung ist deaktiviert, wenn Sie eine verzweigungs- oder tagbasierte Aufbewahrungsrichtlinie oder eine Aufbewahrungsrichtlinie für die Datei `metadata.json` konfigurieren, die länger ist als die über die `PutTableMaintenanceConfiguration`-API konfigurierten Werte. In diesen Fällen lässt S3 Snapshots nicht ablaufen oder entfernen. Sie müssen die Snapshots manuell löschen oder die Eigenschaften aus Ihrer Iceberg-Tabelle entfernen, um Speichergebühren zu vermeiden. ## Überlegungen zum Entfernen von nicht referenzierten Dateien Die folgenden Überlegungen betreffen das Entfernen von Dateien, die nicht referenziert sind. Weitere Informationen zum Entfernen nicht referenzierter Dateien finden Sie unter [Wartung von Tabellen-Buckets](s3-table-buckets-maintenance.md). + Beim Entfernen nicht referenzierter Dateien werden Daten- und Metadatendateien gelöscht, die nicht mehr durch Iceberg-Metadaten referenziert sind, wenn ihr Erstellungsdatum vor dem Aufbewahrungszeitraum liegt. ## Betriebsbeschränkungen für S3-Tabellen und Tabellen-Buckets und ähnliches APIs | Wartungsoperation | Eigenschaft | Auf Tabellen-Bucket-Ebene konfigurierbar? | Auf Tabellenebene konfigurierbar? | Standardwert | Mindestwert | Verwandte Iceberg Wartungsroutine | Steuern der S3-Tables-API | | --- | --- | --- | --- | --- | --- | --- | --- | | Verdichtung | targetFileSizeMB | Nein | Ja | 512 MB | 64 MB | [https://iceberg.apache.org/docs/latest/maintenance/#compact-data-files](https://iceberg.apache.org/docs/latest/maintenance/#compact-data-files) | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) | | Snapshot-Verwaltung | minimumSnapshots | Nein | Ja | 1 | 1 | [https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots](https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots) retainLast | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) | | Snapshot-Verwaltung | maximumSnapshotAge | Nein | Ja | 120 Stunden | 1 Stunde | [https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots](https://iceberg.apache.org/docs/latest/maintenance/#expire-snapshots) expireOlderThan | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableMaintenanceConfiguration.html) | | Entfernung nicht referenzierter Dateien | unreferencedDays | Ja | Nein | 3 Tage | 1 Tag | [https://iceberg.apache.org/docs/latest/maintenance/#delete-orphan-files](https://iceberg.apache.org/docs/latest/maintenance/#delete-orphan-files) | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html) | | Entfernung nicht referenzierter Dateien | nonCurrentDays | Ja | Nein | 10 Tage | 1 Tag | – | [https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_s3tables_PutTableBucketMaintenanceConfiguration.html) | **Anmerkung** S3 Tables verwendet die row-group-default Parkettgröße von 128 MB.