View a markdown version of this page

구체화된 뷰 API - AWS Glue

구체화된 뷰 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)

지정된 구체화된 뷰에 대해 구체화된 뷰 새로 고침 작업 실행을 시작합니다.

요청
  • 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

    구체화된 뷰 새로 고침 작업 실행의 식별자입니다.

오류
  • AccessDeniedException

  • EntityNotFoundException

  • MaterializedViewRefreshTaskRunningException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • InvalidInputException

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 문자열입니다.

    구체화된 보기의 이름입니다.

응답
  • 무응답 파라미터.

오류
  • AccessDeniedException

  • MaterializedViewRefreshTaskNotRunningException

  • MaterializedViewRefreshTaskStoppingException

  • InvalidInputException

  • OperationTimeoutException

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 문자열입니다.

    특정 구체화된 뷰 새로 고침 작업 실행의 식별자입니다.

응답
  • MaterializedViewRefreshTaskRunMaterializedViewRefreshTaskRun 객체입니다.

    작업 실행의 세부 정보를 나타내는 MaterializedViewRefreshTaskRun 객체입니다.

오류
  • AccessDeniedException

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

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 문자열입니다.

    이것이 지속적으로 호출되면 지속적인 토큰입니다.

응답
  • MaterializedViewRefreshTaskRunsMaterializedViewRefreshTaskRun 객체의 배열입니다.

    ListMaterializedViewRefreshTaskRuns 작업의 결과입니다.

  • NextToken – UTF-8 문자열입니다.

    실행된 작업 ID가 아직 전부 반환되지 않은 경우의 지속 토큰입니다.

오류
  • AccessDeniedException

  • InvalidInputException

  • OperationTimeoutException

예외

MaterializedViewRefreshTaskRunningException 구조

작업이 이미 실행 중 상태일 때 발생하는 예외입니다.

Fields
  • Message – UTF-8 문자열입니다.

    문제를 설명하는 메시지

MaterializedViewRefreshTaskNotRunningException 구조

실행 중 상태가 아닌 작업을 중지할 때 발생하는 예외입니다.

Fields
  • Message – UTF-8 문자열입니다.

    문제를 설명하는 메시지

MaterializedViewRefreshTaskStoppingException 구조

작업이 이미 중지됨 상태일 때 발생하는 예외입니다.

Fields
  • Message – UTF-8 문자열입니다.

    문제를 설명하는 메시지