API für Spaltenstatistiken - 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.

API für Spaltenstatistiken

Die API für Spaltenstatistiken beschreibt AWS Glue-APIs für die Rückgabe von Statistiken zu Spalten in einer Tabelle.

Datentypen

ColumnStatisticsTaskRun-Struktur

Das Objekt, das die Details der Ausführung von Spaltenstatistiken anzeigt.

Felder
  • CustomerId – UTF-8-Zeichenfolge, nicht mehr als 12 Bytes lang.

    Die AWS-Konto-ID.

  • ColumnStatisticsTaskRunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Bezeichner für die jeweilige Ausführung der Spaltenstatistik-Aufgabe.

  • DatabaseName – UTF-8-Zeichenfolge.

    Die Datenbank, in der die Tabelle gespeichert ist.

  • TableName – UTF-8-Zeichenfolge.

    Der Name der Tabelle, für die Spaltenstatistiken generiert werden.

  • ColumnNameList – Ein UTF-8-Zeichenfolgen-Array.

    Eine Liste der Spaltennamen. Wird keiner angegeben, werden standardmäßig alle Spaltennamen für die Tabelle verwendet.

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

    Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • Role – UTF-8-Zeichenfolge.

    Die IAM-Rolle, die der Service zur Generierung von Statistiken übernimmt.

  • SampleSize – Zahl (Double), nicht mehr als 100.

    Der Prozentsatz der Zeilen, die zur Generierung von Statistiken verwendet wurden. Wird nichts angegeben, wird die gesamte Tabelle verwendet, um Statistiken zu generieren.

  • SecurityConfiguration – UTF-8-Zeichenfolge, nicht mehr als 128 Bytes lang.

    Name der Sicherheitskonfiguration, die zum Verschlüsseln von CloudWatch-Protokollen für die Ausführung der Spaltenstatistik-Aufgabe verwendet wird.

  • NumberOfWorkers – Zahl (ganze Zahl), mindestens 1.

    Die Anzahl der Worker, die zur Generierung von Spaltenstatistiken verwendet werden. Der Auftrag ist für die automatische Skalierung auf bis zu 25 Instances vorkonfiguriert.

  • WorkerType – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Art der Worker, die für die Generierung von Statistiken verwendet werden. Der Standardwert ist g.1x.

  • Status – UTF-8-Zeichenfolge (zulässige Werte: STARTING | RUNNING | SUCCEEDED | FAILED | STOPPED).

    Der Status der ausgeführten Aufgabe.

  • CreationTime – Zeitstempel.

    Die Zeit, zu der diese Aufgabe erstellt wurde.

  • LastUpdated – Zeitstempel.

    Der Zeitpunkt, an diese Aufgabe zuletzt geändert wurde.

  • StartTime – Zeitstempel.

    Die Anfangszeit der Aufgabe.

  • EndTime – Zeitstempel.

    Die Endzeit der Aufgabe.

  • ErrorMessage – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

    Die Fehlermeldung für den Auftrag.

  • DPUSeconds – Zahl (Double), nicht mehr als Keine.

    Die berechnete DPU-Auslastung in Sekunden für alle automatisch skalierten Worker.

ColumnStatisticsTaskRunningException-Struktur

Eine Ausnahme, die ausgelöst wird, wenn Sie versuchen, einen anderen Auftrag zu starten, während Sie einen Auftrag zur Generierung von Spaltenstatistiken ausführen.

Felder
  • Message – UTF-8-Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

ColumnStatisticsTaskNotRunningException-Struktur

Eine Ausnahme, die ausgelöst wird, wenn Sie versuchen, eine Aufgabenausführung zu beenden, obwohl keine Aufgabe ausgeführt wird.

Felder
  • Message – UTF-8-Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

ColumnStatisticsTaskStoppingException-Struktur

Eine Ausnahme, die ausgelöst wird, wenn Sie versuchen, eine Aufgabenausführung zu beenden.

