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 materialisierte Ansichten Die Materialized View-API beschreibt die AWS Glue Datentypen und Operationen zum Starten, Stoppen und Überwachen der Ausführung von Materialized View-Aktualisierungsaufgaben. ## Datentypen + [MaterializedViewRefreshTaskRun Struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun) ## MaterializedViewRefreshTaskRun Struktur Das Objekt, das die Details der Ausführung der Materialized View-Aktualisierungsaufgabe anzeigt. **Felder** + `CustomerId`— UTF-8 Zeichenfolge, nicht länger als 12 Byte. Die AWS Konto-ID. + `MaterializedViewRefreshTaskRunId`— UTF-8 Zeichenfolge, die dem entspricht[Custom string pattern #48](aws-glue-api-common.md#regex_48). Der Bezeichner der Ausführung der Materialized View-Aktualisierungsaufgabe. + `DatabaseName`— UTF-8 Zeichenfolge. Die Datenbank, in der die Tabelle gespeichert ist. + `TableName`— UTF-8 Zeichenfolge. Der Name der materialisierten Ansicht. + `CatalogId` – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die -Konto-ID verwendet. + `Role`— UTF-8 Zeichenfolge. Die IAM-Rolle, die der Service annimmt, um die Aktualisierungsaufgabe für Materialized Views auszuführen. + `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](aws-glue-api-common.md#aws-glue-api-regex-uri). Die Fehlermeldung für den Auftrag. + `DPUSeconds` – Nummer (doppelt). Die berechnete DPU-Auslastung in Sekunden für alle automatisch skalierten Worker. + `RefreshType`— UTF-8 Zeichenfolge (gültige Werte: `FULL` \|`INCREMENTAL`). Der Typ der Ausführung der Aktualisierungsaufgabe. Entweder VOLLSTÄNDIG oder INKREMENTELL. + `ProcessedBytes` – Zahl (lang). Die Anzahl der Byte, die bei der Ausführung der Aktualisierungsaufgabe gescannt wurden, um die materialisierte Ansicht zu aktualisieren. ## Operationen + [StartMaterializedViewRefreshTaskRun Aktion (Python: start\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun) + [StopMaterializedViewRefreshTaskRun Aktion (Python: stop\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun) + [GetMaterializedViewRefreshTaskRun Aktion (Python: get\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun) + [ListMaterializedViewRefreshTaskRuns Aktion (Python: list\_materialized\_view\_refresh\_task\_runs)](#aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns) ## StartMaterializedViewRefreshTaskRun Aktion (Python: start\_materialized\_view\_refresh\_task\_run) Startet eine Aufgabenausführung zur Aktualisierung einer Materialized View für eine angegebene materialisierte Ansicht. **Anforderung** + `CatalogId`— * Erforderlich: * UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die -Konto-ID verwendet. + `DatabaseName`— * Erforderlich: * UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Der Name der materialisierten Ansicht, für die die Aktualisierungsaufgabe ausgeführt werden soll. + `FullRefresh` – Boolesch. Gibt an, ob es sich um eine vollständige Aktualisierung der Aufgabenausführung handelt. **Antwort** + `MaterializedViewRefreshTaskRunId`— UTF-8 Zeichenfolge, die dem entspricht[Custom string pattern #48](aws-glue-api-common.md#regex_48). Der Bezeichner für die Ausführung der Materialized View-Aktualisierungsaufgabe. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `MaterializedViewRefreshTaskRunningException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InvalidInputException` ## StopMaterializedViewRefreshTaskRun Aktion (Python: stop\_materialized\_view\_refresh\_task\_run) Stoppt die Ausführung einer Aufgabe zur Aktualisierung einer Materialized View für eine angegebene materialisierte Ansicht. **Anforderung** + `CatalogId`— * Erforderlich: * UTF-8 Zeichenfolge mit einer Länge von mindestens 1 oder mehr als 255 Byte, die dem entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die -Konto-ID verwendet. + `DatabaseName`— * Erforderlich: * UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). 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 entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Der Name der materialisierten Ansicht. **Antwort** + *Keine Antwortparameter.* **Fehler** + `AccessDeniedException` + `MaterializedViewRefreshTaskNotRunningException` + `MaterializedViewRefreshTaskStoppingException` + `InvalidInputException` + `OperationTimeoutException` ## GetMaterializedViewRefreshTaskRun Aktion (Python: get\_materialized\_view\_refresh\_task\_run) Ruft den zugehörigen Wert für eine Aufgabenausführung ab, sofern eine Aufgabenlauf-ID angegeben ist. metadata/information **Anforderung** + `CatalogId`— * Erforderlich: * UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die -Konto-ID verwendet. + `MaterializedViewRefreshTaskRunId`— * Erforderlich: * UTF-8 Zeichenfolge, die dem entspricht[Custom string pattern #48](aws-glue-api-common.md#regex_48). Der Bezeichner für die jeweilige Ausführung der Materialized View-Aktualisierungsaufgabe. **Antwort** + `MaterializedViewRefreshTaskRun` – Ein [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun)-Objekt. Ein MaterializedViewRefreshTaskRun Objekt, das die Details der Aufgabenausführung darstellt. **Fehler** + `AccessDeniedException` + `EntityNotFoundException` + `OperationTimeoutException` + `InvalidInputException` ## ListMaterializedViewRefreshTaskRuns Aktion (Python: list\_materialized\_view\_refresh\_task\_runs) Listet alle Aufgabenausführungen für ein bestimmtes Konto auf. **Anforderung** + `CatalogId`— * Erforderlich: * UTF-8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, die dem entspricht. [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Die ID des Data Catalog, in dem sich die Tabelle befindet. Ist keine ID bereitgestellt, wird standardmäßig die -Konto-ID verwendet. + `DatabaseName`— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Die Datenbank, in der die Tabelle gespeichert ist. + `TableName`— UTF-8 Zeichenfolge, die nicht weniger als 1 oder mehr als 255 Byte lang ist und dem entspricht[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Der Name der materialisierten Ansicht. + `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** + `MaterializedViewRefreshTaskRuns` – Ein Array mit [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun)-Objekten. Die Ergebnisse der ListMaterializedViewRefreshTaskRuns Aktion. + `NextToken`— UTF-8 Zeichenfolge. Ein Fortsetzungstoken, falls noch nicht alle Aufgabenausführungs-IDs zurückgegeben wurden. **Fehler** + `AccessDeniedException` + `InvalidInputException` + `OperationTimeoutException` ## Ausnahmen + [MaterializedViewRefreshTaskRunningException Struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException) + [MaterializedViewRefreshTaskNotRunningException Struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException) + [MaterializedViewRefreshTaskStoppingException Struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException) ## MaterializedViewRefreshTaskRunningException Struktur Ausnahme, die ausgelöst wird, wenn sich eine Aufgabe bereits im laufenden Zustand befindet. **Felder** + `Message`— UTF-8 Zeichenfolge. Eine Meldung mit einer Beschreibung des Problems. ## MaterializedViewRefreshTaskNotRunningException Struktur Ausnahme, die ausgelöst wird, wenn eine Aufgabe gestoppt wird, die sich nicht im Status „Wird ausgeführt“ befindet. **Felder** + `Message`— UTF-8 Zeichenfolge. Eine Meldung mit einer Beschreibung des Problems. ## MaterializedViewRefreshTaskStoppingException Struktur Ausnahme, die ausgelöst wird, wenn sich eine Aufgabe bereits im Stoppmodus befindet. **Felder** + `Message`— UTF-8 Zeichenfolge. Eine Meldung mit einer Beschreibung des Problems.