Tabellenoptimierer API - AWS Glue

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

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

Datentypen

TableOptimizer Struktur

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

Felder
  • type— UTF -8 Zeichenfolge (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers. Der einzige gültige Wert ist derzeit compaction.

  • 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 1 oder mehr als 512 Byte lang, entspricht derSingle-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.

TableOptimizerRun Struktur

Enthält Details zur Ausführung eines Tabellenoptimierers.

Felder
  • eventType— UTF -8 Zeichenfolge (gültige 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.

  • error— UTF -8 Zeichenfolge.

    Ein Fehler, der während Optimiererausführung aufgetreten ist.

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 (gültige Werte:compaction="COMPACTION").

    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 (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers.

RunMetrics Struktur

Metriken für die Optimiererausführung.

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 DPU Stunden, die für den Job benötigt wurden.

  • JobDurationInHour— UTF -8 Zeichenfolge.

    Die Dauer des Auftrags in Stunden.

Operationen

GetTableOptimizer Aktion (Python: get_table_optimizer)

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

Anforderung
  • CatalogIdErforderlich: Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID der Tabelle.

  • DatabaseNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.

  • TableNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Tabelle.

  • TypeErforderlich: Zeichenfolge UTF -8 (gültige Werte:compaction="COMPACTION").

    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 Byte lang, entspricht der. 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 Byte lang, entspricht der. Single-line string pattern

    Der Name der Tabelle.

  • TableOptimizer – Ein TableOptimizer-Objekt.

    Der Optimierer, der der angegebenen Tabelle zugeordnet ist.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer Aktion (Python: batch_get_table_optimizer)

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

Anforderung
  • EntriesErforderlich: Ein Array mit BatchGetTableOptimizerEntry-Objekten.

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

Antwort
Fehler
  • InternalServiceException

ListTableOptimizerRuns Aktion (Python: list_table_optimizer_runs)

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

Anforderung
  • CatalogIdErforderlich: Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID der Tabelle.

  • DatabaseNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.

  • TableNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Tabelle.

  • TypeErforderlich: Zeichenfolge UTF -8 (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers. Der einzige gültige Wert ist derzeit compaction.

  • 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 Byte lang, entspricht der. 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 Byte lang, entspricht der. 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
  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer Aktion (Python: create_table_optimizer)

Erzeugt einen neuen Tabellenoptimierer für eine bestimmte Funktion. compaction ist der einzige derzeit unterstützte Optimierertyp.

Anforderung
  • CatalogIdErforderlich: Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID der Tabelle.

  • DatabaseNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.

  • TableNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Tabelle.

  • TypeErforderlich: Zeichenfolge UTF -8 (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers. Der einzige gültige Wert ist derzeit compaction.

  • TableOptimizerConfigurationErforderlich: Ein TableOptimizerConfiguration-Objekt.

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

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

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
  • CatalogIdErforderlich: Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID der Tabelle.

  • DatabaseNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.

  • TableNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Tabelle.

  • TypeErforderlich: Zeichenfolge UTF -8 (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer Aktion (Python: update_table_optimizer)

Aktualisiert die Konfiguration für einen vorhandenen Tabellenoptimierer.

Anforderung
  • CatalogIdErforderlich: Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID der Tabelle.

  • DatabaseNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Datenbank in dem Katalog, in dem sich die Tabelle befindet.

  • TableNameErforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der Tabelle.

  • TypeErforderlich: Zeichenfolge UTF -8 (gültige Werte:compaction="COMPACTION").

    Der Typ des Tabellenoptimierers. Der einzige gültige Wert ist derzeit compaction.

  • TableOptimizerConfigurationErforderlich: Ein TableOptimizerConfiguration-Objekt.

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

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException