표 API

• 테이블 구조

• TableInput 구조

• FederatedTable 구조

• 열 구조

• StorageDescriptor 구조

• SchemaReference 구조

• SerDeInfo 구조

• Order 구조

• SkewedInfo 구조

• TableVersion 구조

• TableError 구조

• TableVersionError 구조

• SortCriterion 구조

• TableIdentifier 구조

• KeySchemaElement 구조

• PartitionIndex 구조

• PartitionIndexDescriptor 구조

• BackfillError 구조

• IcebergInput 구조

• OpenTableFormatInput 구조

• ViewDefinition 구조

• ViewDefinitionInput 구조

• ViewRepresentation 구조

• ViewRepresentationInput 구조

• UpdateOpenTableFormatInput 구조

• UpdateIcebergInput 구조

• CreateIcebergTableInput 구조

• UpdateIcebergTableInput 구조

• IcebergSortOrder 구조

• IcebergSortField 구조

• IcebergPartitionSpec 구조

• IcebergPartitionField 구조

• IcebergSchema 구조

• IcebergStructField 구조

• IcebergTableUpdate 구조

필드

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 이름. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.

• DatabaseName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 메타데이터가 있는 데이터베이스의 이름입니다. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.

• Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  테이블에 대한 설명입니다.

• Owner – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 소유자입니다.

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

  테이블 정의가 데이터 카탈로그에 생성된 시간입니다.

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

  테이블이 업데이트된 마지막 시간입니다.

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

  테이블이 액세스된 마지막 시간입니다. 보통 HDFS에서 가져왔고 대다수는 신뢰할 만하지 않습니다.

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

  이 테이블에 대한 열 통계가 계산된 마지막 시간입니다.

• Retention – None 이하의 숫자(정수)입니다.

  이 테이블의 보관 기간입니다.

• StorageDescriptor – StorageDescriptor 객체입니다.

  이 테이블의 물리적 스토리지에 대한 정보를 포함하는 스토리지 서술자입니다.

• PartitionKeys – 열 객체의 배열입니다.

  테이블을 분할할 열의 목록입니다. 초기 유형만 파티션 키로써 지원됩니다.

  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과(와) 일치하는 1~255 바이트 길이의 키 문자열입니다.

  각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다.

  이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다.

• CreatedBy – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블을 만든 사용자 혹은 개체.

• IsRegisteredWithLakeFormation – 부울입니다.

  테이블이 AWS Lake Formation에 등록되었는지 여부를 나타냅니다.

• TargetTable – TableIdentifier 객체입니다.

  리소스 링크에 대한 대상 테이블을 설명하는 TableIdentifier 구조입니다.

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

  테이블이 위치한 데이터 카탈로그의 ID입니다.

• VersionId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 버전의 ID입니다.

• FederatedTable – FederatedTable 객체입니다.

  AWS Glue Data Catalog 외부의 엔터티를 참조하는 FederatedTable 구조입니다.

• ViewDefinition – ViewDefinition 객체입니다.

  뷰에 대한 하나 이상의 언어와 쿼리 등 뷰를 정의하는 모든 정보를 포함하는 구조입니다.

• IsMultiDialectView – 부울입니다.

  뷰가 여러 다양한 쿼리 엔진의 SQL 언어의 지원하며 해당 엔진에서 읽을 수 있는지 여부를 지정합니다.

필드

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 이름. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다.

• Description – URI address multi-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  테이블에 대한 설명입니다.

• Owner – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 소유자입니다. Apache Hive 호환성을 위해 포함되었습니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다.

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

  테이블이 액세스된 마지막 시간입니다.

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

  이 테이블에 대한 열 통계가 계산된 마지막 시간입니다.

• Retention – None 이하의 숫자(정수)입니다.

  이 테이블의 보관 기간입니다.

• StorageDescriptor – StorageDescriptor 객체입니다.

  이 테이블의 물리적 스토리지에 대한 정보를 포함하는 스토리지 서술자입니다.

• PartitionKeys – 열 객체의 배열입니다.

  테이블을 분할할 열의 목록입니다. 초기 유형만 파티션 키로써 지원됩니다.

  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과(와) 일치하는 1~255 바이트 길이의 키 문자열입니다.

  각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다.

  이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다.

