# 카탈로그 객체 API
<a name="aws-glue-api-catalog"></a>

카탈로그 객체 API는 AWS Glue에서의 카탈로그 작업과 관련된 API 및 데이터 유형에 대해 설명합니다.

**Topics**
+ [카탈로그 API](aws-glue-api-catalog-catalogs.md)
+ [데이터베이스 API](aws-glue-api-catalog-databases.md)
+ [표 API](aws-glue-api-catalog-tables.md)
+ [파티션 API](aws-glue-api-catalog-partitions.md)
+ [연결 API](aws-glue-api-catalog-connections.md)
+ [사용자 정의 함수 API](aws-glue-api-catalog-functions.md)
+ [Athena 카탈로그를 AWS Glue로 가져오기](aws-glue-api-catalog-migration.md)

# 카탈로그 API
<a name="aws-glue-api-catalog-catalogs"></a>

카탈로그 API는 카탈로그 생성, 삭제, 찾기, 업데이트 및 나열을 위한 API를 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-catalogs-objects"></a>
+ [카탈로그 구조](#aws-glue-api-catalog-catalogs-Catalog)
+ [CatalogInput 구조](#aws-glue-api-catalog-catalogs-CatalogInput)
+ [TargetRedshiftCatalog 구조](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
+ [CatalogProperties 구조](#aws-glue-api-catalog-catalogs-CatalogProperties)
+ [CatalogPropertiesOutput 구조](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
+ [DataLakeAccessProperties 구조](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
+ [IcebergOptimizationProperties 구조](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
+ [DataLakeAccessPropertiesOutput 구조](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
+ [IcebergOptimizationPropertiesOutput 구조](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
+ [FederatedCatalog 구조](#aws-glue-api-catalog-catalogs-FederatedCatalog)

## 카탈로그 구조
<a name="aws-glue-api-catalog-catalogs-Catalog"></a>

카탈로그 객체는 AWS Glue Data Catalog 또는 페더레이션 소스에 있는 데이터베이스의 논리적 그룹을 나타냅니다. 이제 Redshift 페더레이션 카탈로그를 생성하거나, 다른 계정 또는 리전의 Redshift 데이터베이스에 대한 리소스 링크가 포함된 카탈로그를 생성할 수 있습니다.

**Fields**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  카탈로그의 ID입니다. 기본 카탈로그에 대한 액세스 권한을 부여하려면 이 필드를 제공해서는 안 됩니다.
+ `Name` – *필수:* [Custom string pattern #25](aws-glue-api-common.md#regex_25)과(와) 일치하는 1\$164바이트 길이의 UTF-8 문자열입니다.

  카탈로그의 이름입니다. 계정 ID와 같을 수 없습니다.
+ `ResourceArn` – UTF-8 문자열입니다.

  카탈로그 리소스에 할당된 Amazon 리소스 이름(ARN)입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  여러 줄로 이루어진 URI 주소 문자열 패턴과 일치하는 2,048바이트 이하 길이의 설명 문자열입니다. 카탈로그에 대한 설명입니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

   카탈로그의 파라미터와 속성을 정의하는 키-값 페어의 맵 배열입니다.
+ `CreateTime` – 타임스탬프입니다.

  카탈로그가 생성된 시간입니다.
+ `UpdateTime` – 타임스탬프입니다.

  카탈로그가 마지막으로 업데이트된 시간입니다.
+ `TargetRedshiftCatalog` – [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog) 객체입니다.

  데이터베이스 리소스 링크에 대한 대상 카탈로그를 설명하는 `TargetRedshiftCatalog` 객체입니다.
+ `FederatedCatalog` – [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog) 객체입니다.

  AWS Glue Data Catalog 외부의 엔터티를 가리키는 `FederatedCatalog` 객체입니다.
+ `CatalogProperties` – [CatalogPropertiesOutput](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput) 객체입니다.

  데이터 레이크 액세스 속성 및 기타 사용자 지정 속성을 지정하는 `CatalogProperties` 객체입니다.
+ `CreateTableDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  `PrincipalPermissions` 객체 어레이. 위탁자에 대한 테이블에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다.
+ `CreateDatabaseDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  `PrincipalPermissions` 객체 어레이. 위탁자에 대한 데이터베이스에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다.
+ `AllowFullTableExternalDataAccess` – UTF-8 문자열입니다(유효한 값: `True` \$1 `False`).

   타사 엔진이 Lake Formation에 등록된 Amazon S3 위치의 데이터에 액세스할 수 있도록 허용합니다.

## CatalogInput 구조
<a name="aws-glue-api-catalog-catalogs-CatalogInput"></a>

카탈로그 속성을 설명하는 구조입니다.

**Fields**
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  여러 줄로 이루어진 URI 주소 문자열 패턴과 일치하는 2,048바이트 이하 길이의 설명 문자열입니다. 카탈로그에 대한 설명입니다.
+ `FederatedCatalog` – [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog) 객체입니다.

  `FederatedCatalog` 객체입니다. AWS Glue Data Catalog 외부의 객체(예: Redshift 데이터베이스)를 참조하는 `FederatedCatalog` 구조입니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  카탈로그의 파라미터와 속성을 정의하는 키-값 페어의 맵 배열입니다.
+ `TargetRedshiftCatalog` – [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog) 객체입니다.

  리소스 링크에 대한 대상 카탈로그를 설명하는 `TargetRedshiftCatalog` 객체입니다.
+ `CatalogProperties` – [CatalogProperties](#aws-glue-api-catalog-catalogs-CatalogProperties) 객체입니다.

  데이터 레이크 액세스 속성 및 기타 사용자 지정 속성을 지정하는 `CatalogProperties` 객체입니다.
+ `CreateTableDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  `PrincipalPermissions` 객체 어레이. 위탁자에 대한 테이블에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. 일반적으로, 빈 목록으로 명시적으로 설정해야 합니다.
+ `CreateDatabaseDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  `PrincipalPermissions` 객체 어레이. 위탁자에 대한 데이터베이스에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. 일반적으로, 빈 목록으로 명시적으로 설정해야 합니다.
+ `AllowFullTableExternalDataAccess` – UTF-8 문자열입니다(유효한 값: `True` \$1 `False`).

   타사 엔진이 Lake Formation에 등록된 Amazon S3 위치의 데이터에 액세스할 수 있도록 허용합니다.

## TargetRedshiftCatalog 구조
<a name="aws-glue-api-catalog-catalogs-TargetRedshiftCatalog"></a>

리소스 링크에 대한 대상 카탈로그를 설명하는 구조입니다.

**Fields**
+ `CatalogArn` – *필수:* UTF-8 문자열입니다.

  카탈로그 리소스의 Amazon 리소스 이름(ARN)입니다.

## CatalogProperties 구조
<a name="aws-glue-api-catalog-catalogs-CatalogProperties"></a>

데이터 레이크 액세스 속성 및 기타 사용자 지정 속성을 지정하는 구조입니다.

**Fields**
+ `DataLakeAccessProperties` – [DataLakeAccessProperties](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties) 객체입니다.

  AWS Glue Data Catalog에서 카탈로그 리소스의 데이터 레이크 액세스를 구성하기 위한 속성을 지정하는 `DataLakeAccessProperties` 객체입니다.
+ `IcebergOptimizationProperties` – [IcebergOptimizationProperties](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties) 객체입니다.

  카탈로그에 대한 Iceberg 테이블 최적화 속성을 지정하는 구조입니다. 여기에는 이 카탈로그의 Iceberg 테이블에 적용 가능한 압축, 보존 및 분리된 파일 삭제 작업의 구성이 포함됩니다.
+ `CustomProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  열 통계 최적화와 같은, 카탈로그의 추가 키-값 속성입니다.

## CatalogPropertiesOutput 구조
<a name="aws-glue-api-catalog-catalogs-CatalogPropertiesOutput"></a>

카탈로그 리소스에 대한 구성 속성을 포함하는 속성 특성입니다.

**Fields**
+ `DataLakeAccessProperties` – [DataLakeAccessPropertiesOutput](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput) 객체입니다.

  AWS Glue Data Catalog에서 카탈로그 리소스의 데이터 레이크 액세스를 구성하기 위한 입력 속성이 있는 `DataLakeAccessProperties` 객체입니다.
+ `IcebergOptimizationProperties` – [IcebergOptimizationPropertiesOutput](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput) 객체입니다.

  압축, 보존 및 분리된 파일 삭제 작업의 구성을 비롯하여 카탈로그에 대한 Iceberg 테이블 최적화 설정을 지정하는 `IcebergOptimizationPropertiesOutput` 객체입니다.
+ `CustomProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  열 통계 최적화와 같은, 카탈로그의 추가 키-값 속성입니다.

## DataLakeAccessProperties 구조
<a name="aws-glue-api-catalog-catalogs-DataLakeAccessProperties"></a>

AWS Glue Data Catalog에서 카탈로그 리소스의 데이터 레이크 액세스를 구성하기 위한 입력 속성입니다.

**Fields**
+ `DataLakeAccess` – 부울입니다.

  Amazon Athena, Amazon EMR, AWS Glue ETL 등 Redshift 이외의 엔진에서 Data Catalog의 Amazon Redshift 데이터베이스에 액세스하는 Apache Spark 애플리케이션의 데이터 레이크 액세스를 활성화하거나 비활성화합니다.
+ `DataTransferRole` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #53](aws-glue-api-common.md#regex_53)

  쿼리 중에 스테이징 안팎으로 데이터를 전송하기 위해 AWS Glue가 수임할 역할입니다.
+ `KmsKey` – UTF-8 문자열입니다.

  카탈로그와 함께 생성되는 스테이징 버킷에 사용할 암호화 키입니다.
+ `CatalogType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  네이티브 카탈로그 리소스의 페더레이션 카탈로그 유형을 지정합니다. 현재 지원되는 유형은 `aws:redshift`입니다.

## IcebergOptimizationProperties 구조
<a name="aws-glue-api-catalog-catalogs-IcebergOptimizationProperties"></a>

압축, 보존 및 분리된 파일 삭제 작업의 구성을 비롯하여 카탈로그에 대한 Iceberg 테이블 최적화 속성을 지정하는 구조입니다.

**Fields**
+ `RoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #53](aws-glue-api-common.md#regex_53)

  Iceberg 테이블 최적화 작업을 수행하기 위해 부여받을 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `Compaction` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  데이터 파일의 레이아웃을 최적화하여 쿼리 성능을 개선하는 Iceberg 테이블 압축 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.
+ `Retention` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  테이블 스냅샷의 수명 주기를 관리하여 스토리지 비용을 최소화하는 Iceberg 테이블 보존 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.
+ `OrphanFileDeletion` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  테이블 메타데이터에서 더 이상 참조하지 않는 파일을 식별하고 제거하는 Iceberg 분리된 파일 삭제 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.

## DataLakeAccessPropertiesOutput 구조
<a name="aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput"></a>

AWS Glue Data Catalog의 카탈로그 리소스에 대한 데이터 레이크 액세스 구성의 출력 속성입니다.

**Fields**
+ `DataLakeAccess` – 부울입니다.

  Data Catalog에서 Amazon Redshift 데이터베이스에 액세스하는 Apache Spark 애플리케이션의 데이터 레이크 액세스를 활성화하거나 비활성화합니다.
+ `DataTransferRole` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #53](aws-glue-api-common.md#regex_53)

  쿼리 중에 스테이징 안팎으로 데이터를 전송하기 위해 AWS Glue가 수임할 역할입니다.
+ `KmsKey` – UTF-8 문자열입니다.

  카탈로그와 함께 생성되는 스테이징 버킷에 사용할 암호화 키입니다.
+ `ManagedWorkgroupName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  카탈로그 리소스에 대해 생성된 관리형 Redshift Serverless 컴퓨팅 이름입니다.
+ `ManagedWorkgroupStatus` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  관리형 Redshift Serverless 컴퓨팅 상태입니다.
+ `RedshiftDatabaseName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  관리형 컴퓨팅의 기본 Redshift 데이터베이스 리소스 이름입니다.
+ `StatusMessage` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  관리형 작업 그룹 상태에 대한 세부 정보를 제공하는 메시지입니다.
+ `CatalogType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  네이티브 카탈로그 리소스의 페더레이션 카탈로그 유형을 지정합니다. 현재 지원되는 유형은 `aws:redshift`입니다.

## IcebergOptimizationPropertiesOutput 구조
<a name="aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput"></a>

AWS Glue Data Catalog의 카탈로그 리소스에 대한 Iceberg 테이블 최적화 구성의 출력 속성이 포함된 구조입니다.

**Fields**
+ `RoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #53](aws-glue-api-common.md#regex_53)

  Iceberg 테이블 최적화 작업을 수행하는 데 사용할 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `Compaction` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  데이터 파일의 레이아웃을 최적화하여 쿼리 성능을 개선하는 Iceberg 테이블 압축 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.
+ `Retention` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  테이블 스냅샷의 수명 주기를 관리하여 스토리지 비용을 최소화하는 Iceberg 테이블 보존 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.
+ `OrphanFileDeletion` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  테이블 메타데이터에서 더 이상 참조하지 않는 파일을 식별하고 제거하는 Iceberg 분리된 파일 삭제 작업의 구성 파라미터를 지정하는 키-값 페어의 맵입니다.
+ `LastUpdatedTime` – 타임스탬프입니다.

  Iceberg 최적화 속성이 마지막으로 업데이트된 시간을 나타내는 타임스탬프입니다.

## FederatedCatalog 구조
<a name="aws-glue-api-catalog-catalogs-FederatedCatalog"></a>

AWS Glue Data Catalog 외부의 엔터티를 가리키는 카탈로그입니다.

**Fields**
+ `Identifier` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  페더레이션 카탈로그의 고유 식별자입니다.
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  Redshift 페더레이션 카탈로그와 같은 외부 데이터 소스에 대한 연결의 이름입니다.
+ `ConnectionType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

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

## 작업
<a name="aws-glue-api-catalog-catalogs-actions"></a>
+ [CreateCatalog 작업(Python: create\$1catalog)](#aws-glue-api-catalog-catalogs-CreateCatalog)
+ [UpdateCatalog 작업(Python: update\$1catalog)](#aws-glue-api-catalog-catalogs-UpdateCatalog)
+ [DeleteCatalog 작업(Python: delete\$1catalog)](#aws-glue-api-catalog-catalogs-DeleteCatalog)
+ [GetCatalog 작업(Python: get\$1catalog)](#aws-glue-api-catalog-catalogs-GetCatalog)
+ [GetCatalogs 작업(Python: get\$1catalogs)](#aws-glue-api-catalog-catalogs-GetCatalogs)

## CreateCatalog 작업(Python: create\$1catalog)
<a name="aws-glue-api-catalog-catalogs-CreateCatalog"></a>

AWS Glue Data Catalog에 새 카탈로그를 생성합니다.

**요청**
+ `Name` – *필수:* [Custom string pattern #25](aws-glue-api-common.md#regex_25)과(와) 일치하는 1\$164바이트 길이의 UTF-8 문자열입니다.

  생성할 카탈로그의 이름입니다.
+ `CatalogInput` – **필수(Required): [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput) 객체입니다.

  카탈로그의 메타데이터를 정의하는 `CatalogInput` 객체입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

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

  50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다. 각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다. 각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다. 카탈로그에 할당하는 태그입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`

## UpdateCatalog 작업(Python: update\$1catalog)
<a name="aws-glue-api-catalog-catalogs-UpdateCatalog"></a>

AWS Glue Data Catalog에서 기존 카탈로그의 속성을 업데이트합니다.

**요청**
+ `CatalogId` – *필수:* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열.

  카탈로그의 ID입니다.
+ `CatalogInput` – **필수(Required): [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput) 객체입니다.

  기존 카탈로그의 새 속성을 지정하는 `CatalogInput` 객체입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`

## DeleteCatalog 작업(Python: delete\$1catalog)
<a name="aws-glue-api-catalog-catalogs-DeleteCatalog"></a>

AWS Glue Data Catalog에서 지정된 카탈로그를 제거합니다.

이 작업을 완료한 후에는 데이터베이스, 테이블(및 테이블에 속하는 모든 테이블 버전과 파티션)은 물론 삭제된 카탈로그에 있는 사용자 정의 함수에 더 이상 액세스하지 못합니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다

관련된 모든 리소스가 즉시 삭제되도록 `DeleteCatalog` 작업을 직접적으로 호출하기 전에 `DeleteTableVersion`(또는 `BatchDeleteTableVersion`), `DeletePartition`(또는 `BatchDeletePartition`), `DeleteTable`(또는 `BatchDeleteTable`), `DeleteUserDefinedFunction` 및 `DeleteDatabase`를 사용하여 카탈로그에 속하는 모든 리소스를 삭제하세요.

**요청**
+ `CatalogId` – *필수:* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열.

  카탈로그의 ID입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `AccessDeniedException`
+ `FederationSourceException`

## GetCatalog 작업(Python: get\$1catalog)
<a name="aws-glue-api-catalog-catalogs-GetCatalog"></a>

가져올 카탈로그의 이름입니다. 모두 소문자여야 합니다.

**요청**
+ `CatalogId` – *필수:* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열.

  카탈로그가 있는 상위 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 번호가 사용됩니다.

**응답**
+ `Catalog` – [카탈로그](#aws-glue-api-catalog-catalogs-Catalog) 객체입니다.

  `Catalog` 객체입니다. AWS Glue Data Catalog에서 지정된 카탈로그의 정의입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetCatalogs 작업(Python: get\$1catalogs)
<a name="aws-glue-api-catalog-catalogs-GetCatalogs"></a>

AWS Glue Data Catalog의 카탈로그에 정의된 모든 카탈로그를 검색합니다. Redshift 페더레이션 카탈로그 사용 사례의 경우, 이 작업은 Redshift 네임스페이스 카탈로그의 Redshift 데이터베이스에 매핑된 카탈로그 목록을 반환합니다.

**요청**
+ `ParentCatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  카탈로그가 있는 상위 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 번호가 사용됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  한 번의 응답으로 반환될 최대 카탈로그 수입니다.
+ `Recursive` – 부울입니다.

  `ParentCatalogId`부터 시작하여 카탈로그 계층 구조 전반의 모든 카탈로그를 나열할지 여부를 나타냅니다. 기본값은 `false`입니다. `true`인 경우 `ParentCatalogID` 계층 구조의 모든 카탈로그 객체가 응답에 열거됩니다.
+ `IncludeRoot` – 부울입니다.

  응답에서 계정 및 리전의 기본 카탈로그를 나열할지 여부를 나타냅니다. 기본값은 `false`입니다. `true` 및 `ParentCatalogId = NULL | AWS Account ID`인 경우 모든 카탈로그와 기본 카탈로그가 응답에 열거됩니다.

  `ParentCatalogId`가 null이 아니고, 이 속성이 `false` 또는 `true`로 전달되면 `InvalidInputException`이 발생합니다.

**응답**
+ `CatalogList` – **필수(Required): [카탈로그](#aws-glue-api-catalog-catalogs-Catalog) 객체의 배열입니다.

  `Catalog` 객체 어레이. 지정된 상위 카탈로그의 `Catalog` 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

# 데이터베이스 API
<a name="aws-glue-api-catalog-databases"></a>

데이터베이스 API는 데이터베이스 데이터 형식을 설명하며, 데이터베이스를 생성, 삭제, 위치 지정, 업데이트 및 목록화하는 API를 포함합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-databases-objects"></a>
+ [데이터베이스 구조](#aws-glue-api-catalog-databases-Database)
+ [DatabaseInput 구조](#aws-glue-api-catalog-databases-DatabaseInput)
+ [PrincipalPermissions 구조](#aws-glue-api-catalog-databases-PrincipalPermissions)
+ [DataLakePrincipal 구조](#aws-glue-api-catalog-databases-DataLakePrincipal)
+ [DatabaseIdentifier 구조](#aws-glue-api-catalog-databases-DatabaseIdentifier)
+ [FederatedDatabase 구조](#aws-glue-api-catalog-databases-FederatedDatabase)

## 데이터베이스 구조
<a name="aws-glue-api-catalog-databases-Database"></a>

`Database` 객체는 Hive 메타스토어 혹은 RDBMS에 있는 테이블의 논리적 그룹을 나타냅니다.

**필드**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터베이스의 이름입니다. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터베이스에 대한 설명입니다.
+ `LocationUri` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 1\$11,024바이트 길이의 URI(Uniform Resource Identifier)입니다.

  데이터베이스의 위치(예: HDFS 경로)입니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 데이터베이스의 파라미터와 속성을 정의합니다.
+ `CreateTime` – 타임스탬프입니다.

  메타 데이터베이스가 카탈로그에 생성된 시간입니다.
+ `CreateTableDefaultPermissions` – [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  보안 주체에 대한 테이블에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다.
+ `TargetDatabase` – [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier) 객체입니다.

  리소스 링크에 대한 대상 데이터베이스를 설명하는 `DatabaseIdentifier` 구조입니다.
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스가 있는 데이터 카탈로그의 ID입니다.
+ `FederatedDatabase` – [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase) 객체입니다.

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

## DatabaseInput 구조
<a name="aws-glue-api-catalog-databases-DatabaseInput"></a>

데이터베이스를 생성 및 업데이트할 때 사용되는 구조입니다.

**필드**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터베이스의 이름입니다. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터베이스에 대한 설명입니다.
+ `LocationUri` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 1\$11,024바이트 길이의 URI(Uniform Resource Identifier)입니다.

  데이터베이스의 위치(예: HDFS 경로)입니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 데이터베이스의 파라미터와 속성을 정의합니다.

  이러한 키-값 쌍은 데이터베이스의 파라미터와 속성을 정의합니다.
+ `CreateTableDefaultPermissions` – [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions) 객체의 배열입니다.

  보안 주체에 대한 테이블에서 기본 권한 세트를 생성합니다. AWS Lake Formation에서 사용됩니다. AWS Glue 작업의 일반적인 과정에서는 사용되지 않습니다.
+ `TargetDatabase` – [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier) 객체입니다.

  리소스 링크에 대한 대상 데이터베이스를 설명하는 `DatabaseIdentifier` 구조입니다.
+ `FederatedDatabase` – [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase) 객체입니다.

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

## PrincipalPermissions 구조
<a name="aws-glue-api-catalog-databases-PrincipalPermissions"></a>

보안 주체에게 부여된 권한입니다.

**필드**
+ `Principal` – [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal) 객체입니다.

  권한을 부여받는 보안 주체입니다.
+ `Permissions` – UTF-8 문자열의 배열입니다.

  보안 주체에게 부여되는 권한입니다.

## DataLakePrincipal 구조
<a name="aws-glue-api-catalog-databases-DataLakePrincipal"></a>

AWS Lake Formation 보안 주체입니다.

**필드**
+ `DataLakePrincipalIdentifier` – 1\$1255바이트 길이의 UTF-8 문자열입니다.

  AWS Lake Formation 보안 주체의 식별자입니다.

## DatabaseIdentifier 구조
<a name="aws-glue-api-catalog-databases-DatabaseIdentifier"></a>

리소스 링크에 대한 대상 데이터베이스를 설명하는 구조입니다.

**필드**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스가 있는 데이터 카탈로그의 ID입니다.
+ `DatabaseName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  카탈로그 데이터베이스의 이름입니다.
+ `Region` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  대상 데이터베이스의 리전입니다.

## FederatedDatabase 구조
<a name="aws-glue-api-catalog-databases-FederatedDatabase"></a>

AWS Glue Data Catalog 외부의 엔터티를 가리키는 데이터베이스입니다.

**필드**
+ `Identifier` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다.

  페더레이션된 데이터베이스의 고유 식별자입니다.
+ `ConnectionName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  외부 메타스토어에 대한 연결 이름입니다.
+ `ConnectionType` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  JDBC, ODBC 또는 기타 지원되는 연결 프로토콜과 같은 페더레이션 데이터베이스 액세스에 사용되는 연결 유형입니다.

## 운영
<a name="aws-glue-api-catalog-databases-actions"></a>
+ [CreateDatabase 작업(Python: create\$1database)](#aws-glue-api-catalog-databases-CreateDatabase)
+ [UpdateDatabase 작업(Python: update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase)
+ [DeleteDatabase 작업(Python: delete\$1database)](#aws-glue-api-catalog-databases-DeleteDatabase)
+ [GetDatabase 작업(Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabase)
+ [GetDatabases 작업(Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabases)

## CreateDatabase 작업(Python: create\$1database)
<a name="aws-glue-api-catalog-databases-CreateDatabase"></a>

데이터 카탈로그에 새로운 데이터베이스를 생성합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스를 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseInput` – *필수(Required):* [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput) 객체입니다.

  데이터베이스의 메타데이터입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

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

  데이터베이스에 할당하는 태그입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## UpdateDatabase 작업(Python: update\$1database)
<a name="aws-glue-api-catalog-databases-UpdateDatabase"></a>

데이터 카탈로그에서 기존 데이터베이스를 업데이트합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  메타데이터 데이터베이스가 있는 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  카탈로그에서 업데이트할 데이터베이스의 이름입니다. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다.
+ `DatabaseInput` – **필수(Required): [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput) 객체입니다.

  `DatabaseInput` 객체는 카탈로그에서 메타데이터 데이터베이스의 새로운 정의를 지정합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`

## DeleteDatabase 작업(Python: delete\$1database)
<a name="aws-glue-api-catalog-databases-DeleteDatabase"></a>

데이터 카탈로그에서 지정된 데이터베이스를 제거합니다.

**참고**  
이 작업을 완료한 후에는 테이블(및 테이블에 속하는 모든 테이블 버전과 파티션)은 물론 삭제된 데이터베이스에 있는 사용자 정의 함수에 더 이상 액세스하지 못합니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다  
관련된 모든 리소스가 즉시 삭제되도록 `DeleteDatabase` 호출 전에 `DeleteTableVersion` 또는 `BatchDeleteTableVersion`, `DeletePartition` 또는 `BatchDeletePartition`, `DeleteUserDefinedFunction` 및 `DeleteTable` 또는 `BatchDeleteTable`를 사용하여 데이터베이스에 속하는 모든 리소스를 삭제하십시오.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스가 있는 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제할 데이터베이스의 이름입니다. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabase 작업(Python: get\$1database)
<a name="aws-glue-api-catalog-databases-GetDatabase"></a>

지정된 데이터베이스의 정의를 검색합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스가 있는 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  검색할 데이터베이스의 이름입니다. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.

**응답**
+ `Database` – [데이터베이스](#aws-glue-api-catalog-databases-Database) 객체입니다.

  데이터 카탈로그에서 지정된 데이터베이스의 정의입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabases 작업(Python: get\$1database)
<a name="aws-glue-api-catalog-databases-GetDatabases"></a>

주어진 데이터 카탈로그에 정의된 모든 데이터베이스를 검색합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  `Databases`를 검색할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

  한 번의 응답으로 반환될 최대 데이터베이스 수입니다.
+ `ResourceShareType` – UTF-8 문자열입니다(유효한 값: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).

  계정과 공유된 데이터베이스를 나열하도록 지정할 수 있습니다. 허용 가능한 값은 `FEDERATED`, `FOREIGN` 또는 `ALL`입니다.
  + `FEDERATED`로 설정하면 계정과 공유된 페더레이션된 데이터베이스(외부 엔터티라고 함)가 나열됩니다.
  + `FOREIGN`으로 설정하면 계정과 공유된 데이터베이스가 나열됩니다.
  + `ALL`로 설정하면 계정과 공유된 데이터베이스와 로컬 계정의 데이터베이스가 나열됩니다.
+ `AttributesToGet` – UTF-8 문자열의 배열입니다.

  `GetDatabases` 호출에서 반환된 데이터베이스 필드를 지정합니다. 이 파라미터는 빈 목록을 허용하지 않습니다. 요청에는 `NAME`이 포함되어야 합니다.

**응답**
+ `DatabaseList` – **필수(Required): [데이터베이스](#aws-glue-api-catalog-databases-Database) 객체의 배열입니다.

  지정된 카탈로그의 `Database` 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

# 표 API
<a name="aws-glue-api-catalog-tables"></a>

테이블 API는 테이블과 관련된 데이터 형식 및 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-tables-objects"></a>
+ [테이블 구조](#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)

## 테이블 구조
<a name="aws-glue-api-catalog-tables-Table"></a>

행과 열에 조직된 관련 데이터 모음을 보여줍니다.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블 이름. 반드시 모두 소문자로 저장하여 Hive 호환성을 유지하도록 합니다.
+ `DatabaseName` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255바이트 길이의 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\$1TABLE  
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\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다.
+ `CreatedBy` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  테이블이 위치한 데이터 카탈로그의 ID입니다.
+ `VersionId` – 과(와) 일치하는 1\$1255바이트 길이의 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 구조
<a name="aws-glue-api-catalog-tables-TableInput"></a>

테이블을 정의하는 데 사용된 구조입니다.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블 이름. 저장될 때 소문자로 저장되어 Hive 호환성을 유지합니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  테이블에 대한 설명입니다.
+ `Owner` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1TABLE  
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\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 테이블과 관련된 속성을 정의합니다.
+ `TargetTable` – [TableIdentifier](#aws-glue-api-catalog-tables-TableIdentifier) 객체입니다.

  리소스 링크에 대한 대상 테이블을 설명하는 `TableIdentifier` 구조입니다.
+ `ViewDefinition` – [ViewDefinitionInput](#aws-glue-api-catalog-tables-ViewDefinitionInput) 객체입니다.

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

## FederatedTable 구조
<a name="aws-glue-api-catalog-tables-FederatedTable"></a>

AWS Glue Data Catalog 외부의 엔터티를 가리키는 테이블입니다.

**Fields**
+ `Identifier` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  페더레이션된 테이블의 고유 식별자입니다.
+ `DatabaseIdentifier` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  페더레이션된 데이터베이스의 고유 식별자입니다.
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  외부 메타스토어에 대한 연결 이름입니다.
+ `ConnectionType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

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

## 열 구조
<a name="aws-glue-api-catalog-tables-Column"></a>

`Table`의 열.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 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\$1255 바이트 길이의 키 문자열입니다.

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

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

## StorageDescriptor 구조
<a name="aws-glue-api-catalog-tables-StorageDescriptor"></a>

테이블 데이터의 물리적 스토리지를 설명합니다.

**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\$1255 바이트 길이의 키 문자열입니다.

  각 값은 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 구조
<a name="aws-glue-api-catalog-tables-SchemaReference"></a>

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\$1100,000의 숫자(정수)입니다.

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

## SerDeInfo 구조
<a name="aws-glue-api-catalog-tables-SerDeInfo"></a>

추출기 및 로더 역할을 하는 직렬화/역직렬화 프로그램(SerDe)에 대한 정보입니다.

**Fields**
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  SerDe의 이름입니다.
+ `SerializationLibrary` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255 바이트 길이의 키 문자열입니다.

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

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

## Order 구조
<a name="aws-glue-api-catalog-tables-Order"></a>

분류된 열의 정렬 순서를 지정합니다.

**Fields**
+ `Column` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  열의 이름입니다.
+ `SortOrder` – *필수(Required):* 1 이하의 숫자(정수)입니다.

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

## SkewedInfo 구조
<a name="aws-glue-api-catalog-tables-SkewedInfo"></a>

테이블에 왜곡된 값을 지정합니다. 왜곡된 값은 매우 높은 빈도를 통해 발생한 값입니다.

**Fields**
+ `SkewedColumnNames` – UTF-8 문자열의 배열입니다.

  왜곡된 값이 포함된 열의 이름 목록입니다.
+ `SkewedColumnValues` – UTF-8 문자열의 배열입니다.

  너무 자주 나타나서 왜곡된 것으로 간주되는 값의 목록입니다.
+ `SkewedColumnValueLocationMaps` – 키-값 페어의 맵 배열입니다.

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

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

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

## TableVersion 구조
<a name="aws-glue-api-catalog-tables-TableVersion"></a>

테이블 버전을 지정합니다.

**Fields**
+ `Table` – [표](#aws-glue-api-catalog-tables-Table) 객체입니다.

  문제의 테이블입니다.
+ `VersionId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

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

## TableError 구조
<a name="aws-glue-api-catalog-tables-TableError"></a>

테이블 작업의 오류 기록.

**Fields**
+ `TableName` – 과(와) 일치하는 1\$1255바이트 길이의 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 구조
<a name="aws-glue-api-catalog-tables-TableVersionError"></a>

테이블 버전 작업의 오류 기록.

**Fields**
+ `TableName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  문제의 테이블 이름입니다.
+ `VersionId` – 과(와) 일치하는 1\$1255바이트 길이의 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 구조
<a name="aws-glue-api-catalog-tables-SortCriterion"></a>

정렬 기준 필드와 정렬 순서를 지정합니다.

**Fields**
+ `FieldName` – 값 문자열입니다(1\$11,024바이트).

  정렬할 필드의 이름입니다.
+ `Sort` – UTF-8 문자열입니다(유효 값: `ASC="ASCENDING"` \$1 `DESC="DESCENDING"`).

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

## TableIdentifier 구조
<a name="aws-glue-api-catalog-tables-TableIdentifier"></a>

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

**Fields**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  테이블이 위치한 데이터 카탈로그의 ID입니다.
+ `DatabaseName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  대상 테이블을 포함하는 카탈로그 데이터베이스의 이름입니다.
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  대상 테이블의 이름입니다.
+ `Region` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

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

## KeySchemaElement 구조
<a name="aws-glue-api-catalog-tables-KeySchemaElement"></a>

이름과 유형으로 구성된 파티션 키 페어입니다.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 키의 이름입니다.
+ `Type` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다.

  파티션 키의 유형입니다.

## PartitionIndex 구조
<a name="aws-glue-api-catalog-tables-PartitionIndex"></a>

파티션 인덱스의 구조입니다.

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

  파티션 인덱스의 키입니다.
+ `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

## PartitionIndexDescriptor 구조
<a name="aws-glue-api-catalog-tables-PartitionIndexDescriptor"></a>

테이블의 파티션 인덱스에 대한 설명자입니다.

**Fields**
+ `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스의 이름입니다.
+ `Keys` – *필수(Required):* [KeySchemaElement](#aws-glue-api-catalog-tables-KeySchemaElement) 객체의 배열로 구조가 1개 이상입니다.

  파티션 인덱스에 대한 하나 이상의 키 목록(`KeySchemaElement` 구조)입니다.
+ `IndexStatus` – *필수(Required):* UTF-8 문자열입니다(유효 값: `CREATING` \$1 `ACTIVE` \$1 `DELETING` \$1 `FAILED`).

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

  가능한 상태는 다음과 같습니다.
  + [생성 중(CREATING)]: 인덱스를 생성 중입니다. 인덱스가 [생성 중(CREATING)] 상태인 경우 인덱스 또는 해당 테이블을 삭제할 수 없습니다.
  + [활성(ACTIVE)]: 인덱스 생성에 성공했습니다.
  + [실패(FAILED)]: 인덱스 생성에 실패했습니다.
  + [삭제 중(DELETING)]: 인덱스 목록에서 인덱스를 삭제합니다.
+ `BackfillErrors` – [BackfillError](#aws-glue-api-catalog-tables-BackfillError) 객체의 배열입니다.

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

## BackfillError 구조
<a name="aws-glue-api-catalog-tables-BackfillError"></a>

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

이러한 오류는 인덱스 등록이 실패한 이유에 대한 세부 정보를 제공하고 응답에 제한된 수의 파티션을 제공하므로 결함이 있는 파티션을 수정하고 인덱스 등록을 다시 시도할 수 있습니다. 발생할 수 있는 가장 일반적인 오류 집합은 다음과 같이 분류됩니다.
+ EncryptedPartitionError: 파티션이 암호화되었습니다.
+ InvalidPartitionTypeDataError: 파티션 값이 해당 파티션 열의 데이터 유형과 일치하지 않습니다.
+ MissingPartitionValueError: 파티션이 암호화되었습니다.
+ UnsupportedPartitionCharacterError: 파티션 값 내의 문자는 지원되지 않습니다. 예: U\$10000 , U\$10001, U\$10002.
+ InternalError: 다른 오류 코드에 속하지 않는 모든 오류입니다.

**Fields**
+ `Code` – UTF-8 문자열입니다(유효한 값: `ENCRYPTED_PARTITION_ERROR` \$1 `INTERNAL_ERROR` \$1 `INVALID_PARTITION_TYPE_DATA_ERROR` \$1 `MISSING_PARTITION_VALUE_ERROR` \$1 `UNSUPPORTED_PARTITION_CHARACTER_ERROR`).

  기존 테이블에 대한 파티션 인덱스를 등록할 때 발생한 오류에 대한 오류 코드입니다.
+ `Partitions` – [PartitionValueList](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList) 객체의 배열입니다.

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

## IcebergInput 구조
<a name="aws-glue-api-catalog-tables-IcebergInput"></a>

카탈로그에서 생성할 Apache Iceberg 메타데이터 테이블을 정의하는 구조입니다.

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

  필수 메타데이터 작업입니다. `CREATE`로만 설정할 수 있습니다.
+ `Version` – 과(와) 일치하는 1\$1255바이트 길이의 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 구조
<a name="aws-glue-api-catalog-tables-OpenTableFormatInput"></a>

오픈 형식 테이블을 나타내는 구조입니다.

**Fields**
+ `IcebergInput` – [IcebergInput](#aws-glue-api-catalog-tables-IcebergInput) 객체입니다.

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

## ViewDefinition 구조
<a name="aws-glue-api-catalog-tables-ViewDefinition"></a>

표현에 대한 세부 정보를 포함하는 구조입니다.

**Fields**
+ `IsProtected` – 부울입니다.

  이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우).
+ `Definer` – 과 일치하는 UTF-8 문자열입니다(20\$12,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\$11,000개입니다.

  표현 목록입니다.

## ViewDefinitionInput 구조
<a name="aws-glue-api-catalog-tables-ViewDefinitionInput"></a>

AWS Glue 뷰를 생성하거나 업데이트하기 위한 세부 정보를 포함하는 구조입니다.

**Fields**
+ `IsProtected` – 부울입니다.

  이 플래그를 true로 설정하면 쿼리 계획 중에 사용자가 제공한 작업을 뷰의 논리적 계획으로 푸시하지 않도록 엔진에 지시할 수 있습니다. 하지만 이 플래그를 설정한다고 해서 엔진이 지시를 따른다는 보장은 없습니다. 제공되는 보장에 대해 알아보려면 엔진 설명서를 참조하세요(있는 경우).
+ `Definer` – 과 일치하는 UTF-8 문자열입니다(20\$12,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\$110개입니다.

  뷰의 언어와 뷰를 정의하는 쿼리를 포함하는 구조의 목록입니다.
+ `SubObjects` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

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

## ViewRepresentation 구조
<a name="aws-glue-api-catalog-tables-ViewRepresentation"></a>

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

**Fields**
+ `Dialect` – UTF-8 문자열입니다(유효한 값: `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  쿼리 엔진의 언어입니다.
+ `DialectVersion` – 1\$1255바이트 길이의 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\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다.
+ `IsStale` – 부울입니다.

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

## ViewRepresentationInput 구조
<a name="aws-glue-api-catalog-tables-ViewRepresentationInput"></a>

Lake Formation 뷰를 업데이트하거나 생성하기 위한 표현의 세부 정보를 포함하는 구조입니다.

**Fields**
+ `Dialect` – UTF-8 문자열입니다(유효한 값: `REDSHIFT` \$1 `ATHENA` \$1 `SPARK`).

  특정 표현의 엔진 유형을 지정하는 파라미터입니다.
+ `DialectVersion` – 1\$1255바이트 길이의 UTF-8 문자열입니다.

  특정 표현의 엔진 버전을 지정하는 파라미터입니다.
+ `ViewOriginalText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다.

  뷰를 설명하는 원본 SQL 쿼리를 나타내는 문자열입니다.
+ `ValidationConnection` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  뷰의 특정 표현을 검증하는 데 사용할 연결의 이름입니다.
+ `ViewExpandedText` – 409,600바이트 이하 길이의 UTF-8 문자열입니다.

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

## UpdateOpenTableFormatInput 구조
<a name="aws-glue-api-catalog-tables-UpdateOpenTableFormatInput"></a>

AWS Glue Data Catalog에서 열린 테이블 형식 테이블을 업데이트하기 위한 입력 파라미터로, Apache Iceberg와 같은 형식별 업데이트 작업의 래퍼 역할을 합니다.

**Fields**
+ `UpdateIcebergInput` – [UpdateIcebergInput](#aws-glue-api-catalog-tables-UpdateIcebergInput) 객체입니다.

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

## UpdateIcebergInput 구조
<a name="aws-glue-api-catalog-tables-UpdateIcebergInput"></a>

AWS Glue Data Catalog의 Apache Iceberg 테이블 업데이트와 관련된 입력 파라미터로, 기존 Iceberg 테이블에 적용할 업데이트 작업을 포함합니다.

**Fields**
+ `UpdateIcebergTableInput` – *필수(Required):* [UpdateIcebergTableInput](#aws-glue-api-catalog-tables-UpdateIcebergTableInput) 객체입니다.

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

## CreateIcebergTableInput 구조
<a name="aws-glue-api-catalog-tables-CreateIcebergTableInput"></a>

테이블 속성 및 메타데이터 사양을 포함하여 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 구조
<a name="aws-glue-api-catalog-tables-UpdateIcebergTableInput"></a>

AWS Glue Data Catalog의 기존 Iceberg 테이블에 적용할 업데이트 작업을 포함하고, 테이블 메타데이터의 새 상태를 정의합니다.

**Fields**
+ `Updates` – **필수(Required): [IcebergTableUpdate](#aws-glue-api-catalog-tables-IcebergTableUpdate) 객체의 배열입니다.

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

## IcebergSortOrder 구조
<a name="aws-glue-api-catalog-tables-IcebergSortOrder"></a>

Iceberg 테이블의 정렬 순서 사양을 정의하여 쿼리 성능 최적화를 위해 파티션 내에서 데이터를 정렬하는 방법을 결정합니다.

**Fields**
+ `OrderId` – **필수(Required): 숫자(정수)입니다.

  Iceberg 테이블의 메타데이터 내에서 이 정렬 순서 사양의 고유 식별자입니다.
+ `Fields` – **필수(Required): [IcebergSortField](#aws-glue-api-catalog-tables-IcebergSortField) 객체의 배열입니다.

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

## IcebergSortField 구조
<a name="aws-glue-api-catalog-tables-IcebergSortField"></a>

소스 필드, 변환, 정렬 방향 및 null 값 순서를 포함하여 Iceberg 정렬 순서 사양 내에서 단일 필드를 정의합니다.

**Fields**
+ `SourceId` – **필수(Required): 숫자(정수)입니다.

  이 정렬 필드의 기반이 되는 테이블 스키마의 소스 필드 식별자입니다.
+ `Transform` – *필수:* UTF-8 문자열입니다.

  정렬 전에 소스 필드에 적용되는 변환 함수(예: identity, bucket, truncate)입니다.
+ `Direction` – *필수:* UTF-8 문자열입니다(유효한 값: `asc="ASC"` \$1 `desc="DESC"`).

  이 필드의 정렬 방향(오름차순 또는 내림차순)입니다.
+ `NullOrder` – *필수:* UTF-8 문자열입니다(유효한 값: `nulls-first="NULLS_FIRST"` \$1 `nulls-last="NULLS_LAST"`).

  이 필드의 null 값에 대한 순서 지정 동작으로, null이 정렬 순서에서 첫 번째 또는 마지막에 나타나야 하는지 여부를 지정합니다.

## IcebergPartitionSpec 구조
<a name="aws-glue-api-catalog-tables-IcebergPartitionSpec"></a>

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

**Fields**
+ `Fields` – **필수(Required): [IcebergPartitionField](#aws-glue-api-catalog-tables-IcebergPartitionField) 객체의 배열입니다.

  소스 필드 및 변환을 포함하여 테이블 데이터가 파티셔닝되는 방법을 정의하는 파티션 필드 목록입니다.
+ `SpecId` - 숫자(정수)입니다.

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

## IcebergPartitionField 구조
<a name="aws-glue-api-catalog-tables-IcebergPartitionField"></a>

소스 필드, 변환 함수, 파티션 이름 및 고유 식별자를 포함하여 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\$11,024바이트 길이의 UTF-8 문자열입니다.

  파티셔닝된 테이블 구조에 표시될 파티션 필드의 이름입니다.
+ `FieldId` - 숫자(정수)입니다.

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

## IcebergSchema 구조
<a name="aws-glue-api-catalog-tables-IcebergSchema"></a>

필드 정의, 데이터 유형 및 스키마 메타데이터를 포함하여 Iceberg 테이블의 스키마 구조를 정의합니다.

**Fields**
+ `SchemaId` - 숫자(정수)입니다.

  Iceberg 테이블의 스키마 진화 기록 내에 있는 이 스키마 버전의 고유 식별자입니다.
+ `IdentifierFieldIds` - 서명된 32비트 정수의 배열입니다.

  테이블의 레코드를 고유하게 식별하는 필드 식별자 목록으로, 행 수준 작업 및 중복 제거에 사용됩니다.
+ `Type` – UTF-8 문자열입니다(유효한 값: `struct="STRUCT"`).

  스키마 구조의 루트 유형으로, 일반적으로 Iceberg 테이블 스키마의 경우 'struct'입니다.
+ `Fields` – **필수(Required): [IcebergStructField](#aws-glue-api-catalog-tables-IcebergStructField) 객체의 배열입니다.

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

## IcebergStructField 구조
<a name="aws-glue-api-catalog-tables-IcebergStructField"></a>

식별자, 이름, 데이터 유형, null 허용 여부 및 문서화를 포함하여 Iceberg 테이블 스키마 내의 단일 필드를 정의합니다.

**Fields**
+ `Id` – **필수(Required): 숫자(정수)입니다.

  Iceberg 테이블 스키마 내에서 이 필드에 할당된 고유 식별자로, 스키마 진화 및 필드 추적에 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$11,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 구조
<a name="aws-glue-api-catalog-tables-IcebergTableUpdate"></a>

스키마 변경, 파티셔닝 수정, 정렬 순서 조정, 위치 업데이트, 속성 변경 등 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 구조
<a name="aws-glue-api-catalog-tables-AuditContext"></a>

Lake Formation 감사 컨텍스트를 포함하는 구조.

**Fields**
+ `AdditionalAuditContext` – UTF-8 문자열입니다(2048바이트 이하).

  추가 감사 컨텍스트 정보가 포함된 문자열.
+ `RequestedColumns` – UTF-8 문자열의 배열입니다.

  감사 요청된 열.
+ `AllColumnsRequested` – 부울입니다.

  모든 열 감사 요청.

## 작업
<a name="aws-glue-api-catalog-tables-actions"></a>
+ [CreateTable 작업(Python: create\$1table)](#aws-glue-api-catalog-tables-CreateTable)
+ [UpdateTable 작업(Python: update\$1table)](#aws-glue-api-catalog-tables-UpdateTable)
+ [DeleteTable 작업(Python: delete\$1table)](#aws-glue-api-catalog-tables-DeleteTable)
+ [BatchDeleteTable 작업(Python: batch\$1delete\$1table)](#aws-glue-api-catalog-tables-BatchDeleteTable)
+ [GetTable 작업(Python: get\$1table)](#aws-glue-api-catalog-tables-GetTable)
+ [GetTables 작업(Python: get\$1tables)](#aws-glue-api-catalog-tables-GetTables)
+ [GetTableVersion 작업(Python: get\$1table\$1version)](#aws-glue-api-catalog-tables-GetTableVersion)
+ [GetTableVersions 작업(Python: get\$1table\$1versions)](#aws-glue-api-catalog-tables-GetTableVersions)
+ [DeleteTableVersion 작업(Python: delete\$1table\$1version)](#aws-glue-api-catalog-tables-DeleteTableVersion)
+ [BatchDeleteTableVersion 작업(Python: batch\$1delete\$1table\$1version)](#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
+ [SearchTables 작업(Python: search\$1tables)](#aws-glue-api-catalog-tables-SearchTables)
+ [GetPartitionIndexes 작업(Python: get\$1partition\$1indexes)](#aws-glue-api-catalog-tables-GetPartitionIndexes)
+ [CreatePartitionIndex 작업(Python: create\$1partition\$1index)](#aws-glue-api-catalog-tables-CreatePartitionIndex)
+ [DeletePartitionIndex 작업(Python: delete\$1partition\$1index)](#aws-glue-api-catalog-tables-DeletePartitionIndex)
+ [GetColumnStatisticsForTable 작업(Python: get\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
+ [UpdateColumnStatisticsForTable 작업(Python: update\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
+ [DeleteColumnStatisticsForTable 작업(Python: delete\$1column\$1statistics\$1for\$1table)](#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)

## CreateTable 작업(Python: create\$1table)
<a name="aws-glue-api-catalog-tables-CreateTable"></a>

데이터 카탈로그에서 새로운 테이블 정의를 생성합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  새로운 테이블을 생성할 카탈로그 데이터베이스입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255바이트 길이의 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\$1table)
<a name="aws-glue-api-catalog-tables-UpdateTable"></a>

데이터 카탈로그에서 메타데이터 테이블을 업데이트합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44)

  테이블 콘텐츠를 업데이트할 트랜잭션 ID입니다.
+ `VersionId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  테이블 콘텐츠를 업데이트할 버전 ID입니다.
+ `ViewUpdateAction` – UTF-8 문자열입니다(유효한 값: `ADD` \$1 `REPLACE` \$1 `ADD_OR_REPLACE` \$1 `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\$1table)
<a name="aws-glue-api-catalog-tables-DeleteTable"></a>

데이터 카탈로그에서 테이블 정의를 제거합니다.

**참고**  
이 작업을 완료하면 삭제된 테이블에 속한 테이블 버전 및 파티션에 더 이상 액세스할 수 없습니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다.  
관련된 모든 리소스가 즉시 삭제되도록 `DeleteTable` 호출 전에 `DeleteTableVersion` 또는 `BatchDeleteTableVersion`과 `DeletePartition` 또는 `BatchDeletePartition`을 사용하여 테이블에 속한 모든 리소스를 삭제하십시오.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 데이터 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제된 테이블 이름. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TransactionId` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1delete\$1table)
<a name="aws-glue-api-catalog-tables-BatchDeleteTable"></a>

한 번에 여러 테이블 삭제

**참고**  
이 작업을 완료하면 삭제된 테이블에 속한 테이블 버전 및 파티션에 더 이상 액세스할 수 없습니다. AWS Glue는 이러한 "분리된" 리소스를 서비스 재량에 따라 적시에 비동기로 삭제합니다.  
관련된 모든 리소스가 즉시 삭제되도록 `BatchDeleteTable` 호출 전에 `DeleteTableVersion` 또는 `BatchDeleteTableVersion`과 `DeletePartition` 또는 `BatchDeletePartition`을 사용하여 테이블에 속한 모든 리소스를 삭제하십시오.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제할 테이블이 있는 카탈로그 데이터베이스의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TablesToDelete` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  삭제할 테이블 목록.
+ `TransactionId` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1table)
<a name="aws-glue-api-catalog-tables-GetTable"></a>

지정된 테이블의 데이터 카탈로그에서 `Table`정의를 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  정의를 가져오는 테이블의 이름입니다. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TransactionId` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1tables)
<a name="aws-glue-api-catalog-tables-GetTables"></a>

주어진 `Database`의 테이블 중 몇 개 혹은 모두의 정의를 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 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\$1100의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 테이블 수.
+ `TransactionId` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1table\$1version)
<a name="aws-glue-api-catalog-tables-GetTableVersion"></a>

테이블의 지정된 버전을 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `VersionId` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1table\$1versions)
<a name="aws-glue-api-catalog-tables-GetTableVersions"></a>

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

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 첫 번째 호출이 아니면 지속적인 토큰입니다.
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

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

**응답**
+ `TableVersions` – [TableVersion](#aws-glue-api-catalog-tables-TableVersion) 객체의 배열입니다.

  문자열 목록은 지정된 테이블의 사용 가능한 버전을 식별합니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteTableVersion 작업(Python: delete\$1table\$1version)
<a name="aws-glue-api-catalog-tables-DeleteTableVersion"></a>

테이블의 지정된 버전을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블의 이름 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `VersionId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeleteTableVersion 작업(Python: batch\$1delete\$1table\$1version)
<a name="aws-glue-api-catalog-tables-BatchDeleteTableVersion"></a>

테이블 버전의 지정된 배치를 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  테이블이 있는 카탈로그의 데이터베이스. 이름은 모두 소문자로 되어 있어야 Hive 호환성을 유지합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 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\$1tables)
<a name="aws-glue-api-catalog-tables-SearchTables"></a>

상위 데이터베이스 뿐만 아니라 테이블 메타데이터의 속성을 기반으로 테이블 집합을 검색합니다. 텍스트 또는 필터 조건으로 검색할 수 있습니다.

Lake Formation에 정의된 보안 정책을 기반으로 액세스할 수 있는 테이블만 가져올 수 있습니다. 테이블이 반환되기 위해서는 최소한 읽기 전용 액세스 권한이 필요합니다. 테이블의 모든 열에 액세스할 수 없으면, 테이블 목록이 다시 반환될 때 이러한 열이 검색되지 않습니다. 열에 액세스할 수 있지만 열의 데이터에는 액세스할 수 없는 경우 해당 열 및 해당 열의 관련 메타데이터가 검색에 포함됩니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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` 필드 값)는 특정 구두점 문자(예: -, :, \$1 등)에서 토큰으로 분할됩니다. 그런 다음 각 토큰은 `PropertyPredicate`의 `Value` 멤버와 정확히 일치합니다. 예를 들어 `Key=Name`과 `Value=link`가 있으면 `customer-link` 및 `xx-link-yy`라는 테이블은 반환되지만 `xxlinkyy`는 반환되지 않는다.
+ `SearchText` – 값 문자열입니다(1\$11,024바이트).

  텍스트 검색에 사용되는 문자열입니다.

  인용 부호로 값을 지정하면, 정확도를 기준으로 필터링합니다.
+ `SortCriteria` – [SortCriterion](#aws-glue-api-catalog-tables-SortCriterion) 객체의 배열이며 구조는 1개 이하입니다.

  필드 이름을 기준으로 결과를 오름차순 또는 내림차순으로 정렬하는 기준 목록입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 테이블 수.
+ `ResourceShareType` – UTF-8 문자열입니다(유효한 값: `FOREIGN` \$1 `ALL` \$1 `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\$1partition\$1indexes)
<a name="aws-glue-api-catalog-tables-GetPartitionIndexes"></a>

테이블과 연결된 파티션 인덱스를 검색합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 검색하려는 데이터베이스의 이름을 지정합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 검색할 테이블의 이름을 지정합니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**응답**
+ `PartitionIndexDescriptorList` – [PartitionIndexDescriptor](#aws-glue-api-catalog-tables-PartitionIndexDescriptor) 객체의 배열입니다.

  인덱스 설명자의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`

## CreatePartitionIndex 작업(Python: create\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-CreatePartitionIndex"></a>

기존 테이블에 지정된 파티션 인덱스를 생성합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 생성하려는 데이터베이스의 이름을 지정합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 생성하려는 테이블의 이름을 지정합니다.
+ `PartitionIndex` – *필수(Required):* [PartitionIndex](#aws-glue-api-catalog-tables-PartitionIndex) 객체입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeletePartitionIndex 작업(Python: delete\$1partition\$1index)
<a name="aws-glue-api-catalog-tables-DeletePartitionIndex"></a>

기존 테이블에서 지정된 파티션 인덱스를 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 삭제하려는 데이터베이스의 이름을 지정합니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 인덱스를 삭제하려는 테이블의 이름을 지정합니다.
+ `IndexName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

**응답**
+ *무응답 파라미터.*

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `GlueEncryptionException`

## GetColumnStatisticsForTable 작업(Python: get\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-GetColumnStatisticsForTable"></a>

열의 테이블 통계를 검색합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `GetTable`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 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\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable"></a>

열의 테이블 통계를 생성하거나 업데이트합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `UpdateTable`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 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\$1column\$1statistics\$1for\$1table)
<a name="aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable"></a>

열의 테이블 통계를 검색합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `DeleteTable`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `ColumnName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  열의 이름입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

# 파티션 API
<a name="aws-glue-api-catalog-partitions"></a>

파티션 API는 파티션을 실행할 데이터 형식 및 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-partitions-objects"></a>
+ [파티션 구조](#aws-glue-api-catalog-partitions-Partition)
+ [PartitionInput 구조](#aws-glue-api-catalog-partitions-PartitionInput)
+ [PartitionSpecWithSharedStorageDescriptor 구조](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
+ [PartitionListComposingSpec 구조](#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
+ [PartitionSpecProxy 구조](#aws-glue-api-catalog-partitions-PartitionSpecProxy)
+ [PartitionValueList 구조](#aws-glue-api-catalog-partitions-PartitionValueList)
+ [세그먼트 구조](#aws-glue-api-catalog-partitions-Segment)
+ [PartitionError 구조](#aws-glue-api-catalog-partitions-PartitionError)
+ [BatchUpdatePartitionFailureEntry 구조](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
+ [BatchUpdatePartitionRequestEntry 구조](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
+ [StorageDescriptor 구조](#aws-glue-api-catalog-partitions-StorageDescriptor)
+ [SchemaReference 구조](#aws-glue-api-catalog-partitions-SchemaReference)
+ [SerDeInfo 구조](#aws-glue-api-catalog-partitions-SerDeInfo)
+ [SkewedInfo 구조](#aws-glue-api-catalog-partitions-SkewedInfo)

## 파티션 구조
<a name="aws-glue-api-catalog-partitions-Partition"></a>

테이블 데이터의 조각을 나타냅니다.

**Fields**
+ `Values` – UTF-8 문자열의 배열입니다.

  파티션 값입니다.
+ `DatabaseName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 생성되는 카탈로그 데이터베이스의 이름입니다.
+ `TableName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 생성되는 데이터베이스 테이블의 이름입니다.
+ `CreationTime` – 타임스탬프입니다.

  파티션이 생성된 시간.
+ `LastAccessTime` – 타임스탬프입니다.

  파티션이 액세스된 마지막 시간.
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) 객체입니다.

  파티션이 저장된 물리적 위치에 대한 정보를 제공합니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 파티션 파라미터를 정의합니다.
+ `LastAnalyzedTime` – 타임스탬프입니다.

  이 파티션을 위해 계산된 열 통계 마지막 시간.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 있는 Data Catalog의 ID입니다.

## PartitionInput 구조
<a name="aws-glue-api-catalog-partitions-PartitionInput"></a>

파티션을 생성 및 업데이트할 때 사용되는 구조입니다.

**Fields**
+ `Values` – UTF-8 문자열의 배열입니다.

  파티션 값입니다. 이 파라미터는 SDK에 필수는 아니지만 유효한 입력을 위해 이 파라미터를 지정해야 합니다.

  새 파티션의 키 값은 Amazon S3 접두사에 표시되는 파티션 키와 동일한 순서로 정렬되어야 하는 문자열 객체의 배열로 전달되어야 합니다. 그렇지 않으면 AWS Glue가 잘못된 키에 값을 추가합니다.
+ `LastAccessTime` – 타임스탬프입니다.

  파티션이 액세스된 마지막 시간.
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) 객체입니다.

  파티션이 저장된 물리적 위치에 대한 정보를 제공합니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  이러한 키-값 쌍은 파티션 파라미터를 정의합니다.
+ `LastAnalyzedTime` – 타임스탬프입니다.

  이 파티션을 위해 계산된 열 통계 마지막 시간.

## PartitionSpecWithSharedStorageDescriptor 구조
<a name="aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor"></a>

물리적 위치를 공유하는 파티션의 파티션 스펙.

**Fields**
+ `StorageDescriptor` – [StorageDescriptor](#aws-glue-api-catalog-partitions-StorageDescriptor) 객체입니다.

  공유된 물리적 스토리지 정보.
+ `Partitions` – [Partition](#aws-glue-api-catalog-partitions-Partition) 객체의 배열입니다.

  이 물리적 위치를 공유하는 파티션 목록.

## PartitionListComposingSpec 구조
<a name="aws-glue-api-catalog-partitions-PartitionListComposingSpec"></a>

관련된 파티션을 나열합니다.

**Fields**
+ `Partitions` – [Partition](#aws-glue-api-catalog-partitions-Partition) 객체의 배열입니다.

  구성 스펙의 파티션 목록.

## PartitionSpecProxy 구조
<a name="aws-glue-api-catalog-partitions-PartitionSpecProxy"></a>

지정된 파티션으로의 루트 경로를 제공합니다.

**Fields**
+ `DatabaseName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 있는 카탈로그 데이터베이스입니다.
+ `TableName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 포함된 테이블의 이름입니다.
+ `RootPath` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 설명되어 있는 프록시 루트 경로.
+ `PartitionSpecWithSharedSD` – [PartitionSpecWithSharedStorageDescriptor](#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor) 객체입니다.

  동일한 스토리지 위치를 공유하는 파티션 스펙.
+ `PartitionListComposingSpec` – [PartitionListComposingSpec](#aws-glue-api-catalog-partitions-PartitionListComposingSpec) 객체입니다.

  파티션 목록을 지정합니다.

## PartitionValueList 구조
<a name="aws-glue-api-catalog-partitions-PartitionValueList"></a>

파티션을 정의하는 값 목록을 포함합니다.

**Fields**
+ `Values` – *필수(Required):* UTF-8 문자열의 배열입니다.

  값 목록.

## 세그먼트 구조
<a name="aws-glue-api-catalog-partitions-Segment"></a>

테이블 파티션의 중첩되지 않은 리전을 정의하여 다양한 요청이 병렬로 실행되도록 허용합니다.

**Fields**
+ `SegmentNumber` – *필수(Required):* None 이하의 숫자(정수)입니다.

  세그먼트의 0 기반 인덱스 숫자입니다. 예를 들어 총 세그먼트 수가 4개인 경우, `SegmentNumber` 값의 범위는 0\$13입니다.
+ `TotalSegments` – *필수(Required):* 1\$110의 숫자(정수)입니다.

  총 세그먼트 수입니다.

## PartitionError 구조
<a name="aws-glue-api-catalog-partitions-PartitionError"></a>

파티션 오류에 관한 정보를 포함합니다.

**Fields**
+ `PartitionValues` – UTF-8 문자열의 배열입니다.

  파티션을 정의하는 값입니다.
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

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

## BatchUpdatePartitionFailureEntry 구조
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry"></a>

배치 업데이트 파티션 오류에 관한 정보를 포함합니다.

**Fields**
+ `PartitionValueList` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  파티션을 정의하는 값의 목록입니다.
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

  배치 업데이트 파티션 오류에 대한 세부 정보입니다.

## BatchUpdatePartitionRequestEntry 구조
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry"></a>

파티션을 업데이트하는 데 사용되는 값과 구조를 포함하는 구조입니다.

**Fields**
+ `PartitionValueList` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  파티션을 정의하는 값의 목록입니다.
+ `PartitionInput` – *필수(Required):* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) 객체입니다.

  파티션을 업데이트할 때 사용되는 구조입니다.

## StorageDescriptor 구조
<a name="aws-glue-api-catalog-partitions-StorageDescriptor"></a>

테이블 데이터의 물리적 스토리지를 설명합니다.

**Fields**
+ `Columns` – [열](aws-glue-api-catalog-tables.md#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-SerDeInfo) 객체입니다.

  직렬화/역직렬화(SerDe) 정보입니다.
+ `BucketColumns` – UTF-8 문자열의 배열입니다.

  테이블의 열, 클러스터링 열 및 버킷 열을 지정하는 그룹화하는 reducer 목록입니다.
+ `SortColumns` – [Order](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order) 객체의 배열입니다.

  테이블에 있는 각 버킷의 정렬 순서를 지정하는 목록입니다.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 키 문자열입니다.

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

  키 값 형식의 사용자 제공 속성입니다.
+ `SkewedInfo` – [SkewedInfo](#aws-glue-api-catalog-partitions-SkewedInfo) 객체입니다.

  열에 자주 표시되는 값에 대한 정보입니다(편향된 값).
+ `StoredAsSubDirectories` – 부울입니다.

  테이블 데이터가 하위 디렉터리에 저장되면 `True`이고 그렇지 않으면 `False`입니다.
+ `SchemaReference` – [SchemaReference](#aws-glue-api-catalog-partitions-SchemaReference) 객체입니다.

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

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

## SchemaReference 구조
<a name="aws-glue-api-catalog-partitions-SchemaReference"></a>

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\$1100,000의 숫자(정수)입니다.

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

## SerDeInfo 구조
<a name="aws-glue-api-catalog-partitions-SerDeInfo"></a>

추출기 및 로더 역할을 하는 직렬화/역직렬화 프로그램(SerDe)에 대한 정보입니다.

**Fields**
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  SerDe의 이름입니다.
+ `SerializationLibrary` – 과(와) 일치하는 1\$1255바이트 길이의 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\$1255 바이트 길이의 키 문자열입니다.

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

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

## SkewedInfo 구조
<a name="aws-glue-api-catalog-partitions-SkewedInfo"></a>

테이블에 왜곡된 값을 지정합니다. 왜곡된 값은 매우 높은 빈도를 통해 발생한 값입니다.

**Fields**
+ `SkewedColumnNames` – UTF-8 문자열의 배열입니다.

  왜곡된 값이 포함된 열의 이름 목록입니다.
+ `SkewedColumnValues` – UTF-8 문자열의 배열입니다.

  너무 자주 나타나서 왜곡된 것으로 간주되는 값의 목록입니다.
+ `SkewedColumnValueLocationMaps` – 키-값 페어의 맵 배열입니다.

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

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

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

## 작업
<a name="aws-glue-api-catalog-partitions-actions"></a>
+ [CreatePartition 작업(Python: create\$1partition)](#aws-glue-api-catalog-partitions-CreatePartition)
+ [BatchCreatePartition 작업(Python: batch\$1create\$1partition)](#aws-glue-api-catalog-partitions-BatchCreatePartition)
+ [UpdatePartition 작업(Python: update\$1partition)](#aws-glue-api-catalog-partitions-UpdatePartition)
+ [DeletePartition 작업(Python: delete\$1partition)](#aws-glue-api-catalog-partitions-DeletePartition)
+ [BatchDeletePartition 작업(Python: batch\$1delete\$1partition)](#aws-glue-api-catalog-partitions-BatchDeletePartition)
+ [GetPartition 작업(Python: get\$1partition)](#aws-glue-api-catalog-partitions-GetPartition)
+ [GetPartitions 작업(Python: get\$1partitions)](#aws-glue-api-catalog-partitions-GetPartitions)
+ [BatchGetPartition 작업(Python: batch\$1get\$1partition)](#aws-glue-api-catalog-partitions-BatchGetPartition)
+ [BatchUpdatePartition 작업(Python: batch\$1update\$1partition)](#aws-glue-api-catalog-partitions-BatchUpdatePartition)
+ [GetColumnStatisticsForPartition 작업(Python: get\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
+ [UpdateColumnStatisticsForPartition 작업(Python: update\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
+ [DeleteColumnStatisticsForPartition 작업(Python: delete\$1column\$1statistics\$1for\$1partition)](#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)

## CreatePartition 작업(Python: create\$1partition)
<a name="aws-glue-api-catalog-partitions-CreatePartition"></a>

새 파티션을 생성합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  파티션이 생성될 카탈로그의 AWS 계정 ID입니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  생성될 파티션이 있는 메타데이터 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  생성될 파티션이 있는 메타데이터 테이블 이름입니다.
+ `PartitionInput` – *필수(Required):* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) 객체입니다.

  `PartitionInput` 구조는 생성될 파티션을 정의합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## BatchCreatePartition 작업(Python: batch\$1create\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchCreatePartition"></a>

배치 작업에서 하나 이상의 파티션을 만듭니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  생성될 파티션이 있는 메타데이터 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  생성될 파티션이 있는 메타데이터 테이블 이름입니다.
+ `PartitionInputList` – *필수(Required):* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) 객체의 배열이며 구조는 100개 이하입니다.

  `PartitionInput` 구조 목록은 생성될 파티션을 정의합니다.

**응답**
+ `Errors` – [PartitionError](#aws-glue-api-catalog-partitions-PartitionError) 객체의 배열입니다.

  요청된 파티션을 생성하고자 할 때 발생한 오류입니다.

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdatePartition 작업(Python: update\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdatePartition"></a>

파티션 업데이트

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 테이블이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트되는 파티션이 있는 테이블 이름입니다.
+ `PartitionValueList` – *필수(Required):* 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  업데이트할 파티션을 정의하는 파티션 키 값 목록입니다.
+ `PartitionInput` – *필수(Required):* [PartitionInput](#aws-glue-api-catalog-partitions-PartitionInput) 객체입니다.

  파티션을 업데이트할 새로운 파티션 객체.

  `Values` 속성을 변경할 수 없습니다. 파티션의 파티션 키 값을 변경하려면 파티션을 삭제하고 다시 생성합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeletePartition 작업(Python: delete\$1partition)
<a name="aws-glue-api-catalog-partitions-DeletePartition"></a>

지정된 파티션을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 테이블이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제될 파티션이 포함된 테이블 이름입니다.
+ `PartitionValues` – *필수(Required):* UTF-8 문자열의 배열입니다.

  파티션을 정의하는 값입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## BatchDeletePartition 작업(Python: batch\$1delete\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchDeletePartition"></a>

배치 작업에서 하나 이상의 파티션을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 테이블이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제될 파티션이 포함된 테이블 이름입니다.
+ `PartitionsToDelete` – *필수(Required):* [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) 객체의 배열이며 구조는 25개 이하입니다.

  `PartitionInput` 구조 목록은 삭제되는 파티션을 정의합니다.

**응답**
+ `Errors` – [PartitionError](#aws-glue-api-catalog-partitions-PartitionError) 객체의 배열입니다.

  요청된 파티션을 삭제하고자 할 때 발생한 오류입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetPartition 작업(Python: get\$1partition)
<a name="aws-glue-api-catalog-partitions-GetPartition"></a>

지정된 파티션에 대한 정보를 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `PartitionValues` – *필수(Required):* UTF-8 문자열의 배열입니다.

  파티션을 정의하는 값입니다.

**응답**
+ `Partition` – [Partition](#aws-glue-api-catalog-partitions-Partition) 객체입니다.

  `Partition` 객체의 형식으로 요청된 정보입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetPartitions 작업(Python: get\$1partitions)
<a name="aws-glue-api-catalog-partitions-GetPartitions"></a>

테이블의 파티션에 대한 정보를 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `Expression` – 과(와) 일치하는 2,048바이트 이하 길이의 조건자 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  반환할 파티션을 필터링하는 표현식입니다.

  이 표현식은 SQL `WHERE` 필터 절과 유사한 SQL 구문을 사용합니다. SQL 문 파서 [JSQLParser](http://jsqlparser.sourceforge.net/home.php)는 이 표현식을 구문 분석합니다.

  *연산자*: 다음은 `Expression` API 호출에서 사용할 수 있는 연산자입니다.  
=  
두 피연산자의 값이 동일한지 여부를 확인하고, 동일한 경우에는 이 조건이 true가 됩니다.  
예제: '변수 a'에는 10이 들어 있고 '변수 b'에는 20이 들어 있다고 가정해 보겠습니다.  
(a = b)는 true가 아닙니다.  
< >  
두 피연산자의 값이 동일한지 여부를 확인하고, 값이 동일하지 않으면 이 조건이 true가 됩니다.  
예제: (a < > b)는 true입니다.  
>  
왼쪽 피연산자의 값이 오른쪽 피연산자의 값보다 큰지 여부를 확인하고, 크면 이 조건이 true가 됩니다.  
예제: (a > b)는 true가 아닙니다.  
<  
왼쪽 피연산자의 값이 오른쪽 피연산자의 값보다 작은지 여부를 확인하고, 크면 이 조건이 true가 됩니다.  
예제: (a < b)는 true입니다.  
>=  
왼쪽 피연산자의 값이 오른쪽 피연산자의 값보다 크거나 같은지 여부를 확인하고, 크거나 같으면 이 조건이 true가 됩니다.  
예제: (a >= b)는 true가 아닙니다.  
<=  
왼쪽 피연산자의 값이 오른쪽 피연산자의 값보다 작거나 같은지 여부를 확인하고, 작거나 같으면 이 조건이 true가 됩니다.  
예제: (a <= b)는 true입니다.  
AND, OR, IN, BETWEEN, LIKE, NOT, IS NULL  
논리 연산자

  *지원되는 파티션 키 유형*: 다음은 지원되는 파티션 키입니다.
  + `string`
  + `date`
  + `timestamp`
  + `int`
  + `bigint`
  + `long`
  + `tinyint`
  + `smallint`
  + `decimal`

  유효하지 않은 유형이 있으면 예외가 발생합니다.

  다음 목록에는 각 유형에 대한 유효 연산자가 표시됩니다. 크롤러를 정의할 때 `partitionKey` 유형이 카탈로그 파티션과 호환될 `STRING`으로 생성됩니다.

  *단순 API 호출*:   
**Example**  

  `twitter_partition` 표에는 파티션 세 개가 있습니다.

  ```
  year = 2015
          year = 2016
          year = 2017
  ```  
**Example**  

  Get partition `year`가 2015와 같음

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year*=*'2015'"
  ```  
**Example**  

  Get Partition `year`가 2016\$12018(제외)

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>'2016' AND year<'2018'"
  ```  
**Example**  

  Get Partition `year`가 2015\$12018(포함) 다음 API 호출은 서로에 상응합니다.

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year>='2015' AND year<='2018'"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year BETWEEN 2015 AND 2018"
          
          aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year IN (2015,2016,2017,2018)"
  ```  
**Example**  

  와일드카드 파티션 필터. 여기서는 다음 호출 출력이 partition year=2017입니다. 정규식은 `LIKE`에서 지원되지 않습니다.

  ```
  aws glue get-partitions --database-name dbname --table-name twitter_partition 
          --expression "year LIKE '%7'"
  ```
+ `NextToken` – UTF-8 문자열입니다.

  이것이 파티션을 가져오기 위한 첫 번째 호출이 아니면 지속적인 토큰입니다.
+ `Segment` – [Segment](#aws-glue-api-catalog-partitions-Segment) 객체입니다.

  이 요청에 따라 스캔할 테이블 파티션의 세그먼트입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 파티션 수.
+ `ExcludeColumnSchema` – 부울입니다.

  true이면 파티션 열 스키마를 반환하지 않도록 지정합니다. 파티션 값이나 위치와 같은 다른 파티션 속성에만 관심이 있을 때 유용합니다. 이 접근 방식을 사용하면 중복 데이터가 반환되지 않으므로 큰 응답 문제를 피할 수 있습니다.
+ `TransactionId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #44](aws-glue-api-common.md#regex_44)

  파티션 콘텐츠를 읽을 트랜잭션 ID입니다.
+ `QueryAsOfTime` – 타임스탬프입니다.

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

**응답**
+ `Partitions` – [Partition](#aws-glue-api-catalog-partitions-Partition) 객체의 배열입니다.

  요청된 파티션 목록.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 파티션 목록에 마지막 항목이 포함되지 않은 경우의 연속 토큰입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `ResourceNotReadyException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchGetPartition 작업(Python: batch\$1get\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchGetPartition"></a>

배치 요청에 따라 파티션을 가져옵니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `PartitionsToGet` – *필수(Required):* [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) 객체의 배열이며 구조는 1,000개 이하입니다.

  파티션 값의 목록은 가져올 파텨션을 식별합니다.

**응답**
+ `Partitions` – [Partition](#aws-glue-api-catalog-partitions-Partition) 객체의 배열입니다.

  요청한 파티션의 목록입니다.
+ `UnprocessedKeys` – [PartitionValueList](#aws-glue-api-catalog-partitions-PartitionValueList) 객체의 배열이며 구조는 1,000개 이하입니다.

  파티션이 반환되지 않은 요청의 파티션 값 목록입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`
+ `InvalidStateException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## BatchUpdatePartition 작업(Python: batch\$1update\$1partition)
<a name="aws-glue-api-catalog-partitions-BatchUpdatePartition"></a>

배치 작업에서 하나 이상의 파티션을 업데이트합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트될 파티션이 있는 메타데이터 데이터베이스의 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트될 파티션이 있는 메타데이터 테이블의 이름입니다.
+ `Entries` – *필수(Required):* [BatchUpdatePartitionRequestEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry) 객체의 배열이며 구조는 1\$1100개입니다.

  업데이트할 최대 100개의 `BatchUpdatePartitionRequestEntry` 객체 목록입니다.

**응답**
+ `Errors` – [BatchUpdatePartitionFailureEntry](#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry) 객체의 배열입니다.

  요청된 파티션을 업데이트하고자 할 때 발생한 오류입니다. `BatchUpdatePartitionFailureEntry` 객체의 목록.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

## GetColumnStatisticsForPartition 작업(Python: get\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition"></a>

열의 파티션 통계를 검색합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `GetPartition`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `PartitionValues` – *필수(Required):* 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) 객체의 배열입니다.

  열 통계 데이터를 검색하는 동안 오류가 발생했습니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## UpdateColumnStatisticsForPartition 작업(Python: update\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition"></a>

열의 파티션 통계를 생성하거나 업데이트합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `UpdatePartition`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `PartitionValues` – *필수(Required):* 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) 객체의 배열입니다.

  열 통계 데이터를 업데이트하는 동안 오류가 발생했습니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteColumnStatisticsForPartition 작업(Python: delete\$1column\$1statistics\$1for\$1partition)
<a name="aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition"></a>

열의 파티션 열 통계를 삭제합니다.

이 작업에 필요한 Identity and Access Management(IAM) 권한은 `DeletePartition`입니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 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\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션이 있는 카탈로그 데이터베이스 이름입니다.
+ `TableName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  파티션 테이블의 이름입니다.
+ `PartitionValues` – *필수(Required):* UTF-8 문자열의 배열입니다.

  파티션을 식별하는 파티션 값의 목록입니다.
+ `ColumnName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  열의 이름입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

# 연결 API
<a name="aws-glue-api-catalog-connections"></a>

연결 API는 AWS Glue에서의 연결 작업과 관련된 API 및 데이터 유형에 대해 설명합니다.

**Topics**
+ [연결 API](aws-glue-api-catalog-connections-connections.md)
+ [연결 유형 API](aws-glue-api-catalog-connections-connections-type.md)
+ [연결 메타데이터 및 미리 보기 API](aws-glue-api-catalog-connections-connections-metadata.md)

# 연결 API
<a name="aws-glue-api-catalog-connections-connections"></a>

연결 API는 AWS Glue 연결 데이터 유형과 연결을 생성, 삭제, 업데이트 및 나열하기 위한 API에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-connections-connections-objects"></a>
+ [연결 구조](#aws-glue-api-catalog-connections-connections-Connection)
+ [ConnectionInput 구조](#aws-glue-api-catalog-connections-connections-ConnectionInput)
+ [TestConnectionInput 구조](#aws-glue-api-catalog-connections-connections-TestConnectionInput)
+ [PhysicalConnectionRequirements 구조](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
+ [GetConnectionsFilter 구조](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
+ [AuthenticationConfiguration 구조](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
+ [AuthenticationConfigurationInput 구조](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
+ [OAuth2Properties 구조](#aws-glue-api-catalog-connections-connections-OAuth2Properties)
+ [OAuth2PropertiesInput 구조](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
+ [OAuth2ClientApplication 구조](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
+ [AuthorizationCodeProperties 구조](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
+ [BasicAuthenticationCredentials 구조](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
+ [OAuth2Credentials 구조](#aws-glue-api-catalog-connections-connections-OAuth2Credentials)

## 연결 구조
<a name="aws-glue-api-catalog-connections-connections-Connection"></a>

데이터 원본으로 연결을 정의합니다.

**Fields**
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 정의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  연결에 대한 설명입니다.
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형입니다. 현재 SFTP는 지원되지 않습니다.
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.
+ `ConnectionProperties` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다(유효한 값: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이러한 키-값 페어는 버전 1 연결 스키마를 사용할 때 연결에 대한 파라미터를 정의합니다.
  + `HOST` - 호스트 URI: 데이터베이스 호스트의 IPv4 주소 또는 FQDN(fully qualified domain name: 정규화된 도메인 이름).
  + `PORT` - 데이터베이스 호스트가 데이터베이스 연결을 수신 중인 포트의 포트 번호(1,024\$165,535)입니다.
  + `USER_NAME`- 데이터베이스에 로그인할 이름. `USER_NAME`의 값 문자열은 "`USERNAME`"입니다.
  + `PASSWORD`- 사용자 이름에 해당하는 암호(사용할 경우).
  + `ENCRYPTED_PASSWORD` - 데이터 카탈로그 암호화 설정에서 `ConnectionPasswordEncryption`을 설정하여 연결 암호 보호를 활성화하면 이 필드가 암호화된 암호를 저장합니다.
  + `JDBC_DRIVER_JAR_URI` - 사용할 JDBC 드라이버가 포함된 JAR 파일의 Amazon Simple Storage Service(Amazon S3) 경로.
  + `JDBC_DRIVER_CLASS_NAME`- 사용할 JDBC 드라이버의 클래스 이름.
  + `JDBC_ENGINE`- 사용할 JDBC 엔진의 이름.
  + `JDBC_ENGINE_VERSION` - 사용할 JDBC 엔진의 버전.
  + `CONFIG_FILES` - (추후 사용 예약.)
  + `INSTANCE_ID`- 사용할 인스턴스 ID.
  + `JDBC_CONNECTION_URL` - JDBC 데이터 원본에 연결하기 위한 URL입니다.
  + `JDBC_ENFORCE_SSL` - 호스트 이름이 일치하는 SSL(Secure Sockets Layer)을 클라이언트의 JDBC 연결용으로 적용할지 여부를 지정하는, 대소문자 구분이 없는 부울 문자열(true, false)입니다. 기본값은 false입니다.
  + `CUSTOM_JDBC_CERT` - 고객의 루트 인증서를 지정하는 Amazon S3 위치입니다. AWS Glue는 이 루트 인증서를 사용하여 고객 데이터베이스에 연결할 때 고객의 인증서를 검증합니다. AWS Glue는 X.509 인증서만 처리합니다. 인증서는 DER로 인코딩되어 Base64 인코딩 PEM 형식으로 제공되어야 합니다.
  + `SKIP_CUSTOM_JDBC_CERT_VALIDATION` - 기본적으로 `false`입니다. AWS Glue는 고객 인증서의 서명 알고리즘 및 주제 퍼블릭 키 알고리즘을 검증합니다. 서명 알고리즘에 허용되는 유일한 알고리즘은 SHA256withRSA, SHA384withRSA 또는 SHA512withRSA. 주제 퍼블릭 키 알고리즘의 경우, 키 길이는 2048 이상이어야 합니다. 이 속성 값을 `true`로 설정하여 AWS Glue의 고객 인증서 검증을 건너뛸 수 있습니다.
  + `CUSTOM_JDBC_CERT_STRING` - 중간자 (man-in-the-middle) 공격을 방지하기 위해 도메인 일치 또는 고유 이름 일치에 사용되는 사용자 지정 JDBC 인증서 문자열입니다. Oracle Database에서는 `SSL_SERVER_CERT_DN`으로, Microsoft SQL Server에서는 `hostNameInCertificate`로 사용됩니다.
  + `CONNECTION_URL` - 일반(비JDBC) 데이터 원본에 연결하기 위한 URL입니다.
  + `SECRET_ID` - 자격 증명의 보안 관리자에 사용되는 보안 암호 ID입니다.
  + `CONNECTOR_URL` - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 URL입니다.
  + `CONNECTOR_TYPE` - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 유형입니다.
  + `CONNECTOR_CLASS_NAME` - MARKETPLACE 또는 CUSTOM 연결을 위한 커넥터 클래스 이름입니다.
  + `KAFKA_BOOTSTRAP_SERVERS` - Kafka 클라이언트에서 연결하고 자체 부트스트랩하는 Kafka 클러스터에 있는 Apache Kafka 브로커의 주소입니다 호스트 및 포트 쌍의 쉼표로 구분된 목록입니다.
  + `KAFKA_SSL_ENABLED` - Apache Kafka 연결에서 SSL을 사용할지 아니면 사용 중지할지 여부입니다. 기본값은 "true"입니다.
  + `KAFKA_CUSTOM_CERT` - 프라이빗 CA 인증서 파일(.pem 포맷)의 Amazon S3 URL입니다. 기본값은 빈 문자열입니다.
  + `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` - CA 인증서 파일의 검증을 건너뛸지 여부입니다. AWS Glue는 SHA256withRSA, SHA384withRSA 및 SHA512withRSA의 세 가지 알고리즘에 대해 검증합니다. 기본값은 "false"입니다.
  + `KAFKA_CLIENT_KEYSTORE` - Kafka 클라이언트 측 인증을 위한 클라이언트 키 스토어 파일의 Amazon S3 위치입니다(선택 사항).
  + `KAFKA_CLIENT_KEYSTORE_PASSWORD` - 제공된 키 스토어에 액세스하기 위한 암호입니다(선택 사항).
  + `KAFKA_CLIENT_KEY_PASSWORD` - 키 스토어는 여러 키로 구성 될 수 있으므로 Kafka 서버 측 키와 함께 사용할 클라이언트 키에 액세스하기 위한 암호입니다(선택 사항).
  + `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` - Kafka 클라이언트 키 스토어 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` - Kafka 클라이언트 키 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `KAFKA_SASL_MECHANISM` - `"SCRAM-SHA-512"`, `"GSSAPI"`, `"AWS_MSK_IAM"` 또는 `"PLAIN"`. 다음은 지원되는 [SASL 메커니즘](https://www.iana.org/assignments/sasl-mechanisms/sasl-mechanisms.xhtml)입니다.
  + `KAFKA_SASL_PLAIN_USERNAME` - "PLAIN" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.
  + `KAFKA_SASL_PLAIN_PASSWORD` - "PLAIN" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다.
  + `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` - Kafka SASL PLAIN 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `KAFKA_SASL_SCRAM_USERNAME` - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 사용자 이름입니다.
  + `KAFKA_SASL_SCRAM_PASSWORD` - "SCRAM-SHA-512" 메커니즘으로 인증하는 데 사용되는 일반 텍스트 암호입니다.
  + `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` - Kafka SASL SCRAM 암호의 암호화된 버전입니다(사용자가 AWS Glue 암호 암호화 설정을 선택한 경우).
  + `KAFKA_SASL_SCRAM_SECRETS_ARN` - AWS Secrets Manager에서 보안 암호의 Amazon 리소스 이름(ARN)입니다.
  + `KAFKA_SASL_GSSAPI_KEYTAB` - Kerberos `keytab` 파일의 S3 위치입니다. keytab은 하나 이상의 보안 주체에 대한 장기 키를 저장합니다. 자세한 내용은 [MIT Kerberos Documentation: Keytab](https://web.mit.edu/kerberos/krb5-latest/doc/basic/keytab_def.html)(MIT Kerberos 설명서: Keytab)을 참조하세요.
  + `KAFKA_SASL_GSSAPI_KRB5_CONF` - Kerberos `krb5.conf` 파일의 S3 위치입니다. krb5.conf는 KDC 서버의 위치와 같은 Kerberos 구성 정보를 저장합니다. 자세한 내용은 [MIT Kerberos Documentation: krb5.conf](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)(MIT Kerberos 설명서: krb5.conf)를 참조하세요.
  + `KAFKA_SASL_GSSAPI_SERVICE` - [Kafka 구성](https://kafka.apache.org/documentation/#brokerconfigs_sasl.kerberos.service.name)에서 `sasl.kerberos.service.name`으로 설정된 Kerberos 서비스 이름입니다.
  + `KAFKA_SASL_GSSAPI_PRINCIPAL` - 에서 사용하는 Kerberos 보안 주체의 이름입니다.AWS Glue 자세한 내용은 [Kafka Documentation: Configuring Kafka Brokers](https://kafka.apache.org/documentation/#security_sasl_kerberos_clientconfig)(Kafka 설명서: Kafka 브로커 구성)를 참조하세요.
  + `ROLE_ARN` - 쿼리를 실행하는 데 사용할 역할.
  + `REGION` - 쿼리를 실행할 AWS 리전.
  + `WORKGROUP_NAME` - 쿼리가 실행되는 Amazon Redshift Serverless 작업 그룹 또는 Amazon Athena 작업 그룹의 이름.
  + `CLUSTER_IDENTIFIER` - 쿼리가 실행되는 Amazon Redshift 클러스터의 클러스터 식별자.
  + `DATABASE` - 연결하려는 Amazon Redshift 데이터베이스.
+ `SparkProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `AthenaProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) 객체입니다.

  Virtual Private Cloud(VPC) 및 `SecurityGroup`과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 연결 정의가 생성된 시간의 타임스탬프입니다.
+ `LastUpdatedTime` – 타임스탬프입니다.

  이 연결 정의가 업데이트된 마지막 시간의 타임스탬프입니다.
+ `LastUpdatedBy` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 연결 정의를 마지막으로 업데이트한 사용자, 그룹 혹은 역할입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  연결 상태입니다. `READY`, `IN_PROGRESS` 또는 `FAILED` 중 하나일 수 있습니다.
+ `StatusReason` – UTF-8 문자열입니다(1\$116384바이트).

  연결 상태의 이유입니다.
+ `LastConnectionValidationTime` – 타임스탬프입니다.

  이 연결이 마지막으로 검증된 시간의 타임스탬프입니다.
+ `AuthenticationConfiguration` – [AuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration) 객체입니다.

  연결의 인증 속성입니다.
+ `ConnectionSchemaVersion` - 1 이상 2 이하의 숫자(정수)입니다.

  이 연결에 대한 연결 스키마의 버전입니다. 버전 2는 특정 컴퓨팅 환경에 대한 속성을 지원합니다.
+ `CompatibleComputeEnvironments` – UTF-8 문자열의 배열입니다.

  연결과 호환되는 컴퓨팅 환경 목록입니다.

## ConnectionInput 구조
<a name="aws-glue-api-catalog-connections-connections-ConnectionInput"></a>

생성 혹은 업데이트를 위한 연결을 지정할 때 사용되는 구조입니다.

**Fields**
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  연결의 이름입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  연결에 대한 설명입니다.
+ `ConnectionType` – *필수:* UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형입니다. 현재 이러한 유형이 지원됩니다.
  + `JDBC` - JDBC(Java Database Connectivity)를 통해 데이터베이스에 대한 연결을 지정합니다.

    `JDBC` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `JDBC_CONNECTION_URL` 또는 (`HOST`, `PORT`, `JDBC_ENGINE`) 모두.
    + 필수 항목: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
    + 선택 사항: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. 이러한 파라미터는 JDBC로 SSL을 구성하는 데 사용됩니다.
  + `KAFKA` - Apache Kafka 스트리밍 플랫폼에 대한 연결을 지정합니다.

    `KAFKA` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `KAFKA_BOOTSTRAP_SERVERS`.
    + 선택 사항: `KAFKA_SSL_ENABLED`, `KAFKA_CUSTOM_CERT`, `KAFKA_SKIP_CUSTOM_CERT_VALIDATION`. 이러한 파라미터는 `KAFKA`로 SSL을 구성하는 데 사용됩니다.
    + 선택 사항: `KAFKA_CLIENT_KEYSTORE`, `KAFKA_CLIENT_KEYSTORE_PASSWORD`, `KAFKA_CLIENT_KEY_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD`, `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD`. 이러한 파라미터는 `KAFKA`에서 SSL로 TLS 클라이언트 구성을 지정하는 데 사용됩니다.
    + 선택 사항: `KAFKA_SASL_MECHANISM`. `SCRAM-SHA-512`, `GSSAPI` 또는 `AWS_MSK_IAM`으로 지정할 수 있습니다.
    + 선택 사항: `KAFKA_SASL_SCRAM_USERNAME`, `KAFKA_SASL_SCRAM_PASSWORD`, `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD`. 이러한 파라미터는 `KAFKA`로 SASL/SCRAM-SHA-512 인증을 구성하는 데 사용됩니다.
    + 선택 사항: `KAFKA_SASL_GSSAPI_KEYTAB`, `KAFKA_SASL_GSSAPI_KRB5_CONF`, `KAFKA_SASL_GSSAPI_SERVICE`, `KAFKA_SASL_GSSAPI_PRINCIPAL`. 이러한 파라미터는 `KAFKA`로 SASL/GSSAPI 인증을 구성하는 데 사용됩니다.
  + `MONGODB` - MongoDB 문서 데이터베이스에 대한 연결을 지정합니다.

    `MONGODB` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `CONNECTION_URL`.
    + 필수 항목: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
  + `VIEW_VALIDATION_REDSHIFT` - Amazon Redshift에서 보기 검증에 사용되는 연결을 지정합니다.
  + `VIEW_VALIDATION_ATHENA` - Amazon Athena에서 보기 검증에 사용되는 연결을 지정합니다.
  + `NETWORK` - Amazon Virtual Private Cloud(Amazon VPC) 환경 내의 데이터 원본에 대한 네트워크 연결을 지정합니다.

    `NETWORK` 연결에는 ConnectionParameters가 필요하지 않습니다. 대신 PhysicalConnectionRequirements를 제공합니다.
  + `MARKETPLACE` - AWS Marketplace에서 구입한 커넥터에 포함된 구성 설정을 사용하여 AWS Glue에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 씁니다.

    `MARKETPLACE` 연결은 다음 ConnectionParameters를 사용합니다.
    + 필수 항목: `CONNECTOR_TYPE`, `CONNECTOR_URL`, `CONNECTOR_CLASS_NAME`, `CONNECTION_URL`.
    + `JDBC` `CONNECTOR_TYPE` 연결에 필요: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
  + `CUSTOM` - 에서 기본적으로 지원하지 않는 데이터 스토어에서 읽고 쓰기 위해 사용자 정의 커넥터에 포함된 구성 설정을 사용합니다.AWS Glue

  특정 커넥터에 필요한 연결 파라미터에 대한 자세한 내용은 AWS Glue 사용 설명서의 [AWS Glue 연결 추가](https://docs.aws.amazon.com/glue/latest/dg/console-connections.html)에서 커넥터에 대한 설명서를 참조하세요.

  `SFTP`는 지원되지 않습니다.

  선택적 ConnectionProperties를 사용하여 AWS Glue의 기능을 구성하는 방법에 대한 자세한 내용을 알아보려면 [AWS Glue 연결 속성](https://docs.aws.amazon.com/glue/latest/dg/connection-defining.html)을 참조하세요.

  선택적 ConnectionProperties를 사용하여 AWS Glue Studio의 기능을 구성하는 방법에 대한 자세한 내용을 알아보려면 [커넥터 및 연결 사용](https://docs.aws.amazon.com/glue/latest/ug/connectors-chapter.html)을 참조하세요.
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  이 연결을 선택할 때 사용할 수 있는 기준입니다.
+ `ConnectionProperties` – *필수(Required):* 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다(유효한 값: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이러한 키-값 쌍은 연결용 파라미터를 정의합니다.
+ `SparkProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `AthenaProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PhysicalConnectionRequirements` – [PhysicalConnectionRequirements](#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements) 객체입니다.

  Virtual Private Cloud(VPC) 및 `SecurityGroup`과 같이 이 연결을 설정하는 데 필요한 물리적 연결 요구 사항입니다.
+ `AuthenticationConfiguration` – [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput) 객체입니다.

  연결의 인증 속성입니다.
+ `ValidateCredentials` – 부울입니다.

  연결 생성 중에 자격 증명을 검증하기 위한 플래그입니다. 기본값은 true입니다.
+ `ValidateForComputeEnvironments` – UTF-8 문자열의 배열입니다.

  지정된 연결 속성을 검증하는 데 기준이 되는 컴퓨팅 환경입니다.

## TestConnectionInput 구조
<a name="aws-glue-api-catalog-connections-connections-TestConnectionInput"></a>

서비스에 대한 연결 테스트를 지정할 때 사용되는 구조입니다.

**Fields**
+ `ConnectionType` – *필수:* UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  테스트할 연결의 유형입니다. 이 작업은 `JDBC` 또는 `SALESFORCE` 연결 유형에만 사용할 수 있습니다.
+ `ConnectionProperties` – *필수(Required):* 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다(유효한 값: `HOST` \$1 `PORT` \$1 `USERNAME="USER_NAME"` \$1 `PASSWORD` \$1 `ENCRYPTED_PASSWORD` \$1 `JDBC_DRIVER_JAR_URI` \$1 `JDBC_DRIVER_CLASS_NAME` \$1 `JDBC_ENGINE` \$1 `JDBC_ENGINE_VERSION` \$1 `CONFIG_FILES` \$1 `INSTANCE_ID` \$1 `JDBC_CONNECTION_URL` \$1 `JDBC_ENFORCE_SSL` \$1 `CUSTOM_JDBC_CERT` \$1 `SKIP_CUSTOM_JDBC_CERT_VALIDATION` \$1 `CUSTOM_JDBC_CERT_STRING` \$1 `CONNECTION_URL` \$1 `KAFKA_BOOTSTRAP_SERVERS` \$1 `KAFKA_SSL_ENABLED` \$1 `KAFKA_CUSTOM_CERT` \$1 `KAFKA_SKIP_CUSTOM_CERT_VALIDATION` \$1 `KAFKA_CLIENT_KEYSTORE` \$1 `KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `KAFKA_CLIENT_KEY_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD` \$1 `ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD` \$1 `KAFKA_SASL_MECHANISM` \$1 `KAFKA_SASL_PLAIN_USERNAME` \$1 `KAFKA_SASL_PLAIN_PASSWORD` \$1 `ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD` \$1 `KAFKA_SASL_SCRAM_USERNAME` \$1 `KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_SCRAM_SECRETS_ARN` \$1 `ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD` \$1 `KAFKA_SASL_GSSAPI_KEYTAB` \$1 `KAFKA_SASL_GSSAPI_KRB5_CONF` \$1 `KAFKA_SASL_GSSAPI_SERVICE` \$1 `KAFKA_SASL_GSSAPI_PRINCIPAL` \$1 `SECRET_ID` \$1 `CONNECTOR_URL` \$1 `CONNECTOR_TYPE` \$1 `CONNECTOR_CLASS_NAME` \$1 `ENDPOINT` \$1 `ENDPOINT_TYPE` \$1 `ROLE_ARN` \$1 `REGION` \$1 `WORKGROUP_NAME` \$1 `CLUSTER_IDENTIFIER` \$1 `DATABASE`).

  각 값은 길이가 1\$11,024바이트인 값 문자열입니다.

  이 키-값 페어는 연결에 대한 파라미터를 정의합니다.

  JDBC 연결에는 다음 연결 속성이 사용됩니다.
  + 필수 항목: `JDBC_CONNECTION_URL` 또는 (`HOST`, `PORT`, `JDBC_ENGINE`) 모두.
  + 필수 항목: `SECRET_ID` 또는 (`USERNAME`, `PASSWORD`) 모두.
  + 선택 사항: `JDBC_ENFORCE_SSL`, `CUSTOM_JDBC_CERT`, `CUSTOM_JDBC_CERT_STRING`, `SKIP_CUSTOM_JDBC_CERT_VALIDATION`. 이러한 파라미터는 JDBC로 SSL을 구성하는 데 사용됩니다.

  SALESFORCE 연결을 사용하려면 `AuthenticationConfiguration` 멤버를 구성해야 합니다.
+ `AuthenticationConfiguration` – [AuthenticationConfigurationInput](#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput) 객체입니다.

  TestConnection 요청에서 인증 구성을 포함하는 구조입니다. OAuth 인증을 사용하여 Salesforce에 연결하는 데 필요합니다.

## PhysicalConnectionRequirements 구조
<a name="aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements"></a>

GetConnection 응답의 OAuth 클라이언트 앱입니다.

**Fields**
+ `SubnetId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결에서 사용하는 서브넷 ID입니다.
+ `SecurityGroupIdList` – 50개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  연결에서 사용하는 보안 그룹 ID 목록입니다.
+ `AvailabilityZone` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결의 가용 영역입니다.

## GetConnectionsFilter 구조
<a name="aws-glue-api-catalog-connections-connections-GetConnectionsFilter"></a>

`GetConnections` API 작업에서 반환하는 연결 정의를 필터링합니다.

**Fields**
+ `MatchCriteria` – 10개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  연결 정의가 반환되도록 연결 정의에 기록된 기준과 반드시 일치해야 하는 기준 문자열입니다.
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  반환할 연결 유형입니다. 현재 SFTP는 지원되지 않습니다.
+ `ConnectionSchemaVersion` - 1 이상 2 이하의 숫자(정수)입니다.

  스키마 버전 1 또는 2로 연결이 생성되었는지 여부를 나타냅니다.

## AuthenticationConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfiguration"></a>

인증 구성을 포함하는 구조입니다.

**Fields**
+ `AuthenticationType` – UTF-8 문자열입니다(유효한 값: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  인증 구성을 포함하는 구조입니다.
+ `SecretArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #36](aws-glue-api-common.md#regex_36)

  자격 증명을 저장할 보안 관리자 ARN입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  민감한 인증 정보를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN)입니다. 이 키는 인증 구성 내에 저장된 자격 증명 및 기타 민감한 데이터를 보호하는 데 사용됩니다.
+ `OAuth2Properties` – [OAuth2Properties](#aws-glue-api-catalog-connections-connections-OAuth2Properties) 객체입니다.

  OAuth2 인증을 위한 속성입니다.

## AuthenticationConfigurationInput 구조
<a name="aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput"></a>

CreateConnection 요청에서 인증 구성을 포함하는 구조입니다.

**Fields**
+ `AuthenticationType` – UTF-8 문자열입니다(유효한 값: `BASIC` \$1 `OAUTH2` \$1 `CUSTOM` \$1 `IAM`).

  CreateConnection 요청에서 인증 구성을 포함하는 구조입니다.
+ `OAuth2Properties` – [OAuth2PropertiesInput](#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput) 객체입니다.

  CreateConnection 요청에서 OAuth2 인증의 속성입니다.
+ `SecretArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #36](aws-glue-api-common.md#regex_36)

  CreateConnection 요청에서 자격 증명을 저장할 보안 관리자 ARN입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  연결을 암호화하는 데 사용되는 KMS 키의 ARN입니다. 요청에서 입력만 가져와 Secret Manager에 저장합니다.
+ `BasicAuthenticationCredentials` – [BasicAuthenticationCredentials](#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials) 객체입니다.

  인증 유형이 기본 인증일 때 사용되는 자격 증명입니다.
+ `CustomAuthenticationCredentials` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$12,048바이트인 UTF-8 문자열입니다.

  인증 유형이 사용자 지정 인증일 때 사용되는 자격 증명입니다.

## OAuth2Properties 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2Properties"></a>

OAuth2 인증을 위한 속성을 포함하는 구조입니다.

**Fields**
+ `OAuth2GrantType` – UTF-8 문자열입니다(유효한 값: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  OAuth2 권한 부여 유형입니다. 예: `AUTHORIZATION_CODE`, `JWT_BEARER` 또는 `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication) 객체입니다.

  클라이언트 애플리케이션 유형입니다. 예: AWS\$1MANAGED 또는 USER\$1MANAGED.
+ `TokenUrl` – 과(와) 일치하는 256바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #40](aws-glue-api-common.md#regex_40)

  인증 코드를 액세스 토큰으로 교환하기 위한 제공업체 인증 서버 URL입니다.
+ `TokenUrlParametersMap` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$1512바이트인 UTF-8 문자열입니다.

  토큰 `GET` 요청에 추가된 파라미터의 맵입니다.

## OAuth2PropertiesInput 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput"></a>

CreateConnection 요청에서 OAuth2를 위한 속성을 포함하는 구조입니다.

**Fields**
+ `OAuth2GrantType` – UTF-8 문자열입니다(유효한 값: `AUTHORIZATION_CODE` \$1 `CLIENT_CREDENTIALS` \$1 `JWT_BEARER`).

  CreateConnection 요청에서 OAuth2 권한 부여 유형입니다. 예: `AUTHORIZATION_CODE`, `JWT_BEARER` 또는 `CLIENT_CREDENTIALS`.
+ `OAuth2ClientApplication` – [OAuth2ClientApplication](#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication) 객체입니다.

  CreateConnection 요청에서 클라이언트 애플리케이션 유형입니다. 예: `AWS_MANAGED`또는 `USER_MANAGED`.
+ `TokenUrl` – 과(와) 일치하는 256바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #40](aws-glue-api-common.md#regex_40)

  인증 코드를 액세스 토큰으로 교환하기 위한 제공업체 인증 서버 URL입니다.
+ `TokenUrlParametersMap` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$1512바이트인 UTF-8 문자열입니다.

  토큰 `GET` 요청에 추가된 파라미터의 맵입니다.
+ `AuthorizationCodeProperties` – [AuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties) 객체입니다.

  OAuth2 `AUTHORIZATION_CODE` 권한 부여 유형에 필요한 속성 세트입니다.
+ `OAuth2Credentials` – [OAuth2Credentials](#aws-glue-api-catalog-connections-connections-OAuth2Credentials) 객체입니다.

  인증 유형이 OAuth2 인증일 때 사용되는 자격 증명입니다.

## OAuth2ClientApplication 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2ClientApplication"></a>

연결에 사용된 OAuth2 클라이언트 앱입니다.

**Fields**
+ `UserManagedClientApplicationClientId` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  ClientAppType이 `USER_MANAGED`인 경우 클라이언트 애플리케이션의 clientID입니다.
+ `AWSManagedClientApplicationReference` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  AWS 관리형인 SaaS 측 클라이언트 앱에 대한 참조입니다.

## AuthorizationCodeProperties 구조
<a name="aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties"></a>

OAuth2 `AUTHORIZATION_CODE` 권한 부여 유형 워크플로에 필요한 속성 세트입니다.

**Fields**
+ `AuthorizationCode` – 과(와) 일치하는 1\$14096바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  `AUTHORIZATION_CODE` 권한 부여 워크플로의 세 번째 레그에서 사용할 인증 코드입니다. 이 코드는 액세스 토큰으로 교환되면 유효하지 않게 되는 일회용 코드이므로 이 값을 요청 파라미터로 사용하는 것이 허용됩니다.
+ `RedirectUri` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #41](aws-glue-api-common.md#regex_41)

  인증 코드를 발급할 때 권한 부여 서버가 사용자를 리디렉션하는 리디렉션 URI입니다. 계속해서 인증 코드를 액세스 토큰으로 교환할 때 이 URI가 사용됩니다.

## BasicAuthenticationCredentials 구조
<a name="aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials"></a>

`SecretArn` 값을 제공하지 않는 경우 기본 인증 자격 증명을 제공하는 데 사용됩니다.

**Fields**
+ `Username` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #37](aws-glue-api-common.md#regex_37)

  데이터 소스에 연결할 사용자 이름.
+ `Password` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #33](aws-glue-api-common.md#regex_33)

  데이터 소스에 연결할 암호.

## OAuth2Credentials 구조
<a name="aws-glue-api-catalog-connections-connections-OAuth2Credentials"></a>

인증 유형이 OAuth2 인증일 때 사용되는 자격 증명입니다.

**Fields**
+ `UserManagedClientApplicationClientSecret` – 과(와) 일치하는 512바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #38](aws-glue-api-common.md#regex_38)

  클라이언트 애플리케이션이 사용자 관리형인 경우 클라이언트 애플리케이션 클라이언트 보안 암호.
+ `AccessToken` – [Custom string pattern #38](aws-glue-api-common.md#regex_38)과(와) 일치하는 4,096바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 액세스 토큰.
+ `RefreshToken` – [Custom string pattern #38](aws-glue-api-common.md#regex_38)과(와) 일치하는 4,096바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 새로 고침 토큰.
+ `JwtToken` – [Custom string pattern #39](aws-glue-api-common.md#regex_39)과(와) 일치하는 8,000바이트 이하 길이의 UTF-8 문자열입니다.

  인증 유형이 OAuth2일 때 사용되는 JSON 웹 토큰(JWT).

## 작업
<a name="aws-glue-api-catalog-connections-connections-actions"></a>
+ [CreateConnection 작업(Python: create\$1connection)](#aws-glue-api-catalog-connections-connections-CreateConnection)
+ [DeleteConnection 작업(Python: delete\$1connection)](#aws-glue-api-catalog-connections-connections-DeleteConnection)
+ [GetConnection 작업(Python: get\$1connection)](#aws-glue-api-catalog-connections-connections-GetConnection)
+ [GetConnections 작업(Python: get\$1connections)](#aws-glue-api-catalog-connections-connections-GetConnections)
+ [UpdateConnection 작업(Python: update\$1connection)](#aws-glue-api-catalog-connections-connections-UpdateConnection)
+ [TestConnection 작업(Python: test\$1connection)](#aws-glue-api-catalog-connections-connections-TestConnection)
+ [BatchDeleteConnection 작업(Python: batch\$1delete\$1connection)](#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)

## CreateConnection 작업(Python: create\$1connection)
<a name="aws-glue-api-catalog-connections-connections-CreateConnection"></a>

데이터 카탈로그에서 연결 정의를 생성합니다.

페더레이션 리소스를 생성하는 데 사용되는 연결에는 IAM `glue:PassConnection` 권한이 필요합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결을 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionInput` – *필수(Required):* [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput) 객체입니다.

  생성할 연결을 정의하는 `ConnectionInput` 객체입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

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

  연결에 할당하는 태그입니다.

**응답**
+ `CreateConnectionStatus` – UTF-8 문자열입니다(유효한 값: `READY` \$1 `IN_PROGRESS` \$1 `FAILED`).

  연결 생성 요청의 상태입니다. VPC를 통해 토큰을 교환하는 OAuth 연결을 생성하는 경우와 같이, 특정 인증 유형의 경우 요청에 다소 시간이 걸릴 수 있습니다.

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## DeleteConnection 작업(Python: delete\$1connection)
<a name="aws-glue-api-catalog-connections-connections-DeleteConnection"></a>

데이터 카탈로그에서 연결을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제할 연결의 이름입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetConnection 작업(Python: get\$1connection)
<a name="aws-glue-api-catalog-connections-connections-GetConnection"></a>

데이터 카탈로그에서 연결 정의를 검색합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  검색할 연결 정의 이름입니다.
+ `HidePassword` – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하되 암호를 표시하지 않습니다. 호출자에게 AWS KMS 키를 사용하여 암호를 복호화할 권한이 없지만 연결 속성의 나머지에 액세스할 권한이 있는 경우 이 파라미터를 설정합니다.
+ `ApplyOverrideForComputeEnvironment` – UTF-8 문자열입니다(유효한 값: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  여러 서비스에서 사용할 수 있는 연결의 경우, 지정된 컴퓨팅 환경에 대한 반환 속성을 지정합니다.

**응답**
+ `Connection` – [연결](#aws-glue-api-catalog-connections-connections-Connection) 객체입니다.

  요청한 연결 정의입니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## GetConnections 작업(Python: get\$1connections)
<a name="aws-glue-api-catalog-connections-connections-GetConnections"></a>

데이터 카탈로그에서 연결 정의의 목록을 검색합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Filter` – [GetConnectionsFilter](#aws-glue-api-catalog-connections-connections-GetConnectionsFilter) 객체입니다.

  반환되는 연결을 관리하는 필터입니다.
+ `HidePassword` – 부울입니다.

  암호를 반환하지 않고 연결 메타데이터를 검색할 수 있습니다. 예를 들어 AWS Glue 콘솔은 이 플래그를 사용하여 연결을 검색하되 암호를 표시하지 않습니다. 호출자에게 AWS KMS 키를 사용하여 암호를 복호화할 권한이 없지만 연결 속성의 나머지에 액세스할 권한이 있는 경우 이 파라미터를 설정합니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  한 번의 응답으로 반환될 최대 결과 수입니다.

**응답**
+ `ConnectionList` – [연결](#aws-glue-api-catalog-connections-connections-Connection) 객체의 배열입니다.

  요청한 연결 정의의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 연결 목록이 필터링된 연결의 마지막을 포함하지 않는 경우의 연속 토큰입니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## UpdateConnection 작업(Python: update\$1connection)
<a name="aws-glue-api-catalog-connections-connections-UpdateConnection"></a>

데이터 카탈로그에서 연결 정의를 업데이트합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트할 연결 정의 이름입니다.
+ `ConnectionInput` – *필수(Required):* [ConnectionInput](#aws-glue-api-catalog-connections-connections-ConnectionInput) 객체입니다.

  질의에 따른 연결을 재정의하는 `ConnectionInput` 객체입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`

## TestConnection 작업(Python: test\$1connection)
<a name="aws-glue-api-catalog-connections-connections-TestConnection"></a>

서비스에 대한 연결을 테스트하여 사용자가 제공하는 서비스 자격 증명을 검증합니다.

기존 연결 이름을 제공하거나, 기존 연결 이외의 연결을 테스트하는 경우 `TestConnectionInput`을 제공할 수 있습니다. 둘 다 동시에 제공하면 오류가 발생합니다.

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  선택 사항입니다. 테스트에 대한 연결의 이름입니다. 이름만 제공하면 이 작업은 해당 연결을 가져와 테스트에 사용합니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 상주하는 카탈로그 ID.
+ `TestConnectionInput` – [TestConnectionInput](#aws-glue-api-catalog-connections-connections-TestConnectionInput) 객체입니다.

  서비스에 대한 연결 테스트를 지정할 때 사용되는 구조입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConflictException`
+ `InternalServiceException`

## BatchDeleteConnection 작업(Python: batch\$1delete\$1connection)
<a name="aws-glue-api-catalog-connections-connections-BatchDeleteConnection"></a>

데이터 카탈로그에서 연결 정의의 목록을 삭제합니다.

**요청**
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 지속될 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `ConnectionNameList` – *필수(Required):* 25개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  삭제할 연결 이름의 목록입니다.

**응답**
+ `Succeeded` – UTF-8 문자열의 배열입니다.

  성공적으로 삭제된 연결 정의 이름의 목록입니다.
+ `Errors` – 키-값 페어의 맵 배열입니다.

  각 키는 [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255 바이트 길이의 UTF-8 문자열입니다.

  각 값은 [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

  오류 세부 정보에서 성공적으로 삭제된 연결 이름의 맵입니다.

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`

# 연결 유형 API
<a name="aws-glue-api-catalog-connections-connections-type"></a>

연결 유형 API는 연결 유형 설명과 관련된 AWS Glue API를 설명합니다.

## 연결 관리 API
<a name="aws-glue-api-catalog-connections-connections-type-connection-management"></a>
+ [DescribeConnectionType 작업(Python: describe\$1connection\$1type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
+ [ListConnectionTypes 작업(Python: list\$1connection\$1types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
+ [ConnectionTypeBrief 구조](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
+ [ConnectionTypeVariant 구조](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)

## DescribeConnectionType 작업(Python: describe\$1connection\$1type)
<a name="aws-glue-api-catalog-connections-connections-type-DescribeConnectionType"></a>

`DescribeConnectionType` API는 AWS Glue에 지정된 연결 유형에 대해 지원되는 옵션에 대한 전체 세부 정보를 제공합니다.

**요청**
+ `ConnectionType` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  설명할 연결 유형의 이름입니다.

**응답**
+ `ConnectionType` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 유형의 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.
+ `Capabilities` – [기능](#aws-glue-api-catalog-connections-connections-type-Capabilities) 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.
+ `ConnectionProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  컴퓨팅 환경 전체에서 공통적인 연결 속성입니다.
+ `ConnectionOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  `ConnectionInput.ConnectionProperties`에서 연결을 생성할 때 설정할 수 있는 속성을 반환합니다. `ConnectionOptions`는 데이터프레임에 전달되는 연결 옵션 맵의 Spark ETL 스크립트에서 설정할 수 있는 파라미터를 정의합니다.
+ `AuthenticationConfiguration` – [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) 객체입니다.

  연결에 사용되는 인증의 유형입니다.
+ `ComputeEnvironmentConfigurations` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) 객체입니다.

  연결에서 지원하는 컴퓨팅 환경입니다.
+ `PhysicalConnectionRequirements` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  VPC, 서브넷, 보안 그룹 사양 등, 연결에 대한 물리적 요구 사항입니다.
+ `AthenaConnectionProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Athena 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `PythonConnectionProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Python 컴퓨팅 환경과 관련된 연결 속성입니다.
+ `SparkConnectionProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Spark 컴퓨팅 환경과 관련된 연결 속성입니다.

**오류**
+ `ValidationException`
+ `InvalidInputException`
+ `InternalServiceException`

## ListConnectionTypes 작업(Python: list\$1connection\$1types)
<a name="aws-glue-api-catalog-connections-connections-type-ListConnectionTypes"></a>

`ListConnectionTypes` API는 AWS Glue에서 사용 가능한 연결 유형을 학습하는 검색 메커니즘을 제공합니다. 응답에는 각 연결 유형에 지원되는 항목에 대한 상위 수준 세부 정보가 포함된 연결 유형 목록이 포함되어 있습니다. 나열된 연결 유형은 `CreateConnection` API의 `ConnectionType` 값에 지원되는 옵션 세트입니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

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

**응답**
+ `ConnectionTypes` – [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) 객체의 배열입니다.

  지원되는 연결 유형에 대한 간략한 정보가 포함된 `ConnectionTypeBrief` 객체의 목록입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  현재 list 세그먼트가 마지막이 아닌 경우의 연속 토큰입니다.

**오류**
+ `InternalServiceException`

## ConnectionTypeBrief 구조
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief"></a>

`ListConnectionTypes` API에서 반환하는 지원되는 연결 유형에 대한 간략한 정보입니다.

**Fields**
+ `ConnectionType` – UTF-8 문자열(유효한 값: `JDBC` \$1 `SFTP` \$1 `MONGODB` \$1 `KAFKA` \$1 `NETWORK` \$1 `MARKETPLACE` \$1 `CUSTOM` \$1 `SALESFORCE` \$1 `VIEW_VALIDATION_REDSHIFT` \$1 `VIEW_VALIDATION_ATHENA` \$1 `GOOGLEADS` \$1 `GOOGLESHEETS` \$1 `GOOGLEANALYTICS4` \$1 `SERVICENOW` \$1 `MARKETO` \$1 `SAPODATA` \$1 `ZENDESK` \$1 `JIRACLOUD` \$1 `NETSUITEERP` \$1 `HUBSPOT` \$1 `FACEBOOKADS` \$1 `INSTAGRAMADS` \$1 `ZOHOCRM` \$1 `SALESFORCEPARDOT` \$1 `SALESFORCEMARKETINGCLOUD` \$1 `ADOBEANALYTICS` \$1 `SLACK` \$1 `LINKEDIN` \$1 `MIXPANEL` \$1 `ASANA` \$1 `STRIPE` \$1 `SMARTSHEET` \$1 `DATADOG` \$1 `WOOCOMMERCE` \$1 `INTERCOM` \$1 `SNAPCHATADS` \$1 `PAYPAL` \$1 `QUICKBOOKS` \$1 `FACEBOOKPAGEINSIGHTS` \$1 `FRESHDESK` \$1 `TWILIO` \$1 `DOCUSIGNMONITOR` \$1 `FRESHSALES` \$1 `ZOOM` \$1 `GOOGLESEARCHCONSOLE` \$1 `SALESFORCECOMMERCECLOUD` \$1 `SAPCONCUR` \$1 `DYNATRACE` \$1 `MICROSOFTDYNAMIC365FINANCEANDOPS` \$1 `MICROSOFTTEAMS` \$1 `BLACKBAUDRAISEREDGENXT` \$1 `MAILCHIMP` \$1 `GITLAB` \$1 `PENDO` \$1 `PRODUCTBOARD` \$1 `CIRCLECI` \$1 `PIPEDIVE` \$1 `SENDGRID` \$1 `AZURECOSMOS` \$1 `AZURESQL` \$1 `BIGQUERY` \$1 `BLACKBAUD` \$1 `CLOUDERAHIVE` \$1 `CLOUDERAIMPALA` \$1 `CLOUDWATCH` \$1 `CLOUDWATCHMETRICS` \$1 `CMDB` \$1 `DATALAKEGEN2` \$1 `DB2` \$1 `DB2AS400` \$1 `DOCUMENTDB` \$1 `DOMO` \$1 `DYNAMODB` \$1 `GOOGLECLOUDSTORAGE` \$1 `HBASE` \$1 `KUSTOMER` \$1 `MICROSOFTDYNAMICS365CRM` \$1 `MONDAY` \$1 `MYSQL` \$1 `OKTA` \$1 `OPENSEARCH` \$1 `ORACLE` \$1 `PIPEDRIVE` \$1 `POSTGRESQL` \$1 `SAPHANA` \$1 `SQLSERVER` \$1 `SYNAPSE` \$1 `TERADATA` \$1 `TERADATANOS` \$1 `TIMESTREAM` \$1 `TPCDS` \$1 `VERTICA`).

  연결 유형의 이름입니다.
+ `DisplayName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 콘솔에 표시되는 연결 유형의 이름이며 인간이 읽을 수 있는 이름입니다.
+ `Vendor` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  이 연결 유형을 생성 또는 유지 관리하는 공급업체 또는 공급자의 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  연결 유형에 대한 설명입니다.
+ `Categories` – .

  이 연결 유형이 속한 범주 목록입니다. 범주는 사용자가 사용 사례에 기반하여 적절한 연결 유형을 필터링하고 찾는 데 도움이 됩니다.
+ `Capabilities` – [기능](#aws-glue-api-catalog-connections-connections-type-Capabilities) 객체입니다.

  지원되는 인증 유형, 데이터 인터페이스 유형(컴퓨팅 환경), 커넥터의 데이터 작업입니다.
+ `LogoUrl` – UTF-8 문자열입니다.

  연결 유형과 연결된 로고의 URL입니다.
+ `ConnectionTypeVariants` – [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant) 객체의 배열입니다.

  이 연결 유형에 사용할 수 있는 변형 목록입니다. 각 변형은 동일한 일반 연결 유형의 특정 사용 사례 또는 구현에 대한 특별 구성을 제공할 수 있습니다.

## ConnectionTypeVariant 구조
<a name="aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant"></a>

AWS Glue 데이터 카탈로그에서 연결 유형의 변형을 나타냅니다. 연결 유형 변형은 동일한 일반 연결 유형의 다양한 구현을 위한 특정 구성 및 동작을 제공합니다.

**Fields**
+ `ConnectionTypeVariantName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  연결 유형 변형의 고유 식별자입니다. 이 이름은 내부적으로 연결 유형의 특정 변형을 식별하는 데 사용됩니다.
+ `DisplayName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 콘솔에 표시되는 연결 유형 변형의 이름이며 인간이 읽을 수 있는 이름입니다.
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  용도, 사용 사례 및 특정 구성 요구 사항 등 연결 유형 변형에 대한 자세한 설명입니다.
+ `LogoUrl` – UTF-8 문자열입니다.

  연결 유형 변형과 연결된 로고의 URL입니다.

## 데이터 유형
<a name="aws-glue-api-catalog-connections-connections-type-connection-types"></a>
+ [Validation 구조](#aws-glue-api-catalog-connections-connections-type-Validation)
+ [AuthConfiguration 구조](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
+ [Capabilities 구조](#aws-glue-api-catalog-connections-connections-type-Capabilities)
+ [Property 구조](#aws-glue-api-catalog-connections-connections-type-Property)
+ [AllowedValue 구조](#aws-glue-api-catalog-connections-connections-type-AllowedValue)
+ [ComputeEnvironmentConfiguration 구조](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)

## Validation 구조
<a name="aws-glue-api-catalog-connections-connections-type-Validation"></a>

연결 속성에서 검증이 수행되는 방법을 정의합니다.

**Fields**
+ `ValidationType` – *필수:* UTF-8 문자열입니다(유효한 값: `REGEX` \$1 `RANGE`).

  수행할 검증 유형(예: `REGEX`)입니다.
+ `Patterns` – .

  검증에 적용되는 패턴의 목록입니다.
+ `Description` – **필수: 1\$11,024바이트 길이의 UTF-8 문자열입니다.

  검증에 대한 설명입니다.
+ `MaxLength` - 숫자(정수)입니다.

  문자열 연결 속성의 최대 길이입니다.
+ `Maximum` - 숫자(정수)입니다.

  검증의 `RANGE` 유형을 지정할 때의 최댓값입니다.
+ `Minimum` - 숫자(정수)입니다.

  검증의 `RANGE` 유형을 지정할 때의 최솟값입니다.

## AuthConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-type-AuthConfiguration"></a>

`DescribeConnectionType` API에서 반환되는 연결에 대한 인증 구성입니다.

**Fields**
+ `AuthenticationType` – *필수:* [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  연결의 인증 유형입니다.
+ `SecretArn` – [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  Secrets Manager의 Amazon 리소스 이름(ARN)입니다.
+ `OAuth2Properties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 `Property` 객체입니다.
+ `BasicAuthenticationProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  OAuth2 속성의 키-값 페어 맵입니다. 각 값은 `Property` 객체입니다.
+ `CustomAuthenticationProperties` – 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  사용자 지정 인증 속성의 키-값 페어 맵입니다. 각 값은 `Property` 객체입니다.

## Capabilities 구조
<a name="aws-glue-api-catalog-connections-connections-type-Capabilities"></a>

`DescribeConnectionType` API에서 반환하는 지원되는 인증 유형을 지정합니다.

**Fields**
+ `SupportedAuthenticationTypes` – *필수:* UTF-8 문자열의 배열입니다.

  지원되는 인증 유형의 목록입니다.
+ `SupportedDataOperations` – *필수:* UTF-8 문자열의 배열입니다.

  지원되는 데이터 작업의 목록입니다.
+ `SupportedComputeEnvironments` – *필수:* UTF-8 문자열의 배열입니다.

  지원되는 컴퓨팅 환경의 목록입니다.

## Property 구조
<a name="aws-glue-api-catalog-connections-connections-type-Property"></a>

컴퓨팅 환경의 연결 유형을 정의하는 객체입니다.

**Fields**
+ `Name` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  속성의 이름입니다.
+ `Description` – *필수:* UTF-8 문자열입니다(1,024바이트 이하).

  속성에 대한 설명입니다.
+ `Required` – *필수(Required):* 부울.

  속성이 필요한지 여부를 나타냅니다.
+ `PropertyTypes` – *필수:* UTF-8 문자열의 배열입니다.

  속성의 유형을 설명합니다.
+ `AllowedValues` – [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue) 객체의 배열입니다.

  속성에 허용되는 값을 나타내는 `AllowedValue` 객체의 목록입니다.
+ `DataOperationScopes` – UTF-8 문자열의 배열입니다.

  속성에 적용할 수 있는 데이터 작업을 나타냅니다.

## AllowedValue 구조
<a name="aws-glue-api-catalog-connections-connections-type-AllowedValue"></a>

속성에 허용되는 값을 나타내는 객체입니다.

**Fields**
+ `Description` – UTF-8 문자열(1,024바이트 이하).

  허용되는 값에 대한 설명입니다.
+ `Value` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  속성에 허용되는 값입니다.

## ComputeEnvironmentConfiguration 구조
<a name="aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration"></a>

`DescribeConnectionType` API에서 반환하는 컴퓨팅 환경(예: Spark, Python 또는 Athena)에 대한 구성이 포함되는 객체입니다.

**Fields**
+ `Name` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  컴퓨팅 환경 구성의 이름입니다.
+ `Description` – *필수:* UTF-8 문자열입니다(1,024바이트 이하).

  컴퓨팅 환경에 대한 설명입니다.
+ `ComputeEnvironment` – *필수:* UTF-8 문자열입니다(유효한 값: `SPARK` \$1 `ATHENA` \$1 `PYTHON`).

  컴퓨팅 환경의 유형입니다.
+ `SupportedAuthenticationTypes` – *필수:* UTF-8 문자열의 배열입니다.

  컴퓨팅 환경에 지원되는 인증 유형입니다.
+ `ConnectionOptions` – *필수(Required):* 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 [속성](#aws-glue-api-catalog-connections-connections-type-Property) 객체입니다.

  컴퓨팅 환경의 연결 옵션으로 사용되는 파라미터입니다.
+ `ConnectionPropertyNameOverrides` – *필수(Required):* 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  연결 속성 이름은 컴퓨팅 환경에 대해 재정의됩니다.
+ `ConnectionOptionNameOverrides` – *필수(Required):* 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  각 값은 길이가 1\$1128바이트인 UTF-8 문자열입니다.

  연결 옵션 이름은 컴퓨팅 환경에 대해 재정의됩니다.
+ `ConnectionPropertiesRequiredOverrides` – *필수:* .

  컴퓨팅 환경에 대한 재정의로서 요구되는 연결 속성입니다.
+ `PhysicalConnectionPropertiesRequired` – 부울입니다.

  `PhysicalConnectionProperties`가 컴퓨팅 환경에 필요한지 여부를 나타냅니다.

# 연결 메타데이터 및 미리 보기 API
<a name="aws-glue-api-catalog-connections-connections-metadata"></a>

다음 연결 API는 연결 메타데이터를 설명하는 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-connections-connections-metadata-objects"></a>
+ [Entity 구조](#aws-glue-api-catalog-connections-connections-metadata-Entity)
+ [Field 구조](#aws-glue-api-catalog-connections-connections-metadata-Field)

## Entity 구조
<a name="aws-glue-api-catalog-connections-connections-metadata-Entity"></a>

지정된 `ConnectionType`에서 지원하는 개체입니다.

**Fields**
+ `EntityName` – UTF-8 문자열입니다.

  개체의 이름입니다.
+ `Label` – UTF-8 문자열입니다.

  엔터티에 사용되는 레이블입니다.
+ `IsParentEntity` – 부울입니다.

  나열할 수 있는 하위 객체가 있는지 확인하는 데 도움이 되는 부울 값입니다.
+ `Description` – UTF-8 문자열입니다.

  엔터티에 대한 설명입니다.
+ `Category` – UTF-8 문자열입니다.

  응답에 있는 엔터티의 유형입니다. 이 값은 소스 연결에 따라 다릅니다. 예를 들어 Salesforce의 경우 `SObjects`이고 Amazon Redshift와 같은 소스의 경우 `databases`, `schemas` 또는 `tables`입니다.
+ `CustomProperties` – 

  커넥터가 엔터티에 대해 반환할 수 있는 키의 선택적 맵입니다.

## Field 구조
<a name="aws-glue-api-catalog-connections-connections-metadata-Field"></a>

`Field` 객체에는 커넥터의 필드와 연결된 다양한 속성에 대한 정보가 있습니다.

**Fields**
+ `FieldName` – UTF-8 문자열입니다.

  필드의 고유 식별자입니다.
+ `Label` – UTF-8 문자열입니다.

  필드에 사용되는 읽기 가능한 레이블입니다.
+ `Description` – UTF-8 문자열입니다.

  필드에 대한 설명입니다.
+ `FieldType` – UTF-8 문자열입니다(유효한 값: `INT` \$1 `SMALLINT` \$1 `BIGINT` \$1 `FLOAT` \$1 `LONG` \$1 `DATE` \$1 `BOOLEAN` \$1 `MAP` \$1 `ARRAY` \$1 `STRING` \$1 `TIMESTAMP` \$1 `DECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE` \$1 `STRUCT`).

  필드의 데이터 유형입니다.
+ `IsPrimaryKey` – 부울입니다.

  이 필드를 지정된 엔터티의 기본 키로 사용할 수 있는지 여부를 나타냅니다.
+ `IsNullable` – 부울입니다.

  이 필드에 null 값이 허용되는지 여부를 나타냅니다.
+ `IsRetrievable` – 부울입니다.

  SQL 쿼리의 Select 절에 이 필드를 추가할 수 있는지 또는 이 필드를 검색할 수 있는지 여부를 나타냅니다.
+ `IsFilterable` – 부울입니다.

   데이터를 쿼리할 때 SQL 문의 filter 절(`WHERE` 절)에 이 필드를 사용할 수 있는지 여부를 나타냅니다.
+ `IsPartitionable` – 부울입니다.

  SaaS에 대한 쿼리를 분할하는 데 지정된 필드를 사용할 수 있는지 여부를 나타냅니다.
+ `IsCreateable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 생성할 수 있는지 여부를 나타냅니다.
+ `IsUpdateable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 업데이트할 수 있는지 여부를 나타냅니다.
+ `IsUpsertable` – 부울입니다.

  이 필드를 대상 쓰기의 일부로 삽입할 수 있는지 여부를 나타냅니다.
+ `IsDefaultOnCreate` – 부울입니다.

  타임스탬프에서 생성되는 객체와 같은 객체가 생성될 때 이 필드가 자동으로 채워지는지 여부를 나타냅니다.
+ `SupportedValues` – .

  필드의 지원되는 값 목록입니다.
+ `SupportedFilterOperators` – UTF-8 문자열의 배열입니다.

  이 필드에 대한 지원 필터 연산자를 나타냅니다.
+ `CustomProperties` – 

  반환되는 키의 선택적 맵입니다.

## 작업
<a name="aws-glue-api-catalog-connections-connections-metadata-actions"></a>
+ [ListEntities 작업(Python: list\$1entities)](#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
+ [DescribeEntity 작업(Python: describe\$1entity)](#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
+ [GetEntityRecords 작업(Python: get\$1entity\$1records)](#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)

## ListEntities 작업(Python: list\$1entities)
<a name="aws-glue-api-catalog-connections-connections-metadata-ListEntities"></a>

연결 유형에서 지원하는 사용 가능한 엔터티를 반환합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  모든 연결 유형을 쿼리하는 데 필요한 자격 증명이 있는 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `ParentEntityName` – UTF-8 문자열입니다.

  하위 항목을 나열하려는 상위 엔터티의 이름입니다. 이 파라미터는 하위 엔터티를 나열하기 위해 엔터티의 정규화된 경로를 사용합니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  SaaS 커넥터의 API 버전입니다.

**응답**
+ `Entities` – [개체](#aws-glue-api-catalog-connections-connections-metadata-Entity) 객체의 배열입니다.

  `Entity` 객체의 목록.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## DescribeEntity 작업(Python: describe\$1entity)
<a name="aws-glue-api-catalog-connections-connections-metadata-DescribeEntity"></a>

선택한 엔터티의 각 필드의 데이터 모델에 대한 설명과 함께 연결 유형에 사용되는 엔터티에 대한 세부 정보를 제공합니다.

 엔터티를 구성하는 모든 필드가 응답에 포함됩니다.

**요청**
+ `ConnectionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  연결 유형 자격 증명이 포함된 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `EntityName` – *필수:* UTF-8 문자열입니다.

  연결 유형에서 설명할 엔터티의 이름입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  데이터 스토어에 사용되는 API의 버전입니다.

**응답**
+ `Fields` – [필드](#aws-glue-api-catalog-connections-connections-metadata-Field) 객체의 배열입니다.

  해당 커넥터 엔터티의 필드를 설명합니다. `Field` 객체의 목록입니다. `Field`는 데이터베이스의 열과 매우 유사합니다. `Field` 객체에는 커넥터의 필드와 연결된 다양한 속성에 대한 정보가 있습니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

## GetEntityRecords 작업(Python: get\$1entity\$1records)
<a name="aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords"></a>

이 API는 지정된 연결 유형 또는 기본 Amazon S3 기반 AWS Glue Data Catalog에서 미리 보기 데이터를 쿼리하는 데 사용됩니다.

레코드를 JSON Blob의 배열로 반환합니다. 각 레코드는 `DescribeEntity` API에서 정의한 필드 유형에 따라 Jackson JsonNode를 사용하여 형식이 지정됩니다.

Spark 커넥터는 `DescribeEntity` API와 동일한 데이터 형식 매핑에 따라 스키마를 생성합니다. Spark 커넥터는 행을 반환할 때 데이터를 스키마와 일치하는 적절한 데이터 유형으로 변환합니다.

**요청**
+ `ConnectionName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 유형 자격 증명이 포함된 연결의 이름입니다.
+ `CatalogId` – 과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결이 포함된 카탈로그의 카탈로그 ID입니다. 이 값은 null일 수 있습니다. 기본적으로 AWS 계정 ID는 카탈로그 ID입니다.
+ `EntityName` – *필수:* UTF-8 문자열입니다.

  지정된 연결 유형에서 미리 보기 데이터를 쿼리하려는 엔터티의 이름입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `DataStoreApiVersion` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #23](aws-glue-api-common.md#regex_23)

  SaaS 커넥터의 API 버전입니다.
+ `ConnectionOptions` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #18](aws-glue-api-common.md#regex_18)과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #17](aws-glue-api-common.md#regex_17)과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다.

  데이터를 쿼리하는 데 필요한 커넥터 옵션입니다.
+ `FilterPredicate` – UTF-8 문자열입니다(1\$1100,000바이트).

  쿼리 요청에 적용할 수 있는 필터 조건자입니다.
+ `Limit` – *필수:* 1\$11,000의 숫자(long)입니다.

  요청으로 가져오는 레코드 수를 제한합니다.
+ `SelectedFields` – UTF-8 문자열의 배열입니다(1\$11,000개의 문자열).

   미리 보기 데이터의 일부로 가져오려는 필드 목록입니다.

**응답**
+ `Records` - 구조의 배열입니다.

  요청한 객체의 목록입니다.
+ `NextToken` – 과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #11](aws-glue-api-common.md#regex_11)

  현재 세그먼트가 마지막이 아닌 경우 연속 토큰이 존재합니다.

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `GlueEncryptionException`
+ `ValidationException`
+ `FederationSourceException`
+ `AccessDeniedException`

# 사용자 정의 함수 API
<a name="aws-glue-api-catalog-functions"></a>

사용자 지정 함수 API는 함수로 작업할 때 사용되는 AWS Glue 데이터 유형 및 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-functions-objects"></a>
+ [UserDefinedFunction 구조](#aws-glue-api-catalog-functions-UserDefinedFunction)
+ [UserDefinedFunctionInput 구조](#aws-glue-api-catalog-functions-UserDefinedFunctionInput)

## UserDefinedFunction 구조
<a name="aws-glue-api-catalog-functions-UserDefinedFunction"></a>

Hive 사용자 정의 함수(`UDF`) 정의와 동등한 수준을 보여줍니다.

**필드**
+ `FunctionName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 이름입니다.
+ `DatabaseName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수를 포함하는 카탈로그 데이터베이스의 이름입니다.
+ `ClassName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수 코드가 포함된 Java 클래스입니다.
+ `OwnerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 소유자입니다.
+ `OwnerType` – UTF-8 문자열입니다(유효 값: `USER` \$1 `ROLE` \$1 `GROUP`).

  소유자 유형입니다.
+ `CreateTime` – 타임스탬프입니다.

  함수가 생성된 시간.
+ `ResourceUris` – [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri) 객체의 배열이며 구조는 1,000개 이하입니다.

  함수 리소스 URI
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  함수가 있는 Data Catalog의 ID입니다.

## UserDefinedFunctionInput 구조
<a name="aws-glue-api-catalog-functions-UserDefinedFunctionInput"></a>

사용자 정의 함수를 생성하거나 업데이트할 때 사용되는 구조입니다.

**필드**
+ `FunctionName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 이름입니다.
+ `ClassName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수 코드가 포함된 Java 클래스입니다.
+ `OwnerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 소유자입니다.
+ `OwnerType` – UTF-8 문자열입니다(유효 값: `USER` \$1 `ROLE` \$1 `GROUP`).

  소유자 유형입니다.
+ `ResourceUris` – [ResourceUri](aws-glue-api-common.md#aws-glue-api-common-ResourceUri) 객체의 배열이며 구조는 1,000개 이하입니다.

  함수 리소스 URI

## 운영
<a name="aws-glue-api-catalog-functions-actions"></a>
+ [CreateUserDefinedFunction 작업(Python: create\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
+ [UpdateUserDefinedFunction 작업 (Python: update\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
+ [DeleteUserDefinedFunction 작업 (Python: delete\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
+ [GetUserDefinedFunction 작업 (Python: get\$1user\$1defined\$1function)](#aws-glue-api-catalog-functions-GetUserDefinedFunction)
+ [GetUserDefinedFunctions 작업 (Python: get\$1user\$1defined\$1functions)](#aws-glue-api-catalog-functions-GetUserDefinedFunctions)

## CreateUserDefinedFunction 작업(Python: create\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-CreateUserDefinedFunction"></a>

데이터 카탈로그에서 새로운 함수 정의를 생성합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  함수를 생성할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수가 생성되는 카탈로그 데이터베이스의 이름입니다.
+ `FunctionInput` – *필수(Required):* [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput) 객체입니다.

  `FunctionInput` 객체는 데이터 카탈로그에 생성할 함수를 정의합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `GlueEncryptionException`

## UpdateUserDefinedFunction 작업 (Python: update\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-UpdateUserDefinedFunction"></a>

데이터 카탈로그에서 기존 함수를 업데이트합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  업데이트되는 함수가 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  업데이트되는 함수가 존재하는 카탈로그 데이터베이스 이름
+ `FunctionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 이름입니다.
+ `FunctionInput` – *필수(Required):* [UserDefinedFunctionInput](#aws-glue-api-catalog-functions-UserDefinedFunctionInput) 객체입니다.

  `FunctionInput` 객체는 데이터 카탈로그의 함수를 재정의합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## DeleteUserDefinedFunction 작업 (Python: delete\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-DeleteUserDefinedFunction"></a>

데이터 카탈로그에서 기존 함수를 삭제합니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  삭제되는 함수가 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수가 존재하는 카탈로그 데이터베이스 이름
+ `FunctionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  삭제된 함수 정의 이름입니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetUserDefinedFunction 작업 (Python: get\$1user\$1defined\$1function)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunction"></a>

데이터 카탈로그에서 지정된 함수를 가져옵니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  가져올 함수가 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수가 존재하는 카탈로그 데이터베이스 이름
+ `FunctionName` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수의 이름입니다.

**응답**
+ `UserDefinedFunction` – [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction) 객체입니다.

  요청한 함수 정의입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`

## GetUserDefinedFunctions 작업 (Python: get\$1user\$1defined\$1functions)
<a name="aws-glue-api-catalog-functions-GetUserDefinedFunctions"></a>

데이터 카탈로그에서 다양한 함수 정의를 가져옵니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  가져올 함수가 존재하는 데이터 카탈로그 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DatabaseName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  함수가 존재하는 카탈로그 데이터베이스 이름 아무 것도 제공되지 않으면 카탈로그에 있는 모든 데이터베이스의 함수가 반환됩니다.
+ `Pattern` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  반환된 함수 정의를 필터링하는 조건부 함수 이름 패턴 문자열입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

  한 번의 응답으로 반환될 최대 함수 수입니다.

**응답**
+ `UserDefinedFunctions` – [UserDefinedFunction](#aws-glue-api-catalog-functions-UserDefinedFunction) 객체의 배열입니다.

  요청한 함수 정의의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 함수 목록이 마지막으로 요청된 함수가 아닌 경우의 연속 토큰입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `GlueEncryptionException`

# Athena 카탈로그를 AWS Glue로 가져오기
<a name="aws-glue-api-catalog-migration"></a>

마이그레이션 API는 Athena 데이터 카탈로그를 AWS Glue로 마이그레이션하는 것과 관련된 AWS Glue 데이터 유형 및 작업에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-catalog-migration-objects"></a>
+ [CatalogImportStatus 구조](#aws-glue-api-catalog-migration-CatalogImportStatus)

## CatalogImportStatus 구조
<a name="aws-glue-api-catalog-migration-CatalogImportStatus"></a>

이송 상태 정보를 포함한 구조.

**필드**
+ `ImportCompleted` – 부울입니다.

  마이그레이션이 완료되면 `True`이고 그렇지 않으면 `False`입니다.
+ `ImportTime` – 타임스탬프입니다.

  이송이 시작된 시간.
+ `ImportedBy` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이송을 시작한 사람의 이름입니다.

## 운영
<a name="aws-glue-api-catalog-migration-actions"></a>
+ [ImportCatalogToGlue 작업(Python: import\$1catalog\$1to\$1glue)](#aws-glue-api-catalog-migration-ImportCatalogToGlue)
+ [GetCatalogImportStatus 작업(Python: get\$1catalog\$1import\$1status)](#aws-glue-api-catalog-migration-GetCatalogImportStatus)

## ImportCatalogToGlue 작업(Python: import\$1catalog\$1to\$1glue)
<a name="aws-glue-api-catalog-migration-ImportCatalogToGlue"></a>

기존 Amazon Athena Data Catalog를 AWS Glue로 가져옵니다.

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  가져올 객체의 ID입니다. 현재는 AWS 계정 ID여야 합니다.

**응답**
+ *무응답 파라미터.*

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetCatalogImportStatus 작업(Python: get\$1catalog\$1import\$1status)
<a name="aws-glue-api-catalog-migration-GetCatalogImportStatus"></a>

이송 작업 상태 검색

**요청**
+ `CatalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  이송할 카탈로그의 ID입니다. 현재는 AWS 계정 ID여야 합니다.

**응답**
+ `ImportStatus` – [CatalogImportStatus](#aws-glue-api-catalog-migration-CatalogImportStatus) 객체입니다.

  지정된 카탈로그 이송 상태.

**오류**
+ `InternalServiceException`
+ `OperationTimeoutException`