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.

  • ComputationType – UTF-8-Zeichenfolge (zulässige Werte: FULL | INCREMENTAL).

    Der Typ der Spaltenstatistikberechnung.

  • 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.

ColumnStatisticsTaskSettings-Struktur

Die Einstellungen für eine Spaltenstatistikaufgabe.

Felder
  • DatabaseName – UTF-8-Zeichenfolge.

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

  • TableName – UTF-8-Zeichenfolge.

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

  • Schedule – Ein Plan-Objekt.

    Ein Zeitplan für die Ausführung der Spaltenstatistiken, angegeben in der CRON-Syntax.

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

    Eine Liste mit Spaltennamen, für die Statistiken ausgeführt werden sollen.

  • 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 die Datenbank gespeichert ist.

  • Role – UTF-8-Zeichenfolge.

    Die Rolle, die für die Ausführung der Spaltenstatistiken verwendet wird.

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

    Der Prozentsatz der Daten, die gesampelt werden sollen.

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

    Name der Sicherheitskonfiguration, die zum Verschlüsseln von CloudWatch-Protokollen verwendet wird.

  • ScheduleType – UTF-8-Zeichenfolge (zulässige Werte: CRON | AUTO).

    Der Typ des Zeitplans für eine Spaltenstatistikaufgabe. Die möglichen Werte sind CRON oder AUTO.

  • SettingSource – UTF-8-Zeichenfolge (zulässige Werte: CATALOG | TABLE).

    Die Quelle für die Einstellung der Spaltenstatistikaufgabe. Die möglichen Werte sind CATALOG oder TABLE.

  • LastExecutionAttempt – Ein ExecutionAttempt-Objekt.

    Der letzte ExecutionAttempt für die Ausführung der Spaltenstatistikaufgabe.

ExectionAttemping-Struktur

Ein Ausführungsversuch für die Ausführung einer Spaltenstatistikaufgabe.

Felder
  • Status – UTF-8-Zeichenfolge (zulässige Werte: FAILED | STARTED).

    Der Status der letzten Ausführung der Spaltenstatistikaufgabe.

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

    Eine Aufgabenausführungs-ID für die letzte Ausführung der Spaltenstatistikaufgabe.

  • ExecutionTimestamp – Zeitstempel.

    Ein Zeitstempel, zu dem die Spaltenstatistikaufgabe zuletzt ausgeführt wurde.

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

    Eine Fehlermeldung im Zusammenhang mit der letzten Ausführung der Spaltenstatistikaufgabe.

Operationen

Aktion StartColumnStatisticsTaskRun (Python: start_column_statistics_task_run)

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

Anforderung
  • 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.

Anforderung
  • 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.

Anforderung
  • 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.

Anforderung
  • 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.

Anforderung
  • 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

CreateColumnStatisticsTaskSettings-Aktion (Python: create_column_statistics_task_settings)

Erstellt Einstellungen für eine Spaltenstatistikaufgabe.

Anforderung
  • 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, für die Spaltenstatistiken generiert werden.

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

    Die Rolle, die für die Ausführung der Spaltenstatistiken verwendet wird.

  • Schedule – UTF-8-Zeichenfolge.

    Ein Zeitplan für die Ausführung der Spaltenstatistiken, angegeben in der CRON-Syntax.

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

    Eine Liste mit Spaltennamen, für die Statistiken ausgeführt werden sollen.

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

    Der Prozentsatz der Daten, die gesampelt werden sollen.

  • 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 die Datenbank gespeichert ist.

  • 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 verwendet wird.

  • Tags – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.

    Eine Karte mit Tags.

Antwort
  • Keine Antwortparameter.

Fehler
  • AlreadyExistsException

  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ColumnStatisticsTaskRunningException

UpdateColumnStatisticsTaskSettings-Aktion (Python: update_column_statistics_task_settings)

Aktualisiert die Einstellungen für eine Spaltenstatistikaufgabe.

Anforderung
  • 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, für die Spaltenstatistiken generiert werden.

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

    Die Rolle, die für die Ausführung der Spaltenstatistiken verwendet wird.

  • Schedule – UTF-8-Zeichenfolge.

    Ein Zeitplan für die Ausführung der Spaltenstatistiken, angegeben in der CRON-Syntax.

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

    Eine Liste mit Spaltennamen, für die Statistiken ausgeführt werden sollen.

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

    Der Prozentsatz der Daten, die gesampelt werden sollen.

  • 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 die Datenbank gespeichert ist.

  • 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 verwendet wird.

Antwort
  • Keine Antwortparameter.

Fehler
  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • VersionMismatchException

  • OperationTimeoutException

GetColumnStatisticsTaskSettings-Aktion (Python: get_column_statistics_task_settings)

Ruft Einstellungen für eine Spaltenstatistikaufgabe ab.

Anforderung
  • 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, für die Spaltenstatistiken abgerufen werden.

Antwort
  • ColumnStatisticsTaskSettings – Ein ColumnStatisticsTaskSettings-Objekt.

    Ein ColumnStatisticsTaskSettings-Objekt, das die Einstellungen für die Spaltenstatistikaufgabe darstellt.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

DeleteColumnStatisticsTaskSettings-Aktion (Python: delete_column_statistics_task_settings)

Löscht Einstellungen für eine Spaltenstatistikaufgabe.

Anforderung
  • 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, für die Spaltenstatistiken gelöscht werden.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

StartColumnStatisticsTaskRunSchedule-Aktion (Python: start_column_statistics_task_run_schedule)

Startet einen Zeitplan für die Ausführung einer Spaltenstatistikaufgabe.

Anforderung
  • 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, für die ein Zeitplan für eine Spaltenstatistikaufgabe gestartet werden soll.

Antwort
  • Keine Antwortparameter.

Fehler
  • AccessDeniedException

  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

StopColumnStatisticsTaskRunSchedule-Aktion (Python: stop_column_statistics_task_run_schedule)

Beendet einen Zeitplan für die Ausführung einer Spaltenstatistikaufgabe.

Anforderung
  • 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, für die ein Zeitplan für die Ausführung einer Spaltenstatistikaufgabe beendet werden soll.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • OperationTimeoutException

Ausnahmen

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.

ColumnStatisticsTaskAutoConcurrencyLimitException-Struktur

Eine Ausnahme, die ausgelöst wird, wenn Sie das Limit für gleichzeitige automatische Statistikaufträge bereits erreicht haben.

Felder
  • Message – UTF-8-Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.

InvalidCatalogSettingException-Struktur

Eine Ausnahme, die ausgelöst wird, wenn es ein Problem mit den Katalogeinstellungen gibt.

Felder
  • Message – UTF-8-Zeichenfolge.

    Eine Meldung mit einer Beschreibung des Problems.