• TargetTable – TableIdentifier 객체입니다.

  리소스 링크에 대한 대상 테이블을 설명하는 TableIdentifier 구조입니다.

• ViewDefinition – ViewDefinitionInput 객체입니다.

  뷰에 대한 하나 이상의 언어와 쿼리 등 뷰를 정의하는 모든 정보를 포함하는 구조입니다.

필드

• Identifier – Single-line string pattern과(와) 일치하는 1~512바이트 길이의 UTF-8 문자열입니다.

  페더레이션된 테이블의 고유 식별자입니다.

• DatabaseIdentifier – Single-line string pattern과(와) 일치하는 1~512바이트 길이의 UTF-8 문자열입니다.

  페더레이션된 데이터베이스의 고유 식별자입니다.

• ConnectionName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  외부 메타스토어에 대한 연결 이름입니다.

• ConnectionType – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  페더레이션 테이블에 액세스하는 데 사용되는 연결 유형으로, 외부 데이터 소스에 연결하기 위한 프로토콜 또는 방법을 지정합니다.

필드

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  Column의 이름입니다.

• Type – Single-line string pattern과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다.

  Column의 데이터 형식입니다.

• Comment – Single-line string pattern과(와) 일치하는 255바이트 이하 길이의 주석 문자열입니다.

  자유 형식의 텍스트 설명.

• Parameters – 키-값 페어의 맵 배열입니다.

  각 키는 Single-line string pattern과(와) 일치하는 1~255 바이트 길이의 키 문자열입니다.

  각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다.

  이러한 키-값 페어는 열과 관련된 속성을 정의합니다.

필드

• Columns – 열 객체의 배열입니다.

  테이블의 Columns 목록입니다.

• Location – URI address multi-line string pattern과(와) 일치하는 2,056바이트 이하 길이의 위치 문자열입니다.

  테이블의 물리적 위치입니다. 기본적으로 웨어하우스 위치, 웨어하우스의 데이터베이스 위치, 테이블 이름 순으로 나타납니다.

• AdditionalLocations – UTF-8 문자열의 배열입니다.

  Delta 테이블이 위치한 경로를 가리키는 위치 목록입니다.

• InputFormat – Single-line string pattern과(와) 일치하는 128바이트 이하 길이의 포맷 문자열입니다.

  입력 형식: SequenceFileInputFormat(이진), TextInputFormat 또는 사용자 지정 형식입니다.

• OutputFormat – Single-line string pattern과(와) 일치하는 128바이트 이하 길이의 포맷 문자열입니다.

  출력 형식: SequenceFileOutputFormat(이진), IgnoreKeyTextOutputFormat 또는 사용자 지정 형식입니다.

• Compressed – 부울입니다.

  테이블의 데이터가 압축되면 True이고 그렇지 않으면 False입니다.

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

  테이블에 차원 열이 포함되어 있는 경우 이 속성을 지정해야 합니다.

• SerdeInfo – SerDeInfo 객체입니다.

  직렬화/역직렬화(SerDe) 정보입니다.

• BucketColumns – UTF-8 문자열의 배열입니다.

  테이블의 열, 클러스터링 열 및 버킷 열을 지정하는 그룹화하는 reducer 목록입니다.

• SortColumns – Order 객체의 배열입니다.

  테이블에 있는 각 버킷의 정렬 순서를 지정하는 목록입니다.

• Parameters – 키-값 페어의 맵 배열입니다.

  각 키는 Single-line string pattern과(와) 일치하는 1~255 바이트 길이의 키 문자열입니다.

  각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다.

  키 값 형식의 사용자 제공 속성입니다.

• SkewedInfo – SkewedInfo 객체입니다.

  열에 자주 표시되는 값에 대한 정보입니다(편향된 값).

• StoredAsSubDirectories – 부울입니다.

  테이블 데이터가 하위 디렉터리에 저장되면 True이고 그렇지 않으면 False입니다.

• SchemaReference – SchemaReference 객체입니다.

  AWS Glue Schema Registry에 저장된 스키마를 참조하는 객체입니다.

  테이블을 생성할 때 스키마에 대한 빈 열 목록을 전달하고, 대신 스키마 참조를 사용할 수 있습니다.

필드

• SchemaId – SchemaId 객체입니다.

  스키마 ID 필드를 포함하는 구조입니다. 이것 또는 SchemaVersionId가 제공되어야 합니다.

• SchemaVersionId – Custom string pattern #44과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다.

  스키마 버전에 할당된 고유 ID입니다. 이것 또는 SchemaId가 제공되어야 합니다.

• SchemaVersionNumber - 1~100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.

필드

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  SerDe의 이름입니다.

• SerializationLibrary – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  일반적으로 SerDe를 구현하는 클래스입니다. 예를 들면, org.apache.hadoop.hive.serde2.columnar.ColumnarSerDe입니다.

• Parameters – 키-값 페어의 맵 배열입니다.

  각 키는 Single-line string pattern과(와) 일치하는 1~255 바이트 길이의 키 문자열입니다.

  각 값은 512000 바이트 이하 길이의 UTF-8 문자열입니다.

  이러한 키-값 쌍은 SerDe의 초기화 파라미터를 정의합니다.

필드

• Column – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  열의 이름입니다.

• SortOrder – 필수(Required): 1 이하의 숫자(정수)입니다.

  열이 오름차순(== 1) 또는 내림차순(==0)으로 정렬된 것을 나타냅니다.

필드

• SkewedColumnNames – UTF-8 문자열의 배열입니다.

  왜곡된 값이 포함된 열의 이름 목록입니다.

• SkewedColumnValues – UTF-8 문자열의 배열입니다.

  너무 자주 나타나서 왜곡된 것으로 간주되는 값의 목록입니다.

• SkewedColumnValueLocationMaps – 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다.

  각 값은 UTF-8 문자열입니다.

  왜곡된 값을 이 값을 포함하는 열에 매핑.

필드

• Table – 표 객체입니다.

  문제의 테이블입니다.

• VersionId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  이 테이블 버전을 식별하는 ID 값. VersionId는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다.

필드

• TableName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.

• ErrorDetail – ErrorDetail 객체입니다.

  오류에 대한 세부 정보입니다.

필드

• TableName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  문제의 테이블 이름입니다.

• VersionId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  문제의 버전 ID 값입니다. VersionID는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다.

• ErrorDetail – ErrorDetail 객체입니다.

  오류에 대한 세부 정보입니다.

필드

• FieldName – 값 문자열입니다(1~1,024바이트).

  정렬할 필드의 이름입니다.

• Sort – UTF-8 문자열입니다(유효 값: ASC="ASCENDING" | DESC="DESCENDING").

  오름차순 또는 내림차순 정렬.

필드

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

  테이블이 위치한 데이터 카탈로그의 ID입니다.

• DatabaseName – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  대상 테이블을 포함하는 카탈로그 데이터베이스의 이름입니다.

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  대상 테이블의 이름입니다.

• Region – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  대상 테이블의 리전입니다.

필드

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 키의 이름입니다.

• Type – 필수(Required): Single-line string pattern과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다.

  파티션 키의 유형입니다.

필드

• Keys – 필수(Required): UTF-8 문자열의 배열이며 문자열은 1개 이상입니다.

  파티션 인덱스의 키입니다.

• IndexName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스의 이름입니다.

필드

• IndexName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스의 이름입니다.

• Keys – 필수(Required): KeySchemaElement 객체의 배열로 구조가 1개 이상입니다.

  파티션 인덱스에 대한 하나 이상의 키 목록(KeySchemaElement 구조)입니다.

• IndexStatus – 필수(Required): UTF-8 문자열입니다(유효 값: CREATING | ACTIVE | DELETING | FAILED).

  파티션 인덱스의 상태입니다.

  가능한 상태는 다음과 같습니다.

  • [생성 중(CREATING)]: 인덱스를 생성 중입니다. 인덱스가 [생성 중(CREATING)] 상태인 경우 인덱스 또는 해당 테이블을 삭제할 수 없습니다.

  • [활성(ACTIVE)]: 인덱스 생성에 성공했습니다.

  • [실패(FAILED)]: 인덱스 생성에 실패했습니다.

  • [삭제 중(DELETING)]: 인덱스 목록에서 인덱스를 삭제합니다.

• BackfillErrors – BackfillError 객체의 배열입니다.

  기존 테이블에 대한 파티션 인덱스를 등록할 때 발생할 수 있는 오류 목록입니다.

• EncryptedPartitionError: 파티션이 암호화되었습니다.

• InvalidPartitionTypeDataError: 파티션 값이 해당 파티션 열의 데이터 유형과 일치하지 않습니다.

• MissingPartitionValueError: 파티션이 암호화되었습니다.

• UnsupportedPartitionCharacterError: 파티션 값 내의 문자는 지원되지 않습니다. 예: U+0000 , U+0001, U+0002.

• InternalError: 다른 오류 코드에 속하지 않는 모든 오류입니다.

필드

• Code – UTF-8 문자열입니다(유효한 값: ENCRYPTED_PARTITION_ERROR | INTERNAL_ERROR | INVALID_PARTITION_TYPE_DATA_ERROR | MISSING_PARTITION_VALUE_ERROR | UNSUPPORTED_PARTITION_CHARACTER_ERROR).

  기존 테이블에 대한 파티션 인덱스를 등록할 때 발생한 오류에 대한 오류 코드입니다.

• Partitions – PartitionValueList 객체의 배열입니다.

  응답의 제한된 수의 파티션 목록입니다.

필드

• MetadataOperation – 필수: UTF-8 문자열입니다(유효한 값: CREATE).

  필수 메타데이터 작업입니다. CREATE로만 설정할 수 있습니다.

• Version – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  Iceberg 테이블의 테이블 버전입니다. 기본값은 2입니다.

• CreateIcebergTableInput – CreateIcebergTableInput 객체입니다.

  테이블 속성 및 메타데이터 사양을 포함하여 AWS Glue Data Catalog에서 새 Iceberg 테이블을 생성하는 데 필요한 구성 파라미터입니다.

필드

• IcebergInput – IcebergInput 객체입니다.

  Apache Iceberg 메타데이터 테이블을 정의하는 IcebergInput 구조를 지정합니다.

필드

• IsProtected – 부울입니다.

  이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우).

• Definer – Single-line string pattern과 일치하는 UTF-8 문자열입니다(20~2,048바이트).

  SQL에서 뷰의 정의자입니다.

• SubObjects – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  Amazon 리소스 이름(ARN) 테이블 목록입니다.

• Representations – ViewRepresentation 객체의 배열이며 구조는 1~1,000개입니다.

  표현 목록입니다.

필드

• IsProtected – 부울입니다.

  이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우).

• Definer – Single-line string pattern과 일치하는 UTF-8 문자열입니다(20~2,048바이트).

  SQL에서 뷰의 정의자입니다.

• Representations – ViewRepresentationInput 객체의 배열이며 구조는 1~10개입니다.

  뷰의 언어와 뷰를 정의하는 쿼리를 포함하는 구조의 목록입니다.

• SubObjects – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  뷰를 구성하는 기본 테이블 ARN의 목록입니다.

필드

• 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 – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다.

• IsStale – 부울입니다.

  기한 경과로 표시된 언어는 더 이상 유효하지 않으므로 해당 쿼리 엔진에서 쿼리하려면 먼저 업데이트해야 합니다.

필드

• Dialect – UTF-8 문자열입니다(유효한 값: REDSHIFT | ATHENA | SPARK).

  특정 표현의 엔진 유형을 지정하는 파라미터입니다.

• DialectVersion – 1~255바이트 길이의 UTF-8 문자열입니다.

  특정 표현의 엔진 버전을 지정하는 파라미터입니다.

• ViewOriginalText – 409,600바이트 이하 길이의 UTF-8 문자열입니다.

  뷰를 설명하는 원본 SQL 쿼리를 나타내는 문자열입니다.

• ValidationConnection – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다.

• ViewExpandedText – 409,600바이트 이하 길이의 UTF-8 문자열입니다.

  확장된 리소스 ARN으로 뷰를 설명하는 SQL 쿼리를 나타내는 문자열

필드

