

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.

# Tabellenoptimierer-API
<a name="aws-glue-api-table-optimizers"></a>

Die Tabellenoptimierer-API beschreibt die AWS Glue API zur Aktivierung der Komprimierung zur Verbesserung der Leseleistung.

## Datentypen
<a name="aws-glue-api-table-optimizers-objects"></a>
+ [TableOptimizer Struktur](#aws-glue-api-table-optimizers-TableOptimizer)
+ [TableOptimizerConfiguration Struktur](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)
+ [TableOptimizerVpcConfiguration Struktur](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)
+ [CompactionConfiguration Struktur](#aws-glue-api-table-optimizers-CompactionConfiguration)
+ [IcebergCompactionConfiguration Struktur](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)
+ [TableOptimizerRun Struktur](#aws-glue-api-table-optimizers-TableOptimizerRun)
+ [BatchGetTableOptimizerEntry Struktur](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)
+ [BatchTableOptimizer Struktur](#aws-glue-api-table-optimizers-BatchTableOptimizer)
+ [BatchGetTableOptimizerError Struktur](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)
+ [RetentionConfiguration Struktur](#aws-glue-api-table-optimizers-RetentionConfiguration)
+ [IcebergRetentionConfiguration Struktur](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)
+ [OrphanFileDeletionConfiguration Struktur](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)
+ [IcebergOrphanFileDeletionConfiguration Struktur](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)
+ [CompactionMetrics Struktur](#aws-glue-api-table-optimizers-CompactionMetrics)
+ [RetentionMetrics Struktur](#aws-glue-api-table-optimizers-RetentionMetrics)
+ [OrphanFileDeletionMetrics Struktur](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)
+ [IcebergCompactionMetrics Struktur](#aws-glue-api-table-optimizers-IcebergCompactionMetrics)
+ [IcebergRetentionMetrics Struktur](#aws-glue-api-table-optimizers-IcebergRetentionMetrics)
+ [IcebergOrphanFileDeletionMetrics Struktur](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)
+ [RunMetrics Struktur](#aws-glue-api-table-optimizers-RunMetrics)

## TableOptimizer Struktur
<a name="aws-glue-api-table-optimizers-TableOptimizer"></a>

Enthält Details zu einem Optimierer für eine Tabelle.

**Felder**
+ `type` – UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers. Die gültigen Werte sind:
  + `compaction`: zum Verwalten der Verdichtung mit einem Tabellenoptimierer.
  + `retention`: zum Verwalten der Aufbewahrung von Snapshots mit einem Tabellenoptimierer.
  + `orphan_file_deletion`: zum Verwalten des Löschens verwaister Dateien mit einem Tabellenoptimierer.
+ `configuration` – Ein [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)-Objekt.

  Ein `TableOptimizerConfiguration`-Objekt, das beim Erstellen oder Aktualisieren eines Tabellenoptimierers angegeben wurde.
+ `lastRun` – Ein [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun)-Objekt.

  Ein `TableOptimizerRun`-Objekt, das den letzten Lauf des Tabellenoptimierers darstellt.
+ `configurationSource` – UTF-8-Zeichenfolge (zulässige Werte: `catalog="CATALOG"` \$1 `table="TABLE"`).

   Gibt die Quelle der Optimiererkonfiguration an. Hier wird angegeben, wie der Tabellenoptimierer konfiguriert wurde und welche Entität oder welcher Dienst die Konfiguration initiiert hat. 

## TableOptimizerConfiguration Struktur
<a name="aws-glue-api-table-optimizers-TableOptimizerConfiguration"></a>

Enthält Details zur Konfiguration eines Tabellenoptimierers. Sie übergeben diese Konfiguration, wenn Sie einen Tabellenoptimierer erstellen oder aktualisieren.

**Felder**
+ `roleArn` – UTF-8-Zeichenfolge, nicht weniger als 20 oder mehr als 2 048 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Eine vom Aufrufer übergebene Rolle, die dem Service die Erlaubnis erteilt, die mit dem Optimierer verknüpften Ressourcen im Namen des Aufrufers zu aktualisieren.
+ `enabled` – Boolesch.

  Ob die Tabellenoptimierung aktiviert ist.
+ `vpcConfiguration` – Ein [TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)-Objekt.

  Ein `TableOptimizerVpcConfiguration`-Objekt, das die VPC-Konfiguration eines Tabellenoptimierers darstellt.

  Diese Konfiguration ist erforderlich, um Tabellen zu optimieren, die sich in einer Kunden-VPC befinden.
+ `compactionConfiguration` – Ein [CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration)-Objekt.

  Die Konfiguration für einen Verdichtungsoptimierer. Diese Konfiguration definiert, wie Datendateien in Ihrer Tabelle verdichtet werden, um die Abfrageleistung zu verbessern und die Speicherkosten zu reduzieren.
+ `retentionConfiguration` – Ein [RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration)-Objekt.

  Die Konfiguration für einen Snapshot-Aufbewahrungsoptimierer.
+ `orphanFileDeletionConfiguration` – Ein [OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)-Objekt.

  Die Konfiguration für einen Optimierer für das Löschen verwaister Dateien.

## TableOptimizerVpcConfiguration Struktur
<a name="aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration"></a>

Ein Objekt, das die VPC-Konfiguration für einen Tabellenoptimierer beschreibt.

Diese Konfiguration ist erforderlich, um Tabellen zu optimieren, die sich in einer Kunden-VPC befinden.

**Felder**
+ `glueConnectionName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der AWS Glue Verbindung, die für die VPC für den Tabellenoptimierer verwendet wird.

## CompactionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-CompactionConfiguration"></a>

Die Konfiguration für einen Verdichtungsoptimierer. Diese Konfiguration definiert, wie Datendateien in Ihrer Tabelle verdichtet werden, um die Abfrageleistung zu verbessern und die Speicherkosten zu reduzieren.

**Felder**
+ `icebergConfiguration` – Ein [IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)-Objekt.

  Die Konfiguration für einen Iceberg-Verdichtungsoptimierer.

## IcebergCompactionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-IcebergCompactionConfiguration"></a>

Die Konfiguration für einen Iceberg-Verdichtungsoptimierer. Diese Konfiguration definiert Parameter zur Optimierung des Layouts von Datendateien in Iceberg-Tabellen.

**Felder**
+ `strategy` – UTF-8-Zeichenfolge (zulässige Werte: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  Die für die Verdichtung zu verwendende Strategie. Folgende sind gültige Werte:
  +  `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. Diese Verdichtungsstrategie wird für die meisten Anwendungsfälle empfohlen. 
  +  `sort`: Organisiert Daten auf der Grundlage bestimmter Spalten, die bei der Verdichtung hierarchisch 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. Um diese Strategie zu verwenden, müssen Sie zunächst mithilfe der `sort_order`-Tabelleneigenschaft eine Sortierreihenfolge in Ihren Iceberg-Tabelleneigenschaften definieren.
  +  `z-order`: 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. Um diese Strategie zu verwenden, müssen Sie zunächst mithilfe der `sort_order`-Tabelleneigenschaft eine Sortierreihenfolge in Ihren Iceberg-Tabelleneigenschaften definieren. 

  Erfolgt keine Eingabe, wird der Standardwert „binpack“ verwendet.
+ `minInputFiles` – Zahl (Ganzzahl).

  Die Mindestanzahl der Datendateien, die vor der Verdichtung in einer Partition vorhanden sein müssen, um Dateien tatsächlich zu verdichten. Dieser Parameter hilft bei der Steuerung, wann die Verdichtung ausgelöst wird, und verhindert so unnötige Verdichtungsvorgänge auf Partitionen mit wenigen Dateien. Erfolgt keine Eingabe, wird der Standardwert 100 verwendet.
+ `deleteFileThreshold` – Zahl (Ganzzahl).

  Die Mindestanzahl an Löschungen, die in einer Datendatei vorhanden sein müssen, damit sie verdichtet werden kann. Dieser Parameter trägt zur Optimierung der Verdichtung bei, indem er sich auf die Dateien konzentriert, die eine erhebliche Anzahl von Löschvorgängen enthalten. Dadurch kann die Abfrageleistung verbessert werden, indem gelöschte Datensätze entfernt werden. Erfolgt keine Eingabe, wird der Standardwert 1 verwendet.

## TableOptimizerRun Struktur
<a name="aws-glue-api-table-optimizers-TableOptimizerRun"></a>

Enthält Details zur Ausführung eines Tabellenoptimierers.

**Felder**
+ `eventType` – UTF-8-Zeichenfolge (zulässige Werte: `starting="STARTING"` \$1 `completed="COMPLETED"` \$1 `failed="FAILED"` \$1 `in_progress="IN_PROGRESS"`).

  Ein Ereignistyp, der den Status der Ausführung des Tabellenoptimierers darstellt.
+ `startTimestamp` – Zeitstempel.

  Stellt den Epoch-Zeitstempel für den Beginn des Verdichtungsauftrags in Lake Formation dar.
+ `endTimestamp` – Zeitstempel.

  Stellt den Epoch-Zeitstempel für das Ende des Verdichtungsauftrags dar.
+ `metrics` – Ein [RunMetrics](#aws-glue-api-table-optimizers-RunMetrics)-Objekt.

  Ein `RunMetrics`-Objekt, das Metriken für die Optimiererausführung enthält.

  Dieses Mitglied ist als veraltet gekennzeichnet. Sehen Sie sich die einzelnen Metrikelemente für die Komprimierung, Aufbewahrung und Löschung verwaister Dateien an.
+ `error` – UTF-8-Zeichenfolge.

  Ein Fehler, der während Optimiererausführung aufgetreten ist.
+ `compactionMetrics` – Ein [CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics)-Objekt.

  Ein `CompactionMetrics`-Objekt, das Metriken für die Optimiererausführung enthält.
+ `compactionStrategy` – UTF-8-Zeichenfolge (zulässige Werte: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  Die für die Verdichtungsausführung verwendete Strategie. Hiermit wird angegeben, welcher Algorithmus angewendet wurde, um zu bestimmen, wie Dateien während des Verdichtungsvorgangs ausgewählt und kombiniert wurden. Folgende sind gültige Werte:
  +  `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. Diese Verdichtungsstrategie wird für die meisten Anwendungsfälle empfohlen. 
  +  `sort`: Organisiert Daten auf der Grundlage bestimmter Spalten, die bei der Verdichtung hierarchisch 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. Um diese Strategie zu verwenden, müssen Sie zunächst mithilfe der `sort_order`-Tabelleneigenschaft eine Sortierreihenfolge in Ihren Iceberg-Tabelleneigenschaften definieren.
  +  `z-order`: 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. Um diese Strategie zu verwenden, müssen Sie zunächst mithilfe der `sort_order`-Tabelleneigenschaft eine Sortierreihenfolge in Ihren Iceberg-Tabelleneigenschaften definieren. 
+ `retentionMetrics` – Ein [RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics)-Objekt.

  Ein `RetentionMetrics`-Objekt, das Metriken für die Optimiererausführung enthält.
+ `orphanFileDeletionMetrics` – Ein [OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)-Objekt.

  Ein `OrphanFileDeletionMetrics`-Objekt, das Metriken für die Optimiererausführung enthält.

## BatchGetTableOptimizerEntry Struktur
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry"></a>

Stellt einen Tabellenoptimierer dar, der während der `BatchGetTableOptimizer`-Operation abgerufen werden soll.

**Felder**
+ `catalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `databaseName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `tableName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Tabelle.
+ `type` – UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.

## BatchTableOptimizer Struktur
<a name="aws-glue-api-table-optimizers-BatchTableOptimizer"></a>

Enthält Details für einen der Tabellenoptimierer, die von der `BatchGetTableOptimizer`-Operation zurückgegeben wurden.

**Felder**
+ `catalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `databaseName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `tableName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Tabelle.
+ `tableOptimizer` – Ein [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer)-Objekt.

  Ein `TableOptimizer`-Objekt, das Details zur Konfiguration und zur letzten Ausführung eines Tabellenoptimierers enthält.

## BatchGetTableOptimizerError Struktur
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerError"></a>

Enthält Details zu einem der Fehler in der von der `BatchGetTableOptimizer`-Operation zurückgegebenen Fehlerliste.

**Felder**
+ `error` – Ein [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)-Objekt.

  Ein `ErrorDetail`-Objekt, das Code- und Meldungsdetails zu dem Fehler enthält.
+ `catalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `databaseName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `tableName` – UTF-8-Zeichenfolge, mindestens 1 Byte lang.

  Der Name der Tabelle.
+ `type` – UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.

## RetentionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-RetentionConfiguration"></a>

Die Konfiguration für einen Snapshot-Aufbewahrungsoptimierer.

**Felder**
+ `icebergConfiguration` – Ein [IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)-Objekt.

  Die Konfiguration für einen Iceberg-Snapshot-Aufbewahrungsoptimierer.

## IcebergRetentionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-IcebergRetentionConfiguration"></a>

Die Konfiguration für einen Iceberg-Snapshot-Aufbewahrungsoptimierer.

**Felder**
+ `snapshotRetentionPeriodInDays` – Zahl (Ganzzahl).

  Die Anzahl der Tage für die Aufbewahrung der Iceberg-Snapshots. Erfolgt keine Eingabe, wird das entsprechende Iceberg-Tabellenkonfigurationsfeld verwendet. Falls es nicht vorhanden ist, wird der Standardwert 5 verwendet.
+ `numberOfSnapshotsToRetain` – Zahl (Ganzzahl).

  Die Anzahl der Iceberg-Snapshots, die innerhalb des Aufbewahrungszeitraums aufbewahrt werden sollen. Erfolgt keine Eingabe, wird das entsprechende Iceberg-Tabellenkonfigurationsfeld verwendet. Falls es nicht vorhanden ist, wird der Standardwert 1 verwendet.
+ `cleanExpiredFiles` – Boolesch.

  Wenn dieser Wert auf „false“ gesetzt ist, werden Snapshots nur aus den Tabellenmetadaten gelöscht, und die zugrunde liegenden Daten und Metadatendateien werden nicht gelöscht.
+ `runRateInHours` – Zahl (Ganzzahl).

  Das Intervall in Stunden zwischen den Ausführungen des Aufbewahrungsauftrags. Dieser Parameter steuert, wie oft der Aufbewahrungsoptimierer ausgeführt wird, um abgelaufene Snapshots zu bereinigen. Der Wert muss zwischen 3 und 168 Stunden (7 Tagen) liegen. Erfolgt keine Eingabe, wird der Standardwert 24 verwendet.

## OrphanFileDeletionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration"></a>

Die Konfiguration für einen Optimierer für das Löschen verwaister Dateien.

**Felder**
+ `icebergConfiguration` – Ein [IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)-Objekt.

  Die Konfiguration für einen Iceberg-Optimierer für das Löschen verwaister Dateien.

## IcebergOrphanFileDeletionConfiguration Struktur
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration"></a>

Die Konfiguration für einen Iceberg-Optimierer für das Löschen verwaister Dateien.

**Felder**
+ `orphanFileRetentionPeriodInDays` – Zahl (Ganzzahl).

  Die Anzahl der Tage, für die verwaiste Dateien aufbewahrt werden sollen, bevor sie gelöscht werden. Erfolgt keine Eingabe, wird der Standardwert 3 verwendet.
+ `location` – UTF-8-Zeichenfolge.

  Gibt das Verzeichnis an, in dem nach Dateien gesucht werden soll (standardmäßig der Speicherort der Tabelle). Sie können ein Unterverzeichnis statt des Speicherorts der Tabelle auf oberster Ebene auswählen.
+ `runRateInHours` – Zahl (Ganzzahl).

  Das Intervall in Stunden zwischen der Ausführung eines Auftrags zum Löschen von verwaisten Dateien. Dieser Parameter steuert, wie oft der Optimierer für das Löschen verwaister Dateien ausgeführt wird, um verwaiste Dateien zu bereinigen. Der Wert muss zwischen 3 und 168 Stunden (7 Tagen) liegen. Erfolgt keine Eingabe, wird der Standardwert 24 verwendet.

## CompactionMetrics Struktur
<a name="aws-glue-api-table-optimizers-CompactionMetrics"></a>

Eine Struktur, die Verdichtungsmetriken für die Optimiererausführung enthält.

**Felder**
+ `IcebergMetrics` – Ein [IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics)-Objekt.

  Eine Struktur, die Iceberg-Verdichtungsmetriken für die Optimiererausführung enthält.

## RetentionMetrics Struktur
<a name="aws-glue-api-table-optimizers-RetentionMetrics"></a>

Eine Struktur, die Aufbewahrungsmetriken für die Optimiererausführung enthält.

**Felder**
+ `IcebergMetrics` – Ein [IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics)-Objekt.

  Eine Struktur, die Iceberg-Aufbewahrungsmetriken für die Optimiererausführung enthält.

## OrphanFileDeletionMetrics Struktur
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionMetrics"></a>

Eine Struktur, die Metriken für das Löschen verwaister Dateien für die Optimiererausführung enthält.

**Felder**
+ `IcebergMetrics` – Ein [IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)-Objekt.

  Eine Struktur, die Iceberg-Metriken für das Löschen verwaister Dateien für die Optimiererausführung enthält.

## IcebergCompactionMetrics Struktur
<a name="aws-glue-api-table-optimizers-IcebergCompactionMetrics"></a>

Iceberg-Verdichtungsmetriken für die Optimiererausführung.

**Felder**
+ `DpuHours` – Nummer (doppelt).

  Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
+ `NumberOfDpus` – Zahl (Ganzzahl).

  Die Anzahl der durch den Auftrag DPUs verbrauchten Daten, aufgerundet auf die nächste ganze Zahl.
+ `JobDurationInHour` – Nummer (doppelt).

  Die Dauer des Auftrags in Stunden.

## IcebergRetentionMetrics Struktur
<a name="aws-glue-api-table-optimizers-IcebergRetentionMetrics"></a>

Snapshot-Aufbewahrungsmetriken für Iceberg für die Optimiererausführung.

**Felder**
+ `DpuHours` – Nummer (doppelt).

  Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
+ `NumberOfDpus` – Zahl (Ganzzahl).

  Die Anzahl der durch den Auftrag DPUs verbrauchten Daten, aufgerundet auf die nächste ganze Zahl.
+ `JobDurationInHour` – Nummer (doppelt).

  Die Dauer des Auftrags in Stunden.

## IcebergOrphanFileDeletionMetrics Struktur
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics"></a>

Metriken für das Löschen verwaister Dateien für Iceberg für die Optimiererausführung.

**Felder**
+ `DpuHours` – Nummer (doppelt).

  Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
+ `NumberOfDpus` – Zahl (Ganzzahl).

  Die Anzahl der durch den Auftrag DPUs verbrauchten Daten, aufgerundet auf die nächste ganze Zahl.
+ `JobDurationInHour` – Nummer (doppelt).

  Die Dauer des Auftrags in Stunden.

## RunMetrics Struktur
<a name="aws-glue-api-table-optimizers-RunMetrics"></a>

Metriken für die Optimiererausführung.

Diese Struktur ist veraltet. Sehen Sie sich die einzelnen Metrikelemente für die Komprimierung, Aufbewahrung und Löschung verwaister Dateien an.

**Felder**
+ `NumberOfBytesCompacted` – UTF-8-Zeichenfolge.

  Die Anzahl der Bytes, die durch den Verdichtungsauftrag entfernt wurden.
+ `NumberOfFilesCompacted` – UTF-8-Zeichenfolge.

  Die Anzahl der Dateien, die durch den Verdichtungsauftrag entfernt wurden.
+ `NumberOfDpus` – UTF-8-Zeichenfolge.

  Die Anzahl der durch den Auftrag DPUs verbrauchten Daten, aufgerundet auf die nächste ganze Zahl.
+ `JobDurationInHour` – UTF-8-Zeichenfolge.

  Die Dauer des Auftrags in Stunden.

## Operationen
<a name="aws-glue-api-table-optimizers-actions"></a>
+ [GetTableOptimizer Aktion (Python: get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-GetTableOptimizer)
+ [BatchGetTableOptimizer Aktion (Python: batch\$1get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-BatchGetTableOptimizer)
+ [ListTableOptimizerRuns Aktion (Python: list\$1table\$1optimizer\$1runs)](#aws-glue-api-table-optimizers-ListTableOptimizerRuns)
+ [CreateTableOptimizer Aktion (Python: create\$1table\$1optimizer)](#aws-glue-api-table-optimizers-CreateTableOptimizer)
+ [DeleteTableOptimizer Aktion (Python: delete\$1table\$1optimizer)](#aws-glue-api-table-optimizers-DeleteTableOptimizer)
+ [UpdateTableOptimizer Aktion (Python: update\$1table\$1optimizer)](#aws-glue-api-table-optimizers-UpdateTableOptimizer)

## GetTableOptimizer Aktion (Python: get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-GetTableOptimizer"></a>

Gibt die Konfiguration aller Optimierer zurück, die einer angegebenen Tabelle zugeordnet sind.

**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Tabelle.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.

**Antwort**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Der Name der Tabelle.
+ `TableOptimizer` – Ein [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer)-Objekt.

  Der Optimierer, der der angegebenen Tabelle zugeordnet ist.

**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## BatchGetTableOptimizer Aktion (Python: batch\$1get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizer"></a>

Gibt die Konfiguration für die angegebenen Tabellenoptimierer zurück.

**Anforderung**
+ `Entries` – *Erforderlich:* Ein Array mit [BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)-Objekten.

  Eine Liste von `BatchGetTableOptimizerEntry`-Objekten, die die abzurufenden Tabellenoptimierer angeben.

**Antwort**
+ `TableOptimizers` – Ein Array mit [BatchTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer)-Objekten.

  Eine Liste von `BatchTableOptimizer`-Objekten.
+ `Failures` – Ein Array mit [BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)-Objekten.

  Eine Liste der Fehler aus der Operation.

**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## ListTableOptimizerRuns Aktion (Python: list\$1table\$1optimizer\$1runs)
<a name="aws-glue-api-table-optimizers-ListTableOptimizerRuns"></a>

Listet den Verlauf früherer Optimizer-Ausführungen für eine bestimmte Tabelle auf.

**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Tabelle.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.
+ `MaxResults` – Zahl (Ganzzahl).

  Die maximale Anzahl von Optimiererausführungen die bei jedem Aufruf zurückgegeben werden.
+ `NextToken` – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.

**Antwort**
+ `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Der Name der Tabelle.
+ `NextToken` – UTF-8-Zeichenfolge.

  Ein Fortsetzungs-Token zum Paginieren der zurückgegebenen Liste mit Optimiererausführungen. Wird zurückgegeben, wenn das aktuelle Segment der Liste nicht das letzte ist.
+ `TableOptimizerRuns` – Ein Array mit [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun)-Objekten.

  Eine Liste der Optimiererausführungen, die mit einer Tabelle verknüpft sind.

**Fehler**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InvalidInputException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`

## CreateTableOptimizer Aktion (Python: create\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-CreateTableOptimizer"></a>

Erstellt einen neuen Tabellenoptimierer für eine bestimmte Funktion. 

**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Tabelle.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.
+ `TableOptimizerConfiguration` – *Erforderlich:* Ein [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)-Objekt.

  Ein `TableOptimizerConfiguration`-Objekt, das die Konfiguration eines Tabellenoptimierers darstellt.

**Antwort**
+ *Keine Antwortparameter.*

**Fehler**
+ `EntityNotFoundException`
+ `ValidationException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `ThrottlingException`

## DeleteTableOptimizer Aktion (Python: delete\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-DeleteTableOptimizer"></a>

Löscht einen Optimierer und alle zugehörigen Metadaten für eine Tabelle. Die Optimierung wird nicht mehr an der Tabelle durchgeführt.

**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Tabelle.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.

**Antwort**
+ *Keine Antwortparameter.*

**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## UpdateTableOptimizer Aktion (Python: update\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-UpdateTableOptimizer"></a>

Aktualisiert die Konfiguration für einen vorhandenen Tabellenoptimierer.

**Anforderung**
+ `CatalogId` – *Erforderlich:* Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Die Katalog-ID der Tabelle.
+ `DatabaseName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.
+ `TableName` – *Erforderlich:* UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 

  Der Name der Tabelle.
+ `Type` – *Erforderlich:* UTF-8-Zeichenfolge (zulässige Werte: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  Der Typ des Tabellenoptimierers.
+ `TableOptimizerConfiguration` – *Erforderlich:* Ein [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)-Objekt.

  Ein `TableOptimizerConfiguration`-Objekt, das die Konfiguration eines Tabellenoptimierers darstellt.

**Antwort**
+ *Keine Antwortparameter.*

**Fehler**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `ConcurrentModificationException`