테이블 옵티마이저 API - AWS Glue

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

테이블 옵티마이저 API

테이블 옵티마이저는 AWS Glue API 컴팩션을 활성화하여 읽기 성능을 향상시키는 방법을 API 설명합니다.

데이터 타입

TableOptimizer 구조

테이블과 관련된 옵티마이저에 대한 세부 정보가 들어 있습니다.

필드
  • type— UTF -8 문자열 (유효한 값:compaction="COMPACTION").

    테이블 옵티마이저 유형. 현재 유일한 유효 값은 compaction입니다.

  • configurationTableOptimizerConfiguration 객체입니다.

    테이블 옵티마이저를 만들거나 업데이트할 때 지정된 TableOptimizerConfiguration 객체입니다.

  • lastRunTableOptimizerRun 객체입니다.

    테이블 옵티마이저의 마지막 실행을 나타내는 TableOptimizerRun 객체입니다.

TableOptimizerConfiguration 구조

테이블 옵티마이저의 구성에 대한 세부 정보가 들어 있습니다. 테이블 옵티마이저를 만들거나 업데이트할 때 이 구성을 전달합니다.

필드
  • roleArn— UTF -8 문자열, 길이가 1바이트 이상 또는 512바이트 이상이어야 하며 다음과 일치합니다. Single-line string pattern

    호출자가 전달하는 역할로, 호출자를 대신하여 최적기와 관련된 리소스를 업데이트할 수 있는 권한을 서비스에 부여합니다.

  • enabled – 부울입니다.

    테이블 최적화가 활성화되었는지 여부.

TableOptimizerRun 구조체

테이블 옵티마이저 실행에 대한 세부 정보가 들어 있습니다.

필드
  • eventType— UTF -8 문자열 (유효한 값: starting="STARTING" | | completed="COMPLETED" failed="FAILED" |in_progress="IN_PROGRESS").

    테이블 옵티마이저 실행 상태를 나타내는 이벤트 유형입니다.

  • startTimestamp – 타임스탬프입니다.

    Lake Formation 내에서 압축 작업이 시작된 시점의 에포크 타임스탬프를 나타냅니다.

  • endTimestamp – 타임스탬프입니다.

    컴팩션 작업이 종료된 에포크 타임스탬프를 나타냅니다.

  • metricsRunMetrics 객체입니다.

    옵티마이저 실행에 대한 메트릭이 포함된 RunMetrics 객체입니다.

  • error— UTF -8 문자열.

    옵티마이저 실행 중에 발생한 오류입니다.

BatchGetTableOptimizerEntry 구조

BatchGetTableOptimizer 작업에서 검색할 테이블 옵티마이저를 나타냅니다.

필드
  • catalogIdSingle-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • databaseName— UTF -8 문자열, 최소 1바이트 길이

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • tableName— UTF -8 문자열, 최소 1바이트 길이

    테이블의 이름

  • type— UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형.

BatchTableOptimizer 구조

BatchGetTableOptimizer 작업에서 반환된 테이블 옵티마이저 중 하나에 대한 세부 정보가 들어 있습니다.

필드
  • catalogIdSingle-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • databaseName— UTF -8 문자열, 최소 1바이트 길이

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • tableName— UTF -8 문자열, 최소 1바이트 길이

    테이블의 이름

  • tableOptimizerTableOptimizer 객체입니다.

    테이블 옵티마이저의 구성 및 마지막 실행에 대한 세부 정보가 포함된 TableOptimizer 객체입니다.

BatchGetTableOptimizerError 구조

BatchGetTableOptimizer 작업에서 반환된 오류 목록의 오류 중 하나에 대한 세부 정보가 들어 있습니다.

필드
  • errorErrorDetail 객체입니다.

    오류에 대한 코드 및 메시지 세부 정보가 포함된 ErrorDetail 객체입니다.

  • catalogIdSingle-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • databaseName— UTF -8 문자열, 최소 1바이트 길이

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • tableName— UTF -8 문자열, 최소 1바이트 길이

    테이블의 이름

  • type— UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형.

RunMetrics 구조

옵티마이저 실행에 대한 지표.

필드
  • NumberOfBytesCompacted— UTF -8 문자열.

    압축 작업 실행으로 제거된 바이트 수입니다.

  • NumberOfFilesCompacted— UTF -8 문자열.

    압축 작업 실행으로 제거된 파일 수입니다.

  • NumberOfDpus— UTF -8 문자열.

    작업에 DPU 소요된 시간.

  • JobDurationInHour— UTF -8 문자열.

    작업 기간(시간).

운영

GetTableOptimizer 액션 (파이썬: get_table_optimizer)

지정된 테이블과 관련된 모든 옵티마이저의 구성을 반환합니다.