• UpdateIcebergInput – UpdateIcebergInput 객체입니다.

  스키마 변경, 파티션 사양 및 테이블 속성을 포함하여 적용할 테이블 수정을 정의하는 Apache Iceberg별 업데이트 파라미터입니다.

필드

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

  Iceberg 테이블에 적용할 특정 업데이트 작업으로, 스키마, 파티션 및 속성을 포함하여 테이블의 새 상태를 정의하는 업데이트 목록을 포함합니다.

필드

• Location - 필수: URI address multi-line string pattern과 일치하는 2,056바이트 이하 길이의 위치 문자열입니다.

  Iceberg 테이블 데이터가 저장되는 S3 위치입니다.

• Schema – 필수(Required): IcebergSchema 객체입니다.

  Iceberg 테이블의 구조, 필드 유형 및 메타데이터를 지정하는 스키마 정의입니다.

• PartitionSpec – IcebergPartitionSpec 객체입니다.

  최적의 쿼리 성능을 위해 Iceberg 테이블 데이터가 구성 및 파티셔닝되는 방법을 정의하는 파티셔닝 사양입니다.

• WriteOrder – IcebergSortOrder 객체입니다.

  쿼리 성능을 최적화하기 위해 각 파티션 내에서 데이터를 정렬하는 방법을 정의하는 정렬 순서 사양입니다.

• Properties – 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다.

  각 값은 UTF-8 문자열입니다.

  Iceberg 테이블의 추가 테이블 속성 및 구성 설정의 키-값 페어입니다.

필드

• Updates – 필수(Required): IcebergTableUpdate 객체의 배열입니다.

  Iceberg 테이블에 적용할 변경 사항을 지정하는 테이블 업데이트 작업 목록으로, 스키마 수정, 파티션 사양 및 테이블 속성을 포함합니다.

필드

• OrderId – 필수(Required): 숫자(정수)입니다.

  Iceberg 테이블의 메타데이터 내에서 이 정렬 순서 사양의 고유 식별자입니다.

• Fields – 필수(Required): IcebergSortField 객체의 배열입니다.

  Iceberg 테이블 데이터의 순서 기준을 정의하는 필드 목록 및 정렬 방향입니다.

필드

• 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이 정렬 순서에서 첫 번째 또는 마지막에 나타나야 하는지 여부를 지정합니다.

필드

• Fields – 필수(Required): IcebergPartitionField 객체의 배열입니다.

  소스 필드 및 변환을 포함하여 테이블 데이터가 파티셔닝되는 방법을 정의하는 파티션 필드 목록입니다.

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

  Iceberg 테이블의 메타데이터 기록 내에서 이 파티션 사양의 고유 식별자입니다.

필드

• SourceId – 필수(Required): 숫자(정수)입니다.

  이 파티션 필드의 기반이 되는 테이블 스키마의 소스 필드 식별자입니다.

• Transform – 필수: UTF-8 문자열입니다.

  파티션을 생성하기 위해 소스 필드에 적용되는 변환 함수(예: identity, bucket, truncate, year, month, day, hour)입니다.

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~1,024바이트 길이의 UTF-8 문자열입니다.

  파티셔닝된 테이블 구조에 표시될 파티션 필드의 이름입니다.

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

  Iceberg 테이블의 파티션 사양 내에서 이 파티션 필드에 할당된 고유 식별자입니다.

필드

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

  Iceberg 테이블의 스키마 진화 기록 내에 있는 이 스키마 버전의 고유 식별자입니다.

• IdentifierFieldIds - 서명된 32비트 정수의 배열입니다.

  테이블의 레코드를 고유하게 식별하는 필드 식별자 목록으로, 행 수준 작업 및 중복 제거에 사용됩니다.

• Type – UTF-8 문자열입니다(유효한 값: struct="STRUCT").

  스키마 구조의 루트 유형으로, 일반적으로 Iceberg 테이블 스키마의 경우 'struct'입니다.

• Fields – 필수(Required): IcebergStructField 객체의 배열입니다.

  필드 이름, 유형 및 메타데이터를 포함하여 테이블 스키마를 구성하는 필드 정의 목록입니다.

필드

• Id – 필수(Required): 숫자(정수)입니다.

  Iceberg 테이블 스키마 내에서 이 필드에 할당된 고유 식별자로, 스키마 진화 및 필드 추적에 사용됩니다.

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~1,024바이트 길이의 UTF-8 문자열입니다.

  테이블 스키마 및 쿼리 작업에 표시되는 필드의 이름입니다.

• Type - 필수: 이름이 IcebergDocument인 빈 구조입니다.

  이 필드에 대한 데이터 유형 정의로, 포함된 데이터의 구조와 형식을 지정합니다.

• Required – 필수(Required): 부울.

  테이블 스키마에 이 필드가 필요한지(null 비허용) 또는 선택 사항인지(null 허용) 여부를 나타냅니다.

• Doc – Single-line string pattern과(와) 일치하는 255바이트 이하 길이의 주석 문자열입니다.

  이 필드의 용도 및 사용에 대한 추가 컨텍스트를 제공하는 선택적 문서화 또는 설명 텍스트입니다.

필드

• Schema – 필수(Required): IcebergSchema 객체입니다.

  필드 구조, 데이터 유형 또는 스키마 메타데이터에 대한 변경 사항을 지정하여 Iceberg 테이블에 대해 업데이트된 스키마 정의입니다.

• PartitionSpec – IcebergPartitionSpec 객체입니다.

  테이블 데이터가 재구성 및 파티셔닝되는 방법을 정의하는 업데이트된 파티셔닝 사양입니다.

• SortOrder – IcebergSortOrder 객체입니다.

  최적의 쿼리 성능을 위해 파티션 내에서 데이터를 정렬하는 방법을 정의하는 업데이트된 정렬 순서 사양입니다.

• Location - 필수: URI address multi-line string pattern과 일치하는 2,056바이트 이하 길이의 위치 문자열입니다.

  Iceberg 테이블 데이터가 저장되는 업데이트된 S3 위치입니다.

• Properties – 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다.

  각 값은 UTF-8 문자열입니다.

  Iceberg 테이블의 테이블 속성 및 구성 설정의 업데이트된 키-값 페어입니다.

• CreateTable 작업(Python: create_table)

• UpdateTable 작업(Python: update_table)

• DeleteTable 작업(Python: delete_table)

• BatchDeleteTable 작업(Python: batch_delete_table)

• GetTable 작업(Python: get_table)

• GetTables 작업(Python: get_tables)

• GetTableVersion 작업(Python: get_table_version)

• GetTableVersions 작업(Python: get_table_versions)

• DeleteTableVersion 작업(Python: delete_table_version)

• BatchDeleteTableVersion 작업(Python: batch_delete_table_version)

• SearchTables 작업(Python: search_tables)

• GetPartitionIndexes 작업(Python: get_partition_indexes)

• CreatePartitionIndex 작업(Python: create_partition_index)

• DeletePartitionIndex 작업(Python: delete_partition_index)

• GetColumnStatisticsForTable 작업(Python: get_column_statistics_for_table)

• UpdateColumnStatisticsForTable 작업(Python: update_column_statistics_for_table)

• DeleteColumnStatisticsForTable 작업(Python: delete_column_statistics_for_table)

요청

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

  Table을 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  새로운 테이블을 생성할 카탈로그 데이터베이스입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog에 생성될 지정된 데이터베이스 내 테이블의 고유 식별자입니다.

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

  TableInput 객체는 카탈로그에 생성할 메타데이터 테이블을 정의합니다.

• PartitionIndexes – PartitionIndex 객체의 배열이며 구조는 3개 이하입니다.

  테이블에 생성할 파티션 인덱스(PartitionIndex 구조)의 목록입니다.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  트랜잭션의 ID입니다.

• OpenTableFormatInput – OpenTableFormatInput 객체입니다.

  오픈 형식 테이블을 생성하는 경우 OpenTableFormatInput 구조를 지정합니다.

응답

• 무응답 파라미터.

오류

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  AWS Glue Data Catalog에 생성될 지정된 데이터베이스 내 테이블의 고유 식별자입니다.

• TableInput – TableInput 객체입니다.

  업데이트된 TableInput 객체는 카탈로그에 생성할 메타데이터 테이블을 정의합니다.

