# 표 API 테이블 API는 테이블과 관련된 데이터 형식 및 작업에 대해 설명합니다. ## 데이터 타입 + [테이블 구조](#aws-glue-api-catalog-tables-Table) + [TableInput 구조](#aws-glue-api-catalog-tables-TableInput) + [FederatedTable 구조](#aws-glue-api-catalog-tables-FederatedTable) + [열 구조](#aws-glue-api-catalog-tables-Column) + [StorageDescriptor 구조](#aws-glue-api-catalog-tables-StorageDescriptor) + [SchemaReference 구조](#aws-glue-api-catalog-tables-SchemaReference) + [SerDeInfo 구조](#aws-glue-api-catalog-tables-SerDeInfo) + [Order 구조](#aws-glue-api-catalog-tables-Order) + [SkewedInfo 구조](#aws-glue-api-catalog-tables-SkewedInfo) + [TableVersion 구조](#aws-glue-api-catalog-tables-TableVersion) + [TableError 구조](#aws-glue-api-catalog-tables-TableError) + [TableVersionError 구조](#aws-glue-api-catalog-tables-TableVersionError) + [SortCriterion 구조](#aws-glue-api-catalog-tables-SortCriterion) + [TableIdentifier 구조](#aws-glue-api-catalog-tables-TableIdentifier) + [KeySchemaElement 구조](#aws-glue-api-catalog-tables-KeySchemaElement) + [PartitionIndex 구조](#aws-glue-api-catalog-tables-PartitionIndex) + [PartitionIndexDescriptor 구조](#aws-glue-api-catalog-tables-PartitionIndexDescriptor) + [BackfillError 구조](#aws-glue-api-catalog-tables-BackfillError) + [IcebergInput 구조](#aws-glue-api-catalog-tables-IcebergInput) + [OpenTableFormatInput 구조](#aws-glue-api-catalog-tables-OpenTableFormatInput) + [ViewDefinition 구조](#aws-glue-api-catalog-tables-ViewDefinition) + [ViewDefinitionInput 구조](#aws-glue-api-catalog-tables-ViewDefinitionInput) + [ViewRepresentation 구조](#aws-glue-api-catalog-tables-ViewRepresentation) + [ViewRepresentationInput 구조](#aws-glue-api-catalog-tables-ViewRepresentationInput) + [UpdateOpenTableFormatInput 구조](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput) + [UpdateIcebergInput 구조](#aws-glue-api-catalog-tables-UpdateIcebergInput) + [CreateIcebergTableInput 구조](#aws-glue-api-catalog-tables-CreateIcebergTableInput) + [UpdateIcebergTableInput 구조](#aws-glue-api-catalog-tables-UpdateIcebergTableInput) + [IcebergSortOrder 구조](#aws-glue-api-catalog-tables-IcebergSortOrder) + [IcebergSortField 구조](#aws-glue-api-catalog-tables-IcebergSortField) + [IcebergPartitionSpec 구조](#aws-glue-api-catalog-tables-IcebergPartitionSpec) + [IcebergPartitionField 구조](#aws-glue-api-catalog-tables-IcebergPartitionField) + [IcebergSchema 구조](#aws-glue-api-catalog-tables-IcebergSchema) + [IcebergStructField 구조](#aws-glue-api-catalog-tables-IcebergStructField) + [IcebergTableUpdate 구조](#aws-glue-api-catalog-tables-IcebergTableUpdate) + [AuditContext 구조](#aws-glue-api-catalog-tables-AuditContext) ## 테이블 구조 행과 열에 조직된 관련 데이터 모음을 보여줍니다. **Fields** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블 이름. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다. + `DatabaseName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블 메타데이터가 있는 데이터베이스의 이름입니다. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다. + `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 테이블에 대한 설명입니다. + `Owner` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블의 소유자입니다. + `CreateTime` – 타임스탬프입니다. 테이블 정의가 데이터 카탈로그에 생성된 시간입니다. + `UpdateTime` – 타임스탬프입니다. 테이블이 업데이트된 마지막 시간입니다. + `LastAccessTime` – 타임스탬프입니다. 테이블이 액세스된 마지막 시간입니다. 보통 HDFS에서 가져왔고 대다수는 신뢰할 만하지 않습니다. + `LastAnalyzedTime` – 타임스탬프입니다. 이 테이블에 대한 열 통계가 계산된 마지막 시간입니다. + `Retention` – None 이하의 숫자(정수)입니다. 이 테이블의 보관 기간입니다. + `StorageDescriptor` – [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor) 객체입니다. 이 테이블의 물리적 스토리지에 대한 정보를 포함하는 스토리지 서술자입니다. + `PartitionKeys` – [열](#aws-glue-api-catalog-tables-Column) 객체의 배열입니다. 테이블을 분할할 열의 목록입니다. 초기 유형만 파티션 키로써 지원됩니다. Amazon Athena에서 사용하는 테이블을 생성할 때 `partitionKeys`를 지정하지 않은 경우, 최소한 값 `partitionKeys`를 빈 목록으로 설정해야 합니다. 예: `"PartitionKeys": []` + `ViewOriginalText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다. 테이블이 `VIRTUAL_VIEW`인 경우 특정 Athena 구성이 base64로 인코딩됩니다. + `ViewExpandedText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다. + `TableType` – 255바이트 이하 길이의 UTF-8 문자열입니다. 이 테이블의 유형입니다. AWS Glue에서 `EXTERNAL_TABLE` 유형으로 테이블을 생성합니다. Athena 등의 다른 서비스에서는 추가 테이블 유형으로 테이블을 생성할 수 있습니다. AWS Glue 관련 테이블 유형: EXTERNAL\_TABLE Hive 호환 속성 - Hive 관리형이 아닌 테이블을 나타냅니다. GOVERNED AWS Lake Formation에서 사용됩니다. AWS Glue 데이터 카탈로그는 `GOVERNED`를 이해합니다. + `Parameters` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255 바이트 길이의 키 문자열입니다. 각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다. 이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다. + `CreatedBy` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블을 만든 사용자 혹은 개체. + `IsRegisteredWithLakeFormation` – 부울입니다. 테이블이 AWS Lake Formation에 등록되었는지 여부를 나타냅니다. + `TargetTable` – [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier) 객체입니다. 리소스 링크에 대한 대상 테이블을 설명하는 `TableIdentifier` 구조입니다. + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 위치한 데이터 카탈로그의 ID입니다. + `VersionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블 버전의 ID입니다. + `FederatedTable` – [FederatedTable](#aws-glue-api-catalog-tables-FederatedTable) 객체입니다. AWS Glue Data Catalog 외부의 엔터티를 참조하는 `FederatedTable` 구조입니다. + `ViewDefinition` – [ViewDefinition](#aws-glue-api-catalog-tables-ViewDefinition) 객체입니다. 뷰에 대한 하나 이상의 언어와 쿼리 등 뷰를 정의하는 모든 정보를 포함하는 구조입니다. + `IsMultiDialectView` – 부울입니다. 뷰가 여러 다양한 쿼리 엔진의 SQL 언어의 지원하며 해당 엔진에서 읽을 수 있는지 여부를 지정합니다. ## TableInput 구조 테이블을 정의하는 데 사용된 구조입니다. **Fields** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블 이름. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다. + `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 테이블에 대한 설명입니다. + `Owner` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블 소유자입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다. + `LastAccessTime` – 타임스탬프입니다. 테이블이 액세스된 마지막 시간입니다. + `LastAnalyzedTime` – 타임스탬프입니다. 이 테이블에 대한 열 통계가 계산된 마지막 시간입니다. + `Retention` – None 이하의 숫자(정수)입니다. 이 테이블의 보관 기간입니다. + `StorageDescriptor` – [StorageDescriptor](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor) 객체입니다. 이 테이블의 물리적 스토리지에 대한 정보를 포함하는 스토리지 서술자입니다. + `PartitionKeys` – [열](#aws-glue-api-catalog-tables-Column) 객체의 배열입니다. 테이블을 분할할 열의 목록입니다. 초기 유형만 파티션 키로써 지원됩니다. Amazon Athena에서 사용하는 테이블을 생성할 때 `partitionKeys`를 지정하지 않은 경우, 최소한 값 `partitionKeys`를 빈 목록으로 설정해야 합니다. 예: `"PartitionKeys": []` + `ViewOriginalText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다. 테이블이 `VIRTUAL_VIEW`인 경우 특정 Athena 구성이 base64로 인코딩됩니다. + `ViewExpandedText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다. + `TableType` – 255바이트 이하 길이의 UTF-8 문자열입니다. 이 테이블의 유형입니다. AWS Glue에서 `EXTERNAL_TABLE` 유형으로 테이블을 생성합니다. Athena 등의 다른 서비스에서는 추가 테이블 유형으로 테이블을 생성할 수 있습니다. AWS Glue 관련 테이블 유형: EXTERNAL\_TABLE Hive 호환 속성 - Hive 관리형이 아닌 테이블을 나타냅니다. GOVERNED AWS Lake Formation에서 사용됩니다. AWS Glue 데이터 카탈로그는 `GOVERNED`를 이해합니다. + `Parameters` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255 바이트 길이의 키 문자열입니다. 각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다. 이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다. + `TargetTable` – [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier) 객체입니다. 리소스 링크에 대한 대상 테이블을 설명하는 `TableIdentifier` 구조입니다. + `ViewDefinition` – [ViewDefinitionInput](#aws-glue-api-catalog-tables-ViewDefinitionInput) 객체입니다. 뷰에 대한 하나 이상의 언어와 쿼리 등 뷰를 정의하는 모든 정보를 포함하는 구조입니다. ## FederatedTable 구조 AWS Glue Data Catalog 외부의 엔터티를 가리키는 테이블입니다. **Fields** + `Identifier` – 과(와) 일치하는 1\~512바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 페더레이션된 테이블의 고유 식별자입니다. + `DatabaseIdentifier` – 과(와) 일치하는 1\~512바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 페더레이션된 데이터베이스의 고유 식별자입니다. + `ConnectionName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 외부 메타스토어에 대한 연결 이름입니다. + `ConnectionType` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 페더레이션 테이블에 액세스하는 데 사용되는 연결 유형으로, 외부 데이터 소스에 연결하기 위한 프로토콜 또는 방법을 지정합니다. ## 열 구조 `Table`의 열. **Fields** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. `Column`의 이름입니다. + `Type` – 과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) `Column`의 데이터 형식입니다. + `Comment` – 과(와) 일치하는 255바이트 이하 길이의 주석 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 자유 형식의 텍스트 설명. + `Parameters` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255 바이트 길이의 키 문자열입니다. 각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다. 이러한 키-값 페어는 열과 관련된 속성을 정의합니다. ## StorageDescriptor 구조 테이블 데이터의 물리적 스토리지를 설명합니다. **Fields** + `Columns` – [열](#aws-glue-api-catalog-tables-Column) 객체의 배열입니다. 테이블의 `Columns` 목록입니다. + `Location` – 과(와) 일치하는 2,056바이트 이하 길이의 위치 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) 테이블의 물리적 위치입니다. 기본적으로 웨어하우스 위치, 웨어하우스의 데이터베이스 위치, 테이블 이름 순으로 나타납니다. + `AdditionalLocations` – UTF-8 문자열의 배열입니다. Delta 테이블이 위치한 경로를 가리키는 위치 목록입니다. + `InputFormat` – 과(와) 일치하는 128바이트 이하 길이의 포맷 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 입력 형식: `SequenceFileInputFormat`(이진), `TextInputFormat` 또는 사용자 지정 형식입니다. + `OutputFormat` – 과(와) 일치하는 128바이트 이하 길이의 포맷 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 출력 형식: `SequenceFileOutputFormat`(이진), `IgnoreKeyTextOutputFormat` 또는 사용자 지정 형식입니다. + `Compressed` – 부울입니다. 테이블의 데이터가 압축되면 `True`이고 그렇지 않으면 `False`입니다. + `NumberOfBuckets` - 숫자(정수)입니다. 테이블에 차원 열이 포함되어 있는 경우 이 속성을 지정해야 합니다. + `SerdeInfo` – [SerDeInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo) 객체입니다. 직렬화/역직렬화(SerDe) 정보입니다. + `BucketColumns` – UTF-8 문자열의 배열입니다. 테이블의 열, 클러스터링 열 및 버킷 열을 지정하는 그룹화하는 reducer 목록입니다. + `SortColumns` – [Order](#aws-glue-api-catalog-tables-Order) 객체의 배열입니다. 테이블에 있는 각 버킷의 정렬 순서를 지정하는 목록입니다. + `Parameters` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255 바이트 길이의 키 문자열입니다. 각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다. 키 값 형식의 사용자 제공 속성입니다. + `SkewedInfo` – [SkewedInfo](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SkewedInfo) 객체입니다. 열에 자주 표시되는 값에 대한 정보입니다(편향된 값). + `StoredAsSubDirectories` – 부울입니다. 테이블 데이터가 하위 디렉터리에 저장되면 `True`이고 그렇지 않으면 `False`입니다. + `SchemaReference` – [SchemaReference](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference) 객체입니다. AWS Glue Schema Registry에 저장된 스키마를 참조하는 객체입니다. 테이블을 생성할 때 스키마에 대한 빈 열 목록을 전달하고, 대신 스키마 참조를 사용할 수 있습니다. ## SchemaReference 구조 AWS Glue Schema Registry에 저장된 스키마를 참조하는 객체입니다. **Fields** + `SchemaId` – [SchemaId](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId) 객체입니다. 스키마 ID 필드를 포함하는 구조입니다. 이것 또는 `SchemaVersionId`가 제공되어야 합니다. + `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45) 스키마 버전에 할당된 고유 ID입니다. 이것 또는 `SchemaId`가 제공되어야 합니다. + `SchemaVersionNumber` - 1\~100,000의 숫자(정수)입니다. 스키마의 버전 번호입니다. ## SerDeInfo 구조 추출기 및 로더 역할을 하는 직렬화/역직렬화 프로그램(SerDe)에 대한 정보입니다. **Fields** + `Name` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) SerDe의 이름입니다. + `SerializationLibrary` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 일반적으로 SerDe를 구현하는 클래스입니다. 예를 들면, `org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe`입니다. + `Parameters` – 키-값 페어의 맵 배열입니다. 각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255 바이트 길이의 키 문자열입니다. 각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다. 이러한 키-값 쌍은 SerDe의 초기화 파라미터를 정의합니다. ## Order 구조 분류된 열의 정렬 순서를 지정합니다. **Fields** + `Column` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 열의 이름입니다. + `SortOrder` – *필수(Required):* 1 이하의 숫자(정수)입니다. 열이 오름차순(`== 1`) 또는 내림차순(`==0`)으로 정렬된 것을 나타냅니다. ## SkewedInfo 구조 테이블에 왜곡된 값을 지정합니다. 왜곡된 값은 매우 높은 빈도를 통해 발생한 값입니다. **Fields** + `SkewedColumnNames` – UTF-8 문자열의 배열입니다. 왜곡된 값이 포함된 열의 이름 목록입니다. + `SkewedColumnValues` – UTF-8 문자열의 배열입니다. 너무 자주 나타나서 왜곡된 것으로 간주되는 값의 목록입니다. + `SkewedColumnValueLocationMaps` – 키-값 페어의 맵 배열입니다. 각 키는 UTF-8 문자열입니다. 각 값은 UTF-8 문자열입니다. 왜곡된 값을 이 값을 포함하는 열에 매핑. ## TableVersion 구조 테이블 버전을 지정합니다. **Fields** + `Table` – [표](#aws-glue-api-catalog-tables-Table) 객체입니다. 문제의 테이블입니다. + `VersionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 이 테이블 버전을 식별하는 ID 값. `VersionId`는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다. ## TableError 구조 테이블 작업의 오류 기록. **Fields** + `TableName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블의 이름 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다. + `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다. 오류에 대한 세부 정보입니다. ## TableVersionError 구조 테이블 버전 작업의 오류 기록. **Fields** + `TableName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 문제의 테이블 이름입니다. + `VersionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 문제의 버전 ID 값입니다. `VersionID`는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다. + `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다. 오류에 대한 세부 정보입니다. ## SortCriterion 구조 정렬 기준 필드와 정렬 순서를 지정합니다. **Fields** + `FieldName` – 값 문자열입니다(1\~1,024바이트). 정렬할 필드의 이름입니다. + `Sort` – UTF-8 문자열입니다(유효 값: `ASC="ASCENDING"` \| `DESC="DESCENDING"`). 오름차순 또는 내림차순 정렬. ## TableIdentifier 구조 리소스 링크에 대한 대상 테이블을 설명하는 구조입니다. **Fields** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 위치한 데이터 카탈로그의 ID입니다. + `DatabaseName` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 대상 테이블을 포함하는 카탈로그 데이터베이스의 이름입니다. + `Name` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 대상 테이블의 이름입니다. + `Region` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 대상 테이블의 리전입니다. ## KeySchemaElement 구조 이름과 유형으로 구성된 파티션 키 페어입니다. **Fields** + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 파티션 키의 이름입니다. + `Type` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다. 파티션 키의 유형입니다. ## PartitionIndex 구조 파티션 인덱스의 구조입니다. **Fields** + `Keys` – *필수(Required):* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다. 파티션 인덱스의 키입니다. + `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 파티션 인덱스의 이름입니다. ## PartitionIndexDescriptor 구조 테이블의 파티션 인덱스에 대한 설명자입니다. **Fields** + `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 파티션 인덱스의 이름입니다. + `Keys` – *필수(Required):* [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement) 객체의 배열로 구조가 1개 이상입니다. 파티션 인덱스에 대한 하나 이상의 키 목록(`KeySchemaElement` 구조)입니다. + `IndexStatus` – *필수(Required):* UTF-8 문자열입니다(유효 값: `CREATING` \| `ACTIVE` \| `DELETING` \| `FAILED`). 파티션 인덱스의 상태입니다. 가능한 상태는 다음과 같습니다. + [생성 중(CREATING)]: 인덱스를 생성 중입니다. 인덱스가 [생성 중(CREATING)] 상태인 경우 인덱스 또는 해당 테이블을 삭제할 수 없습니다. + [활성(ACTIVE)]: 인덱스 생성에 성공했습니다. + [실패(FAILED)]: 인덱스 생성에 실패했습니다. + [삭제 중(DELETING)]: 인덱스 목록에서 인덱스를 삭제합니다. + `BackfillErrors` – [BackfillError](#aws-glue-api-catalog-tables-BackfillError) 객체의 배열입니다. 기존 테이블에 대한 파티션 인덱스를 등록할 때 발생할 수 있는 오류 목록입니다. ## BackfillError 구조 기존 테이블에 대한 파티션 인덱스를 등록할 때 발생할 수 있는 오류 목록입니다. 이러한 오류는 인덱스 등록이 실패한 이유에 대한 세부 정보를 제공하고 응답에 제한된 수의 파티션을 제공하므로 결함이 있는 파티션을 수정하고 인덱스 등록을 다시 시도할 수 있습니다. 발생할 수 있는 가장 일반적인 오류 집합은 다음과 같이 분류됩니다. + EncryptedPartitionError: 파티션이 암호화되었습니다. + InvalidPartitionTypeDataError: 파티션 값이 해당 파티션 열의 데이터 유형과 일치하지 않습니다. + MissingPartitionValueError: 파티션이 암호화되었습니다. + UnsupportedPartitionCharacterError: 파티션 값 내의 문자는 지원되지 않습니다. 예: U\+0000 , U\+0001, U\+0002. + InternalError: 다른 오류 코드에 속하지 않는 모든 오류입니다. **Fields** + `Code` – UTF-8 문자열입니다(유효한 값: `ENCRYPTED_PARTITION_ERROR` \| `INTERNAL_ERROR` \| `INVALID_PARTITION_TYPE_DATA_ERROR` \| `MISSING_PARTITION_VALUE_ERROR` \| `UNSUPPORTED_PARTITION_CHARACTER_ERROR`). 기존 테이블에 대한 파티션 인덱스를 등록할 때 발생한 오류에 대한 오류 코드입니다. + `Partitions` – [PartitionValueList](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList) 객체의 배열입니다. 응답의 제한된 수의 파티션 목록입니다. ## IcebergInput 구조 카탈로그에서 생성할 Apache Iceberg 메타데이터 테이블을 정의하는 구조입니다. **Fields** + `MetadataOperation` – *필수:* UTF-8 문자열입니다(유효한 값: `CREATE`). 필수 메타데이터 작업입니다. `CREATE`로만 설정할 수 있습니다. + `Version` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) Iceberg 테이블의 테이블 버전입니다. 기본값은 2입니다. + `CreateIcebergTableInput` – [CreateIcebergTableInput](#aws-glue-api-catalog-tables-CreateIcebergTableInput) 객체입니다. 테이블 속성 및 메타데이터 사양을 포함하여 AWS Glue Data Catalog에서 새 Iceberg 테이블을 생성하는 데 필요한 구성 파라미터입니다. ## OpenTableFormatInput 구조 오픈 형식 테이블을 나타내는 구조입니다. **Fields** + `IcebergInput` – [IcebergInput](#aws-glue-api-catalog-tables-IcebergInput) 객체입니다. Apache Iceberg 메타데이터 테이블을 정의하는 `IcebergInput` 구조를 지정합니다. ## ViewDefinition 구조 표현에 대한 세부 정보를 포함하는 구조입니다. **Fields** + `IsProtected` – 부울입니다. 이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우). + `Definer` – 과 일치하는 UTF-8 문자열입니다(20\~2,048바이트).)[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). SQL에서 뷰의 정의자입니다. + `SubObjects` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다. Amazon 리소스 이름(ARN) 테이블 목록입니다. + `Representations` – [ViewRepresentation](#aws-glue-api-catalog-tables-ViewRepresentation) 객체의 배열이며 구조는 1\~1,000개입니다. 표현 목록입니다. ## ViewDefinitionInput 구조 AWS Glue 뷰를 생성하거나 업데이트하기 위한 세부 정보를 포함하는 구조입니다. **Fields** + `IsProtected` – 부울입니다. 이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우). + `Definer` – 과 일치하는 UTF-8 문자열입니다(20\~2,048바이트).)[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine). SQL에서 뷰의 정의자입니다. + `Representations` – [ViewRepresentationInput](#aws-glue-api-catalog-tables-ViewRepresentationInput) 객체의 배열이며 구조는 1\~10개입니다. 뷰의 언어와 뷰를 정의하는 쿼리를 포함하는 구조의 목록입니다. + `SubObjects` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다. 뷰를 구성하는 기본 테이블 ARN의 목록입니다. ## ViewRepresentation 구조 뷰의 언어와 뷰를 정의하는 쿼리를 포함하는 구조입니다. **Fields** + `Dialect` – UTF-8 문자열입니다(유효한 값: `REDSHIFT` \| `ATHENA` \| `SPARK`). 쿼리 엔진의 언어입니다. + `DialectVersion` – 1\~255바이트 길이의 UTF-8 문자열입니다. 쿼리 엔진의 언어 버전입니다. 예를 들어 3.0.0입니다. + `ViewOriginalText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. `CREATE VIEW DDL` 중에 고객이 제공한 `SELECT` 쿼리입니다. 이 SQL은 뷰에서 쿼리를 수행하는 동안에는 사용되지 않습니다(대신 `ViewExpandedText` 사용). `ViewOriginalText`는 사용자가 뷰를 생성한 원본 DDL 명령을 보려고 하는 `SHOW CREATE VIEW`와 같은 경우에 사용됩니다. + `ViewExpandedText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. 뷰를 위한 확장된 SQL입니다. 이 SQL은 엔진이 뷰에서 쿼리를 처리하는 동안 사용됩니다. 엔진은 뷰 생성 중에 `ViewOriginalText`를 `ViewExpandedText`로 변환하기 위해 작업을 수행할 수 있습니다. 예: + 정규화된 식별자: `SELECT * from table1 -> SELECT * from db1.table1` + `ValidationConnection` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다. + `IsStale` – 부울입니다. 기한 경과로 표시된 언어는 더 이상 유효하지 않으므로 해당 쿼리 엔진에서 쿼리하려면 먼저 업데이트해야 합니다. ## ViewRepresentationInput 구조 Lake Formation 뷰를 업데이트하거나 생성하기 위한 표현의 세부 정보를 포함하는 구조입니다. **Fields** + `Dialect` – UTF-8 문자열입니다(유효한 값: `REDSHIFT` \| `ATHENA` \| `SPARK`). 특정 표현의 엔진 유형을 지정하는 파라미터입니다. + `DialectVersion` – 1\~255바이트 길이의 UTF-8 문자열입니다. 특정 표현의 엔진 버전을 지정하는 파라미터입니다. + `ViewOriginalText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. 뷰를 설명하는 원본 SQL 쿼리를 나타내는 문자열입니다. + `ValidationConnection` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다. + `ViewExpandedText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다. 확장된 리소스 ARN으로 뷰를 설명하는 SQL 쿼리를 나타내는 문자열 ## UpdateOpenTableFormatInput 구조 AWS Glue Data Catalog에서 열린 테이블 형식 테이블을 업데이트하기 위한 입력 파라미터로, Apache Iceberg와 같은 형식별 업데이트 작업의 래퍼 역할을 합니다. **Fields** + `UpdateIcebergInput` – [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput) 객체입니다. 스키마 변경, 파티션 사양 및 테이블 속성을 포함하여 적용할 테이블 수정을 정의하는 Apache Iceberg별 업데이트 파라미터입니다. ## UpdateIcebergInput 구조 AWS Glue Data Catalog의 Apache Iceberg 테이블 업데이트와 관련된 입력 파라미터로, 기존 Iceberg 테이블에 적용할 업데이트 작업을 포함합니다. **Fields** + `UpdateIcebergTableInput` – *필수(Required):* [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-UpdateIcebergTableInput) 객체입니다. Iceberg 테이블에 적용할 특정 업데이트 작업으로, 스키마, 파티션 및 속성을 포함하여 테이블의 새 상태를 정의하는 업데이트 목록을 포함합니다. ## CreateIcebergTableInput 구조 테이블 속성 및 메타데이터 사양을 포함하여 AWS Glue Data Catalog에서 새 Iceberg 테이블을 생성하는 데 필요한 구성 파라미터입니다. **Fields** + `Location` - *필수:* [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과 일치하는 2,056바이트 이하 길이의 위치 문자열입니다. Iceberg 테이블 데이터가 저장되는 S3 위치입니다. + `Schema` – *필수(Required):* [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema) 객체입니다. Iceberg 테이블의 구조, 필드 유형 및 메타데이터를 지정하는 스키마 정의입니다. + `PartitionSpec` – [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec) 객체입니다. 최적의 쿼리 성능을 위해 Iceberg 테이블 데이터가 구성 및 파티셔닝되는 방법을 정의하는 파티셔닝 사양입니다. + `WriteOrder` – [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder) 객체입니다. 쿼리 성능을 최적화하기 위해 각 파티션 내에서 데이터를 정렬하는 방법을 정의하는 정렬 순서 사양입니다. + `Properties` – Iceberg 테이블의 추가 테이블 속성 및 구성 설정의 키-값 페어입니다. ## UpdateIcebergTableInput 구조 AWS Glue Data Catalog의 기존 Iceberg 테이블에 적용할 업데이트 작업을 포함하고, 테이블 메타데이터의 새 상태를 정의합니다. **Fields** + `Updates` – **필수(Required): [IcebergTableUpdate](#aws-glue-api-catalog-tables-IcebergTableUpdate) 객체의 배열입니다. Iceberg 테이블에 적용할 변경 사항을 지정하는 테이블 업데이트 작업 목록으로, 스키마 수정, 파티션 사양 및 테이블 속성을 포함합니다. ## IcebergSortOrder 구조 Iceberg 테이블의 정렬 순서 사양을 정의하여 쿼리 성능 최적화를 위해 파티션 내에서 데이터를 정렬하는 방법을 결정합니다. **Fields** + `OrderId` – **필수(Required): 숫자(정수)입니다. Iceberg 테이블의 메타데이터 내에서 이 정렬 순서 사양의 고유 식별자입니다. + `Fields` – **필수(Required): [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField) 객체의 배열입니다. Iceberg 테이블 데이터의 순서 기준을 정의하는 필드 목록 및 정렬 방향입니다. ## IcebergSortField 구조 소스 필드, 변환, 정렬 방향 및 null 값 순서를 포함하여 Iceberg 정렬 순서 사양 내에서 단일 필드를 정의합니다. **Fields** + `SourceId` – **필수(Required): 숫자(정수)입니다. 이 정렬 필드의 기반이 되는 테이블 스키마의 소스 필드 식별자입니다. + `Transform` – *필수:* UTF-8 문자열입니다. 정렬 전에 소스 필드에 적용되는 변환 함수(예: identity, bucket, truncate)입니다. + `Direction` – *필수:* UTF-8 문자열입니다(유효한 값: `asc="ASC"` \| `desc="DESC"`). 이 필드의 정렬 방향(오름차순 또는 내림차순)입니다. + `NullOrder` – *필수:* UTF-8 문자열입니다(유효한 값: `nulls-first="NULLS_FIRST"` \| `nulls-last="NULLS_LAST"`). 이 필드의 null 값에 대한 순서 지정 동작으로, null이 정렬 순서에서 첫 번째 또는 마지막에 나타나야 하는지 여부를 지정합니다. ## IcebergPartitionSpec 구조 Iceberg 테이블의 파티셔닝 사양을 정의하여 최적의 쿼리 성능을 위해 테이블 데이터가 구성 및 파티셔닝되는 방법을 결정합니다. **Fields** + `Fields` – **필수(Required): [IcebergPartitionField](#aws-glue-api-catalog-tables-IcebergPartitionField) 객체의 배열입니다. 소스 필드 및 변환을 포함하여 테이블 데이터가 파티셔닝되는 방법을 정의하는 파티션 필드 목록입니다. + `SpecId` - 숫자(정수)입니다. Iceberg 테이블의 메타데이터 기록 내에서 이 파티션 사양의 고유 식별자입니다. ## IcebergPartitionField 구조 소스 필드, 변환 함수, 파티션 이름 및 고유 식별자를 포함하여 Iceberg 파티션 사양 내에서 단일 파티션 필드를 정의합니다. **Fields** + `SourceId` – **필수(Required): 숫자(정수)입니다. 이 파티션 필드의 기반이 되는 테이블 스키마의 소스 필드 식별자입니다. + `Transform` – *필수:* UTF-8 문자열입니다. 파티션을 생성하기 위해 소스 필드에 적용되는 변환 함수(예: identity, bucket, truncate, year, month, day, hour)입니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~1,024바이트 길이의 UTF-8 문자열입니다. 파티셔닝된 테이블 구조에 표시될 파티션 필드의 이름입니다. + `FieldId` - 숫자(정수)입니다. Iceberg 테이블의 파티션 사양 내에서 이 파티션 필드에 할당된 고유 식별자입니다. ## IcebergSchema 구조 필드 정의, 데이터 유형 및 스키마 메타데이터를 포함하여 Iceberg 테이블의 스키마 구조를 정의합니다. **Fields** + `SchemaId` - 숫자(정수)입니다. Iceberg 테이블의 스키마 진화 기록 내에 있는 이 스키마 버전의 고유 식별자입니다. + `IdentifierFieldIds` - 서명된 32비트 정수의 배열입니다. 테이블의 레코드를 고유하게 식별하는 필드 식별자 목록으로, 행 수준 작업 및 중복 제거에 사용됩니다. + `Type` – UTF-8 문자열입니다(유효한 값: `struct="STRUCT"`). 스키마 구조의 루트 유형으로, 일반적으로 Iceberg 테이블 스키마의 경우 'struct'입니다. + `Fields` – **필수(Required): [IcebergStructField](#aws-glue-api-catalog-tables-IcebergStructField) 객체의 배열입니다. 필드 이름, 유형 및 메타데이터를 포함하여 테이블 스키마를 구성하는 필드 정의 목록입니다. ## IcebergStructField 구조 식별자, 이름, 데이터 유형, null 허용 여부 및 문서화를 포함하여 Iceberg 테이블 스키마 내의 단일 필드를 정의합니다. **Fields** + `Id` – **필수(Required): 숫자(정수)입니다. Iceberg 테이블 스키마 내에서 이 필드에 할당된 고유 식별자로, 스키마 진화 및 필드 추적에 사용됩니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~1,024바이트 길이의 UTF-8 문자열입니다. 테이블 스키마 및 쿼리 작업에 표시되는 필드의 이름입니다. + `Type` - *필수:* 이름이 `IcebergDocument`인 빈 구조입니다. 이 필드에 대한 데이터 유형 정의로, 포함된 데이터의 구조와 형식을 지정합니다. + `Required` – *필수(Required):* 부울. 테이블 스키마에 이 필드가 필요한지(null 비허용) 또는 선택 사항인지(null 허용) 여부를 나타냅니다. + `Doc` – 과(와) 일치하는 255바이트 이하 길이의 주석 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 이 필드의 용도 및 사용에 대한 추가 컨텍스트를 제공하는 선택적 문서화 또는 설명 텍스트입니다. ## IcebergTableUpdate 구조 스키마 변경, 파티셔닝 수정, 정렬 순서 조정, 위치 업데이트, 속성 변경 등 Iceberg 테이블에 적용할 전체 업데이트 세트를 정의합니다. **Fields** + `Schema` – *필수(Required):* [IcebergSchema](#aws-glue-api-catalog-tables-IcebergSchema) 객체입니다. 필드 구조, 데이터 유형 또는 스키마 메타데이터에 대한 변경 사항을 지정하여 Iceberg 테이블에 대해 업데이트된 스키마 정의입니다. + `PartitionSpec` – [IcebergPartitionSpec](#aws-glue-api-catalog-tables-IcebergPartitionSpec) 객체입니다. 테이블 데이터가 재구성 및 파티셔닝되는 방법을 정의하는 업데이트된 파티셔닝 사양입니다. + `SortOrder` – [IcebergSortOrder](#aws-glue-api-catalog-tables-IcebergSortOrder) 객체입니다. 최적의 쿼리 성능을 위해 파티션 내에서 데이터를 정렬하는 방법을 정의하는 업데이트된 정렬 순서 사양입니다. + `Location` - *필수:* [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과 일치하는 2,056바이트 이하 길이의 위치 문자열입니다. Iceberg 테이블 데이터가 저장되는 업데이트된 S3 위치입니다. + `Properties` – Iceberg 테이블의 테이블 속성 및 구성 설정의 업데이트된 키-값 페어입니다. ## AuditContext 구조 Lake Formation 감사 컨텍스트를 포함하는 구조. **Fields** + `AdditionalAuditContext` – UTF-8 문자열입니다(2048바이트 이하). 추가 감사 컨텍스트 정보가 포함된 문자열. + `RequestedColumns` – UTF-8 문자열의 배열입니다. 감사 요청된 열. + `AllColumnsRequested` – 부울입니다. 모든 열 감사 요청. ## 작업 + [CreateTable 작업(Python: create\_table)](#aws-glue-api-catalog-tables-CreateTable) + [UpdateTable 작업(Python: update\_table)](#aws-glue-api-catalog-tables-UpdateTable) + [DeleteTable 작업(Python: delete\_table)](#aws-glue-api-catalog-tables-DeleteTable) + [BatchDeleteTable 작업(Python: batch\_delete\_table)](#aws-glue-api-catalog-tables-BatchDeleteTable) + [GetTable 작업(Python: get\_table)](#aws-glue-api-catalog-tables-GetTable) + [GetTables 작업(Python: get\_tables)](#aws-glue-api-catalog-tables-GetTables) + [GetTableVersion 작업(Python: get\_table\_version)](#aws-glue-api-catalog-tables-GetTableVersion) + [GetTableVersions 작업(Python: get\_table\_versions)](#aws-glue-api-catalog-tables-GetTableVersions) + [DeleteTableVersion 작업(Python: delete\_table\_version)](#aws-glue-api-catalog-tables-DeleteTableVersion) + [BatchDeleteTableVersion 작업(Python: batch\_delete\_table\_version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion) + [SearchTables 작업(Python: search\_tables)](#aws-glue-api-catalog-tables-SearchTables) + [GetPartitionIndexes 작업(Python: get\_partition\_indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes) + [CreatePartitionIndex 작업(Python: create\_partition\_index)](#aws-glue-api-catalog-tables-CreatePartitionIndex) + [DeletePartitionIndex 작업(Python: delete\_partition\_index)](#aws-glue-api-catalog-tables-DeletePartitionIndex) + [GetColumnStatisticsForTable 작업(Python: get\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable) + [UpdateColumnStatisticsForTable 작업(Python: update\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable) + [DeleteColumnStatisticsForTable 작업(Python: delete\_column\_statistics\_for\_table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable) ## CreateTable 작업(Python: create\_table) 데이터 카탈로그에서 새로운 테이블 정의를 생성합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) `Table`을 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 새로운 테이블을 생성할 카탈로그 데이터베이스입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `Name` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) AWS Glue Data Catalog에 생성될 지정된 데이터베이스 내 테이블의 고유 식별자입니다. + `TableInput` – [TableInput](#aws-glue-api-catalog-tables-TableInput) 객체입니다. `TableInput` 객체는 카탈로그에 생성할 메타데이터 테이블을 정의합니다. + `PartitionIndexes` – [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex) 객체의 배열이며 구조는 3개 이하입니다. 테이블에 생성할 파티션 인덱스(`PartitionIndex` 구조)의 목록입니다. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 트랜잭션의 ID입니다. + `OpenTableFormatInput` – [OpenTableFormatInput](#aws-glue-api-catalog-tables-OpenTableFormatInput) 객체입니다. 오픈 형식 테이블을 생성하는 경우 `OpenTableFormatInput` 구조를 지정합니다. **응답** + *무응답 파라미터.* **오류** + `AlreadyExistsException` + `InvalidInputException` + `EntityNotFoundException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## UpdateTable 작업(Python: update\_table) 데이터 카탈로그에서 메타데이터 테이블을 업데이트합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `Name` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) AWS Glue Data Catalog에 생성될 지정된 데이터베이스 내 테이블의 고유 식별자입니다. + `TableInput` – [TableInput](#aws-glue-api-catalog-tables-TableInput) 객체입니다. 업데이트된 `TableInput` 객체는 카탈로그에 생성할 메타데이터 테이블을 정의합니다. + `SkipArchive` – 부울입니다. 기본적으로 `UpdateTable`는 항상 업데이트하기 전에 테이블 보관 버전을 생성합니다. 그러나 `skipArchive`이 true이면 `UpdateTable`는 보관된 버전을 생성하지 않습니다. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 테이블 콘텐츠를 업데이트할 트랜잭션 ID입니다. + `VersionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블 콘텐츠를 업데이트할 버전 ID입니다. + `ViewUpdateAction` – UTF-8 문자열입니다(유효한 값: `ADD` \| `REPLACE` \| `ADD_OR_REPLACE` \| `DROP`). 뷰를 업데이트할 때 수행할 작업입니다. + `Force` – 부울입니다. 이 플래그를 true로 설정하면 일치하는 스토리지 서술자와 하위 객체 매칭 요구 사항을 무시하도록 지정할 수 있습니다. + `UpdateOpenTableFormatInput` – [UpdateOpenTableFormatInput](#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput) 객체입니다. AWS Glue Data Catalog에서 열린 테이블 형식 테이블을 업데이트하기 위한 입력 파라미터로, Apache Iceberg와 같은 형식별 업데이트 작업의 래퍼 역할을 합니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `ConcurrentModificationException` + `ResourceNumberLimitExceededException` + `GlueEncryptionException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` + `AlreadyExistsException` ## DeleteTable 작업(Python: delete\_table) 데이터 카탈로그에서 테이블 정의를 제거합니다. **참고** 이 작업을 완료하면 삭제된 테이블에 속한 테이블 버전 및 파티션에 더 이상 액세스할 수 없습니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다. 관련된 모든 리소스가 즉시 삭제되도록 `DeleteTable` 호출 전에 `DeleteTableVersion` 또는 `BatchDeleteTableVersion`과 `DeletePartition` 또는 `BatchDeletePartition`을 사용하여 테이블에 속한 모든 리소스를 삭제하십시오. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 삭제된 테이블 이름. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 테이블 콘텐츠를 삭제할 트랜잭션 ID입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `ConcurrentModificationException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## BatchDeleteTable 작업(Python: batch\_delete\_table) 한 번에 여러 테이블 삭제 **참고** 이 작업을 완료하면 삭제된 테이블에 속한 테이블 버전 및 파티션에 더 이상 액세스할 수 없습니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다. 관련된 모든 리소스가 즉시 삭제되도록 `BatchDeleteTable` 호출 전에 `DeleteTableVersion` 또는 `BatchDeleteTableVersion`과 `DeletePartition` 또는 `BatchDeletePartition`을 사용하여 테이블에 속한 모든 리소스를 삭제하십시오. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 삭제할 테이블이 있는 카탈로그 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TablesToDelete` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 삭제할 테이블 목록. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 테이블 콘텐츠를 삭제할 트랜잭션 ID입니다. **응답** + `Errors` – [TableError](#aws-glue-api-catalog-tables-TableError) 객체의 배열입니다. 지정된 테이블을 삭제하는 중 발생한 오류 목록입니다. **오류** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ResourceNotReadyException` ## GetTable 작업(Python: get\_table) 지정된 테이블의 데이터 카탈로그에서 `Table`정의를 가져옵니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 카탈로그의 데이터베이스 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 정의를 가져오는 테이블의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 테이블 콘텐츠를 읽을 트랜잭션 ID입니다. + `QueryAsOfTime` – 타임스탬프입니다. 테이블 콘텐츠를 읽을 기준 시간입니다. 설정하지 않으면 가장 최근의 트랜잭션 커밋 시간이 사용됩니다. `TransactionId`과(와) 함께 지정할 수 없습니다. + `AuditContext` – [AuditContext](#aws-glue-api-catalog-tables-AuditContext) 객체입니다. Lake Formation [감사 컨텍스트](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html)를 포함하는 구조. + `IncludeStatusDetails` – 부울입니다. AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다. **응답** + `Table` – [표](#aws-glue-api-catalog-tables-Table) 객체입니다. 지정한 테이블을 정의하는 `Table` 객체. **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ResourceNotReadyException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetTables 작업(Python: get\_tables) 주어진 `Database`의 테이블 중 몇 개 혹은 모두의 정의를 가져옵니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 기록할 테이블이 있는 카탈로그의 데이터베이스입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `Expression` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 정규 표현식 패턴 테이블이 있으면 이름이 패턴과 일치하는 테이블만 반환됩니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다. + `MaxResults` – 1\~100의 숫자(정수)입니다. 한 번의 응답으로 반환할 최대 테이블 수. + `TransactionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44) 테이블 콘텐츠를 읽을 트랜잭션 ID입니다. + `QueryAsOfTime` – 타임스탬프입니다. 테이블 콘텐츠를 읽을 기준 시간입니다. 설정하지 않으면 가장 최근의 트랜잭션 커밋 시간이 사용됩니다. `TransactionId`과(와) 함께 지정할 수 없습니다. + `AuditContext` – [AuditContext](#aws-glue-api-catalog-tables-AuditContext) 객체입니다. Lake Formation [감사 컨텍스트](https://docs.aws.amazon.com/glue/latest/webapi/API_AuditContext.html)를 포함하는 구조. + `IncludeStatusDetails` – 부울입니다. AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다. + `AttributesToGet` – UTF-8 문자열의 배열입니다. `GetTables` 호출에서 반환된 테이블 필드를 지정합니다. 이 파라미터는 빈 목록을 허용하지 않습니다. 요청에는 `NAME`이(가) 포함되어야 합니다. 유효한 값 조합은 다음과 같습니다. + `NAME` - 데이터베이스의 모든 테이블 이름. + `NAME`, `TABLE_TYPE` - 모든 테이블의 이름 및 테이블 유형. **응답** + `TableList` – [표](#aws-glue-api-catalog-tables-Table) 객체의 배열입니다. 요청한 `Table` 객체의 목록입니다. + `NextToken` – UTF-8 문자열입니다. 현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `GlueEncryptionException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetTableVersion 작업(Python: get\_table\_version) 테이블의 지정된 버전을 가져옵니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `VersionId` – 과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 가져올 테이블 버전의 ID값입니다. `VersionID`는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다. **응답** + `TableVersion` – [TableVersion](#aws-glue-api-catalog-tables-TableVersion) 객체입니다. 요청한 테이블 버전 **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## GetTableVersions 작업(Python: get\_table\_versions) 문자열 목록을 가져와 지정된 테이블의 사용 가능한 버전을 식별합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `NextToken` – UTF-8 문자열입니다. 이것이 첫 번째 호출이 아니면 지속적인 토큰입니다. + `MaxResults` – 1\~100의 숫자(정수)입니다. 한 번의 응답으로 반환될 최대 테이블 버전 수입니다. **응답** + `TableVersions` – [TableVersion](#aws-glue-api-catalog-tables-TableVersion) 객체의 배열입니다. 문자열 목록은 지정된 테이블의 사용 가능한 버전을 식별합니다. + `NextToken` – UTF-8 문자열입니다. 사용 가능한 버전 목록이 마지막 버전을 포함하지 않은 경우의 연속 토큰입니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeleteTableVersion 작업(Python: delete\_table\_version) 테이블의 지정된 버전을 삭제합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `VersionId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 삭제될 테이블 버전의 ID입니다. `VersionID`는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## BatchDeleteTableVersion 작업(Python: batch\_delete\_table\_version) 테이블 버전의 지정된 배치를 삭제합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다. + `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다. + `VersionIds` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 삭제될 ID 버전 목록입니다. `VersionId`는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다. **응답** + `Errors` – [TableVersionError](#aws-glue-api-catalog-tables-TableVersionError) 객체의 배열입니다. 지정된 테이블 버전을 삭제하고자 할 때 발생한 오류 목록입니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` ## SearchTables 작업(Python: search\_tables) 상위 데이터베이스 뿐만 아니라 테이블 메타데이터의 속성을 기반으로 테이블 집합을 검색합니다. 텍스트 또는 필터 조건으로 검색할 수 있습니다. Lake Formation에 정의된 보안 정책을 기반으로 액세스할 수 있는 테이블만 가져올 수 있습니다. 테이블이 반환되기 위해서는 최소한 읽기 전용 액세스 권한이 필요합니다. 테이블의 모든 열에 액세스할 수 없으면, 테이블 목록이 다시 반환될 때 이러한 열이 검색되지 않습니다. 열에 액세스할 수 있지만 열의 데이터에는 액세스할 수 없는 경우 해당 열 및 해당 열의 관련 메타데이터가 검색에 포함됩니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) `account_id`로 구성된 고유한 식별자입니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다. + `Filters` – [PropertyPredicate](aws-glue-api-common.md#aws-glue-api-common-PropertyPredicate) 객체의 배열입니다. 키-값 페어의 목록 및 검색 결과를 필터링하는 데 사용되는 비교기입니다. 조건자와 일치하는 모든 엔터티를 반환합니다. `PropertyPredicate` 구조체의 `Comparator` 멤버는 시간 필드에만 사용되며 다른 필드 유형에서는 생략할 수 있습니다. 또한 `Key=Name`과 같이 문자열 값을 비교할 때 퍼지 일치 알고리즘을 사용합니다. `Key` 필드(예: `Name` 필드 값)는 특정 구두점 문자(예: -, :, \# 등)에서 토큰으로 분할됩니다. 그런 다음 각 토큰은 `PropertyPredicate`의 `Value` 멤버와 정확히 일치합니다. 예를 들어 `Key=Name`과 `Value=link`가 있으면 `customer-link` 및 `xx-link-yy`라는 테이블은 반환되지만 `xxlinkyy`는 반환되지 않는다. + `SearchText` – 값 문자열입니다(1\~1,024바이트). 텍스트 검색에 사용되는 문자열입니다. 인용 부호로 값을 지정하면, 정확도를 기준으로 필터링합니다. + `SortCriteria` – [SortCriterion](#aws-glue-api-catalog-tables-SortCriterion) 객체의 배열이며 구조는 1개 이하입니다. 필드 이름을 기준으로 결과를 오름차순 또는 내림차순으로 정렬하는 기준 목록입니다. + `MaxResults` – 1\~1,000의 숫자(정수)입니다. 한 번의 응답으로 반환할 최대 테이블 수. + `ResourceShareType` – UTF-8 문자열입니다(유효한 값: `FOREIGN` \| `ALL` \| `FEDERATED`). 계정과 공유된 테이블을 검색하도록 지정할 수 있습니다. 허용 가능 값은 `FOREIGN` 또는 `ALL`입니다. + `FOREIGN`으로 설정하면 계정과 공유된 테이블이 검색됩니다. + `ALL`로 설정하면 계정과 공유된 테이블과 로컬 계정의 테이블이 검색됩니다. + `IncludeStatusDetails` – 부울입니다. AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다. **응답** + `NextToken` – UTF-8 문자열입니다. 현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다. + `TableList` – [표](#aws-glue-api-catalog-tables-Table) 객체의 배열입니다. 요청한 `Table` 객체의 목록입니다. `SearchTables` 응답은 액세스할 수 있는 테이블만 반환합니다. **오류** + `InternalServiceException` + `InvalidInputException` + `OperationTimeoutException` ## GetPartitionIndexes 작업(Python: get\_partition\_indexes) 테이블과 연결된 파티션 인덱스를 검색합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 있는 카탈로그 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 문자열입니다. 파티션 인덱스를 검색할 테이블의 이름을 지정합니다. + `NextToken` – UTF-8 문자열입니다. 이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다. **응답** + `PartitionIndexDescriptorList` – [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor) 객체의 배열입니다. 인덱스 설명자의 목록입니다. + `NextToken` – UTF-8 문자열입니다. 현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다. **오류** + `InternalServiceException` + `OperationTimeoutException` + `InvalidInputException` + `EntityNotFoundException` + `ConflictException` ## CreatePartitionIndex 작업(Python: create\_partition\_index) 기존 테이블에 지정된 파티션 인덱스를 생성합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 있는 카탈로그 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 문자열입니다. 파티션 인덱스를 생성하려는 테이블의 이름을 지정합니다. + `PartitionIndex` – *필수(Required):* [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex) 객체입니다. `PartitionIndex` 구조를 지정하여 기존 테이블에 파티션 인덱스를 생성합니다. **응답** + *무응답 파라미터.* **오류** + `AlreadyExistsException` + `InvalidInputException` + `EntityNotFoundException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeletePartitionIndex 작업(Python: delete\_partition\_index) 기존 테이블에서 지정된 파티션 인덱스를 삭제합니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 테이블이 있는 카탈로그 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 문자열입니다. 파티션 인덱스를 삭제하려는 테이블의 이름을 지정합니다. + `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 삭제할 파티션 인덱스의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `InternalServiceException` + `OperationTimeoutException` + `InvalidInputException` + `EntityNotFoundException` + `ConflictException` + `GlueEncryptionException` ## GetColumnStatisticsForTable 작업(Python: get\_column\_statistics\_for\_table) 열의 테이블 통계를 검색합니다. 이 작업에 필요한 Identity and Access Management(IAM) 권한은 `GetTable`입니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 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 문자열입니다. 파티션 테이블의 이름입니다. + `ColumnNames` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다. 열 이름의 목록입니다. **응답** + `ColumnStatisticsList` – [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics) 객체의 배열입니다. ColumnStatistics 목록입니다. + `Errors` – [ColumnError](aws-glue-api-common.md#aws-glue-api-common-ColumnError) 객체의 배열입니다. 검색에 실패한 ColumnStatistics 목록입니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## UpdateColumnStatisticsForTable 작업(Python: update\_column\_statistics\_for\_table) 열의 테이블 통계를 생성하거나 업데이트합니다. 이 작업에 필요한 Identity and Access Management(IAM) 권한은 `UpdateTable`입니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 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 문자열입니다. 파티션 테이블의 이름입니다. + `ColumnStatisticsList` – *필수(Required):* [ColumnStatistics](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics) 객체의 배열이며 구조는 25개 이하입니다. 열 통계의 목록입니다. **응답** + `Errors` – [ColumnStatisticsError](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError) 객체의 배열입니다. ColumnStatisticsErrors의 목록입니다. **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` ## DeleteColumnStatisticsForTable 작업(Python: delete\_column\_statistics\_for\_table) 열의 테이블 통계를 검색합니다. 이 작업에 필요한 Identity and Access Management(IAM) 권한은 `DeleteTable`입니다. **요청** + `CatalogId` – 과(와) 일치하는 1\~255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) 문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 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 문자열입니다. 파티션 테이블의 이름입니다. + `ColumnName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\~255바이트 길이의 UTF-8 문자열입니다. 열의 이름입니다. **응답** + *무응답 파라미터.* **오류** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException`