View a markdown version of this page

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 länger als 12 Byte.

    Die AWS Konto-ID.

  • ColumnStatisticsTaskRunId— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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— Eine Reihe von UTF-8 Zeichenketten.

    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. Wenn keine angegeben wird, 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 länger als 128 Byte.

    Name der Sicherheitskonfiguration, die zum Verschlüsseln der CloudWatch Protokolle 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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem Single-line string pattern entspricht.

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

  • ComputationType— UTF-8 Zeichenfolge (gültige Werte: FULL |INCREMENTAL).

    Der Typ der Spaltenstatistikberechnung.

  • Status— UTF-8 Zeichenfolge (gültige 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 – Nummer (doppelt).

    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— Eine Reihe von UTF-8 Zeichenketten.

    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 länger als 128 Byte.

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

  • ScheduleType— UTF-8 Zeichenfolge (gültige Werte: CRON |AUTO).

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

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

ExecutionAttempt Struktur

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

Felder
  • Status— UTF-8 Zeichenfolge (gültige Werte: FAILED |STARTED).

    Der Status der letzten Ausführung der Spaltenstatistikaufgabe.

  • ColumnStatisticsTaskRunId— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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

StartColumnStatisticsTaskRun Aktion (Python: start_column_statistics_task_run)

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

Anforderung
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-line string pattern.

    Der Name der Tabelle zum Generieren von Statistiken.

  • ColumnNameList— Eine Reihe von UTF-8 Zeichenketten.

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

  • Role Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-line string pattern.

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

Antwort
  • ColumnStatisticsTaskRunId— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem Single-line string pattern entspricht.

    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 den zugehörigen Wert metadata/information für eine Aufgabenausführung ab, sofern eine Aufgabenlauf-ID angegeben ist.

Anforderung
  • ColumnStatisticsTaskRunId Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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
  • DatabaseName— Erforderlich: Zeichenfolge. UTF-8

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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— Eine Reihe von UTF-8 Zeichenketten, nicht mehr als 100 Zeichenketten.

    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
  • DatabaseName— Erforderlich: Zeichenfolge. UTF-8

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-line string pattern.

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

  • Role Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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— Eine Reihe von UTF-8 Zeichenketten.

    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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-line string pattern.

    Die ID des Data Catalog, in dem die Datenbank gespeichert ist.

  • SecurityConfiguration— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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 Byte lang ist.

    Jeder Wert ist eine UTF-8 Zeichenfolge, die nicht länger als 256 Byte 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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-line string pattern.

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

  • Role— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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— Eine Reihe von UTF-8 Zeichenketten.

    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, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-line string pattern.

    Die ID des Data Catalog, in dem die Datenbank gespeichert ist.

  • SecurityConfiguration— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entsprichtSingle-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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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
  • DatabaseName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. Single-line string pattern

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

  • TableName Erforderlich: UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entsprichtSingle-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.