• SkipArchive – 부울입니다.

  기본적으로 UpdateTable는 항상 업데이트하기 전에 테이블 보관 버전을 생성합니다. 그러나 skipArchive이 true이면 UpdateTable는 보관된 버전을 생성하지 않습니다.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 업데이트할 트랜잭션 ID입니다.

• VersionId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 업데이트할 버전 ID입니다.

• ViewUpdateAction – UTF-8 문자열입니다(유효한 값: ADD | REPLACE | ADD_OR_REPLACE | DROP).

  뷰를 업데이트할 때 수행할 작업입니다.

• Force – 부울입니다.

  이 플래그를 true로 설정하면 일치하는 스토리지 서술자와 하위 객체 매칭 요구 사항을 무시하도록 지정할 수 있습니다.

응답

• 무응답 파라미터.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNumberLimitExceededException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

• AlreadyExistsException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제된 테이블 이름. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 삭제할 트랜잭션 ID입니다.

응답

• 무응답 파라미터.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• ConcurrentModificationException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제할 테이블이 있는 카탈로그 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TablesToDelete – 필수(Required): 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  삭제할 테이블 목록.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 삭제할 트랜잭션 ID입니다.

응답

• Errors – TableError 객체의 배열입니다.

  지정된 테이블을 삭제하는 중 발생한 오류 목록입니다.

오류

• InvalidInputException

• EntityNotFoundException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  정의를 가져오는 테이블의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 읽을 트랜잭션 ID입니다.

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

  테이블 콘텐츠를 읽을 기준 시간입니다. 설정하지 않으면 가장 최근의 트랜잭션 커밋 시간이 사용됩니다. TransactionId과(와) 함께 지정할 수 없습니다.

• IncludeStatusDetails – 부울입니다.

  AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다.

응답

• Table – 표 객체입니다.

  지정한 테이블을 정의하는 Table 객체.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

• ResourceNotReadyException

• FederationSourceException

• FederationSourceRetryableException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  기록할 테이블이 있는 카탈로그의 데이터베이스입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• Expression – Single-line string pattern과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  정규 표현식 패턴 테이블이 있으면 이름이 패턴과 일치하는 테이블만 반환됩니다.

• NextToken – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.

• MaxResults – 1~100의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 테이블 수.

• TransactionId – Custom string pattern #43과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블 콘텐츠를 읽을 트랜잭션 ID입니다.

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

  테이블 콘텐츠를 읽을 기준 시간입니다. 설정하지 않으면 가장 최근의 트랜잭션 커밋 시간이 사용됩니다. TransactionId과(와) 함께 지정할 수 없습니다.

• IncludeStatusDetails – 부울입니다.

  AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다.

• AttributesToGet – UTF-8 문자열의 배열입니다.

  GetTables 호출에서 반환된 테이블 필드를 지정합니다. 이 파라미터는 빈 목록을 허용하지 않습니다. 요청에는 NAME이(가) 포함되어야 합니다.

  유효한 값 조합은 다음과 같습니다.

  • NAME - 데이터베이스의 모든 테이블 이름.

  • NAME, TABLE_TYPE - 모든 테이블의 이름 및 테이블 유형.

응답

• TableList – 표 객체의 배열입니다.

  요청한 Table 객체의 목록입니다.

• NextToken – UTF-8 문자열입니다.

  현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다.

오류

• EntityNotFoundException

• InvalidInputException

• OperationTimeoutException

• InternalServiceException

• GlueEncryptionException

• FederationSourceException

• FederationSourceRetryableException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• VersionId – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  가져올 테이블 버전의 ID값입니다. VersionID는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다.

응답

• TableVersion – TableVersion 객체입니다.

  요청한 테이블 버전

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• NextToken – UTF-8 문자열입니다.

  이것이 첫 번째 호출이 아니면 지속적인 토큰입니다.

• MaxResults – 1~100의 숫자(정수)입니다.

  한 번의 응답으로 반환될 최대 테이블 버전 수입니다.

응답

• TableVersions – TableVersion 객체의 배열입니다.

  문자열 목록은 지정된 테이블의 사용 가능한 버전을 식별합니다.

