기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
테이블 옵티마이저 API
테이블 옵티마이저는 AWS Glue API 컴팩션을 활성화하여 읽기 성능을 향상시키는 방법을 API 설명합니다.
데이터 타입
TableOptimizer 구조
테이블과 관련된 옵티마이저에 대한 세부 정보가 들어 있습니다.
필드
-
type
— UTF -8 문자열 (유효한 값:compaction="COMPACTION"
).테이블 옵티마이저 유형. 현재 유일한 유효 값은
compaction
입니다. -
configuration
– TableOptimizerConfiguration 객체입니다.테이블 옵티마이저를 만들거나 업데이트할 때 지정된
TableOptimizerConfiguration
객체입니다. -
lastRun
– TableOptimizerRun 객체입니다.테이블 옵티마이저의 마지막 실행을 나타내는
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
– 타임스탬프입니다.컴팩션 작업이 종료된 에포크 타임스탬프를 나타냅니다.
-
metrics
– RunMetrics 객체입니다.옵티마이저 실행에 대한 메트릭이 포함된
RunMetrics
객체입니다. -
error
— UTF -8 문자열.옵티마이저 실행 중에 발생한 오류입니다.
BatchGetTableOptimizerEntry 구조
BatchGetTableOptimizer
작업에서 검색할 테이블 옵티마이저를 나타냅니다.
필드
-
catalogId
– Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.테이블의 카탈로그 ID.
-
databaseName
— UTF -8 문자열, 최소 1바이트 길이테이블이 있는 카탈로그의 데이터베이스 이름입니다.
-
tableName
— UTF -8 문자열, 최소 1바이트 길이테이블의 이름
-
type
— UTF -8 문자열 (유효한 값:).compaction="COMPACTION"
테이블 옵티마이저 유형.
BatchTableOptimizer 구조
BatchGetTableOptimizer
작업에서 반환된 테이블 옵티마이저 중 하나에 대한 세부 정보가 들어 있습니다.
필드
-
catalogId
– Single-line string pattern과(와) 일치하는 1~255바이트 길이의 카탈로그 ID 문자열입니다.테이블의 카탈로그 ID.
-
databaseName
— UTF -8 문자열, 최소 1바이트 길이테이블이 있는 카탈로그의 데이터베이스 이름입니다.
-
tableName
— UTF -8 문자열, 최소 1바이트 길이테이블의 이름
-
tableOptimizer
– TableOptimizer 객체입니다.테이블 옵티마이저의 구성 및 마지막 실행에 대한 세부 정보가 포함된
TableOptimizer
객체입니다.
BatchGetTableOptimizerError 구조
BatchGetTableOptimizer
작업에서 반환된 오류 목록의 오류 중 하나에 대한 세부 정보가 들어 있습니다.
필드
-
error
– ErrorDetail 객체입니다.오류에 대한 코드 및 메시지 세부 정보가 포함된
ErrorDetail
객체입니다. -
catalogId
– Single-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"
테이블 옵티마이저 유형.
응답
-
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테이블의 이름
-
TableOptimizer
– TableOptimizer 객체입니다.지정된 테이블에 연결된 옵티마이저입니다.
Errors
EntityNotFoundException
InvalidInputException
AccessDeniedException
InternalServiceException
BatchGetTableOptimizer 액션 (Python: batch_get_table_optimizer)
지정된 테이블 옵티마이저의 구성을 반환합니다.
요청
-
Entries
– 필수(Required): BatchGetTableOptimizerEntry 객체의 배열입니다.검색할 테이블 옵티마이저를 지정하는
BatchGetTableOptimizerEntry
객체 목록입니다.
응답
-
TableOptimizers
– BatchTableOptimizer 객체의 배열입니다.BatchTableOptimizer
객체의 목록. -
Failures
– BatchGetTableOptimizerError 객체의 배열입니다.작업의 오류 목록.
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 문자열.이것이 지속적으로 호출되면 지속적인 토큰입니다.
응답
-
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테이블의 이름
-
NextToken
— -8 문자열UTF.목록의 현재 세그먼트가 마지막이 아니면 반환된 옵티마이저 실행 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.
-
TableOptimizerRuns
– TableOptimizerRun 객체의 배열입니다.테이블에 연결된 옵티마이저 실행 목록입니다.
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