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
Die Tabellenoptimierer-API beschreibt die AWS Glue API zur Aktivierung der Komprimierung zur Verbesserung der Leseleistung.
Datentypen
TableOptimizer Struktur
Enthält Details zu einem Optimierer für eine Tabelle.
Felder
-
type– UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers. Die gültigen Werte sind:
-
compaction: zur Verwaltung der Komprimierung mit einem Tabellenoptimierer. -
retention: zur Verwaltung der Aufbewahrung von Snapshots mit einem Tabellenoptimierer. -
orphan_file_deletion: zur Verwaltung des Löschens verwaister Dateien mit einem Tabellenoptimierer.
-
-
configuration– Ein TableOptimizerConfiguration-Objekt.Ein
TableOptimizerConfiguration-Objekt, das beim Erstellen oder Aktualisieren eines Tabellenoptimierers angegeben wurde. -
lastRun– Ein TableOptimizerRun-Objekt.Ein
TableOptimizerRun-Objekt, das den letzten Lauf des Tabellenoptimierers darstellt.
TableOptimizerConfiguration Struktur
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.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-Objekt.Ein
TableOptimizerVpcConfigurationObjekt, das die VPC-Konfiguration für einen Tabellenoptimierer darstellt.Diese Konfiguration ist erforderlich, um die Optimierung von Tabellen durchzuführen, die sich in einer Kunden-VPC befinden.
-
retentionConfiguration– Ein RetentionConfiguration-Objekt.Die Konfiguration für einen Snapshot-Aufbewahrungsoptimierer.
-
orphanFileDeletionConfiguration– Ein OrphanFileDeletionConfiguration-Objekt.Die Konfiguration für einen Optimizer für das Löschen verwaister Dateien.
TableOptimizerVpcConfiguration Struktur
Ein Objekt, das die VPC-Konfiguration für einen Tabellenoptimierer beschreibt.
Diese Konfiguration ist erforderlich, um die Optimierung von Tabellen durchzuführen, 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.
TableOptimizerRun Struktur
Enthält Details zur Ausführung eines Tabellenoptimierers.
Felder
-
eventType– UTF-8-Zeichenfolge (zulässige Werte:starting="STARTING"|completed="COMPLETED"|failed="FAILED"|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-Objekt.Ein
RunMetrics-Objekt, das Metriken für die Optimiererausführung enthält.Dieses Mitglied ist als veraltet gekennzeichnet. Sehen Sie sich die einzelnen Kennzahlen für Komprimierung, Aufbewahrung und Löschung verwaister Dateien an.
-
error– UTF-8-Zeichenfolge.Ein Fehler, der während Optimiererausführung aufgetreten ist.
-
compactionMetrics– Ein CompactionMetrics-Objekt.Ein
CompactionMetrics-Objekt, das Metriken für die Optimiererausführung enthält. -
retentionMetrics– Ein RetentionMetrics-Objekt.Ein
RetentionMetrics-Objekt, das Metriken für die Optimiererausführung enthält. -
orphanFileDeletionMetrics– Ein OrphanFileDeletionMetrics-Objekt.Ein
OrphanFileDeletionMetricsObjekt, das Metriken für den Optimierer-Lauf enthält.
BatchGetTableOptimizerEntry Struktur
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.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"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers.
BatchTableOptimizer Struktur
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.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-Objekt.Ein
TableOptimizer-Objekt, das Details zur Konfiguration und zur letzten Ausführung eines Tabellenoptimierers enthält.
BatchGetTableOptimizerError Struktur
Enthält Details zu einem der Fehler in der von der BatchGetTableOptimizer-Operation zurückgegebenen Fehlerliste.
Felder
-
error– Ein 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.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"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers.
RetentionConfiguration Struktur
Die Konfiguration für einen Snapshot-Aufbewahrungsoptimierer.
Felder
-
icebergConfiguration– Ein IcebergRetentionConfiguration-Objekt.Die Konfiguration für einen Iceberg-Snapshot-Aufbewahrungsoptimierer.
IcebergRetentionConfiguration Struktur
Die Konfiguration für einen Iceberg Snapshot Retention Optimizer.
Felder
-
snapshotRetentionPeriodInDays– Zahl (Ganzzahl).Die Anzahl der Tage, für die die Iceberg-Snapshots aufbewahrt werden sollen. Wenn keine Eingabe erfolgt, 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. Wenn keine Eingabe erfolgt, 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 Schnappschüsse nur aus den Tabellenmetadaten gelöscht, und die zugrunde liegenden Daten und Metadatendateien werden nicht gelöscht.
OrphanFileDeletionConfiguration Struktur
Die Konfiguration für einen Optimierer für das Löschen verwaister Dateien.
Felder
-
icebergConfiguration– Ein IcebergOrphanFileDeletionConfiguration-Objekt.Die Konfiguration für einen Iceberg-Optimierer für das Löschen verwaister Dateien.
IcebergOrphanFileDeletionConfiguration Struktur
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. Wenn keine Eingabe erfolgt, wird der Standardwert 3 verwendet.
-
location– UTF-8-Zeichenfolge.Gibt ein Verzeichnis an, in dem nach Dateien gesucht werden soll (standardmäßig der Speicherort der Tabelle). Sie können ein Unterverzeichnis anstelle des Speicherorts der Tabelle auf oberster Ebene wählen.
CompactionMetrics Struktur
Eine Struktur, die Verdichtungsmetriken für den Optimiererlauf enthält.
Felder
-
IcebergMetrics– Ein IcebergCompactionMetrics-Objekt.Eine Struktur, die die Iceberg-Verdichtungsmetriken für den Optimierer-Lauf enthält.
RetentionMetrics Struktur
Eine Struktur, die Aufbewahrungsmetriken für den Optimiererlauf enthält.
Felder
-
IcebergMetrics– Ein IcebergRetentionMetrics-Objekt.Eine Struktur, die die Iceberg-Aufbewahrungsmetriken für den Optimierer-Lauf enthält.
OrphanFileDeletionMetrics Struktur
Eine Struktur, die Metriken zum Löschen verwaister Dateien für den Optimierer-Lauf enthält.
Felder
-
IcebergMetrics– Ein IcebergOrphanFileDeletionMetrics-Objekt.Eine Struktur, die die Iceberg-Metriken zum Löschen verwaister Dateien für den Optimierer-Lauf enthält.
IcebergCompactionMetrics Struktur
Verdichtungsmetriken für Iceberg für den Optimierer-Lauf.
Felder
-
NumberOfDpus— Zahl (Ganzzahl).Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
-
JobDurationInHour– Nummer (doppelt).Die Dauer des Auftrags in Stunden.
IcebergRetentionMetrics Struktur
Kennzahlen zur Aufbewahrung von Snapshots für Iceberg für den Optimizer-Lauf.
Felder
-
NumberOfDpus— Zahl (Ganzzahl).Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
-
JobDurationInHour– Nummer (doppelt).Die Dauer des Auftrags in Stunden.
IcebergOrphanFileDeletionMetrics Struktur
Metriken zum Löschen verwaister Dateien für Iceberg für den Optimizer-Lauf.
Felder
-
NumberOfDpus— Zahl (Ganzzahl).Die Anzahl der durch den Auftrag verbrauchten DPU-Stunden.
-
JobDurationInHour– Nummer (doppelt).Die Dauer des Auftrags in Stunden.
RunMetrics Struktur
Metriken für die Optimiererausführung.
Diese Struktur ist veraltet. Sehen Sie sich die einzelnen Metrikelemente für 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 verbrauchten DPU-Stunden.
-
JobDurationInHour– UTF-8-Zeichenfolge.Die Dauer des Auftrags in Stunden.
Operationen
BatchGetTableOptimizer Aktion (Python: batch_get_table_optimizer)
ListTableOptimizerRuns Aktion (Python: list_table_optimizer_runs)
CreateTableOptimizer Aktion (Python: create_table_optimizer)
DeleteTableOptimizer Aktion (Python: delete_table_optimizer)
UpdateTableOptimizer Aktion (Python: update_table_optimizer)
GetTableOptimizer Aktion (Python: get_table_optimizer)
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.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.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.Der Name der Tabelle.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|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.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.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.Der Name der Tabelle.
-
TableOptimizer– Ein TableOptimizer-Objekt.Der Optimierer, der der angegebenen Tabelle zugeordnet ist.
Fehler
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceExceptionThrottlingException
BatchGetTableOptimizer Aktion (Python: batch_get_table_optimizer)
Gibt die Konfiguration für die angegebenen Tabellenoptimierer zurück.
Anforderung
-
Entries– Erforderlich: Ein Array mit BatchGetTableOptimizerEntry-Objekten.Eine Liste von
BatchGetTableOptimizerEntry-Objekten, die die abzurufenden Tabellenoptimierer angeben.
Antwort
-
TableOptimizers– Ein Array mit BatchTableOptimizer-Objekten.Eine Liste von
BatchTableOptimizer-Objekten. -
Failures– Ein Array mit BatchGetTableOptimizerError-Objekten.Eine Liste der Fehler aus der Operation.
Fehler
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceExceptionThrottlingException
ListTableOptimizerRuns Aktion (Python: list_table_optimizer_runs)
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.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.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.Der Name der Tabelle.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|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.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.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.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-Objekten.Eine Liste der Optimiererausführungen, die mit einer Tabelle verknüpft sind.
Fehler
EntityNotFoundExceptionAccessDeniedExceptionInvalidInputExceptionValidationExceptionInternalServiceExceptionThrottlingException
CreateTableOptimizer Aktion (Python: create_table_optimizer)
Erzeugt 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.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.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.Der Name der Tabelle.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers.
-
TableOptimizerConfiguration– Erforderlich: Ein TableOptimizerConfiguration-Objekt.Ein
TableOptimizerConfiguration-Objekt, das die Konfiguration eines Tabellenoptimierers darstellt.
Antwort
Keine Antwortparameter.
Fehler
EntityNotFoundExceptionValidationExceptionInvalidInputExceptionAccessDeniedExceptionAlreadyExistsExceptionInternalServiceExceptionThrottlingException
DeleteTableOptimizer Aktion (Python: delete_table_optimizer)
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.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.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.Der Name der Tabelle.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers.
Antwort
Keine Antwortparameter.
Fehler
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionInternalServiceExceptionThrottlingException
UpdateTableOptimizer Aktion (Python: update_table_optimizer)
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.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.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.Der Name der Tabelle.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige Werte:compaction="COMPACTION"|retention="RETENTION"|orphan_file_deletion="ORPHAN_FILE_DELETION").Der Typ des Tabellenoptimierers.
-
TableOptimizerConfiguration– Erforderlich: Ein TableOptimizerConfiguration-Objekt.Ein
TableOptimizerConfiguration-Objekt, das die Konfiguration eines Tabellenoptimierers darstellt.
Antwort
Keine Antwortparameter.
Fehler
EntityNotFoundExceptionInvalidInputExceptionAccessDeniedExceptionValidationExceptionInternalServiceExceptionThrottlingExceptionConcurrentModificationException
