Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # API de vue matérialisée L'API de vue matérialisée décrit les types de AWS Glue données et les opérations permettant de démarrer, d'arrêter et de surveiller les exécutions de tâches d'actualisation de la vue matérialisée. ## Types de données + [MaterializedViewRefreshTaskRun structure](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun) ## MaterializedViewRefreshTaskRun structure L'objet qui affiche les détails de la tâche d'actualisation de la vue matérialisée exécutée. **Champs** + `CustomerId`— UTF-8 chaîne ne dépassant pas 12 octets. L'identifiant AWS du compte. + `MaterializedViewRefreshTaskRunId`— UTF-8 chaîne, correspondant à[Custom string pattern #48](aws-glue-api-common.md#regex_48). Identifiant de la tâche d'actualisation de la vue matérialisée exécutée. + `DatabaseName`— UTF-8 ficelle. La base de données où réside la table. + `TableName`— UTF-8 ficelle. Nom de la vue matérialisée. + `CatalogId` – Chaîne d’ID de catalogue, d’une longueur comprise entre 1 et 255 octets, correspondant au [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte est utilisé par défaut. + `Role`— UTF-8 ficelle. Rôle IAM assumé par le service pour exécuter la tâche d'actualisation de la vue matérialisée. + `Status`— UTF-8 chaîne (valeurs valides : `STARTING` \| `RUNNING` \| `SUCCEEDED` \| `FAILED` \|`STOPPED`). L'état d'exécution de la tâche. + `CreationTime` – Horodatage. Heure à laquelle cette tâche a été créée. + `LastUpdated` – Horodatage. Dernier moment où cette tâche a été modifiée. + `StartTime` – Horodatage. L'heure de début de la tâche. + `EndTime` – Horodatage. L'heure de fin de la tâche. + `ErrorMessage` – Chaîne de description, d’une longueur maximale de 2 048 octets, correspondant au [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri). Le message d'erreur pour la tâche. + `DPUSeconds` – Nombre (double). L'utilisation de la DPU calculée en secondes pour tous les travailleurs mis à l'échelle automatique. + `RefreshType`— UTF-8 chaîne (valeurs valides : `FULL` \|`INCREMENTAL`). Type de tâche d'actualisation exécutée. Complet ou incrémentiel. + `ProcessedBytes` – Nombre (long). Le nombre d'octets que la tâche d'actualisation a analysés pour actualiser la vue matérialisée. ## Opérations + [StartMaterializedViewRefreshTaskRun action (Python : start\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun) + [StopMaterializedViewRefreshTaskRun action (Python : stop\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun) + [GetMaterializedViewRefreshTaskRun action (Python : get\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun) + [ListMaterializedViewRefreshTaskRuns action (Python : list\_materialized\_view\_refresh\_task\_runs)](#aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns) ## StartMaterializedViewRefreshTaskRun action (Python : start\_materialized\_view\_refresh\_task\_run) Lance une tâche d'actualisation de la vue matérialisée exécutée pour une vue matérialisée spécifiée. **Demande** + `CatalogId`— * Obligatoire : * UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte est utilisé par défaut. + `DatabaseName`— * Obligatoire : * UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Le nom de la base de données où réside la table. + `TableName`— * Obligatoire : * UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la vue matérialisée pour laquelle exécuter la tâche d'actualisation. + `FullRefresh` : booléen. Spécifie s'il s'agit d'une actualisation complète de la tâche exécutée. **Réponse** + `MaterializedViewRefreshTaskRunId`— UTF-8 chaîne, correspondant à[Custom string pattern #48](aws-glue-api-common.md#regex_48). Identifiant de la tâche d'actualisation de la vue matérialisée exécutée. **Erreurs** + `AccessDeniedException` + `EntityNotFoundException` + `MaterializedViewRefreshTaskRunningException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InvalidInputException` ## StopMaterializedViewRefreshTaskRun action (Python : stop\_materialized\_view\_refresh\_task\_run) Arrête une tâche d'actualisation de la vue matérialisée exécutée pour une vue matérialisée spécifiée. **Demande** + `CatalogId`— * Obligatoire : * UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). L'ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte est utilisé par défaut. + `DatabaseName`— * Obligatoire : * UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Le nom de la base de données où réside la table. + `TableName`— * Obligatoire : * UTF-8 chaîne d'au moins 1 ou plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la vue matérialisée. **Réponse** + *Paramètres d’absence de réponse.* **Erreurs** + `AccessDeniedException` + `MaterializedViewRefreshTaskNotRunningException` + `MaterializedViewRefreshTaskStoppingException` + `InvalidInputException` + `OperationTimeoutException` ## GetMaterializedViewRefreshTaskRun action (Python : get\_materialized\_view\_refresh\_task\_run) Obtenez les informations associées à metadata/information l'exécution d'une tâche, en fonction de l'ID d'exécution de la tâche. **Demande** + `CatalogId`— * Obligatoire : * UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte est utilisé par défaut. + `MaterializedViewRefreshTaskRunId`— * Obligatoire : * UTF-8 chaîne correspondant à[Custom string pattern #48](aws-glue-api-common.md#regex_48). Identifiant de la tâche d'actualisation de la vue matérialisée exécutée en particulier. **Réponse** + `MaterializedViewRefreshTaskRun` – Un objet [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun). Un MaterializedViewRefreshTaskRun objet représentant les détails de la tâche exécutée. **Erreurs** + `AccessDeniedException` + `EntityNotFoundException` + `OperationTimeoutException` + `InvalidInputException` ## ListMaterializedViewRefreshTaskRuns action (Python : list\_materialized\_view\_refresh\_task\_runs) Répertoriez toutes les exécutions de tâches pour un compte spécifique. **Demande** + `CatalogId`— * Obligatoire : * UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). ID du catalogue de données où réside la table. Si aucun nom n'est fourni, l'ID de compte est utilisé par défaut. + `DatabaseName`— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). La base de données où réside la table. + `TableName`— UTF-8 chaîne d'une longueur d'au moins 1 ou de plus de 255 octets, correspondant à[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). Nom de la vue matérialisée. + `MaxResults` – Nombre (entier), compris entre 1 et 1 000. Taille maximale de la réponse. + `NextToken`— UTF-8 ficelle. Jeton de continuation, s’il s’agit d’un appel de continuation. **Réponse** + `MaterializedViewRefreshTaskRuns` : un tableau d’objets [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun). Les résultats de l' ListMaterializedViewRefreshTaskRuns action. + `NextToken`— UTF-8 ficelle. Un jeton de continuation, si toutes les ID d'exécution de tâches n'ont pas encore été renvoyées. **Erreurs** + `AccessDeniedException` + `InvalidInputException` + `OperationTimeoutException` ## Exceptions + [MaterializedViewRefreshTaskRunningException structure](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException) + [MaterializedViewRefreshTaskNotRunningException structure](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException) + [MaterializedViewRefreshTaskStoppingException structure](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException) ## MaterializedViewRefreshTaskRunningException structure Exception déclenchée lorsqu'une tâche est déjà en cours d'exécution. **Champs** + `Message`— UTF-8 ficelle. Un message décrivant le problème. ## MaterializedViewRefreshTaskNotRunningException structure Exception levée lors de l'arrêt d'une tâche qui n'est pas en cours d'exécution. **Champs** + `Message`— UTF-8 ficelle. Un message décrivant le problème. ## MaterializedViewRefreshTaskStoppingException structure Exception déclenchée lorsqu'une tâche est déjà en état d'arrêt. **Champs** + `Message`— UTF-8 ficelle. Un message décrivant le problème.