# S3 Tables 유지 관리 작업 상태
<a name="s3-tables-maintenance-status"></a>

S3 Tables 유지 관리 작업은 S3 테이블 또는 테이블 버킷에 대해 주기적으로 실행됩니다. `GetTableMaintenanceJobStatus` API를 사용하여 이러한 작업의 상태를 쿼리할 수 있습니다.

**AWS CLI를 사용하여 유지 관리 작업의 상태를 확인하는 방법**  
다음 예시에서는 `GetTableMaintenanceJobStatus` API를 사용하여 유지 관리 작업의 상태를 가져옵니다.  

```
aws s3tables get-table-maintenance-job-status \
   --table-bucket-arn="arn:aws:s3tables:arn:aws::111122223333:bucket/{{amzn-s3-demo-bucket1}}" \
   --namespace="{{mynamespace}}" \
   --name="{{testtable}}"
```
자세한 내용은 *AWS CLI 명령 참조*의 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3tables/get-table-maintenance-job-status.html) 섹션을 참조하십시오.

S3 Tables 유지 관리 작업은 다음 네 가지 상태 간에 전환할 수 있습니다.
+ `Successful`
+ `Failed`
+ `Disabled`
+ `Not_Yet_Run`

실패 상태의 작업에는 실패 메시지가 포함됩니다. 다음 목록에는 나타날 수 있는 실패 메시지가 설명되어 있습니다.
+ 테이블을 읽으려고 할 때 Iceberg 검증 예외가 발생했습니다. 테이블이 읽을 수 있고 Iceberg 사양을 준수하며 S3 테이블 별칭으로 시작하는 S3 경로만 포함하는지 확인합니다.
+ Iceberg 스냅샷 관리는 현재 사용자 정의 태그 또는 참조를 지원하지 않습니다.
+ Iceberg 테이블 유지 관리 구성은 'history.expire.max-snapshot-age-ms' 및 'history.expire.min-snapshots-to-keep' 테이블 속성과 호환되지 않습니다.
+ 'gc.enabled' 테이블 속성이 false인 경우 Iceberg 스냅샷 관리 및 참조되지 않는 파일 제거가 지원되지 않습니다. 이 속성이 설정되지 않았거나 명시적으로 true로 설정되어 있는지 확인합니다.
+ 오래된 메타데이터로 인해 커밋하지 못했습니다. 유지 관리는 사용 가능한 다음 기회에 다시 시도됩니다.
+ 테이블 유지 관리를 수행할 수 있는 권한이 부족합니다. 테이블을 암호화하는 데 사용되는 키가 활성 상태이고 존재하며 S3 서비스 위탁자 `maintenance.s3tables.amazonaws.com`에게 액세스 권한을 부여하는 리소스 정책이 있는지 확인합니다.
**참고**  
 S3 Tables의 AWS KMS 권한에 대한 자세한 내용은 [S3 Tables SSE-KMS 암호화에 대한 권한 요구 사항](s3-tables-kms-permissions.md) 섹션을 참조하세요.
+ 내부 오류