View a markdown version of this page

API de vue matérialisée - AWS Glue
  —  les types de données  —MaterializedViewRefreshTaskRun  —  operations  —StartMaterializedViewRefreshTaskRun (start_materialized_view_refresh_task_run)StopMaterializedViewRefreshTaskRun (stop_materialized_view_refresh_task_run)GetMaterializedViewRefreshTaskRun (get_materialized_view_refresh_task_run)ListMaterializedViewRefreshTaskRuns (list_materialized_view_refresh_task_runs) —  exceptions  —MaterializedViewRefreshTaskRunningExceptionMaterializedViewRefreshTaskNotRunningExceptionMaterializedViewRefreshTaskStoppingException

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

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.

    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.

    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.

    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)

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.

    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.

    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.

    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.

    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.

    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.

    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.

    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.

    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.

    Identifiant de la tâche d'actualisation de la vue matérialisée exécutée en particulier.

Réponse

  • MaterializedViewRefreshTaskRun – Un objet 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.

    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.

    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.

    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.

    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

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.