API de vista materializada
La API de vista materializada describe los tipos de datos y las operaciones de AWS Glue para iniciar, detener y supervisar las ejecuciones de las tareas de actualización de vista materializada.
Tipos de datos
Estructura de MaterializedViewRefreshTaskRun
Objeto que muestra los detalles de la ejecución de la tarea de actualización de la vista materializada.
Campos
-
CustomerId: cadena UTF-8, no más de 12 bytes de largo.El ID de la cuenta de AWS.
-
MaterializedViewRefreshTaskRunId– cadena UTF-8 que coincide con el Custom string pattern #48.Identificador de la ejecución de la tarea de actualización de la vista materializada.
-
DatabaseName: cadena UTF-8.La base de datos en la que se encuentra la tabla.
-
TableName: cadena UTF-8.El nombre de la vista materializada.
-
CatalogId– cadena de ID de catálogo, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El ID del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, el ID de cuenta de se usará de forma predeterminada.
-
Role: cadena UTF-8.Rol de IAM que asume el servicio para ejecutar la tarea de actualización de la vista materializada.
-
Status– cadena UTF-8 (valores válidos:STARTING|RUNNING|SUCCEEDED|FAILED|STOPPED).El estado de la ejecución de la tarea.
-
CreationTime: marca temporal.La hora en que se creó esta tarea.
-
LastUpdated: marca temporal.El último punto temporal en que se modificó esta tarea.
-
StartTime: marca temporal.La hora de inicio de la tarea.
-
EndTime: marca temporal.La hora de finalización de la tarea.
-
ErrorMessage– cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.El mensaje de error del trabajo.
-
DPUSeconds: número (doble).El uso de la DPU calculado en segundos para todos los trabajadores con escalado automático.
-
RefreshType– cadena UTF-8 (valores válidos:FULL|INCREMENTAL).Tipo de ejecución de la tarea de actualización. Puede ser FULL o INCREMENTAL.
-
ProcessedBytes: número (largo).Cantidad de bytes que ha escaneado la ejecución de la tarea de actualización para actualizar la vista materializada.
Operaciones
Acción StartMaterializedViewRefreshTaskRun (Python: start_materialized_view_refresh_task_run)
Acción StopMaterializedViewRefreshTaskRun (Python: stop_materialized_view_refresh_task_run)
Acción GetMaterializedViewRefreshTaskRun (Python: get_materialized_view_refresh_task_run)
Acción ListMaterializedViewRefreshTaskRuns (Python: list_materialized_view_refresh_task_runs)
Acción StartMaterializedViewRefreshTaskRun (Python: start_materialized_view_refresh_task_run)
Inicia una ejecución de tarea de actualización de vista materializada para una vista materializada especificada.
Solicitud
-
CatalogId: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El ID del catálogo de datos donde reside la tabla. Si no se proporciona ninguno, el ID de cuenta de se usará de forma predeterminada.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre de la base de datos donde reside la tabla.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.Nombre de la vista materializada para la que se ejecutará la tarea de actualización.
-
FullRefresh: booleano.Especifica si se trata de una actualización completa de la ejecución de la tarea.
Respuesta
-
MaterializedViewRefreshTaskRunId– cadena UTF-8 que coincide con el Custom string pattern #48.Identificador de la ejecución de la tarea de actualización de la vista materializada.
Errores
AccessDeniedExceptionEntityNotFoundExceptionMaterializedViewRefreshTaskRunningExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionInvalidInputException
Acción StopMaterializedViewRefreshTaskRun (Python: stop_materialized_view_refresh_task_run)
Detiene una ejecución de tarea de actualización de vista materializada para una vista materializada especificada.
Solicitud
-
CatalogId: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El ID del catálogo de datos donde reside la tabla. Si no se proporciona ninguno, el ID de cuenta de se usará de forma predeterminada.
-
DatabaseName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre de la base de datos donde reside la tabla.
-
TableName: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre de la vista materializada.
Respuesta
Sin parámetros de respuesta.
Errores
AccessDeniedExceptionMaterializedViewRefreshTaskNotRunningExceptionMaterializedViewRefreshTaskStoppingExceptionInvalidInputExceptionOperationTimeoutException
Acción GetMaterializedViewRefreshTaskRun (Python: get_materialized_view_refresh_task_run)
Obtenga los metadatos o la información asociados a la ejecución de una tarea, con un identificador de ejecución de la tarea determinado.
Solicitud
-
CatalogId: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El ID del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, el ID de cuenta de se usará de forma predeterminada.
-
MaterializedViewRefreshTaskRunId: obligatorio: cadena UTF-8 que coincide con el Custom string pattern #48.Identificador de la ejecución de la tarea de actualización de la vista materializada específica.
Respuesta
-
MaterializedViewRefreshTaskRun: un objeto MaterializedViewRefreshTaskRun.Objeto MaterializedViewRefreshTaskRun que representa los detalles de la ejecución de la tarea.
Errores
AccessDeniedExceptionEntityNotFoundExceptionOperationTimeoutExceptionInvalidInputException
Acción ListMaterializedViewRefreshTaskRuns (Python: list_materialized_view_refresh_task_runs)
Enumera todas las ejecuciones de tareas para una cuenta en particular.
Solicitud
-
CatalogId: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El ID del Catálogo de datos donde reside la tabla. Si no se proporciona ninguno, el ID de cuenta de se usará de forma predeterminada.
-
DatabaseName– cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.La base de datos en la que se encuentra la tabla.
-
TableName– cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre de la vista materializada.
-
MaxResults: número (entero) que no es inferior a 1 ni es superior a 1000.Tamaño máximo de la respuesta.
-
NextToken: cadena UTF-8.Token de continuación si se trata de una llamada de continuidad.
Respuesta
-
MaterializedViewRefreshTaskRuns: matriz de objetos MaterializedViewRefreshTaskRun.Resultados de la acción ListMaterializedViewRefreshTaskRuns.
-
NextToken: cadena UTF-8.Un token de continuación, si todavía no se han devuelto todos los identificadores de ejecución de tareas.
Errores
AccessDeniedExceptionInvalidInputExceptionOperationTimeoutException
Excepciones
Estructura de MaterializedViewRefreshTaskRunningException
Excepción que se produce cuando una tarea ya se encuentra en estado de ejecución.
Campos
-
Message: cadena UTF-8.Mensaje que describe el problema.
Estructura de MaterializedViewRefreshTaskNotRunningException
Excepción que se produce cuando se detiene una tarea que no se encuentra en estado de ejecución.
Campos
-
Message: cadena UTF-8.Mensaje que describe el problema.
Estructura de MaterializedViewRefreshTaskStoppingException
Excepción que se produce cuando una tarea ya se encuentra en estado de detención.
Campos
-
Message: cadena UTF-8.Mensaje que describe el problema.