Felder
  • Message – UTF-8-Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

Operationen

Aktion StartColumnStatisticsTaskRun (Python: start_column_statistics_task_run)

Startet eine Aufgabenausführung für Spaltenstatistiken für eine angegebene Tabelle und ihre Spalten.

Anfrage
  • DatabaseNameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

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

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

    Der Name der Tabelle zum Generieren von Statistiken.

  • ColumnNameList – Ein UTF-8-Zeichenfolgen-Array.

    Eine Liste der Spaltennamen, um Statistiken zu generieren. Wird keiner angegeben, werden standardmäßig alle Spaltennamen für die Tabelle verwendet.

  • RoleErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die IAM-Rolle, die der Service zur Generierung von Statistiken übernimmt.

  • SampleSize – Zahl (Double), nicht mehr als 100.

    Der Prozentsatz der Zeilen, die zur Generierung von Statistiken verwendet wurden. Wird nichts angegeben, wird die gesamte Tabelle verwendet, um Statistiken zu generieren.

  • CatalogID – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • SecurityConfiguration – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name der Sicherheitskonfiguration, die zum Verschlüsseln von CloudWatch-Protokollen für die Ausführung der Spaltenstatistik-Aufgabe verwendet wird.

Antwort
  • ColumnStatisticsTaskRunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Bezeichner für die Ausführung der Spaltenstatistik-Aufgabe.

Fehler
  • AccessDeniedException

  • EntityNotFoundException

  • ColumnStatisticsTaskRunningException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • InvalidInputException

GetColumnStatisticsTaskRun-Aktion (Python: get_column_statistics_task_run)

Ruft die zugehörigen Metadaten/Informationen für eine Aufgabenausführung ab, wenn eine Aufgabenausführungs-ID angegeben ist.

Anfrage
  • ColumnStatisticsTaskRunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Bezeichner für die jeweilige Ausführung der Spaltenstatistik-Aufgabe.

Antwort
  • ColumnStatisticsTaskRun – Ein ColumnStatisticsTaskRun-Objekt.

    Ein ColumnStatisticsTaskRun-Objekt, das die Details der Ausführung mit Spaltenstatistiken darstellt.

Fehler
  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

GetColumnStatisticsTaskRuns-Aktion (Python: get_column_statistics_task_runs)

Ruft Informationen zu allen Ausführungen in Verbindung mit der angegebenen Tabelle ab.

Anfrage
  • DatabaseNameErforderlich: UTF-8-Zeichenfolge.

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

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

    Der Name der Tabelle.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

    Die maximale Größe der Antwort.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.

Antwort
  • ColumnStatisticsTaskRuns – Ein Array mit ColumnStatisticsTaskRun-Objekten.

    Eine Liste der Spaltenstatistik-Aufgabenausführungen.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungstoken, falls noch nicht alle Aufgabenausführungen zurückgegeben wurden.

Fehler
  • OperationTimeoutException

ListColumnStatisticsTaskRuns-Aktion (Python: list_column_statistics_task_runs)

Listet alle Aufgabenausführungen für ein bestimmtes Konto auf.

Anfrage
  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

    Die maximale Größe der Antwort.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.

Antwort
  • ColumnStatisticsTaskRunIds – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 100 Zeichenfolgen.

    Eine Liste der IDs von Spaltenstatistik-Aufgabenausführungen.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungstoken, falls noch nicht alle Aufgabenausführungs-IDs zurückgegeben wurden.

Fehler
  • OperationTimeoutException

StopColumnStatisticsTaskRun-Aktion (Python: stop_column_statistics_task_run)

Stoppt die Ausführung einer Aufgabe für die angegebene Tabelle.

Anfrage
  • DatabaseNameErforderlich: UTF-8-Zeichenfolge.

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

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

    Der Name der Tabelle.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • ColumnStatisticsTaskNotRunningException

  • ColumnStatisticsTaskStoppingException

  • OperationTimeoutException