# 구체화된 뷰 API
<a name="aws-glue-api-catalog-materialized-views"></a>

구체화된 뷰 API는 구체화된 뷰 새로 고침 작업 실행을 시작, 중지, 모니터링하기 위한 AWS Glue 데이터 유형 및 작업을 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-materialized-views-objects"></a>
+ [MaterializedViewRefreshTaskRun 구조](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun)

## MaterializedViewRefreshTaskRun 구조
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun"></a>

구체화된 뷰 새로 고침 작업 실행의 세부 정보를 보여주는 객체입니다.

**Fields**
+ `CustomerId` – UTF-8 문자열입니다(12바이트 이하).

  AWS 계정 ID입니다.
+ `MaterializedViewRefreshTaskRunId` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  구체화된 뷰 새로 고침 작업 실행의 식별자입니다.
+ `DatabaseName` – UTF-8 문자열입니다.

  테이블이 상주하는 데이터베이스.
+ `TableName` – UTF-8 문자열입니다.

  구체화된 보기의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  테이블이 존재하는 데이터 카탈로그의 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](aws-glue-api-common.md#aws-glue-api-regex-uri)

  작업에 대한 오류 메시지입니다.
+ `DPUSeconds` - 숫자(double)입니다.

  자동 크기 조정된 모든 작업자의 계산된 DPU 사용량(초 단위).
+ `RefreshType` – UTF-8 문자열입니다(유효한 값: `FULL` \| `INCREMENTAL`).

  새로 고침 작업 실행의 유형입니다. FULL 또는 INCREMENTAL입니다.
+ `ProcessedBytes` - 숫자(정수)입니다.

  새로 고침 작업 실행이 구체화된 뷰를 새로 고치기 위해 스캔한 바이트 수입니다.

## 작업
<a name="aws-glue-api-catalog-materialized-views-actions"></a>
+ [StartMaterializedViewRefreshTaskRun 작업(Python: start\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun)
+ [StopMaterializedViewRefreshTaskRun 작업(Python: stop\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun)
+ [GetMaterializedViewRefreshTaskRun 작업(Python: get\_materialized\_view\_refresh\_task\_run)](#aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun)
+ [ListMaterializedViewRefreshTaskRuns 작업(Python: list\_materialized\_view\_refresh\_task\_runs)](#aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns)

## StartMaterializedViewRefreshTaskRun 작업(Python: start\_materialized\_view\_refresh\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun"></a>

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

**요청**
+ `CatalogId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터베이스의 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  새로 고침 작업이 실행될 구체화된 뷰의 이름입니다.
+ `FullRefresh` – 부울입니다.

  작업 실행의 전체 새로 고침인지 여부를 지정합니다.

**응답**
+ `MaterializedViewRefreshTaskRunId` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

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

**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `MaterializedViewRefreshTaskRunningException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## StopMaterializedViewRefreshTaskRun 작업(Python: stop\_materialized\_view\_refresh\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun"></a>

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

**요청**
+ `CatalogId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터베이스의 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `AccessDeniedException`
+ `MaterializedViewRefreshTaskNotRunningException`
+ `MaterializedViewRefreshTaskStoppingException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## GetMaterializedViewRefreshTaskRun 작업(Python: get\_materialized\_view\_refresh\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun"></a>

작업 실행 ID가 주어지면 작업 실행과 관련된 메타데이터/정보를 가져옵니다.

**요청**
+ `CatalogId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
+ `MaterializedViewRefreshTaskRunId` – *필수:* [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 UTF-8 문자열입니다.

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

**응답**
+ `MaterializedViewRefreshTaskRun` – [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun) 객체입니다.

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

**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListMaterializedViewRefreshTaskRuns 작업(Python: list\_materialized\_view\_refresh\_task\_runs)
<a name="aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns"></a>

특정 계정에 대해 실행된 모든 작업을 나열합니다.

**요청**
+ `CatalogId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 계정 ID가 사용됩니다.
+ `DatabaseName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  테이블이 상주하는 데이터베이스.
+ `TableName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  구체화된 보기의 이름입니다.
+ `MaxResults` – 1\~1,000의 숫자(정수)입니다.

  응답의 최대 크기입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**응답**
+ `MaterializedViewRefreshTaskRuns` – [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun) 객체의 배열입니다.

  ListMaterializedViewRefreshTaskRuns 작업의 결과입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## 예외
<a name="aws-glue-api-catalog-materialized-views-exceptions"></a>
+ [MaterializedViewRefreshTaskRunningException 구조](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException)
+ [MaterializedViewRefreshTaskNotRunningException 구조](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException)
+ [MaterializedViewRefreshTaskStoppingException 구조](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException)

## MaterializedViewRefreshTaskRunningException 구조
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException"></a>

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

**Fields**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## MaterializedViewRefreshTaskNotRunningException 구조
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException"></a>

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

**Fields**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## MaterializedViewRefreshTaskStoppingException 구조
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException"></a>

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

**Fields**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지