• NextToken – UTF-8 문자열입니다.

  사용 가능한 버전 목록이 마지막 버전을 포함하지 않은 경우의 연속 토큰입니다.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• VersionId – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제될 테이블 버전의 ID입니다. VersionID는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다.

응답

• 무응답 파라미터.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

요청

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

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.

• VersionIds – 필수(Required): 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  삭제될 ID 버전 목록입니다. VersionId는 정수의 문자열 표현입니다. 각 버전은 1씩 증가합니다.

응답

• Errors – TableVersionError 객체의 배열입니다.

  지정된 테이블 버전을 삭제하고자 할 때 발생한 오류 목록입니다.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

요청

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

  account_id로 구성된 고유한 식별자입니다.

• NextToken – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.

• Filters – 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 객체의 배열이며 구조는 1개 이하입니다.

  필드 이름을 기준으로 결과를 오름차순 또는 내림차순으로 정렬하는 기준 목록입니다.

• MaxResults – 1~1,000의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 테이블 수.

• ResourceShareType – UTF-8 문자열입니다(유효한 값: FOREIGN | ALL | FEDERATED).

  계정과 공유된 테이블을 검색하도록 지정할 수 있습니다. 허용 가능 값은 FOREIGN 또는 ALL입니다.

  • FOREIGN으로 설정하면 계정과 공유된 테이블이 검색됩니다.

  • ALL로 설정하면 계정과 공유된 테이블과 로컬 계정의 테이블이 검색됩니다.

• IncludeStatusDetails – 부울입니다.

  AWS Glue 데이터 카탈로그 보기를 생성하거나 업데이트하기 위한 요청과 관련된 상태 세부 정보를 포함할지 여부를 지정합니다.

응답

• NextToken – UTF-8 문자열입니다.

  현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다.

• TableList – 표 객체의 배열입니다.

  요청한 Table 객체의 목록입니다. SearchTables 응답은 액세스할 수 있는 테이블만 반환합니다.

오류

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

요청

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

  테이블이 있는 카탈로그 ID입니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 검색하려는 데이터베이스의 이름을 지정합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 검색할 테이블의 이름을 지정합니다.

• NextToken – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.

응답

• PartitionIndexDescriptorList – PartitionIndexDescriptor 객체의 배열입니다.

  인덱스 설명자의 목록입니다.

• NextToken – UTF-8 문자열입니다.

  현재 목록 부분이 유지가 되지 않으면 연속 토큰이 존재합니다.

오류

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

요청

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

  테이블이 있는 카탈로그 ID입니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 생성하려는 데이터베이스의 이름을 지정합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 생성하려는 테이블의 이름을 지정합니다.

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

  PartitionIndex 구조를 지정하여 기존 테이블에 파티션 인덱스를 생성합니다.

응답

• 무응답 파라미터.

오류

• AlreadyExistsException

• InvalidInputException

• EntityNotFoundException

• ResourceNumberLimitExceededException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

요청

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

  테이블이 있는 카탈로그 ID입니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 삭제하려는 데이터베이스의 이름을 지정합니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 삭제하려는 테이블의 이름을 지정합니다.

• IndexName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제할 파티션 인덱스의 이름입니다.

응답

• 무응답 파라미터.

오류

• InternalServiceException

• OperationTimeoutException

• InvalidInputException

• EntityNotFoundException

• ConflictException

• GlueEncryptionException

요청

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

  문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.

• ColumnNames – 필수(Required): 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  열 이름의 목록입니다.

응답

• ColumnStatisticsList – ColumnStatistics 객체의 배열입니다.

  ColumnStatistics 목록입니다.

• Errors – ColumnError 객체의 배열입니다.

  검색에 실패한 ColumnStatistics 목록입니다.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

요청

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

  문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.

• ColumnStatisticsList – 필수(Required): ColumnStatistics 객체의 배열이며 구조는 25개 이하입니다.

  열 통계의 목록입니다.

응답

• Errors – ColumnStatisticsError 객체의 배열입니다.

  ColumnStatisticsErrors의 목록입니다.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException

요청

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

  문제의 파티션이 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.

• DatabaseName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.

• TableName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.

• ColumnName – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  열의 이름입니다.

응답

• 무응답 파라미터.

오류

• EntityNotFoundException

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

• GlueEncryptionException