구체화된 뷰 API
구체화된 뷰 API는 구체화된 뷰 새로 고침 작업 실행을 시작, 중지, 모니터링하기 위한 AWS Glue 데이터 유형 및 작업을 설명합니다.
데이터 타입
MaterializedViewRefreshTaskRun 구조
구체화된 뷰 새로 고침 작업 실행의 세부 정보를 보여주는 객체입니다.
Fields
-
CustomerId– UTF-8 문자열입니다(12바이트 이하).AWS 계정 ID입니다.
-
MaterializedViewRefreshTaskRunId– 과(와) 일치하는 UTF-8 문자열입니다..Custom string pattern #48구체화된 뷰 새로 고침 작업 실행의 식별자입니다.
-
DatabaseName– UTF-8 문자열입니다.테이블이 상주하는 데이터베이스.
-
TableName– UTF-8 문자열입니다.구체화된 보기의 이름입니다.
-
CatalogId– 과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다..Single-line string pattern테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
-
Role– UTF-8 문자열입니다.구체화된 뷰 새로 고침 작업을 실행하기 위해 서비스가 수임하는 IAM 역할입니다.
-
Status– UTF-8 문자열입니다(유효한 값:STARTING|RUNNING|SUCCEEDED|FAILED|STOPPED).실행된 작업의 상태입니다.
-
CreationTime– 타임스탬프입니다.이 작업이 생성된 시각입니다.
-
LastUpdated– 타임스탬프입니다.이 작업이 마지막으로 수정된 시점.
-
StartTime– 타임스탬프입니다.이벤트의 시작 시각.
-
EndTime– 타임스탬프입니다.작업의 종료 시각.
-
ErrorMessage– 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..URI address multi-line string pattern작업에 대한 오류 메시지입니다.
-
DPUSeconds- 숫자(double)입니다.자동 크기 조정된 모든 작업자의 계산된 DPU 사용량(초 단위).
-
RefreshType– UTF-8 문자열입니다(유효한 값:FULL|INCREMENTAL).새로 고침 작업 실행의 유형입니다. FULL 또는 INCREMENTAL입니다.
-
ProcessedBytes- 숫자(정수)입니다.새로 고침 작업 실행이 구체화된 뷰를 새로 고치기 위해 스캔한 바이트 수입니다.
작업
StartMaterializedViewRefreshTaskRun 작업(Python: start_materialized_view_refresh_task_run)
StopMaterializedViewRefreshTaskRun 작업(Python: stop_materialized_view_refresh_task_run)
GetMaterializedViewRefreshTaskRun 작업(Python: get_materialized_view_refresh_task_run)
ListMaterializedViewRefreshTaskRuns 작업(Python: list_materialized_view_refresh_task_runs)
StartMaterializedViewRefreshTaskRun 작업(Python: start_materialized_view_refresh_task_run)
지정된 구체화된 뷰에 대해 구체화된 뷰 새로 고침 작업 실행을 시작합니다.
요청
-
CatalogId– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
-
DatabaseName– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 있는 데이터베이스의 이름입니다.
-
TableName– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.새로 고침 작업이 실행될 구체화된 뷰의 이름입니다.
-
FullRefresh– 부울입니다.작업 실행의 전체 새로 고침인지 여부를 지정합니다.
응답
-
MaterializedViewRefreshTaskRunId– 과(와) 일치하는 UTF-8 문자열입니다..Custom string pattern #48구체화된 뷰 새로 고침 작업 실행의 식별자입니다.
오류
AccessDeniedExceptionEntityNotFoundExceptionMaterializedViewRefreshTaskRunningExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionInvalidInputException
StopMaterializedViewRefreshTaskRun 작업(Python: stop_materialized_view_refresh_task_run)
지정된 구체화된 뷰에 대한 구체화된 뷰 새로 고침 작업 실행을 중지합니다.
요청
-
CatalogId– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
-
DatabaseName– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 있는 데이터베이스의 이름입니다.
-
TableName– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.구체화된 보기의 이름입니다.
응답
무응답 파라미터.
오류
AccessDeniedExceptionMaterializedViewRefreshTaskNotRunningExceptionMaterializedViewRefreshTaskStoppingExceptionInvalidInputExceptionOperationTimeoutException
GetMaterializedViewRefreshTaskRun 작업(Python: get_materialized_view_refresh_task_run)
작업 실행 ID가 주어지면 작업 실행과 관련된 메타데이터/정보를 가져옵니다.
요청
-
CatalogId– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
-
MaterializedViewRefreshTaskRunId– 필수: Custom string pattern #48과(와) 일치하는 UTF-8 문자열입니다.특정 구체화된 뷰 새로 고침 작업 실행의 식별자입니다.
응답
-
MaterializedViewRefreshTaskRun– MaterializedViewRefreshTaskRun 객체입니다.작업 실행의 세부 정보를 나타내는 MaterializedViewRefreshTaskRun 객체입니다.
오류
AccessDeniedExceptionEntityNotFoundExceptionOperationTimeoutExceptionInvalidInputException
ListMaterializedViewRefreshTaskRuns 작업(Python: list_materialized_view_refresh_task_runs)
특정 계정에 대해 실행된 모든 작업을 나열합니다.
요청
-
CatalogId– 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
-
DatabaseName– 과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다..Single-line string pattern테이블이 상주하는 데이터베이스.
-
TableName– 과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다..Single-line string pattern구체화된 보기의 이름입니다.
-
MaxResults– 1~1,000의 숫자(정수)입니다.응답의 최대 크기입니다.
-
NextToken– UTF-8 문자열입니다.이것이 지속적으로 호출되면 지속적인 토큰입니다.
응답
-
MaterializedViewRefreshTaskRuns– MaterializedViewRefreshTaskRun 객체의 배열입니다.ListMaterializedViewRefreshTaskRuns 작업의 결과입니다.
-
NextToken– UTF-8 문자열입니다.실행된 작업 ID가 아직 전부 반환되지 않은 경우의 지속 토큰입니다.
오류
AccessDeniedExceptionInvalidInputExceptionOperationTimeoutException
예외
MaterializedViewRefreshTaskRunningException 구조
작업이 이미 실행 중 상태일 때 발생하는 예외입니다.
Fields
-
Message– UTF-8 문자열입니다.문제를 설명하는 메시지
MaterializedViewRefreshTaskNotRunningException 구조
실행 중 상태가 아닌 작업을 중지할 때 발생하는 예외입니다.
Fields
-
Message– UTF-8 문자열입니다.문제를 설명하는 메시지
MaterializedViewRefreshTaskStoppingException 구조
작업이 이미 중지됨 상태일 때 발생하는 예외입니다.
Fields
-
Message– UTF-8 문자열입니다.문제를 설명하는 메시지