요청
  • CatalogId – 필수: Single-line string pattern과 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName필수: UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName필수: 다음과 UTF 일치하는 -8개의 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

    테이블의 이름

  • Type필수: UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형.

응답
  • CatalogIdSingle-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName— UTF -8 문자열로, 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName— UTF 일치하는 -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 합니다. Single-line string pattern

    테이블의 이름

  • TableOptimizerTableOptimizer 객체입니다.

    지정된 테이블에 연결된 옵티마이저입니다.

Errors
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

BatchGetTableOptimizer 액션 (Python: batch_get_table_optimizer)

지정된 테이블 옵티마이저의 구성을 반환합니다.

요청
  • Entries필수(Required): BatchGetTableOptimizerEntry 객체의 배열입니다.

    검색할 테이블 옵티마이저를 지정하는 BatchGetTableOptimizerEntry 객체 목록입니다.

응답
Errors
  • InternalServiceException

ListTableOptimizerRuns 액션 (Python: 목록_테이블_옵티마이저_실행)

특정 테이블에 대한 이전 옵티마이저 실행 기록을 나열합니다.

요청
  • CatalogId – 필수: Single-line string pattern과 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName필수: UTF -8 문자열로, 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName필수: 다음과 UTF 일치하는 -8개의 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

    테이블의 이름

  • Type필수: UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형. 현재 유일한 유효 값은 compaction입니다.

  • MaxResults - 숫자(정수)입니다.

    각 호출에서 반환되는 옵티마이저 실행의 최대 수입니다.

  • NextToken— UTF -8 문자열.

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

응답
  • CatalogIdSingle-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName— UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName— UTF 일치하는 -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 합니다. Single-line string pattern

    테이블의 이름

  • NextToken— -8 문자열UTF.

    목록의 현재 세그먼트가 마지막이 아니면 반환된 옵티마이저 실행 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.

  • TableOptimizerRunsTableOptimizerRun 객체의 배열입니다.

    테이블에 연결된 옵티마이저 실행 목록입니다.

Errors
  • EntityNotFoundException

  • AccessDeniedException

  • InvalidInputException

  • InternalServiceException

CreateTableOptimizer 액션 (Python: 생성_테이블_옵티마이저)

특정 함수를 위한 새 테이블 옵티마이저를 만듭니다. compaction은 현재 지원되는 유일한 옵티마이저 유형입니다.

요청
  • CatalogId – 필수: Single-line string pattern과 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName필수: UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName필수: 다음과 UTF 일치하는 -8개의 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

    테이블의 이름

  • Type필수: UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형. 현재 유일한 유효 값은 compaction입니다.

  • TableOptimizerConfiguration필수(Required): TableOptimizerConfiguration 객체입니다.

    테이블 옵티마이저의 구성을 나타내는 TableOptimizerConfiguration 객체입니다.

응답
  • 무응답 파라미터.

Errors
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • AlreadyExistsException

  • InternalServiceException

DeleteTableOptimizer 액션 (Python: 삭제_테이블_옵티마이저)

테이블의 옵티마이저 및 모든 관련 메타데이터를 삭제합니다. 최적화는 더 이상 테이블에서 수행되지 않습니다.

요청
  • CatalogId – 필수: Single-line string pattern과 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName필수: UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName필수: 다음과 UTF 일치하는 -8개의 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

    테이블의 이름

  • Type필수: UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형.

응답
  • 무응답 파라미터.

Errors
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException

UpdateTableOptimizer 액션 (Python: 업데이트_테이블_옵티마이저)

기존 테이블 옵티마이저의 구성을 업데이트합니다.

요청
  • CatalogId – 필수: Single-line string pattern과 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.

    테이블의 카탈로그 ID.

  • DatabaseName필수: UTF -8 문자열, 길이가 1바이트 이상 또는 255바이트 이상이어야 하며 다음과 일치해야 합니다. Single-line string pattern

    테이블이 있는 카탈로그의 데이터베이스 이름입니다.

  • TableName필수: 다음과 UTF 일치하는 -8개의 문자열, 1바이트 이상 또는 255바이트 이상 Single-line string pattern

    테이블의 이름

  • Type필수: UTF -8 문자열 (유효한 값:). compaction="COMPACTION"

    테이블 옵티마이저 유형. 현재 유일한 유효 값은 compaction입니다.

  • TableOptimizerConfiguration필수(Required): TableOptimizerConfiguration 객체입니다.

    테이블 옵티마이저의 구성을 나타내는 TableOptimizerConfiguration 객체입니다.

응답
  • 무응답 파라미터.

Errors
  • EntityNotFoundException

  • InvalidInputException

  • AccessDeniedException

  • InternalServiceException