# AWS Glue API
<a name="aws-glue-api"></a>

이 섹션에서는 AWS Glue SDK 및 도구에서 사용하는 데이터 유형 및 기본 요소에 대해 설명합니다. 각각 자체 문서가 있는 AWS Management Console 외부에서 프로그래밍 방식으로 AWS Glue와 상호 작용하는 세 가지 일반적인 방법이 있습니다.
+  언어 SDK 라이브러리를 사용하면 일반적인 프로그래밍 언어의 AWS 리소스에 액세스할 수 있습니다. [AWS를 기반으로 빌드할 도구](https://aws.amazon.com/tools/)에서 자세한 정보를 찾으십시오.
+  AWS CLI를 사용하면 명령줄에서 AWS 리소스에 액세스할 수 있습니다. [AWS CLI명령 참조](https://docs.aws.amazon.com/cli/latest/reference/)에서 자세한 정보를 찾으십시오.
+  CloudFormation을 사용하면 일관되게 함께 프로비저닝할 AWS 리소스 집합을 정의할 수 있습니다. [CloudFormation:AWS Glue리소스 유형 참조](https://docs.aws.amazon.com/en_us/AWSCloudFormation/latest/UserGuide/AWS_Glue.html)에서 자세한 정보를 찾으십시오.

 이 섹션에서는 이러한 SDK 및 도구와는 별도로 공유 기본 요소에 대해 설명합니다. 도구는 [AWS Glue웹 API 참조](https://docs.aws.amazon.com/glue/latest/webapi/WebAPI_Welcome.html)를 사용하여 AWS와 통신합니다.

**Contents**
+ [AWS Glue의 보안 API](aws-glue-api-jobs-security.md)
  + [데이터 타입](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-objects)
  + [DataCatalogEncryptionSettings 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DataCatalogEncryptionSettings)
  + [EncryptionAtRest 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-EncryptionAtRest)
  + [ConnectionPasswordEncryption 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-ConnectionPasswordEncryption)
  + [EncryptionConfiguration 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-EncryptionConfiguration)
  + [S3Encryption 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-S3Encryption)
  + [CloudWatchEncryption 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-CloudWatchEncryption)
  + [JobBookmarksEncryption 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-JobBookmarksEncryption)
  + [SecurityConfiguration 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-SecurityConfiguration)
  + [GluePolicy 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GluePolicy)
  + [DataQualityEncryption 구조](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DataQualityEncryption)
  + [작업](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-actions)
  + [GetDataCatalogEncryptionSettings 작업(Python: get\$1data\$1catalog\$1encryption\$1settings)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings)
  + [PutDataCatalogEncryptionSettings 작업(Python: put\$1data\$1catalog\$1encryption\$1settings)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings)
  + [PutResourcePolicy 작업(Python: put\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-PutResourcePolicy)
  + [GetResourcePolicy 작업(Python: get\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetResourcePolicy)
  + [DeleteResourcePolicy 작업(Python: delete\$1resource\$1policy)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DeleteResourcePolicy)
  + [CreateSecurityConfiguration 작업(Python: create\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-CreateSecurityConfiguration)
  + [DeleteSecurityConfiguration 작업(Python: delete\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-DeleteSecurityConfiguration)
  + [GetSecurityConfiguration 작업(Python: get\$1security\$1configuration)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetSecurityConfiguration)
  + [GetSecurityConfigurations 작업(Python: get\$1security\$1configurations)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetSecurityConfigurations)
  + [GetResourcePolicies 작업(Python: get\$1resource\$1policies)](aws-glue-api-jobs-security.md#aws-glue-api-jobs-security-GetResourcePolicies)
+ [카탈로그 객체 API](aws-glue-api-catalog.md)
  + [카탈로그 API](aws-glue-api-catalog-catalogs.md)
    + [데이터 타입](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-objects)
    + [카탈로그 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-Catalog)
    + [CatalogInput 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogInput)
    + [TargetRedshiftCatalog 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog)
    + [CatalogProperties 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogProperties)
    + [CatalogPropertiesOutput 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput)
    + [DataLakeAccessProperties 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DataLakeAccessProperties)
    + [IcebergOptimizationProperties 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties)
    + [DataLakeAccessPropertiesOutput 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput)
    + [IcebergOptimizationPropertiesOutput 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput)
    + [FederatedCatalog 구조](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-FederatedCatalog)
    + [작업](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-actions)
    + [CreateCatalog 작업(Python: create\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-CreateCatalog)
    + [UpdateCatalog 작업(Python: update\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-UpdateCatalog)
    + [DeleteCatalog 작업(Python: delete\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-DeleteCatalog)
    + [GetCatalog 작업(Python: get\$1catalog)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-GetCatalog)
    + [GetCatalogs 작업(Python: get\$1catalogs)](aws-glue-api-catalog-catalogs.md#aws-glue-api-catalog-catalogs-GetCatalogs)
  + [데이터베이스 API](aws-glue-api-catalog-databases.md)
    + [데이터 타입](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-objects)
    + [데이터베이스 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-Database)
    + [DatabaseInput 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DatabaseInput)
    + [PrincipalPermissions 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions)
    + [DataLakePrincipal 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DataLakePrincipal)
    + [DatabaseIdentifier 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DatabaseIdentifier)
    + [FederatedDatabase 구조](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-FederatedDatabase)
    + [운영](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-actions)
    + [CreateDatabase 작업(Python: create\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-CreateDatabase)
    + [UpdateDatabase 작업(Python: update\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-UpdateDatabase)
    + [DeleteDatabase 작업(Python: delete\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-DeleteDatabase)
    + [GetDatabase 작업(Python: get\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-GetDatabase)
    + [GetDatabases 작업(Python: get\$1database)](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-GetDatabases)
  + [표 API](aws-glue-api-catalog-tables.md)
    + [데이터 타입](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-objects)
    + [테이블 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Table)
    + [TableInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableInput)
    + [FederatedTable 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-FederatedTable)
    + [열 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Column)
    + [StorageDescriptor 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-StorageDescriptor)
    + [SchemaReference 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SchemaReference)
    + [SerDeInfo 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SerDeInfo)
    + [Order 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-Order)
    + [SkewedInfo 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SkewedInfo)
    + [TableVersion 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableVersion)
    + [TableError 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableError)
    + [TableVersionError 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableVersionError)
    + [SortCriterion 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SortCriterion)
    + [TableIdentifier 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-TableIdentifier)
    + [KeySchemaElement 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-KeySchemaElement)
    + [PartitionIndex 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-PartitionIndex)
    + [PartitionIndexDescriptor 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-PartitionIndexDescriptor)
    + [BackfillError 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BackfillError)
    + [IcebergInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergInput)
    + [OpenTableFormatInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-OpenTableFormatInput)
    + [ViewDefinition 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewDefinition)
    + [ViewDefinitionInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewDefinitionInput)
    + [ViewRepresentation 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewRepresentation)
    + [ViewRepresentationInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-ViewRepresentationInput)
    + [UpdateOpenTableFormatInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateOpenTableFormatInput)
    + [UpdateIcebergInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateIcebergInput)
    + [CreateIcebergTableInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreateIcebergTableInput)
    + [UpdateIcebergTableInput 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateIcebergTableInput)
    + [IcebergSortOrder 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSortOrder)
    + [IcebergSortField 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSortField)
    + [IcebergPartitionSpec 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergPartitionSpec)
    + [IcebergPartitionField 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergPartitionField)
    + [IcebergSchema 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergSchema)
    + [IcebergStructField 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergStructField)
    + [IcebergTableUpdate 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-IcebergTableUpdate)
    + [AuditContext 구조](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-AuditContext)
    + [작업](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-actions)
    + [CreateTable 작업(Python: create\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreateTable)
    + [UpdateTable 작업(Python: update\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateTable)
    + [DeleteTable 작업(Python: delete\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteTable)
    + [BatchDeleteTable 작업(Python: batch\$1delete\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BatchDeleteTable)
    + [GetTable 작업(Python: get\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTable)
    + [GetTables 작업(Python: get\$1tables)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTables)
    + [GetTableVersion 작업(Python: get\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTableVersion)
    + [GetTableVersions 작업(Python: get\$1table\$1versions)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetTableVersions)
    + [DeleteTableVersion 작업(Python: delete\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteTableVersion)
    + [BatchDeleteTableVersion 작업(Python: batch\$1delete\$1table\$1version)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-BatchDeleteTableVersion)
    + [SearchTables 작업(Python: search\$1tables)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-SearchTables)
    + [GetPartitionIndexes 작업(Python: get\$1partition\$1indexes)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetPartitionIndexes)
    + [CreatePartitionIndex 작업(Python: create\$1partition\$1index)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-CreatePartitionIndex)
    + [DeletePartitionIndex 작업(Python: delete\$1partition\$1index)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeletePartitionIndex)
    + [GetColumnStatisticsForTable 작업(Python: get\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-GetColumnStatisticsForTable)
    + [UpdateColumnStatisticsForTable 작업(Python: update\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-UpdateColumnStatisticsForTable)
    + [DeleteColumnStatisticsForTable 작업(Python: delete\$1column\$1statistics\$1for\$1table)](aws-glue-api-catalog-tables.md#aws-glue-api-catalog-tables-DeleteColumnStatisticsForTable)
  + [파티션 API](aws-glue-api-catalog-partitions.md)
    + [데이터 타입](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-objects)
    + [파티션 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-Partition)
    + [PartitionInput 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionInput)
    + [PartitionSpecWithSharedStorageDescriptor 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionSpecWithSharedStorageDescriptor)
    + [PartitionListComposingSpec 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionListComposingSpec)
    + [PartitionSpecProxy 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionSpecProxy)
    + [PartitionValueList 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionValueList)
    + [세그먼트 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-Segment)
    + [PartitionError 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-PartitionError)
    + [BatchUpdatePartitionFailureEntry 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartitionFailureEntry)
    + [BatchUpdatePartitionRequestEntry 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartitionRequestEntry)
    + [StorageDescriptor 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-StorageDescriptor)
    + [SchemaReference 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SchemaReference)
    + [SerDeInfo 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SerDeInfo)
    + [SkewedInfo 구조](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-SkewedInfo)
    + [작업](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-actions)
    + [CreatePartition 작업(Python: create\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-CreatePartition)
    + [BatchCreatePartition 작업(Python: batch\$1create\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchCreatePartition)
    + [UpdatePartition 작업(Python: update\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-UpdatePartition)
    + [DeletePartition 작업(Python: delete\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-DeletePartition)
    + [BatchDeletePartition 작업(Python: batch\$1delete\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchDeletePartition)
    + [GetPartition 작업(Python: get\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetPartition)
    + [GetPartitions 작업(Python: get\$1partitions)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetPartitions)
    + [BatchGetPartition 작업(Python: batch\$1get\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchGetPartition)
    + [BatchUpdatePartition 작업(Python: batch\$1update\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-BatchUpdatePartition)
    + [GetColumnStatisticsForPartition 작업(Python: get\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-GetColumnStatisticsForPartition)
    + [UpdateColumnStatisticsForPartition 작업(Python: update\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-UpdateColumnStatisticsForPartition)
    + [DeleteColumnStatisticsForPartition 작업(Python: delete\$1column\$1statistics\$1for\$1partition)](aws-glue-api-catalog-partitions.md#aws-glue-api-catalog-partitions-DeleteColumnStatisticsForPartition)
  + [연결 API](aws-glue-api-catalog-connections.md)
    + [연결 API](aws-glue-api-catalog-connections-connections.md)
      + [데이터 타입](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-objects)
      + [연결 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-Connection)
      + [ConnectionInput 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-ConnectionInput)
      + [TestConnectionInput 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-TestConnectionInput)
      + [PhysicalConnectionRequirements 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-PhysicalConnectionRequirements)
      + [GetConnectionsFilter 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnectionsFilter)
      + [AuthenticationConfiguration 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthenticationConfiguration)
      + [AuthenticationConfigurationInput 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthenticationConfigurationInput)
      + [OAuth2Properties 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2Properties)
      + [OAuth2PropertiesInput 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2PropertiesInput)
      + [OAuth2ClientApplication 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2ClientApplication)
      + [AuthorizationCodeProperties 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-AuthorizationCodeProperties)
      + [BasicAuthenticationCredentials 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-BasicAuthenticationCredentials)
      + [OAuth2Credentials 구조](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-OAuth2Credentials)
      + [작업](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-actions)
      + [CreateConnection 작업(Python: create\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-CreateConnection)
      + [DeleteConnection 작업(Python: delete\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-DeleteConnection)
      + [GetConnection 작업(Python: get\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnection)
      + [GetConnections 작업(Python: get\$1connections)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-GetConnections)
      + [UpdateConnection 작업(Python: update\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-UpdateConnection)
      + [TestConnection 작업(Python: test\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-TestConnection)
      + [BatchDeleteConnection 작업(Python: batch\$1delete\$1connection)](aws-glue-api-catalog-connections-connections.md#aws-glue-api-catalog-connections-connections-BatchDeleteConnection)
    + [연결 유형 API](aws-glue-api-catalog-connections-connections-type.md)
      + [연결 관리 API](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-connection-management)
      + [DescribeConnectionType 작업(Python: describe\$1connection\$1type)](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType)
      + [ListConnectionTypes 작업(Python: list\$1connection\$1types)](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes)
      + [ConnectionTypeBrief 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief)
      + [ConnectionTypeVariant 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant)
      + [데이터 유형](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-connection-types)
      + [Validation 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Validation)
      + [AuthConfiguration 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-AuthConfiguration)
      + [Capabilities 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Capabilities)
      + [Property 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-Property)
      + [AllowedValue 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-AllowedValue)
      + [ComputeEnvironmentConfiguration 구조](aws-glue-api-catalog-connections-connections-type.md#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration)
    + [연결 메타데이터 및 미리 보기 API](aws-glue-api-catalog-connections-connections-metadata.md)
      + [데이터 타입](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-objects)
      + [Entity 구조](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-Entity)
      + [Field 구조](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-Field)
      + [작업](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-actions)
      + [ListEntities 작업(Python: list\$1entities)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-ListEntities)
      + [DescribeEntity 작업(Python: describe\$1entity)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-DescribeEntity)
      + [GetEntityRecords 작업(Python: get\$1entity\$1records)](aws-glue-api-catalog-connections-connections-metadata.md#aws-glue-api-catalog-connections-connections-metadata-GetEntityRecords)
  + [사용자 정의 함수 API](aws-glue-api-catalog-functions.md)
    + [데이터 타입](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-objects)
    + [UserDefinedFunction 구조](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UserDefinedFunction)
    + [UserDefinedFunctionInput 구조](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UserDefinedFunctionInput)
    + [운영](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-actions)
    + [CreateUserDefinedFunction 작업(Python: create\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-CreateUserDefinedFunction)
    + [UpdateUserDefinedFunction 작업 (Python: update\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-UpdateUserDefinedFunction)
    + [DeleteUserDefinedFunction 작업 (Python: delete\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-DeleteUserDefinedFunction)
    + [GetUserDefinedFunction 작업 (Python: get\$1user\$1defined\$1function)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-GetUserDefinedFunction)
    + [GetUserDefinedFunctions 작업 (Python: get\$1user\$1defined\$1functions)](aws-glue-api-catalog-functions.md#aws-glue-api-catalog-functions-GetUserDefinedFunctions)
  + [Athena 카탈로그를 AWS Glue로 가져오기](aws-glue-api-catalog-migration.md)
    + [데이터 타입](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-objects)
    + [CatalogImportStatus 구조](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-CatalogImportStatus)
    + [운영](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-actions)
    + [ImportCatalogToGlue 작업(Python: import\$1catalog\$1to\$1glue)](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-ImportCatalogToGlue)
    + [GetCatalogImportStatus 작업(Python: get\$1catalog\$1import\$1status)](aws-glue-api-catalog-migration.md#aws-glue-api-catalog-migration-GetCatalogImportStatus)
+ [테이블 옵티마이저 API](aws-glue-api-table-optimizers.md)
  + [데이터 타입](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-objects)
  + [TableOptimizer 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizer)
  + [TableOptimizerConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerConfiguration)
  + [TableOptimizerVpcConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)
  + [CompactionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CompactionConfiguration)
  + [IcebergCompactionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)
  + [TableOptimizerRun 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-TableOptimizerRun)
  + [BatchGetTableOptimizerEntry 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)
  + [BatchTableOptimizer 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchTableOptimizer)
  + [BatchGetTableOptimizerError 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)
  + [RetentionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RetentionConfiguration)
  + [IcebergRetentionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)
  + [OrphanFileDeletionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)
  + [IcebergOrphanFileDeletionConfiguration 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)
  + [CompactionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CompactionMetrics)
  + [RetentionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RetentionMetrics)
  + [OrphanFileDeletionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)
  + [IcebergCompactionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergCompactionMetrics)
  + [IcebergRetentionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergRetentionMetrics)
  + [IcebergOrphanFileDeletionMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)
  + [RunMetrics 구조](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-RunMetrics)
  + [운영](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-actions)
  + [GetTableOptimizer 작업 (Python: get\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-GetTableOptimizer)
  + [BatchGetTableOptimizer 작업 (Python: batch\$1get\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-BatchGetTableOptimizer)
  + [ListTableOptimizerRuns 작업 (Python: list\$1table\$1optimizer\$1runs)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-ListTableOptimizerRuns)
  + [CreateTableOptimizer 작업 (Python: create\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-CreateTableOptimizer)
  + [DeleteTableOptimizer 작업 (Python: delete\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-DeleteTableOptimizer)
  + [UpdateTableOptimizer 작업 (Python: update\$1table\$1optimizer)](aws-glue-api-table-optimizers.md#aws-glue-api-table-optimizers-UpdateTableOptimizer)
+ [크롤러 및 분류자 API](aws-glue-api-crawler.md)
  + [분류자 API](aws-glue-api-crawler-classifiers.md)
    + [데이터 타입](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-objects)
    + [분류자 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-Classifier)
    + [GrokClassifier 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GrokClassifier)
    + [XMLClassifier 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-XMLClassifier)
    + [JsonClassifier 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-JsonClassifier)
    + [CsvClassifier 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CsvClassifier)
    + [CreateGrokClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest)
    + [UpdateGrokClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest)
    + [CreateXMLClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest)
    + [UpdateXMLClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest)
    + [CreateJsonClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest)
    + [UpdateJsonClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest)
    + [CreateCsvClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest)
    + [UpdateCsvClassifierRequest 구조](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest)
    + [운영](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-actions)
    + [CreateClassifier 작업(Python: create\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-CreateClassifier)
    + [DeleteClassifier 작업(Python: delete\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-DeleteClassifier)
    + [GetClassifier 작업(Python: get\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GetClassifier)
    + [GetClassifiers 작업(Python: get\$1classifiers)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-GetClassifiers)
    + [UpdateClassifier 작업(Python: update\$1classifier)](aws-glue-api-crawler-classifiers.md#aws-glue-api-crawler-classifiers-UpdateClassifier)
  + [크롤러 API](aws-glue-api-crawler-crawling.md)
    + [데이터 타입](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-objects)
    + [크롤러 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-Crawler)
    + [일정 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-Schedule)
    + [CrawlerTargets 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerTargets)
    + [S3Target 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3Target)
    + [S3DeltaCatalogTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3DeltaCatalogTarget)
    + [S3DeltaDirectTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-S3DeltaDirectTarget)
    + [JdbcTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-JdbcTarget)
    + [MongoDBTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-MongoDBTarget)
    + [DynamoDBTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DynamoDBTarget)
    + [DeltaTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DeltaTarget)
    + [IcebergTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-IcebergTarget)
    + [HudiTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-HudiTarget)
    + [CatalogTarget 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CatalogTarget)
    + [CrawlerMetrics 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerMetrics)
    + [CrawlerHistory 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlerHistory)
    + [CrawlsFilter 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CrawlsFilter)
    + [SchemaChangePolicy 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-SchemaChangePolicy)
    + [LastCrawlInfo 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LastCrawlInfo)
    + [RecrawlPolicy 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-RecrawlPolicy)
    + [LineageConfiguration 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LineageConfiguration)
    + [LakeFormationConfiguration 구조](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-LakeFormationConfiguration)
    + [작업](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-actions)
    + [CreateCrawler 작업(Python: create\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-CreateCrawler)
    + [DeleteCrawler 작업(Python: delete\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-DeleteCrawler)
    + [GetCrawler 작업(Python: get\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawler)
    + [GetCrawlers 작업(Python: get\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawlers)
    + [GetCrawlerMetrics Action(Python: get\$1crawler\$1metrics)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-GetCrawlerMetrics)
    + [UpdateCrawler 작업(Python: update\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-UpdateCrawler)
    + [StartCrawler 작업(Python: start\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-StartCrawler)
    + [StopCrawler 작업(Python: stop\$1crawler)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-StopCrawler)
    + [BatchGetCrawlers 작업(Python: batch\$1get\$1crawlers)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-BatchGetCrawlers)
    + [ListCrawlers 작업(Python: list\$1crawlers)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-ListCrawlers)
    + [ListCrawls 작업(Python: list\$1crawls)](aws-glue-api-crawler-crawling.md#aws-glue-api-crawler-crawling-ListCrawls)
  + [열 통계의 API](aws-glue-api-crawler-column-statistics.md)
    + [데이터 타입](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-objects)
    + [ColumnStatisticsTaskRun 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun)
    + [ColumnStatisticsTaskSettings 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings)
    + [ExecutionAttempt 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ExecutionAttempt)
    + [운영](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-actions)
    + [StartColumnStatisticsTaskRun 작업 (Python: start\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun)
    + [GetColumnStatisticsTaskRun 작업 (Python: get\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun)
    + [GetColumnStatisticsTaskRuns 작업 (Python: get\$1column\$1statistics\$1task\$1runs)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns)
    + [ListColumnStatisticsTaskRuns 작업 (Python: list\$1column\$1statistics\$1task\$1runs)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns)
    + [StopColumnStatisticsTaskRun 작업 (Python: stop\$1column\$1statistics\$1task\$1run)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun)
    + [CreateColumnStatisticsTaskSettings 작업(Python: create\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings)
    + [UpdateColumnStatisticsTaskSettings 작업(Python: update\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings)
    + [GetColumnStatisticsTaskSettings 작업(Python: get\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings)
    + [DeleteColumnStatisticsTaskSettings 작업(Python: delete\$1column\$1statistics\$1task\$1settings)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings)
    + [StartColumnStatisticsTaskRunSchedule 작업(Python: start\$1column\$1statistics\$1task\$1run\$1schedule)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule)
    + [StopColumnStatisticsTaskRunSchedule 작업(Python: stop\$1column\$1statistics\$1task\$1run\$1schedule)](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule)
    + [예외](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-exceptions)
    + [ColumnStatisticsTaskRunningException 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException)
    + [ColumnStatisticsTaskNotRunningException 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException)
    + [ColumnStatisticsTaskStoppingException 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException)
    + [ColumnStatisticsTaskAutoConcurrencyLimitException 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException)
    + [InvalidCatalogSettingException 구조](aws-glue-api-crawler-column-statistics.md#aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException)
  + [크롤러 스케줄러 API](aws-glue-api-crawler-scheduler.md)
    + [데이터 타입](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-objects)
    + [일정 구조](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule)
    + [운영](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-actions)
    + [UpdateCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule)
    + [StartCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-StartCrawlerSchedule)
    + [StopCrawlerSchedule 작업(Python: stop\$1crawler\$1schedule)](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-StopCrawlerSchedule)
+ [ETL 스크립트 API 자동 생성](aws-glue-api-etl-script-generation.md)
  + [데이터 타입](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-objects)
  + [CodeGenNode 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenNode)
  + [CodeGenNodeArg 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenNodeArg)
  + [CodeGenEdge 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CodeGenEdge)
  + [위치 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-Location)
  + [CatalogEntry 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CatalogEntry)
  + [MappingEntry 구조](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-MappingEntry)
  + [운영](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-actions)
  + [CreateScript 작업(Python: create\$1script)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-CreateScript)
  + [GetDataflowGraph 작업(Python: get\$1dataflow\$1graph)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetDataflowGraph)
  + [GetMapping 작업(Python: get\$1mapping)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetMapping)
  + [GetPlan 작업(Python: get\$1plan)](aws-glue-api-etl-script-generation.md#aws-glue-api-etl-script-generation-GetPlan)
+ [시각적 작업 API](aws-glue-api-visual-job-api.md)
  + [데이터 타입](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-objects)
  + [CodeGenConfigurationNode 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode)
  + [JDBCConnectorOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorOptions)
  + [StreamingDataPreviewOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-StreamingDataPreviewOptions)
  + [AthenaConnectorSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AthenaConnectorSource)
  + [JDBCConnectorSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorSource)
  + [SparkConnectorSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkConnectorSource)
  + [CatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSource)
  + [MySQLCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MySQLCatalogSource)
  + [PostgreSQLCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PostgreSQLCatalogSource)
  + [OracleSQLCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-OracleSQLCatalogSource)
  + [MicrosoftSQLServerCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource)
  + [CatalogKinesisSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogKinesisSource)
  + [DirectKinesisSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectKinesisSource)
  + [KinesisStreamingSourceOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions)
  + [CatalogKafkaSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogKafkaSource)
  + [DirectKafkaSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectKafkaSource)
  + [KafkaStreamingSourceOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions)
  + [RedshiftSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RedshiftSource)
  + [AmazonRedshiftSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftSource)
  + [AmazonRedshiftNodeData 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftNodeData)
  + [AmazonRedshiftAdvancedOption 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption)
  + [옵션 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Option)
  + [S3CatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogSource)
  + [S3SourceAdditionalOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3SourceAdditionalOptions)
  + [S3CsvSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CsvSource)
  + [DirectJDBCSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectJDBCSource)
  + [S3DirectSourceAdditionalOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions)
  + [S3JsonSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3JsonSource)
  + [S3ParquetSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3ParquetSource)
  + [S3DeltaSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaSource)
  + [S3CatalogDeltaSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogDeltaSource)
  + [CatalogDeltaSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogDeltaSource)
  + [S3HudiSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiSource)
  + [S3CatalogHudiSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogHudiSource)
  + [S3ExcelSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3ExcelSource)
  + [CatalogHudiSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogHudiSource)
  + [DynamoDBCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamoDBCatalogSource)
  + [RelationalCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RelationalCatalogSource)
  + [JDBCConnectorTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JDBCConnectorTarget)
  + [SparkConnectorTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkConnectorTarget)
  + [BasicCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-BasicCatalogTarget)
  + [MySQLCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MySQLCatalogTarget)
  + [PostgreSQLCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget)
  + [OracleSQLCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-OracleSQLCatalogTarget)
  + [MicrosoftSQLServerCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget)
  + [RedshiftTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RedshiftTarget)
  + [AmazonRedshiftTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AmazonRedshiftTarget)
  + [UpsertRedshiftTargetOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions)
  + [S3CatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogTarget)
  + [S3GlueParquetTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3GlueParquetTarget)
  + [CatalogSchemaChangePolicy 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy)
  + [S3DirectTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DirectTarget)
  + [S3HudiCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiCatalogTarget)
  + [S3HudiDirectTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HudiDirectTarget)
  + [S3DeltaCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaCatalogTarget)
  + [S3DeltaDirectTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3DeltaDirectTarget)
  + [S3HyperDirectTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3HyperDirectTarget)
  + [S3IcebergDirectTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3IcebergDirectTarget)
  + [DirectSchemaChangePolicy 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectSchemaChangePolicy)
  + [ApplyMapping 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ApplyMapping)
  + [Mapping 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Mapping)
  + [SelectFields 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SelectFields)
  + [DropFields 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropFields)
  + [RenameField 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RenameField)
  + [Spigot 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Spigot)
  + [조인 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Join)
  + [JoinColumn 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-JoinColumn)
  + [SplitFields 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SplitFields)
  + [SelectFromCollection 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SelectFromCollection)
  + [FillMissingValues 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FillMissingValues)
  + [Filter 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Filter)
  + [FilterExpression 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FilterExpression)
  + [FilterValue 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-FilterValue)
  + [CustomCode 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CustomCode)
  + [SparkSQL 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SparkSQL)
  + [SqlAlias 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SqlAlias)
  + [DropNullFields 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropNullFields)
  + [NullCheckBoxList 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-NullCheckBoxList)
  + [NullValueField 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-NullValueField)
  + [데이터 형식 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Datatype)
  + [병합 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Merge)
  + [결합 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Union)
  + [PIIDetection 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-PIIDetection)
  + [집계 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Aggregate)
  + [DropDuplicates 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DropDuplicates)
  + [GovernedCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GovernedCatalogTarget)
  + [GovernedCatalogSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GovernedCatalogSource)
  + [AggregateOperation 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AggregateOperation)
  + [GlueSchema 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueSchema)
  + [GlueStudioSchemaColumn 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueStudioSchemaColumn)
  + [GlueStudioColumn 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueStudioColumn)
  + [DynamicTransform 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamicTransform)
  + [TransformConfigParameter 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-TransformConfigParameter)
  + [EvaluateDataQuality 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-EvaluateDataQuality)
  + [DQResultsPublishingOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DQResultsPublishingOptions)
  + [DQStopJobOnFailureOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions)
  + [EvaluateDataQualityMultiFrame 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame)
  + [레시피 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Recipe)
  + [RecipeReference 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeReference)
  + [SnowflakeNodeData 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeNodeData)
  + [SnowflakeSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeSource)
  + [SnowflakeTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-SnowflakeTarget)
  + [ConnectorDataSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConnectorDataSource)
  + [ConnectorDataTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConnectorDataTarget)
  + [RecipeStep 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeStep)
  + [RecipeAction 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-RecipeAction)
  + [ConditionExpression 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-ConditionExpression)
  + [S3CatalogIcebergSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3CatalogIcebergSource)
  + [CatalogIcebergSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogIcebergSource)
  + [S3IcebergCatalogTarget 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-S3IcebergCatalogTarget)
  + [DynamoDBELTConnectorSource 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource)
  + [DDBELTConnectionOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DDBELTConnectionOptions)
  + [DDBELTCatalogAdditionalOptions 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions)
  + [Route 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-Route)
  + [GroupFilters 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GroupFilters)
  + [AutoDataQuality 구조](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality)
+ [작업 API](aws-glue-api-jobs.md)
  + [작업](aws-glue-api-jobs-job.md)
    + [데이터 타입](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-objects)
    + [작업 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-Job)
    + [ExecutionProperty 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ExecutionProperty)
    + [NotificationProperty 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-NotificationProperty)
    + [JobCommand 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-JobCommand)
    + [ConnectionsList 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ConnectionsList)
    + [JobUpdate 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-JobUpdate)
    + [SourceControlDetails 구조](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-SourceControlDetails)
    + [운영](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-actions)
    + [CreateJob 작업(Python: create\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-CreateJob)
    + [UpdateJob 작업(Python: update\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-UpdateJob)
    + [GetJob 작업(Python: get\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-GetJob)
    + [GetJobs 작업(Python: get\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-GetJobs)
    + [DeleteJob 작업(Python: delete\$1job)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-DeleteJob)
    + [ListJobs 작업(Python: list\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-ListJobs)
    + [BatchGetJobs 작업(Python: batch\$1get\$1jobs)](aws-glue-api-jobs-job.md#aws-glue-api-jobs-job-BatchGetJobs)
  + [작업 실행](aws-glue-api-jobs-runs.md)
    + [데이터 타입](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-objects)
    + [JobRun 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobRun)
    + [이전 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-Predecessor)
    + [JobBookmarkEntry 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobBookmarkEntry)
    + [BatchStopJobRunSuccessfulSubmission 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
    + [BatchStopJobRunError 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRunError)
    + [NotificationProperty 구조](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty)
    + [운영](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-actions)
    + [StartJobRun 작업(Python: start\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-StartJobRun)
    + [BatchStopJobRun 작업(Python: batch\$1stop\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-BatchStopJobRun)
    + [GetJobRun 작업(Python: get\$1job\$1run)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobRun)
    + [GetJobRuns 작업(Python: get\$1job\$1runs)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobRuns)
    + [GetJobBookmark 작업(Python: get\$1job\$1bookmark)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobBookmark)
    + [GetJobBookmarks 작업(Python: get\$1job\$1bookmarks)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-GetJobBookmarks)
    + [ResetJobBookmark 작업(Python: reset\$1job\$1bookmark)](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-ResetJobBookmark)
  + [트리거](aws-glue-api-jobs-trigger.md)
    + [데이터 타입](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-objects)
    + [트리거 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Trigger)
    + [TriggerUpdate 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-TriggerUpdate)
    + [조건자 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Predicate)
    + [조건 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Condition)
    + [작업 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Action)
    + [EventBatchingCondition 구조](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-EventBatchingCondition)
    + [운영](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-actions)
    + [CreateTrigger 작업(Python: create\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-CreateTrigger)
    + [StartTrigger 작업(Python: start\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-StartTrigger)
    + [GetTrigger 작업(Python: get\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-GetTrigger)
    + [GetTrigger 작업(Python: get\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-GetTriggers)
    + [UpdateTrigger 작업(Python: update\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-UpdateTrigger)
    + [StopTrigger 작업(Python: stop\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-StopTrigger)
    + [DeleteTrigger 작업(Python: delete\$1trigger)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-DeleteTrigger)
    + [ListTriggers 작업(Python: list\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-ListTriggers)
    + [BatchGetTriggers 작업(Python: batch\$1get\$1triggers)](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-BatchGetTriggers)
+ [AWS Glue의 통합 API](aws-glue-api-integrations.md)
  + [데이터 타입](aws-glue-api-integrations.md#aws-glue-api-integrations-objects)
  + [통합 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-Integration)
  + [IntegrationConfig 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationConfig)
  + [IntegrationPartition 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationPartition)
  + [IntegrationError 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationError)
  + [IntegrationFilter 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationFilter)
  + [InboundIntegration 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-InboundIntegration)
  + [SourceProcessingProperties 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-SourceProcessingProperties)
  + [TargetProcessingProperties 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetProcessingProperties)
  + [SourceTableConfig 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-SourceTableConfig)
  + [TargetTableConfig 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetTableConfig)
  + [운영](aws-glue-api-integrations.md#aws-glue-api-integrations-actions)
  + [CreateIntegration 작업(Python: create\$1integration)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegration)
  + [ModifyIntegration 작업(Python: modify\$1integration)](aws-glue-api-integrations.md#aws-glue-api-integrations-ModifyIntegration)
  + [DescribeIntegrations 작업(Python: describe\$1integrations)](aws-glue-api-integrations.md#aws-glue-api-integrations-DescribeIntegrations)
  + [DeleteIntegration 작업(Python: delete\$1integration)](aws-glue-api-integrations.md#aws-glue-api-integrations-DeleteIntegration)
  + [DescribeInboundIntegrations 작업(Python: describe\$1inbound\$1integrations)](aws-glue-api-integrations.md#aws-glue-api-integrations-DescribeInboundIntegrations)
  + [CreateIntegrationTableProperties 작업(Python: create\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegrationTableProperties)
  + [UpdateIntegrationTableProperties 작업(Python: update\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-UpdateIntegrationTableProperties)
  + [GetIntegrationTableProperties 작업(Python: get\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-GetIntegrationTableProperties)
  + [DeleteIntegrationTableProperties 작업(Python: delete\$1integration\$1table\$1properties)](aws-glue-api-integrations.md#aws-glue-api-integrations-DeleteIntegrationTableProperties)
  + [CreateIntegrationResourceProperty 작업(Python: create\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-CreateIntegrationResourceProperty)
  + [UpdateIntegrationResourceProperty 작업(Python: update\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-UpdateIntegrationResourceProperty)
  + [GetIntegrationResourceProperty 작업(Python: get\$1integration\$1resource\$1property)](aws-glue-api-integrations.md#aws-glue-api-integrations-GetIntegrationResourceProperty)
  + [UntagResource 작업(Python: untag\$1resource)](aws-glue-api-integrations.md#aws-glue-api-integrations-UntagResource)
  + [ListTagsForResource 작업(Python: list\$1tags\$1for\$1resource)](aws-glue-api-integrations.md#aws-glue-api-integrations-ListTagsForResource)
  + [예외](aws-glue-api-integrations.md#aws-glue-api-integrations-exceptions)
  + [ResourceNotFoundException 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-ResourceNotFoundException)
  + [InternalServerException 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-InternalServerException)
  + [IntegrationAlreadyExistsFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationAlreadyExistsFault)
  + [IntegrationConflictOperationFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationConflictOperationFault)
  + [IntegrationQuotaExceededFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationQuotaExceededFault)
  + [KMSKeyNotAccessibleFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-KMSKeyNotAccessibleFault)
  + [IntegrationNotFoundFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-IntegrationNotFoundFault)
  + [TargetResourceNotFound 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-TargetResourceNotFound)
  + [InvalidIntegrationStateFault 구조](aws-glue-api-integrations.md#aws-glue-api-integrations-InvalidIntegrationStateFault)
+ [대화형 세션 API](aws-glue-api-interactive-sessions.md)
  + [데이터 타입](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-objects)
  + [세션 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-Session)
  + [SessionCommand 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-SessionCommand)
  + [명령문 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-Statement)
  + [StatementOutput 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StatementOutput)
  + [StatementOutputData 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StatementOutputData)
  + [ConnectionsList 구조](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList)
  + [작업](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-actions)
  + [CreateSession 작업(Python: create\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CreateSession)
  + [StopSession 작업(Python: stop\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-StopSession)
  + [DeleteSession 작업(Python: delete\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-DeleteSession)
  + [GetSession 작업(Python: get\$1session)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetSession)
  + [ListSessions 작업(Python: list\$1sessions)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ListSessions)
  + [RunStatement 작업(Python: run\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-RunStatement)
  + [CancelStatement 작업(Python: cancel\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CancelStatement)
  + [GetStatement 작업(Python: get\$1statement)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetStatement)
  + [ListStatements 작업(Python: list\$1statements)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ListStatements)
  + [GetGlueIdentityCenterConfiguration 작업(Python: get\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
  + [UpdateGlueIdentityCenterConfiguration 작업(Python: update\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
  + [CreateGlueIdentityCenterConfiguration 작업(Python: create\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
  + [DeleteGlueIdentityCenterConfiguration 작업(Python: delete\$1glue\$1identity\$1center\$1configuration)](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)
+ [개발 엔드포인트 API](aws-glue-api-dev-endpoint.md)
  + [데이터 타입](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-objects)
  + [DevEndpoint 구조](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DevEndpoint)
  + [DevEndpointCustomLibraries 구조](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries)
  + [작업](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-actions)
  + [CreateDevEndpoint 작업(Python: create\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-CreateDevEndpoint)
  + [UpdateDevEndpoint 작업(Python: update\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-UpdateDevEndpoint)
  + [DeleteDevEndpoint 작업(Python: delete\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-DeleteDevEndpoint)
  + [GetDevEndpoint 작업(Python: get\$1dev\$1endpoint)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-GetDevEndpoint)
  + [GetDevEndpoints 작업(Python: get\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-GetDevEndpoints)
  + [BatchGetDevEndpoints 작업(Python: batch\$1get\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-BatchGetDevEndpoints)
  + [ListDevEndpoints 작업(Python: list\$1dev\$1endpoints)](aws-glue-api-dev-endpoint.md#aws-glue-api-dev-endpoint-ListDevEndpoints)
+ [Schema Registry](aws-glue-api-schema-registry-api.md)
  + [데이터 타입](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-objects)
  + [RegistryId 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegistryId)
  + [RegistryListItem 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegistryListItem)
  + [MetadataInfo 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-MetadataInfo)
  + [OtherMetadataValueListItem 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-OtherMetadataValueListItem)
  + [SchemaListItem 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaListItem)
  + [SchemaVersionListItem 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionListItem)
  + [MetadataKeyValuePair 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-MetadataKeyValuePair)
  + [SchemaVersionErrorItem 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionErrorItem)
  + [ErrorDetails 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ErrorDetails)
  + [SchemaVersionNumber 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaVersionNumber)
  + [SchemaId 구조](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-SchemaId)
  + [작업](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-actions)
  + [CreateRegistry 작업(Python: create\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CreateRegistry)
  + [CreateSchema 작업(Python: create\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CreateSchema)
  + [GetSchema 작업(Python: get\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchema)
  + [ListSchemaVersions 작업(Python: list\$1schema\$1versions)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListSchemaVersions)
  + [GetSchemaVersion 작업(Python: get\$1schema\$1version)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaVersion)
  + [GetSchemaVersionsDiff 작업(Python: get\$1schema\$1versions\$1diff)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaVersionsDiff)
  + [ListRegistries 작업(Python: list\$1registries)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListRegistries)
  + [ListSchemas 작업(Python: list\$1schemas)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-ListSchemas)
  + [RegisterSchemaVersion 작업(Python: register\$1schema\$1version)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RegisterSchemaVersion)
  + [UpdateSchema 작업(Python: update\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-UpdateSchema)
  + [CheckSchemaVersionValidity 작업(Python: check\$1schema\$1version\$1validity)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-CheckSchemaVersionValidity)
  + [UpdateRegistry 작업(Python: update\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-UpdateRegistry)
  + [GetSchemaByDefinition 작업(Python: get\$1schema\$1by\$1definition)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetSchemaByDefinition)
  + [GetRegistry 작업(Python: get\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-GetRegistry)
  + [PutSchemaVersionMetadata 작업(Python: put\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-PutSchemaVersionMetadata)
  + [QuerySchemaVersionMetadata 작업(Python: query\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata)
  + [RemoveSchemaVersionMetadata 작업(Python: remove\$1schema\$1version\$1metadata)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata)
  + [DeleteRegistry 작업(Python: delete\$1registry)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteRegistry)
  + [DeleteSchema 작업(Python: delete\$1schema)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteSchema)
  + [DeleteSchemaVersions 작업(Python: delete\$1schema\$1versions)](aws-glue-api-schema-registry-api.md#aws-glue-api-schema-registry-api-DeleteSchemaVersions)
+ [워크플로](aws-glue-api-workflow.md)
  + [데이터 타입](aws-glue-api-workflow.md#aws-glue-api-workflow-objects)
  + [JobNodeDetails 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-JobNodeDetails)
  + [CrawlerNodeDetails 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-CrawlerNodeDetails)
  + [TriggerNodeDetails 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-TriggerNodeDetails)
  + [크롤 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-Crawl)
  + [노드 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-Node)
  + [엣지 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-Edge)
  + [워크플루 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-Workflow)
  + [WorkflowGraph 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowGraph)
  + [WorkflowRun 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowRun)
  + [WorkflowRunStatistics 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-WorkflowRunStatistics)
  + [StartingEventBatchCondition 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-StartingEventBatchCondition)
  + [블루프린트 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-Blueprint)
  + [BlueprintDetails 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-BlueprintDetails)
  + [LastActiveDefinition 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-LastActiveDefinition)
  + [BlueprintRun 구조](aws-glue-api-workflow.md#aws-glue-api-workflow-BlueprintRun)
  + [운영](aws-glue-api-workflow.md#aws-glue-api-workflow-actions)
  + [CreateWorkflow 작업(Python: create\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-CreateWorkflow)
  + [UpdateWorkflow 작업(Python: update\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-UpdateWorkflow)
  + [DeleteWorkflow 작업(Python: delete\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-DeleteWorkflow)
  + [GetWorkflow 작업(Python: get\$1workflow)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflow)
  + [ListWorkflows 작업(Python: list\$1workflows)](aws-glue-api-workflow.md#aws-glue-api-workflow-ListWorkflows)
  + [BatchGetWorkflows 작업(Python: batch\$1get\$1workflows)](aws-glue-api-workflow.md#aws-glue-api-workflow-BatchGetWorkflows)
  + [GetWorkflowRun 작업(Python: get\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRun)
  + [GetWorkflowRuns 작업(Python: get\$1workflow\$1runs)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRuns)
  + [GetWorkflowRunProperties 작업(Python: get\$1workflow\$1run\$1properties)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetWorkflowRunProperties)
  + [PutWorkflowRunProperties 작업(Python: put\$1workflow\$1run\$1properties)](aws-glue-api-workflow.md#aws-glue-api-workflow-PutWorkflowRunProperties)
  + [CreateBlueprint 작업(Python: create\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-CreateBlueprint)
  + [UpdateBlueprint 작업(Python: update\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-UpdateBlueprint)
  + [DeleteBlueprint 작업(Python: delete\$1blueprint)](aws-glue-api-workflow.md#aws-glue-api-workflow-DeleteBlueprint)
  + [ListBlueprints 작업(Python: list\$1blueprints)](aws-glue-api-workflow.md#aws-glue-api-workflow-ListBlueprints)
  + [BatchGetBlueprints 작업(Python: batch\$1get\$1blueprints)](aws-glue-api-workflow.md#aws-glue-api-workflow-BatchGetBlueprints)
  + [StartBlueprintRun 작업(Python: start\$1blueprint\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StartBlueprintRun)
  + [GetBlueprintRun 작업(Python: get\$1blueprint\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetBlueprintRun)
  + [GetBlueprintRuns 작업(Python: get\$1blueprint\$1runs)](aws-glue-api-workflow.md#aws-glue-api-workflow-GetBlueprintRuns)
  + [StartWorkflowRun 작업(Python: start\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StartWorkflowRun)
  + [StopWorkflowRun 작업(Python: stop\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-StopWorkflowRun)
  + [ResumeWorkflowRun 작업(Python: resume\$1workflow\$1run)](aws-glue-api-workflow.md#aws-glue-api-workflow-ResumeWorkflowRun)
+ [사용 프로필](aws-glue-api-usage-profiles.md)
  + [데이터 타입](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-objects)
  + [ProfileConfiguration 구조](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ProfileConfiguration)
  + [ConfigurationObject 구조](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ConfigurationObject)
  + [UsageProfileDefinition 구조](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-UsageProfileDefinition)
  + [운영](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-actions)
  + [CreateUsageProfile 작업(Python: create\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-CreateUsageProfile)
  + [GetUsageProfile 작업(Python: get\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-GetUsageProfile)
  + [UpdateUsageProfile 작업(Python: update\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-UpdateUsageProfile)
  + [DeleteUsageProfile 작업(Python: delete\$1usage\$1profile)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-DeleteUsageProfile)
  + [ListUsageProfiles 작업(Python: list\$1usage\$1profiles)](aws-glue-api-usage-profiles.md#aws-glue-api-usage-profiles-ListUsageProfiles)
+ [기계 학습 API](aws-glue-api-machine-learning-api.md)
  + [데이터 타입](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-objects)
  + [TransformParameters 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformParameters)
  + [EvaluationMetrics 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-EvaluationMetrics)
  + [MLTransform 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-MLTransform)
  + [FindMatchesParameters 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesParameters)
  + [FindMatchesMetrics 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesMetrics)
  + [ConfusionMatrix 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ConfusionMatrix)
  + [GlueTable 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GlueTable)
  + [TaskRun 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRun)
  + [TransformFilterCriteria 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformFilterCriteria)
  + [TransformSortCriteria 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformSortCriteria)
  + [TaskRunFilterCriteria 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunFilterCriteria)
  + [TaskRunSortCriteria 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunSortCriteria)
  + [TaskRunProperties 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TaskRunProperties)
  + [FindMatchesTaskRunProperties 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties)
  + [ImportLabelsTaskRunProperties 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties)
  + [ExportLabelsTaskRunProperties 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties)
  + [LabelingSetGenerationTaskRunProperties 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties)
  + [SchemaColumn 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-SchemaColumn)
  + [TransformEncryption 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-TransformEncryption)
  + [MLUserDataEncryption 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-MLUserDataEncryption)
  + [ColumnImportance 구조](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ColumnImportance)
  + [작업](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-actions)
  + [CreateMLTransform 작업(Python: create\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-CreateMLTransform)
  + [UpdateMLTransform 작업(Python: update\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-UpdateMLTransform)
  + [DeleteMLTransform 작업(Python: delete\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-DeleteMLTransform)
  + [GetMLTransform 작업(Python: get\$1ml\$1transform)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTransform)
  + [GetMLTransforms 작업(Python: get\$1ml\$1transforms)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTransforms)
  + [ListMLTransforms 작업(Python: list\$1ml\$1transforms)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-ListMLTransforms)
  + [StartMLEvaluationTaskRun 작업(Python: start\$1ml\$1evaluation\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun)
  + [StartMLLabelingSetGenerationTaskRun 작업(Python: start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun)
  + [GetMLTaskRun 작업(Python: get\$1ml\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTaskRun)
  + [GetMLTaskRuns 작업(Python: get\$1ml\$1task\$1runs)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GetMLTaskRuns)
  + [CancelMLTaskRun 작업(Python: cancel\$1ml\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-CancelMLTaskRun)
  + [StartExportLabelsTaskRun 작업(Python: start\$1export\$1labels\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartExportLabelsTaskRun)
  + [StartImportLabelsTaskRun 작업(Python: start\$1import\$1labels\$1task\$1run)](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-StartImportLabelsTaskRun)
+ [데이터 품질 API](aws-glue-api-data-quality-api.md)
  + [데이터 타입](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-objects)
  + [DataSource 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataSource)
  + [DataQualityRulesetListDetails 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetListDetails)
  + [DataQualityTargetTable 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityTargetTable)
  + [DataQualityRulesetEvaluationRunDescription 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription)
  + [DataQualityRulesetEvaluationRunFilter 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter)
  + [DataQualityEvaluationRunAdditionalRunOptions 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions)
  + [DataQualityRuleRecommendationRunDescription 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription)
  + [DataQualityRuleRecommendationRunFilter 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter)
  + [DataQualityResult 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResult)
  + [DataQualityAnalyzerResult 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityAnalyzerResult)
  + [DataQualityObservation 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityObservation)
  + [MetricBasedObservation 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-MetricBasedObservation)
  + [DataQualityMetricValues 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityMetricValues)
  + [DataQualityRuleResult 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRuleResult)
  + [DataQualityResultDescription 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResultDescription)
  + [DataQualityResultFilterCriteria 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria)
  + [DataQualityRulesetFilterCriteria 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria)
  + [DataQualityAggregatedMetrics 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics)
  + [StatisticAnnotation 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticAnnotation)
  + [TimestampedInclusionAnnotation 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation)
  + [AnnotationError 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-AnnotationError)
  + [DatapointInclusionAnnotation 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DatapointInclusionAnnotation)
  + [StatisticSummaryList 목록](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticSummaryList)
  + [StatisticSummary 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticSummary)
  + [RunIdentifier 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-RunIdentifier)
  + [StatisticModelResult 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StatisticModelResult)
  + [DataQualityGlueTable 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DataQualityGlueTable)
  + [운영](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-actions)
  + [StartDataQualityRulesetEvaluationRun 작업(Python: start\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun)
  + [CancelDataQualityRulesetEvaluationRun 작업(Python: cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun)
  + [GetDataQualityRulesetEvaluationRun 작업(Python: get\$1data\$1quality\$1ruleset\$1evaluation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun)
  + [ListDataQualityRulesetEvaluationRuns 작업(Python: list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns)
  + [StartDataQualityRuleRecommendationRun 작업(Python: start\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun)
  + [CancelDataQualityRuleRecommendationRun 작업(Python: cancel\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun)
  + [GetDataQualityRuleRecommendationRun 작업(Python: get\$1data\$1quality\$1rule\$1recommendation\$1run)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun)
  + [ListDataQualityRuleRecommendationRuns 작업(Python: list\$1data\$1quality\$1rule\$1recommendation\$1runs)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns)
  + [GetDataQualityResult 작업(Python: get\$1data\$1quality\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityResult)
  + [BatchGetDataQualityResult 작업(Python: batch\$1get\$1data\$1quality\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-BatchGetDataQualityResult)
  + [ListDataQualityResults 작업(Python: list\$1data\$1quality\$1results)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityResults)
  + [CreateDataQualityRuleset 작업(Python: create\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CreateDataQualityRuleset)
  + [DeleteDataQualityRuleset 작업(Python: delete\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-DeleteDataQualityRuleset)
  + [GetDataQualityRuleset 작업(Python: get\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleset)
  + [ListDataQualityRulesets 작업(Python: list\$1data\$1quality\$1rulesets)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityRulesets)
  + [UpdateDataQualityRuleset 작업(Python: update\$1data\$1quality\$1ruleset)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-UpdateDataQualityRuleset)
  + [ListDataQualityStatistics 작업(Python: list\$1data\$1quality\$1statistics)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityStatistics)
  + [TimestampFilter 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-TimestampFilter)
  + [CreateDataQualityRulesetRequest 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest)
  + [GetDataQualityRulesetResponse 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRulesetResponse)
  + [GetDataQualityResultResponse 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityResultResponse)
  + [StartDataQualityRuleRecommendationRunRequest 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest)
  + [GetDataQualityRuleRecommendationRunResponse 구조](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse)
  + [BatchPutDataQualityStatisticAnnotation 작업(Python: batch\$1put\$1data\$1quality\$1statistic\$1annotation)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation)
  + [GetDataQualityModel 작업(Python: get\$1data\$1quality\$1model)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityModel)
  + [GetDataQualityModelResult 작업(Python: get\$1data\$1quality\$1model\$1result)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-GetDataQualityModelResult)
  + [ListDataQualityStatisticAnnotations 작업(Python: list\$1data\$1quality\$1statistic\$1annotations)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations)
  + [PutDataQualityProfileAnnotation 작업(Python: put\$1data\$1quality\$1profile\$1annotation)](aws-glue-api-data-quality-api.md#aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation)
+ [민감한 데이터 감지 API](aws-glue-api-sensitive-data-api.md)
  + [데이터 타입](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-objects)
  + [CustomEntityType 구조](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-CustomEntityType)
  + [운영](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-actions)
  + [CreateCustomEntityType 작업(Python: create\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-CreateCustomEntityType)
  + [DeleteCustomEntityType 작업(Python: delete\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-DeleteCustomEntityType)
  + [GetCustomEntityType 작업(Python: get\$1custom\$1entity\$1type)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-GetCustomEntityType)
  + [BatchGetCustomEntityTypes 작업(Python: batch\$1get\$1custom\$1entity\$1types)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes)
  + [ListCustomEntityTypes 작업(Python: list\$1custom\$1entity\$1types)](aws-glue-api-sensitive-data-api.md#aws-glue-api-sensitive-data-api-ListCustomEntityTypes)
+ [AWS Glue에서 API 태그 지정](aws-glue-api-tags.md)
  + [데이터 타입](aws-glue-api-tags.md#aws-glue-api-tags-objects)
  + [태그 구조](aws-glue-api-tags.md#aws-glue-api-tags-Tag)
  + [작업](aws-glue-api-tags.md#aws-glue-api-tags-actions)
  + [TagResource 작업(Python: tag\$1resource)](aws-glue-api-tags.md#aws-glue-api-tags-TagResource)
  + [UntagResource 작업(Python: untag\$1resource)](aws-glue-api-tags.md#aws-glue-api-tags-UntagResource)
  + [GetTags 작업(Python: get\$1tags)](aws-glue-api-tags.md#aws-glue-api-tags-GetTags)
+ [공통 데이터 형식](aws-glue-api-common.md)
  + [태그 구조](aws-glue-api-common.md#aws-glue-api-common-Tag)
  + [DecimalNumber 구조](aws-glue-api-common.md#aws-glue-api-common-DecimalNumber)
  + [ErrorDetail 구조](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail)
  + [PropertyPredicate 구조](aws-glue-api-common.md#aws-glue-api-common-PropertyPredicate)
  + [ResourceUri 구조](aws-glue-api-common.md#aws-glue-api-common-ResourceUri)
  + [ColumnStatistics 구조](aws-glue-api-common.md#aws-glue-api-common-ColumnStatistics)
  + [ColumnStatisticsError 구조](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsError)
  + [ColumnError 구조](aws-glue-api-common.md#aws-glue-api-common-ColumnError)
  + [ColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-ColumnStatisticsData)
  + [BooleanColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-BooleanColumnStatisticsData)
  + [DateColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-DateColumnStatisticsData)
  + [DecimalColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-DecimalColumnStatisticsData)
  + [DoubleColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-DoubleColumnStatisticsData)
  + [LongColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-LongColumnStatisticsData)
  + [StringColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-StringColumnStatisticsData)
  + [BinaryColumnStatisticsData 구조](aws-glue-api-common.md#aws-glue-api-common-BinaryColumnStatisticsData)
  + [문자열 패턴](aws-glue-api-common.md#aws-glue-api-common-_string-patterns)
+ [예외](aws-glue-api-exceptions.md)
  + [AccessDeniedException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-AccessDeniedException)
  + [AlreadyExistsException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-AlreadyExistsException)
  + [ConcurrentModificationException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ConcurrentModificationException)
  + [ConcurrentRunsExceededException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ConcurrentRunsExceededException)
  + [CrawlerNotRunningException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerNotRunningException)
  + [CrawlerRunningException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerRunningException)
  + [CrawlerStoppingException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-CrawlerStoppingException)
  + [EntityNotFoundException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-EntityNotFoundException)
  + [FederationSourceException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-FederationSourceException)
  + [FederationSourceRetryableException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-FederationSourceRetryableException)
  + [GlueEncryptionException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-GlueEncryptionException)
  + [IdempotentParameterMismatchException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-IdempotentParameterMismatchException)
  + [IllegalWorkflowStateException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-IllegalWorkflowStateException)
  + [InternalServiceException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InternalServiceException)
  + [InvalidExecutionEngineException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidExecutionEngineException)
  + [InvalidInputException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidInputException)
  + [InvalidStateException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidStateException)
  + [InvalidTaskStatusTransitionException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-InvalidTaskStatusTransitionException)
  + [JobDefinitionErrorException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobDefinitionErrorException)
  + [JobRunInTerminalStateException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunInTerminalStateException)
  + [JobRunInvalidStateTransitionException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunInvalidStateTransitionException)
  + [JobRunNotInTerminalStateException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-JobRunNotInTerminalStateException)
  + [LateRunnerException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-LateRunnerException)
  + [NoScheduleException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-NoScheduleException)
  + [OperationTimeoutException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-OperationTimeoutException)
  + [ResourceNotReadyException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ResourceNotReadyException)
  + [ResourceNumberLimitExceededException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ResourceNumberLimitExceededException)
  + [SchedulerNotRunningException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerNotRunningException)
  + [SchedulerRunningException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerRunningException)
  + [SchedulerTransitioningException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-SchedulerTransitioningException)
  + [UnrecognizedRunnerException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-UnrecognizedRunnerException)
  + [ValidationException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-ValidationException)
  + [VersionMismatchException 구조](aws-glue-api-exceptions.md#aws-glue-api-exceptions-VersionMismatchException)

# AWS Glue의 보안 API
<a name="aws-glue-api-jobs-security"></a>

보안 API는 보안 데이터 유형 및 AWS Glue의 보안과 관련된 API에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-jobs-security-objects"></a>
+ [DataCatalogEncryptionSettings 구조](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings)
+ [EncryptionAtRest 구조](#aws-glue-api-jobs-security-EncryptionAtRest)
+ [ConnectionPasswordEncryption 구조](#aws-glue-api-jobs-security-ConnectionPasswordEncryption)
+ [EncryptionConfiguration 구조](#aws-glue-api-jobs-security-EncryptionConfiguration)
+ [S3Encryption 구조](#aws-glue-api-jobs-security-S3Encryption)
+ [CloudWatchEncryption 구조](#aws-glue-api-jobs-security-CloudWatchEncryption)
+ [JobBookmarksEncryption 구조](#aws-glue-api-jobs-security-JobBookmarksEncryption)
+ [SecurityConfiguration 구조](#aws-glue-api-jobs-security-SecurityConfiguration)
+ [GluePolicy 구조](#aws-glue-api-jobs-security-GluePolicy)
+ [DataQualityEncryption 구조](#aws-glue-api-jobs-security-DataQualityEncryption)

## DataCatalogEncryptionSettings 구조
<a name="aws-glue-api-jobs-security-DataCatalogEncryptionSettings"></a>

데이터 카탈로그 보안을 유지 관리하기 위한 구성 정보가 포함되어 있습니다.

**Fields**
+ `EncryptionAtRest` – [EncryptionAtRest](#aws-glue-api-jobs-security-EncryptionAtRest) 객체입니다.

  데이터 카탈로그에 대한 저장 데이터 암호화 구성을 지정합니다.
+ `ConnectionPasswordEncryption` – [ConnectionPasswordEncryption](#aws-glue-api-jobs-security-ConnectionPasswordEncryption) 객체입니다.

  연결 암호 보호가 활성화된 경우 데이터 카탈로그는 고객 제공 키를 사용하여 `CreateConnection` 또는 `UpdateConnection`의 일부로 암호를 암호화하고 이를 연결 속성의 `ENCRYPTED_PASSWORD` 필드에 저장합니다. 카탈로그 암호화를 활성화하거나 암호 암호화만 활성화할 수 있습니다.

## EncryptionAtRest 구조
<a name="aws-glue-api-jobs-security-EncryptionAtRest"></a>

데이터 카탈로그에 대한 저장 데이터 암호화 구성을 지정합니다.

**Fields**
+ `CatalogEncryptionMode` – *필수:* UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `SSE-KMS="SSEKMS"` \$1 `SSE-KMS-WITH-SERVICE-ROLE="SSEKMSWITHSERVICEROLE"`).

  데이터 카탈로그 데이터를 암호화하기 위한 저장 데이터 암호화 모드입니다.
+ `SseAwsKmsKeyId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  저장된 데이터 암호화에 사용할 AWS KMS 키의 ID입니다.
+ `CatalogEncryptionServiceRole` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #53](aws-glue-api-common.md#regex_53)

  AWS Glue가 호출자를 대신하여 데이터 카탈로그 객체를 암호화 및 해독하는 역할을 맡습니다.

## ConnectionPasswordEncryption 구조
<a name="aws-glue-api-jobs-security-ConnectionPasswordEncryption"></a>

데이터 카탈로그가 `CreateConnection` 또는 `UpdateConnection`의 일부로 암호를 암호화하고 이를 연결 속성의 `ENCRYPTED_PASSWORD` 필드에 저장하기 위해 사용하는 데이터 구조입니다. 카탈로그 암호화를 활성화하거나 암호 암호화만 활성화할 수 있습니다.

암호를 포함하는 `CreationConnection` 요청이 도착하면 Data Catalog는 먼저 AWS KMS 키를 사용하여 암호를 암호화합니다. 그런 다음 카탈로그 암호화도 활성화되어 있으면 전체 연결 객체를 다시 암호화합니다.

이 암호화를 사용하려면 보안 요구 사항에 따라 암호 키에 대한 액세스를 사용하거나 제한하도록 AWS KMS 키 권한을 설정해야 합니다. 예를 들어 관리자만 암호 키에 대한 암호화 해제 권한을 갖도록 하고자 할 수 있습니다.

**Fields**
+ `ReturnConnectionPasswordEncrypted` – *필수(Required):* 부울.

  `ReturnConnectionPasswordEncrypted` 플래그가 "true"로 설정된 경우, 암호는 `GetConnection` 및 `GetConnections`의 응답에서 암호화된 상태로 유지됩니다. 이 암호화는 카탈로그 암호화와는 독립적으로 적용됩니다.
+ `AwsKmsKeyId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  연결 암호를 암호화하는 데 사용되는 AWS KMS 키입니다.

  연결 암호 보호가 사용되는 경우 `CreateConnection` 및 `UpdateConnection`의 호출자는 Data Catalog에 암호를 저장하기 전에 암호화하려면 지정된 AWS KMS 키에 대한 최소한 `kms:Encrypt` 권한이 필요합니다.

  보안 요구 사항에 따라 암호 키에 대한 액세스를 허용하거나 제한하도록 암호화 해제 권한을 설정할 수 있습니다.

## EncryptionConfiguration 구조
<a name="aws-glue-api-jobs-security-EncryptionConfiguration"></a>

암호화 구성을 지정합니다.

**Fields**
+ `S3Encryption` – [S3Encryption](#aws-glue-api-jobs-security-S3Encryption) 객체의 배열입니다.

  Amazon Simple Storage Service(Amazon S3) 데이터에 대한 암호화 구성.
+ `CloudWatchEncryption` – [CloudWatchEncryption](#aws-glue-api-jobs-security-CloudWatchEncryption) 객체입니다.

  Amazon CloudWatch에 대한 암호화 구성.
+ `JobBookmarksEncryption` – [JobBookmarksEncryption](#aws-glue-api-jobs-security-JobBookmarksEncryption) 객체입니다.

  작업 북마크에 대한 암호화 구성.
+ `DataQualityEncryption` – [DataQualityEncryption](#aws-glue-api-jobs-security-DataQualityEncryption) 객체입니다.

  AWS Glue Data Quality 자산에 대한 암호화 구성.

## S3Encryption 구조
<a name="aws-glue-api-jobs-security-S3Encryption"></a>

Amazon Simple Storage Service(Amazon S3) 데이터를 암호화하는 방법을 지정합니다.

**Fields**
+ `S3EncryptionMode` – UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `SSE-KMS="SSEKMS"` \$1 `SSE-S3="SSES3"`).

  Amazon S3 데이터에 사용할 암호화 모드입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  데이터를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN).

## CloudWatchEncryption 구조
<a name="aws-glue-api-jobs-security-CloudWatchEncryption"></a>

Amazon CloudWatch 데이터를 암호화하는 방법을 지정합니다.

**Fields**
+ `CloudWatchEncryptionMode` – UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  CloudWatch 데이터에 사용할 암호화 모드입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  데이터를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN).

## JobBookmarksEncryption 구조
<a name="aws-glue-api-jobs-security-JobBookmarksEncryption"></a>

작업 북마크 데이터를 암호화하는 방법을 지정합니다.

**Fields**
+ `JobBookmarksEncryptionMode` – UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `CSE-KMS="CSEKMS"`).

  작업 북마크 데이터에 사용할 암호화 모드입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  데이터를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN).

## SecurityConfiguration 구조
<a name="aws-glue-api-jobs-security-SecurityConfiguration"></a>

보안 구성을 지정합니다.

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

  보안 구성의 이름입니다.
+ `CreatedTimeStamp` – 타임스탬프입니다.

  이 보안 구성이 생성된 시간입니다.
+ `EncryptionConfiguration` – [EncryptionConfiguration](#aws-glue-api-jobs-security-EncryptionConfiguration) 객체입니다.

  이 보안 구성과 관련된 암호화 구성입니다.

## GluePolicy 구조
<a name="aws-glue-api-jobs-security-GluePolicy"></a>

리소스 정책을 반환하기 위한 구조입니다.

**Fields**
+ `PolicyInJson` – UTF-8 문자열입니다(최소 2바이트).

  요청된 정책 문서(JSON 형식)가 포함되어 있습니다.
+ `PolicyHash` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 정책과 연관된 해시 값을 포함하고 있습니다.
+ `CreateTime` – 타임스탬프입니다.

  정책이 생성된 날짜와 시간입니다.
+ `UpdateTime` – 타임스탬프입니다.

  정책이 업데이트된 날짜와 시간입니다.

## DataQualityEncryption 구조
<a name="aws-glue-api-jobs-security-DataQualityEncryption"></a>

계정의 Data Quality 자산을 암호화하는 방법을 지정합니다.

**Fields**
+ `DataQualityEncryptionMode` – UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  Data Quality 자산을 암호화하는 데 사용할 암호화 모드. 이러한 자산에는 데이터 품질 규칙 세트, 결과, 통계, 이상 탐지 모델 및 관찰이 포함됩니다.

  유효한 값은 고객 관리형 KMS 키를 사용한 암호화의 경우 `SSEKMS`, 또는 `DISABLED`입니다.
+ `KmsKeyArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #42](aws-glue-api-common.md#regex_42)

  데이터를 암호화하는 데 사용되는 KMS 키의 Amazon 리소스 이름(ARN).

## 작업
<a name="aws-glue-api-jobs-security-actions"></a>
+ [GetDataCatalogEncryptionSettings 작업(Python: get\$1data\$1catalog\$1encryption\$1settings)](#aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings)
+ [PutDataCatalogEncryptionSettings 작업(Python: put\$1data\$1catalog\$1encryption\$1settings)](#aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings)
+ [PutResourcePolicy 작업(Python: put\$1resource\$1policy)](#aws-glue-api-jobs-security-PutResourcePolicy)
+ [GetResourcePolicy 작업(Python: get\$1resource\$1policy)](#aws-glue-api-jobs-security-GetResourcePolicy)
+ [DeleteResourcePolicy 작업(Python: delete\$1resource\$1policy)](#aws-glue-api-jobs-security-DeleteResourcePolicy)
+ [CreateSecurityConfiguration 작업(Python: create\$1security\$1configuration)](#aws-glue-api-jobs-security-CreateSecurityConfiguration)
+ [DeleteSecurityConfiguration 작업(Python: delete\$1security\$1configuration)](#aws-glue-api-jobs-security-DeleteSecurityConfiguration)
+ [GetSecurityConfiguration 작업(Python: get\$1security\$1configuration)](#aws-glue-api-jobs-security-GetSecurityConfiguration)
+ [GetSecurityConfigurations 작업(Python: get\$1security\$1configurations)](#aws-glue-api-jobs-security-GetSecurityConfigurations)
+ [GetResourcePolicies 작업(Python: get\$1resource\$1policies)](#aws-glue-api-jobs-security-GetResourcePolicies)

## GetDataCatalogEncryptionSettings 작업(Python: get\$1data\$1catalog\$1encryption\$1settings)
<a name="aws-glue-api-jobs-security-GetDataCatalogEncryptionSettings"></a>

지정된 카탈로그에 대한 보안 구성을 검색합니다.

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

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

**응답**
+ `DataCatalogEncryptionSettings` – [DataCatalogEncryptionSettings](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings) 객체입니다.

  요청된 보안 구성입니다.

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

## PutDataCatalogEncryptionSettings 작업(Python: put\$1data\$1catalog\$1encryption\$1settings)
<a name="aws-glue-api-jobs-security-PutDataCatalogEncryptionSettings"></a>

지정된 카탈로그에 대한 보안 구성을 설정합니다. 구성이 설정되면 지정된 암호화가 이후의 모든 카탈로그 쓰기에 적용됩니다.

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

  보안 구성을 설정할 데이터 카탈로그의 ID입니다. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `DataCatalogEncryptionSettings` – *필수(Required):* [DataCatalogEncryptionSettings](#aws-glue-api-jobs-security-DataCatalogEncryptionSettings) 객체입니다.

  설정할 보안 구성입니다.

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

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

## PutResourcePolicy 작업(Python: put\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-PutResourcePolicy"></a>

액세스 제어를 위한 데이터 카탈로그 리소스 정책을 설정합니다.

**요청**
+ `PolicyInJson` – *필수:* UTF-8 문자열입니다(최소 2바이트).

  설정할 정책 문서(JSON 형식)가 포함되어 있습니다.
+ `ResourceArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  이전 정책이 `PutResourcePolicy`를 사용하여 설정된 경우 반환되는 해시 값입니다. 정책의 동시 수정을 방지하기 위해 사용됩니다. 설정된 이전 정책이 없는 경우에는 이 파라미터를 사용하지 마십시오.
+ `PolicyExistsCondition` – UTF-8 문자열입니다(유효 값: `MUST_EXIST` \$1 `NOT_EXIST` \$1 `NONE`).

  `MUST_EXIST`의 값은 정책을 업데이트하는 데 사용됩니다. `NOT_EXIST`의 값은 새 정책을 생성하는 데 사용됩니다. `NONE`의 값 또는 null 값이 사용되는 경우 호출은 정책의 존재 여부에 종속되지 않습니다.
+ `EnableHybrid` – UTF-8 문자열입니다(유효한 값: `TRUE` \$1 `FALSE`).

  `'TRUE'`이면 Data Catalog 리소스에 대한 교차 계정 액세스 권한을 부여하기 위해 두 가지 방법을 모두 사용하고 있음을 나타냅니다.
  + `PutResourePolicy`로 리소스 정책을 직접 업데이트하여
  + AWS Management Console에서 **권한 부여** 명령을 사용합니다.

  이미 관리 콘솔을 사용하여 교차 계정 액세스 권한을 부여한 경우 `'TRUE'`로 설정해야 합니다. 그렇지 않으면 호출이 실패합니다. 기본값은 'FALSE'입니다.

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

  방금 설정한 정책의 해시입니다. 이 정책을 덮어쓰거나 업데이트하는 후속 호출에 반드시 포함되어 있어야 합니다.

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

## GetResourcePolicy 작업(Python: get\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-GetResourcePolicy"></a>

지정된 리소스 정책을 검색합니다.

**요청**
+ `ResourceArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  리소스 정책을 검색할 AWS Glue 리소스의 ARN입니다. 제공하지 않으면 Data Catalog 리소스 정책이 반환됩니다. `GetResourcePolicies`를 사용하여 기존 리소스 정책을 모두 봅니다. 자세한 내용은 [AWS Glue 리소스 ARN 지정](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)을 참조하세요.

**응답**
+ `PolicyInJson` – UTF-8 문자열입니다(최소 2바이트).

  요청된 정책 문서(JSON 형식)가 포함되어 있습니다.
+ `PolicyHash` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 정책과 연관된 해시 값을 포함하고 있습니다.
+ `CreateTime` – 타임스탬프입니다.

  정책이 생성된 날짜와 시간입니다.
+ `UpdateTime` – 타임스탬프입니다.

  정책이 업데이트된 날짜와 시간입니다.

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

## DeleteResourcePolicy 작업(Python: delete\$1resource\$1policy)
<a name="aws-glue-api-jobs-security-DeleteResourcePolicy"></a>

지정된 정책을 삭제합니다.

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

  이 정책이 설정되었을 때 반환된 해시 값입니다.
+ `ResourceArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  삭제할 리소스 정책에 대한 AWS Glue 리소스의 ARN입니다.

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

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

## CreateSecurityConfiguration 작업(Python: create\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-CreateSecurityConfiguration"></a>

새로운 보안 구성을 생성합니다. 보안 구성은 AWS Glue에서 사용할 수 있는 보안 속성 세트입니다. 보안 구성을 사용하여 미사용 데이터를 암호화할 수 있습니다. AWS Glue에서 보안 구성 사용에 대한 자세한 내용은 [크롤러, 작업 및 개발 엔드포인트로 기록된 데이터 암호화](https://docs.aws.amazon.com/glue/latest/dg/encryption-security-configuration.html)를 참조하세요.

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

  새 보안 구성의 이름입니다.
+ `EncryptionConfiguration` – *필수(Required):* [EncryptionConfiguration](#aws-glue-api-jobs-security-EncryptionConfiguration) 객체입니다.

  새 보안 구성을 위한 암호화 구성입니다.

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

  새 보안 구성에 할당된 이름입니다.
+ `CreatedTimestamp` – 타임스탬프입니다.

  새 보안 구성이 생성된 시간입니다.

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

## DeleteSecurityConfiguration 작업(Python: delete\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-DeleteSecurityConfiguration"></a>

지정된 보안 구성을 삭제합니다.

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

  삭제할 보안 구성의 이름입니다.

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

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

## GetSecurityConfiguration 작업(Python: get\$1security\$1configuration)
<a name="aws-glue-api-jobs-security-GetSecurityConfiguration"></a>

지정된 보안 구성을 검색합니다.

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

  검색할 보안 구성의 이름입니다.

**응답**
+ `SecurityConfiguration` – [SecurityConfiguration](#aws-glue-api-jobs-security-SecurityConfiguration) 객체입니다.

  요청된 보안 구성입니다.

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

## GetSecurityConfigurations 작업(Python: get\$1security\$1configurations)
<a name="aws-glue-api-jobs-security-GetSecurityConfigurations"></a>

모든 보안 구성 목록을 검색합니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `SecurityConfigurations` – [SecurityConfiguration](#aws-glue-api-jobs-security-SecurityConfiguration) 객체의 배열입니다.

  보안 구성의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환할 보안 구성이 더 있는 경우 연속 토큰입니다.

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

## GetResourcePolicies 작업(Python: get\$1resource\$1policies)
<a name="aws-glue-api-jobs-security-GetResourcePolicies"></a>

교차 계정 권한 부여 중에 AWS Resource Access Manager가 개별 리소스에 설정한 리소스 정책을 검색합니다. 또한 Data Catalog 리소스 정책을 검색합니다.

Data Catalog 설정에서 메타데이터 암호화를 사용하고 AWS KMS 키에 대한 권한이 없으면 작업에서 Data Catalog 리소스 정책을 반환할 수 없습니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.

**응답**
+ `GetResourcePoliciesResponseList` – [GluePolicy](#aws-glue-api-jobs-security-GluePolicy) 객체의 배열입니다.

  개별 리소스 정책 및 계정 수준 리소스 정책 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용 가능한 마지막 리소스 정책을 포함하지 경우의 연속 토큰입니다.

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

# 카탈로그 객체 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`

# 테이블 옵티마이저 API
<a name="aws-glue-api-table-optimizers"></a>

테이블 옵티마이저 API는 컴팩션을 활성화하여 읽기 성능을 향상시키는 AWS Glue API를 설명합니다.

## 데이터 타입
<a name="aws-glue-api-table-optimizers-objects"></a>
+ [TableOptimizer 구조](#aws-glue-api-table-optimizers-TableOptimizer)
+ [TableOptimizerConfiguration 구조](#aws-glue-api-table-optimizers-TableOptimizerConfiguration)
+ [TableOptimizerVpcConfiguration 구조](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration)
+ [CompactionConfiguration 구조](#aws-glue-api-table-optimizers-CompactionConfiguration)
+ [IcebergCompactionConfiguration 구조](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration)
+ [TableOptimizerRun 구조](#aws-glue-api-table-optimizers-TableOptimizerRun)
+ [BatchGetTableOptimizerEntry 구조](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry)
+ [BatchTableOptimizer 구조](#aws-glue-api-table-optimizers-BatchTableOptimizer)
+ [BatchGetTableOptimizerError 구조](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError)
+ [RetentionConfiguration 구조](#aws-glue-api-table-optimizers-RetentionConfiguration)
+ [IcebergRetentionConfiguration 구조](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration)
+ [OrphanFileDeletionConfiguration 구조](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration)
+ [IcebergOrphanFileDeletionConfiguration 구조](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration)
+ [CompactionMetrics 구조](#aws-glue-api-table-optimizers-CompactionMetrics)
+ [RetentionMetrics 구조](#aws-glue-api-table-optimizers-RetentionMetrics)
+ [OrphanFileDeletionMetrics 구조](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics)
+ [IcebergCompactionMetrics 구조](#aws-glue-api-table-optimizers-IcebergCompactionMetrics)
+ [IcebergRetentionMetrics 구조](#aws-glue-api-table-optimizers-IcebergRetentionMetrics)
+ [IcebergOrphanFileDeletionMetrics 구조](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics)
+ [RunMetrics 구조](#aws-glue-api-table-optimizers-RunMetrics)

## TableOptimizer 구조
<a name="aws-glue-api-table-optimizers-TableOptimizer"></a>

테이블과 관련된 옵티마이저에 대한 세부 정보가 들어 있습니다.

**필드**
+ `type` – UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형. 유효한 값은 다음과 같습니다.
  + `compaction`: 테이블 옵티마이저 압축 관리.
  + `retention`: 테이블 옵티마이저 스냅샷 보존 관리.
  + `orphan_file_deletion`: 테이블 옵티마이저 분리된 파일의 삭제 관리.
+ `configuration` – [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 객체입니다.

  테이블 옵티마이저를 만들거나 업데이트할 때 지정된 `TableOptimizerConfiguration` 객체입니다.
+ `lastRun` – [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun) 객체입니다.

  테이블 옵티마이저의 마지막 실행을 나타내는 `TableOptimizerRun` 객체입니다.
+ `configurationSource` – UTF-8 문자열입니다(유효한 값: `catalog="CATALOG"` \$1 `table="TABLE"`).

   옵티마이저 구성의 소스를 지정합니다. 이는 테이블 옵티마이저가 구성된 방식과 구성을 시작한 엔터티 또는 서비스를 나타냅니다.

## TableOptimizerConfiguration 구조
<a name="aws-glue-api-table-optimizers-TableOptimizerConfiguration"></a>

테이블 옵티마이저의 구성에 대한 세부 정보가 들어 있습니다. 테이블 옵티마이저를 만들거나 업데이트할 때 이 구성을 전달합니다.

**필드**
+ `roleArn` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과 일치하는 UTF-8 문자열입니다(20\$12,048바이트).

  호출자가 전달하는 역할로, 호출자를 대신하여 최적기와 관련된 리소스를 업데이트할 수 있는 권한을 서비스에 부여합니다.
+ `enabled` – 부울입니다.

  테이블 최적화가 활성화되었는지 여부.
+ `vpcConfiguration` – [TableOptimizerVpcConfiguration](#aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration) 객체입니다.

  테이블 옵티마이저에 대한 구성을 나타내는 `TableOptimizerVpcConfiguration` 객체.

  이 구성은 고객 VPC에 있는 테이블에서 최적화를 수행하는 데 필요합니다.
+ `compactionConfiguration` – [CompactionConfiguration](#aws-glue-api-table-optimizers-CompactionConfiguration) 객체입니다.

  압축 옵티마이저의 구성입니다. 이 구성은 쿼리 성능을 개선하고 스토리지 비용을 줄이기 위해 테이블의 데이터 파일이 압축되는 방식을 정의합니다.
+ `retentionConfiguration` – [RetentionConfiguration](#aws-glue-api-table-optimizers-RetentionConfiguration) 객체입니다.

  스냅샷 보존 옵티마이저의 구성.
+ `orphanFileDeletionConfiguration` – [OrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration) 객체입니다.

  분리된 파일 삭제 옵티마이저의 구성.

## TableOptimizerVpcConfiguration 구조
<a name="aws-glue-api-table-optimizers-TableOptimizerVpcConfiguration"></a>

테이블 옵티마이저에 대한 VPC 구성을 설명하는 객체.

이 구성은 고객 VPC에 있는 테이블에서 최적화를 수행하는 데 필요합니다.

**필드**
+ `glueConnectionName` – UTF-8 문자열입니다(최소 1바이트).

  테이블 옵티마이저에 대한 VPC에 사용되는 AWS Glue 연결의 이름.

## CompactionConfiguration 구조
<a name="aws-glue-api-table-optimizers-CompactionConfiguration"></a>

압축 옵티마이저의 구성입니다. 이 구성은 쿼리 성능을 개선하고 스토리지 비용을 줄이기 위해 테이블의 데이터 파일이 압축되는 방식을 정의합니다.

**필드**
+ `icebergConfiguration` – [IcebergCompactionConfiguration](#aws-glue-api-table-optimizers-IcebergCompactionConfiguration) 객체입니다.

  Iceberg 압축 옵티마이저의 구성입니다.

## IcebergCompactionConfiguration 구조
<a name="aws-glue-api-table-optimizers-IcebergCompactionConfiguration"></a>

Iceberg 압축 옵티마이저의 구성입니다. 이 구성은 Iceberg 테이블의 데이터 파일 레이아웃을 최적화하기 위한 파라미터를 정의합니다.

**필드**
+ `strategy` – UTF-8 문자열입니다(유효한 값: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  압축에 사용할 전략입니다. 유효한 값은 다음과 같습니다.
  +  `binpack`: 작은 파일을 더 큰 파일로 결합합니다. 일반적으로 100MB 이상의 크기를 대상으로 하는 동시에 보류 중인 삭제를 적용합니다. 대부분의 사용 사례에 권장되는 압축 전략입니다.
  +  `sort`: 압축 도중 계층적으로 정렬된 지정된 열을 기반으로 데이터를 구성하여 필터링된 작업에 대한 쿼리 성능을 개선합니다. 이 전략은 쿼리가 특정 열을 자주 필터링할 때 권장됩니다. 이 전략을 사용하려면 먼저 `sort_order` 테이블 속성을 사용하여 Iceberg 테이블 속성에서 정렬 순서를 정의해야 합니다.
  +  `z-order`: 여러 속성을 정렬에 사용할 수 있는 단일 스칼라 값으로 블렌딩하여 데이터 구성을 최적화하므로 여러 차원에 걸쳐 효율적인 쿼리가 가능합니다. 이 전략은 여러 차원에서 동시에 데이터를 쿼리해야 하는 경우에 권장됩니다. 이 전략을 사용하려면 먼저 `sort_order` 테이블 속성을 사용하여 Iceberg 테이블 속성에서 정렬 순서를 정의해야 합니다.

  입력이 제공되지 않으면 기본값인 'binpack'이 사용됩니다.
+ `minInputFiles` - 숫자(정수)입니다.

  압축을 통해 실제로 파일을 압축하기 위해 파티션에 있어야 하는 최소 데이터 파일 수입니다. 이 파라미터는 압축이 트리거되는 시점을 제어하여 파일이 거의 없는 파티션에서 불필요하게 압축 작업이 실행되지 않도록 합니다. 입력하지 않으면 기본값 100이 사용됩니다.
+ `deleteFileThreshold` - 숫자(정수)입니다.

  압축에 적합한 크기가 되기 위해 데이터 파일에 있어야 하는 최소 삭제 건수입니다. 이 파라미터는 상당한 수의 삭제 작업이 포함되어 있어 삭제된 레코드를 제거할 경우 쿼리 성능이 개선될 수 있는 파일에 집중함으로써 압축을 최적화하는 데 도움이 됩니다. 입력하지 않으면 기본값 1이 사용됩니다.

## TableOptimizerRun 구조
<a name="aws-glue-api-table-optimizers-TableOptimizerRun"></a>

테이블 옵티마이저 실행에 대한 세부 정보가 들어 있습니다.

**필드**
+ `eventType` – UTF-8 문자열입니다(유효한 값: `starting="STARTING"` \$1 `completed="COMPLETED"` \$1 `failed="FAILED"` \$1 `in_progress="IN_PROGRESS"`).

  테이블 옵티마이저 실행 상태를 나타내는 이벤트 유형입니다.
+ `startTimestamp` – 타임스탬프입니다.

  Lake Formation 내에서 압축 작업이 시작된 시점의 에포크 타임스탬프를 나타냅니다.
+ `endTimestamp` – 타임스탬프입니다.

  컴팩션 작업이 종료된 에포크 타임스탬프를 나타냅니다.
+ `metrics` – [RunMetrics](#aws-glue-api-table-optimizers-RunMetrics) 객체입니다.

  옵티마이저 실행에 대한 메트릭이 포함된 `RunMetrics` 객체입니다.

  이 멤버는 더 이상 사용되지 않습니다. 압축, 보존 및 분리된 파일 삭제에 대해서는 개별 지표 구성원을 참조하세요.
+ `error` – UTF-8 문자열입니다.

  옵티마이저 실행 중에 발생한 오류입니다.
+ `compactionMetrics` – [CompactionMetrics](#aws-glue-api-table-optimizers-CompactionMetrics) 객체입니다.

  옵티마이저 실행에 대한 메트릭이 포함된 `CompactionMetrics` 객체입니다.
+ `compactionStrategy` – UTF-8 문자열입니다(유효한 값: `binpack="BINPACK"` \$1 `sort="SORT"` \$1 `z-order="ZORDER"`).

  압축 실행에 사용되는 전략입니다. 압축 프로세스 중에 파일을 선택하고 결합하는 방법을 결정하는 데 적용된 알고리즘을 나타냅니다. 유효한 값은 다음과 같습니다.
  +  `binpack`: 작은 파일을 더 큰 파일로 결합합니다. 일반적으로 100MB 이상의 크기를 대상으로 하는 동시에 보류 중인 삭제를 적용합니다. 대부분의 사용 사례에 권장되는 압축 전략입니다.
  +  `sort`: 압축 도중 계층적으로 정렬된 지정된 열을 기반으로 데이터를 구성하여 필터링된 작업에 대한 쿼리 성능을 개선합니다. 이 전략은 쿼리가 특정 열을 자주 필터링할 때 권장됩니다. 이 전략을 사용하려면 먼저 `sort_order` 테이블 속성을 사용하여 Iceberg 테이블 속성에서 정렬 순서를 정의해야 합니다.
  +  `z-order`: 여러 속성을 정렬에 사용할 수 있는 단일 스칼라 값으로 블렌딩하여 데이터 구성을 최적화하므로 여러 차원에 걸쳐 효율적인 쿼리가 가능합니다. 이 전략은 여러 차원에서 동시에 데이터를 쿼리해야 하는 경우에 권장됩니다. 이 전략을 사용하려면 먼저 `sort_order` 테이블 속성을 사용하여 Iceberg 테이블 속성에서 정렬 순서를 정의해야 합니다.
+ `retentionMetrics` – [RetentionMetrics](#aws-glue-api-table-optimizers-RetentionMetrics) 객체입니다.

  옵티마이저 실행에 대한 메트릭이 포함된 `RetentionMetrics` 객체입니다.
+ `orphanFileDeletionMetrics` – [OrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-OrphanFileDeletionMetrics) 객체입니다.

  옵티마이저 실행에 대한 메트릭이 포함된 `OrphanFileDeletionMetrics` 객체입니다.

## BatchGetTableOptimizerEntry 구조
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry"></a>

`BatchGetTableOptimizer` 작업에서 검색할 테이블 옵티마이저를 나타냅니다.

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

  테이블의 카탈로그 ID.
+ `databaseName` – UTF-8 문자열입니다(최소 1바이트).

  테이블이 있는 카탈로그의 데이터베이스 이름입니다.
+ `tableName` – UTF-8 문자열입니다(최소 1바이트).

  테이블의 이름
+ `type` – UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.

## BatchTableOptimizer 구조
<a name="aws-glue-api-table-optimizers-BatchTableOptimizer"></a>

`BatchGetTableOptimizer` 작업에서 반환된 테이블 옵티마이저 중 하나에 대한 세부 정보가 들어 있습니다.

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

  테이블의 카탈로그 ID.
+ `databaseName` – UTF-8 문자열입니다(최소 1바이트).

  테이블이 있는 카탈로그의 데이터베이스 이름입니다.
+ `tableName` – UTF-8 문자열입니다(최소 1바이트).

  테이블의 이름
+ `tableOptimizer` – [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer) 객체입니다.

  테이블 옵티마이저의 구성 및 마지막 실행에 대한 세부 정보가 포함된 `TableOptimizer` 객체입니다.

## BatchGetTableOptimizerError 구조
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizerError"></a>

`BatchGetTableOptimizer` 작업에서 반환된 오류 목록의 오류 중 하나에 대한 세부 정보가 들어 있습니다.

**필드**
+ `error` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

  오류에 대한 코드 및 메시지 세부 정보가 포함된 `ErrorDetail` 객체입니다.
+ `catalogId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  테이블의 카탈로그 ID.
+ `databaseName` – UTF-8 문자열입니다(최소 1바이트).

  테이블이 있는 카탈로그의 데이터베이스 이름입니다.
+ `tableName` – UTF-8 문자열입니다(최소 1바이트).

  테이블의 이름
+ `type` – UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.

## RetentionConfiguration 구조
<a name="aws-glue-api-table-optimizers-RetentionConfiguration"></a>

스냅샷 보존 옵티마이저의 구성.

**필드**
+ `icebergConfiguration` – [IcebergRetentionConfiguration](#aws-glue-api-table-optimizers-IcebergRetentionConfiguration) 객체입니다.

  Iceberg 스냅샷 보존 옵티마이저의 구성.

## IcebergRetentionConfiguration 구조
<a name="aws-glue-api-table-optimizers-IcebergRetentionConfiguration"></a>

Iceberg 스냅샷 보존 옵티마이저의 구성.

**필드**
+ `snapshotRetentionPeriodInDays` - 숫자(정수)입니다.

  Iceberg 스냅샷을 보존하는 기간(일). 입력이 없으면 해당 Iceberg 테이블 구성 필드가 사용되거나 필드가 없는 경우 기본값 5가 사용됩니다.
+ `numberOfSnapshotsToRetain` - 숫자(정수)입니다.

  보존 기간 내에 유지해야 하는 Iceberg 스냅샷의 수. 입력이 없으면 해당 Iceberg 테이블 구성 필드가 사용되거나 필드가 없는 경우 기본값 1이 사용됩니다.
+ `cleanExpiredFiles` – 부울입니다.

  false로 설정하면 스냅샷은 테이블 메타데이터에서만 삭제되고, 그에 속한 데이터 및 메타데이터 파일은 삭제되지 않습니다.
+ `runRateInHours` - 숫자(정수)입니다.

  보존 작업의 실행 간격(단위: 시간)입니다. 이 파라미터는 보존 옵티마이저를 실행하여 만료된 스냅샷을 정리하는 빈도를 제어합니다. 이 값은 3\$1168시간(7일)이어야 합니다. 입력하지 않으면 기본값 24가 사용됩니다.

## OrphanFileDeletionConfiguration 구조
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionConfiguration"></a>

분리된 파일 삭제 옵티마이저의 구성.

**필드**
+ `icebergConfiguration` – [IcebergOrphanFileDeletionConfiguration](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration) 객체입니다.

  Iceberg 분리된 파일 삭제 옵티마이저의 구성.

## IcebergOrphanFileDeletionConfiguration 구조
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionConfiguration"></a>

Iceberg 분리된 파일 삭제 옵티마이저의 구성.

**필드**
+ `orphanFileRetentionPeriodInDays` - 숫자(정수)입니다.

  파일이 삭제되기 전까지 분리된 파일이 보존되어야 하는 기간(일). 입력이 없으면 기본값 3이 사용됩니다.
+ `location` – UTF-8 문자열입니다.

  파일을 찾을 디렉터리를 지정합니다(기본값은 테이블 위치). 최상위 테이블 위치 대신 하위 디렉터리를 선택할 수 있습니다.
+ `runRateInHours` - 숫자(정수)입니다.

  분리된 파일 삭제 작업의 실행 간격(단위: 시간)입니다. 이 파라미터는 분리된 파일 삭제 옵티마이저를 실행하여 분리된 파일을 정리하는 빈도를 제어합니다. 이 값은 3\$1168시간(7일)이어야 합니다. 입력하지 않으면 기본값 24가 사용됩니다.

## CompactionMetrics 구조
<a name="aws-glue-api-table-optimizers-CompactionMetrics"></a>

옵티마이저 실행에 대한 압축 지표가 포함된 구조.

**필드**
+ `IcebergMetrics` – [IcebergCompactionMetrics](#aws-glue-api-table-optimizers-IcebergCompactionMetrics) 객체입니다.

  옵티마이저 실행에 대한 Iceberg 압축 지표가 포함된 구조.

## RetentionMetrics 구조
<a name="aws-glue-api-table-optimizers-RetentionMetrics"></a>

옵티마이저 실행에 대한 보존 지표가 포함된 구조.

**필드**
+ `IcebergMetrics` – [IcebergRetentionMetrics](#aws-glue-api-table-optimizers-IcebergRetentionMetrics) 객체입니다.

  옵티마이저 실행에 대한 Iceberg 보존 지표가 포함된 구조.

## OrphanFileDeletionMetrics 구조
<a name="aws-glue-api-table-optimizers-OrphanFileDeletionMetrics"></a>

옵티마이저 실행에 대한 분리된 파일 삭제 지표가 포함된 구조.

**필드**
+ `IcebergMetrics` – [IcebergOrphanFileDeletionMetrics](#aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics) 객체입니다.

  옵티마이저 실행에 대한 Iceberg 분리된 파일 삭제 지표가 포함된 구조.

## IcebergCompactionMetrics 구조
<a name="aws-glue-api-table-optimizers-IcebergCompactionMetrics"></a>

옵티마이저 실행에 대한 Iceberg 압축 지표.

**필드**
+ `DpuHours` - 숫자(double)입니다.

  작업에 사용된 DPU 시간.
+ `NumberOfDpus` - 숫자(정수)입니다.

  작업에서 사용하는 DPU의 수로, 가장 가까운 정수로 반올림됩니다.
+ `JobDurationInHour` - 숫자(double)입니다.

  작업 기간(시간).

## IcebergRetentionMetrics 구조
<a name="aws-glue-api-table-optimizers-IcebergRetentionMetrics"></a>

옵티마이저 실행에 대한 Iceberg 스냅샷 보존 지표.

**필드**
+ `DpuHours` - 숫자(double)입니다.

  작업에 사용된 DPU 시간.
+ `NumberOfDpus` - 숫자(정수)입니다.

  작업에서 사용하는 DPU의 수로, 가장 가까운 정수로 반올림됩니다.
+ `JobDurationInHour` - 숫자(double)입니다.

  작업 기간(시간).

## IcebergOrphanFileDeletionMetrics 구조
<a name="aws-glue-api-table-optimizers-IcebergOrphanFileDeletionMetrics"></a>

옵티마이저 실행에 대한 Iceberg 분리된 파일 삭제 지표.

**필드**
+ `DpuHours` - 숫자(double)입니다.

  작업에 사용된 DPU 시간.
+ `NumberOfDpus` - 숫자(정수)입니다.

  작업에서 사용하는 DPU의 수로, 가장 가까운 정수로 반올림됩니다.
+ `JobDurationInHour` - 숫자(double)입니다.

  작업 기간(시간).

## RunMetrics 구조
<a name="aws-glue-api-table-optimizers-RunMetrics"></a>

옵티마이저 실행에 대한 지표.

이 구조는 더 이상 사용되지 않습니다. 압축, 보존 및 분리된 파일 삭제에 대해서는 개별 지표 구성원을 참조하세요.

**필드**
+ `NumberOfBytesCompacted` – UTF-8 문자열입니다.

  압축 작업 실행으로 제거된 바이트 수입니다.
+ `NumberOfFilesCompacted` – UTF-8 문자열입니다.

  압축 작업 실행으로 제거된 파일 수입니다.
+ `NumberOfDpus` – UTF-8 문자열입니다.

  작업에서 사용하는 DPU의 수로, 가장 가까운 정수로 반올림됩니다.
+ `JobDurationInHour` – UTF-8 문자열입니다.

  작업 기간(시간).

## 운영
<a name="aws-glue-api-table-optimizers-actions"></a>
+ [GetTableOptimizer 작업 (Python: get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-GetTableOptimizer)
+ [BatchGetTableOptimizer 작업 (Python: batch\$1get\$1table\$1optimizer)](#aws-glue-api-table-optimizers-BatchGetTableOptimizer)
+ [ListTableOptimizerRuns 작업 (Python: list\$1table\$1optimizer\$1runs)](#aws-glue-api-table-optimizers-ListTableOptimizerRuns)
+ [CreateTableOptimizer 작업 (Python: create\$1table\$1optimizer)](#aws-glue-api-table-optimizers-CreateTableOptimizer)
+ [DeleteTableOptimizer 작업 (Python: delete\$1table\$1optimizer)](#aws-glue-api-table-optimizers-DeleteTableOptimizer)
+ [UpdateTableOptimizer 작업 (Python: update\$1table\$1optimizer)](#aws-glue-api-table-optimizers-UpdateTableOptimizer)

## GetTableOptimizer 작업 (Python: get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-GetTableOptimizer"></a>

지정된 테이블과 관련된 모든 옵티마이저의 구성을 반환합니다.

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

  테이블의 카탈로그 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 문자열입니다.

  테이블의 이름
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.

**응답**
+ `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 문자열입니다.

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

  테이블의 이름
+ `TableOptimizer` – [TableOptimizer](#aws-glue-api-table-optimizers-TableOptimizer) 객체입니다.

  지정된 테이블에 연결된 옵티마이저입니다.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## BatchGetTableOptimizer 작업 (Python: batch\$1get\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-BatchGetTableOptimizer"></a>

지정된 테이블 옵티마이저의 구성을 반환합니다.

**요청**
+ `Entries` – **필수(Required): [BatchGetTableOptimizerEntry](#aws-glue-api-table-optimizers-BatchGetTableOptimizerEntry) 객체의 배열입니다.

  검색할 테이블 옵티마이저를 지정하는 `BatchGetTableOptimizerEntry` 객체 목록입니다.

**응답**
+ `TableOptimizers` – [BatchTableOptimizer](#aws-glue-api-table-optimizers-BatchTableOptimizer) 객체의 배열입니다.

  `BatchTableOptimizer` 객체의 목록.
+ `Failures` – [BatchGetTableOptimizerError](#aws-glue-api-table-optimizers-BatchGetTableOptimizerError) 객체의 배열입니다.

  작업의 오류 목록.

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## ListTableOptimizerRuns 작업 (Python: list\$1table\$1optimizer\$1runs)
<a name="aws-glue-api-table-optimizers-ListTableOptimizerRuns"></a>

특정 테이블에 대한 이전 옵티마이저 실행 기록을 나열합니다.

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

  테이블의 카탈로그 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 문자열입니다.

  테이블의 이름
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.
+ `MaxResults` - 숫자(정수)입니다.

  각 호출에서 반환되는 옵티마이저 실행의 최대 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `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 문자열입니다.

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

  테이블의 이름
+ `NextToken` – UTF-8 문자열입니다.

  목록의 현재 세그먼트가 마지막이 아니면 반환된 옵티마이저 실행 목록에 페이지를 매기는 지속적인 토큰은 반환됩니다.
+ `TableOptimizerRuns` – [TableOptimizerRun](#aws-glue-api-table-optimizers-TableOptimizerRun) 객체의 배열입니다.

  테이블에 연결된 옵티마이저 실행 목록입니다.

**오류**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InvalidInputException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`

## CreateTableOptimizer 작업 (Python: create\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-CreateTableOptimizer"></a>

특정 함수에 대한 새 테이블 옵티마이저를 생성합니다.

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

  테이블의 카탈로그 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 문자열입니다.

  테이블의 이름
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.
+ `TableOptimizerConfiguration` – **필수(Required): [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 객체입니다.

  테이블 옵티마이저의 구성을 나타내는 `TableOptimizerConfiguration` 객체입니다.

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

**오류**
+ `EntityNotFoundException`
+ `ValidationException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `ThrottlingException`

## DeleteTableOptimizer 작업 (Python: delete\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-DeleteTableOptimizer"></a>

테이블의 옵티마이저 및 모든 관련 메타데이터를 삭제합니다. 최적화는 더 이상 테이블에서 수행되지 않습니다.

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

  테이블의 카탈로그 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 문자열입니다.

  테이블의 이름
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `ThrottlingException`

## UpdateTableOptimizer 작업 (Python: update\$1table\$1optimizer)
<a name="aws-glue-api-table-optimizers-UpdateTableOptimizer"></a>

기존 테이블 옵티마이저의 구성을 업데이트합니다.

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

  테이블의 카탈로그 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 문자열입니다.

  테이블의 이름
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `compaction="COMPACTION"` \$1 `retention="RETENTION"` \$1 `orphan_file_deletion="ORPHAN_FILE_DELETION"`).

  테이블 옵티마이저 유형.
+ `TableOptimizerConfiguration` – **필수(Required): [TableOptimizerConfiguration](#aws-glue-api-table-optimizers-TableOptimizerConfiguration) 객체입니다.

  테이블 옵티마이저의 구성을 나타내는 `TableOptimizerConfiguration` 객체입니다.

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ValidationException`
+ `InternalServiceException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

# 크롤러 및 분류자 API
<a name="aws-glue-api-crawler"></a>

크롤러 및 분류자 API는 AWS Glue 크롤러 및 분류자 데이터 유형에 대해 설명하며 크롤러 또는 분류자를 생성, 삭제, 업데이트 및 나열하기 위한 API를 포함합니다.

**Topics**
+ [분류자 API](aws-glue-api-crawler-classifiers.md)
+ [크롤러 API](aws-glue-api-crawler-crawling.md)
+ [열 통계의 API](aws-glue-api-crawler-column-statistics.md)
+ [크롤러 스케줄러 API](aws-glue-api-crawler-scheduler.md)

# 분류자 API
<a name="aws-glue-api-crawler-classifiers"></a>

분류자 API는 AWS Glue 분류자 데이터 유형에 대해 설명하며 분류자를 생성, 삭제, 업데이트 및 나열하기 위한 API를 포함합니다.

## 데이터 타입
<a name="aws-glue-api-crawler-classifiers-objects"></a>
+ [분류자 구조](#aws-glue-api-crawler-classifiers-Classifier)
+ [GrokClassifier 구조](#aws-glue-api-crawler-classifiers-GrokClassifier)
+ [XMLClassifier 구조](#aws-glue-api-crawler-classifiers-XMLClassifier)
+ [JsonClassifier 구조](#aws-glue-api-crawler-classifiers-JsonClassifier)
+ [CsvClassifier 구조](#aws-glue-api-crawler-classifiers-CsvClassifier)
+ [CreateGrokClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest)
+ [UpdateGrokClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest)
+ [CreateXMLClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest)
+ [UpdateXMLClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest)
+ [CreateJsonClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest)
+ [UpdateJsonClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest)
+ [CreateCsvClassifierRequest 구조](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest)
+ [UpdateCsvClassifierRequest 구조](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest)

## 분류자 구조
<a name="aws-glue-api-crawler-classifiers-Classifier"></a>

분류자는 크롤링 작업 중에 시작됩니다. 분류자는 지정된 파일이 처리할 수 있는 형식인지 여부를 확인합니다. 처리할 수 있는 형식인 경우, 분류자는 해당 데이터 형식과 일치하는 `StructType` 객체의 형태로 스키마를 생성합니다.

AWS Glue가 제공하는 스탠더드 분류자를 사용하거나 자체 분류자를 작성하여 데이터 원본을 분류하고 분류자를 고려해 사용할 적절한 스키마를 지정합니다. 분류자는 `grok` 분류자이거나, `XML` 분류자이거나, `JSON` 분류자이거나, `Classifier` 객체의 필드 중 하나에 지정된 사용자 지정 `CSV` 분류자일 수 있습니다.

**필드**
+ `GrokClassifier` – [GrokClassifier](#aws-glue-api-crawler-classifiers-GrokClassifier) 객체입니다.

  `grok`을 사용하는 분류자입니다.
+ `XMLClassifier` – [XMLClassifier](#aws-glue-api-crawler-classifiers-XMLClassifier) 객체입니다.

  XML 콘텐츠의 분류자입니다.
+ `JsonClassifier` – [JsonClassifier](#aws-glue-api-crawler-classifiers-JsonClassifier) 객체입니다.

  JSON 콘텐츠의 분류자입니다.
+ `CsvClassifier` – [CsvClassifier](#aws-glue-api-crawler-classifiers-CsvClassifier) 객체입니다.

  쉼표로 구분된 값(CSV)의 분류자입니다.

## GrokClassifier 구조
<a name="aws-glue-api-crawler-classifiers-GrokClassifier"></a>

`grok` 패턴을 사용하는 분류자입니다.

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

  분류자의 이름입니다.
+ `Classification` – *필수(Required):* UTF-8 문자열입니다.

  Twitter, JSON, Omniture 로그, 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 분류자가 등록된 시간입니다.
+ `LastUpdated` – 타임스탬프입니다.

  이 분류자가 마지막으로 업데이트된 시간입니다.
+ `Version` - 숫자(정수)입니다.

  이 분류자 버전
+ `GrokPattern` – *필수(Required):* [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다.

  이 분류자에 의해 grok 패턴이 데이터 스토어로 적용됩니다. 자세한 내용은 [사용자 지정 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html)에서 기본 설정 패턴을 참조하십시오.
+ `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다.

  이 분류자가 정의한 조건부 사용자 지정 grok 패턴입니다. 자세한 내용은 [사용자 지정 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html)에서 사용자 지정 패턴을 참조하십시오.

## XMLClassifier 구조
<a name="aws-glue-api-crawler-classifiers-XMLClassifier"></a>

`XML` 내용의 분류자

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

  분류자의 이름입니다.
+ `Classification` – *필수(Required):* UTF-8 문자열입니다.

  분류자가 일치하는 데이터 양식의 분류자입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 분류자가 등록된 시간입니다.
+ `LastUpdated` – 타임스탬프입니다.

  이 분류자가 마지막으로 업데이트된 시간입니다.
+ `Version` - 숫자(정수)입니다.

  이 분류자 버전
+ `RowTag` – UTF-8 문자열입니다.

  각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, `<row item_a="A" item_b="B"></row>`는 괜찮지만 `<row item_a="A" item_b="B" />`는 괜찮지 않습니다).

## JsonClassifier 구조
<a name="aws-glue-api-crawler-classifiers-JsonClassifier"></a>

`JSON` 내용의 분류자

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

  분류자의 이름입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 분류자가 등록된 시간입니다.
+ `LastUpdated` – 타임스탬프입니다.

  이 분류자가 마지막으로 업데이트된 시간입니다.
+ `Version` - 숫자(정수)입니다.

  이 분류자 버전
+ `JsonPath` – *필수(Required):* UTF-8 문자열입니다.

  분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다.

## CsvClassifier 구조
<a name="aws-glue-api-crawler-classifiers-CsvClassifier"></a>

사용자 지정 `CSV` 콘텐츠의 분류자입니다.

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

  분류자의 이름입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 분류자가 등록된 시간입니다.
+ `LastUpdated` – 타임스탬프입니다.

  이 분류자가 마지막으로 업데이트된 시간입니다.
+ `Version` - 숫자(정수)입니다.

  이 분류자 버전
+ `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다.
+ `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다.
+ `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다.
+ `Header` – UTF-8 문자열의 배열입니다.

  열 이름을 나타내는 문자열 목록입니다.
+ `DisableValueTrimming` – 부울입니다.

  열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 `true`입니다.
+ `AllowSingleColumn` – 부울입니다.

  오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다.
+ `CustomDatatypeConfigured` – 부울입니다.

  사용자 지정 데이터 유형을 구성할 수 있습니다.
+ `CustomDatatypes` – UTF-8 문자열의 배열입니다.

  사용자 지정 데이터 유형 목록에는 “바이너리”, “부울”, “날짜”, “십진수”, “더블”, “플로트”, “INT”, “롱”, “쇼트”, “문자열”, “타임스탬프” 등이 포함됩니다.
+ `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다.

## CreateGrokClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest"></a>

생성할 `CreateClassifier`를 위해 `grok` 분류자를 지정합니다.

**필드**
+ `Classification` – *필수(Required):* UTF-8 문자열입니다.

  Twitter, JSON, Omniture Logs, Amazon CloudWatch Logs 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  새로운 분류자의 이름입니다.
+ `GrokPattern` – *필수(Required):* [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다.

  이 분류자가 사용하는 grok 패턴입니다.
+ `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다.

  이 분류자가 사용하는 조건부 사용자 지정 grok 패턴입니다.

## UpdateGrokClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest"></a>

`UpdateClassifier`로 전달되면 업데이트될 grok 분류자를 지정합니다.

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

  `GrokClassifier`의 이름입니다.
+ `Classification` – UTF-8 문자열입니다.

  Twitter, JSON, Omniture Logs, Amazon CloudWatch Logs 등과 같이 분류자가 일치하는 데이터 양식의 분류자입니다.
+ `GrokPattern` – [A Logstash Grok string pattern](aws-glue-api-common.md#aws-glue-api-grok-pattern)과(와) 일치하는 1\$12,048바이트 길이의 UTF-8 문자열입니다.

  이 분류자가 사용하는 grok 패턴입니다.
+ `CustomPatterns` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 16,000바이트 이하 길이의 UTF-8 문자열입니다.

  이 분류자가 사용하는 조건부 사용자 지정 grok 패턴입니다.

## CreateXMLClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest"></a>

생성할 `CreateClassifier`를 위해 XML 분류자를 지정합니다.

**필드**
+ `Classification` – *필수(Required):* UTF-8 문자열입니다.

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

  분류자의 이름입니다.
+ `RowTag` – UTF-8 문자열입니다.

  각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, `<row item_a="A" item_b="B"></row>`는 괜찮지만 `<row item_a="A" item_b="B" />`는 괜찮지 않습니다).

## UpdateXMLClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest"></a>

업데이트될 XML 분류자를 지정합니다.

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

  분류자의 이름입니다.
+ `Classification` – UTF-8 문자열입니다.

  분류자가 일치하는 데이터 양식의 분류자입니다.
+ `RowTag` – UTF-8 문자열입니다.

  각 기록을 구문 분석된 XML 문서에 포함하는 요소를 설계하는 XML 태그입니다. 이 태그는 자기 닫기 요소(`/>`에 의해 닫힌 요소)를 식별할 수 없습니다. 요소가 닫는 태그를 통해 종료되는 한 구문 분석된 속성만 포함하는 빈 행 요소입니다 (예를 들어, `<row item_a="A" item_b="B"></row>`는 괜찮지만 `<row item_a="A" item_b="B" />`는 괜찮지 않습니다).

## CreateJsonClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest"></a>

생성할 `CreateClassifier`를 위해 JSON 분류자를 지정합니다.

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

  분류자의 이름입니다.
+ `JsonPath` – *필수(Required):* UTF-8 문자열입니다.

  분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다.

## UpdateJsonClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest"></a>

업데이트될 JSON 분류자를 지정합니다.

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

  분류자의 이름입니다.
+ `JsonPath` – UTF-8 문자열입니다.

  분류자가 분류할 JSON 데이터를 정의하는 `JsonPath` 문자열입니다. AWS Glue는 [Writing JsonPath 사용자 정의 분류자 작성](https://docs.aws.amazon.com/glue/latest/dg/custom-classifier.html#custom-classifier-json)에 설명된 대로 JsonPath의 하위 집합을 지원합니다.

## CreateCsvClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest"></a>

생성할 `CreateClassifier`를 위해 사용자 지정 CSV 분류자를 지정합니다.

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

  분류자의 이름입니다.
+ `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다.
+ `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다.
+ `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다.
+ `Header` – UTF-8 문자열의 배열입니다.

  열 이름을 나타내는 문자열 목록입니다.
+ `DisableValueTrimming` – 부울입니다.

  열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 true입니다.
+ `AllowSingleColumn` – 부울입니다.

  오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다.
+ `CustomDatatypeConfigured` – 부울입니다.

  사용자 지정 데이터 유형을 구성할 수 있습니다.
+ `CustomDatatypes` – UTF-8 문자열의 배열입니다.

  지원되는 사용자 지정 데이터 유형 목록을 만듭니다.
+ `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다.

## UpdateCsvClassifierRequest 구조
<a name="aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest"></a>

업데이트될 사용자 지정 CSV 분류자를 지정합니다.

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

  분류자의 이름입니다.
+ `Delimiter` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  행의 열 입력 항목 각각을 구분하는 것을 나타내기 위한 사용자 지정 기호입니다.
+ `QuoteSymbol` – [Custom string pattern #26](aws-glue-api-common.md#regex_26)과(와) 일치하는 1\$11바이트 길이의 UTF-8 문자열입니다.

  단일 열 값에 내용을 결합하는 것을 나타내기 위한 사용자 지정 기호입니다. 열 구분 기호와 달라야 합니다.
+ `ContainsHeader` – UTF-8 문자열입니다(유효 값: `UNKNOWN` \$1 `PRESENT` \$1 `ABSENT`).

  CSV 파일에 헤더가 포함되어 있는지 여부를 나타냅니다.
+ `Header` – UTF-8 문자열의 배열입니다.

  열 이름을 나타내는 문자열 목록입니다.
+ `DisableValueTrimming` – 부울입니다.

  열 값의 유형을 식별하기 전에 값을 트리밍하지 않도록 지정합니다. 기본값은 true입니다.
+ `AllowSingleColumn` – 부울입니다.

  오직 하나의 열만 포함하는 파일을 처리할 수 있도록 합니다.
+ `CustomDatatypeConfigured` – 부울입니다.

  사용자 지정 데이터 유형의 구성을 지정합니다.
+ `CustomDatatypes` – UTF-8 문자열의 배열입니다.

  지원되는 사용자 지정 데이터 유형 목록을 지정합니다.
+ `Serde` – UTF-8 문자열입니다(유효한 값: `OpenCSVSerDe` \$1 `LazySimpleSerDe` \$1 `None`).

  분류자에서 CSV를 처리하기 위한 Serde를 설정합니다. 이는 데이터 카탈로그에서 적용됩니다. 유효한 값은 `OpenCSVSerDe`, `LazySimpleSerDe`, `None`입니다. 크롤러에서 감지하려는 경우 `None` 값을 지정할 수 있습니다.

## 운영
<a name="aws-glue-api-crawler-classifiers-actions"></a>
+ [CreateClassifier 작업(Python: create\$1classifier)](#aws-glue-api-crawler-classifiers-CreateClassifier)
+ [DeleteClassifier 작업(Python: delete\$1classifier)](#aws-glue-api-crawler-classifiers-DeleteClassifier)
+ [GetClassifier 작업(Python: get\$1classifier)](#aws-glue-api-crawler-classifiers-GetClassifier)
+ [GetClassifiers 작업(Python: get\$1classifiers)](#aws-glue-api-crawler-classifiers-GetClassifiers)
+ [UpdateClassifier 작업(Python: update\$1classifier)](#aws-glue-api-crawler-classifiers-UpdateClassifier)

## CreateClassifier 작업(Python: create\$1classifier)
<a name="aws-glue-api-crawler-classifiers-CreateClassifier"></a>

사용자 계정에 분류자를 만듭니다. 이 분류자는 어떤 요청 필드가 존재하는지에 따라 `GrokClassifier`, `XMLClassifier`, `JsonClassifier` 또는 `CsvClassifier`일 수 있습니다.

**요청**
+ `GrokClassifier` – [CreateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-CreateGrokClassifierRequest) 객체입니다.

  `GrokClassifier` 객체는 생성할 분류자를 지정합니다.
+ `XMLClassifier` – [CreateXMLClassifierRequest](#aws-glue-api-crawler-classifiers-CreateXMLClassifierRequest) 객체입니다.

  `XMLClassifier` 객체는 생성할 분류자를 지정합니다.
+ `JsonClassifier` – [CreateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-CreateJsonClassifierRequest) 객체입니다.

  `JsonClassifier` 객체는 생성할 분류자를 지정합니다.
+ `CsvClassifier` – [CreateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-CreateCsvClassifierRequest) 객체입니다.

  `CsvClassifier` 객체는 생성할 분류자를 지정합니다.

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

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## DeleteClassifier 작업(Python: delete\$1classifier)
<a name="aws-glue-api-crawler-classifiers-DeleteClassifier"></a>

데이터 카탈로그에서 분류자를 제거합니다.

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

  제거할 분류자의 이름입니다.

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

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetClassifier 작업(Python: get\$1classifier)
<a name="aws-glue-api-crawler-classifiers-GetClassifier"></a>

이름에 따라 분류자를 검색합니다.

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

  검색할 분류자의 이름입니다.

**응답**
+ `Classifier` – [분류자](#aws-glue-api-crawler-classifiers-Classifier) 객체입니다.

  요청된 분류자

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetClassifiers 작업(Python: get\$1classifiers)
<a name="aws-glue-api-crawler-classifiers-GetClassifiers"></a>

데이터 카탈로그에서 분류자 객체를 열거합니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 크기(선택 사항)입니다.
+ `NextToken` – UTF-8 문자열입니다.

  연속 토큰(선택 사항).

**응답**
+ `Classifiers` – [분류자](#aws-glue-api-crawler-classifiers-Classifier) 객체의 배열입니다.

  분류자 객체의 요청한 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  연속 토큰

**오류**
+ `OperationTimeoutException`

## UpdateClassifier 작업(Python: update\$1classifier)
<a name="aws-glue-api-crawler-classifiers-UpdateClassifier"></a>

기존 분류자(어떤 필드가 존재하는지에 따라 `GrokClassifier`, `XMLClassifier`, `JsonClassifier` 또는 `CsvClassifier` 분류자)를 수정합니다.

**요청**
+ `GrokClassifier` – [UpdateGrokClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateGrokClassifierRequest) 객체입니다.

  업데이트도니 필드와 `GrokClassifier` 객체.
+ `XMLClassifier` – [UpdateXMLClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateXMLClassifierRequest) 객체입니다.

  업데이트도니 필드와 `XMLClassifier` 객체.
+ `JsonClassifier` – [UpdateJsonClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateJsonClassifierRequest) 객체입니다.

  업데이트도니 필드와 `JsonClassifier` 객체.
+ `CsvClassifier` – [UpdateCsvClassifierRequest](#aws-glue-api-crawler-classifiers-UpdateCsvClassifierRequest) 객체입니다.

  업데이트도니 필드와 `CsvClassifier` 객체.

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

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

# 크롤러 API
<a name="aws-glue-api-crawler-crawling"></a>

크롤러 API는 크롤러를 생성, 삭제, 업데이트 및 나열하기 위한 API와 함께 AWS Glue 크롤러 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-crawler-crawling-objects"></a>
+ [크롤러 구조](#aws-glue-api-crawler-crawling-Crawler)
+ [일정 구조](#aws-glue-api-crawler-crawling-Schedule)
+ [CrawlerTargets 구조](#aws-glue-api-crawler-crawling-CrawlerTargets)
+ [S3Target 구조](#aws-glue-api-crawler-crawling-S3Target)
+ [S3DeltaCatalogTarget 구조](#aws-glue-api-crawler-crawling-S3DeltaCatalogTarget)
+ [S3DeltaDirectTarget 구조](#aws-glue-api-crawler-crawling-S3DeltaDirectTarget)
+ [JdbcTarget 구조](#aws-glue-api-crawler-crawling-JdbcTarget)
+ [MongoDBTarget 구조](#aws-glue-api-crawler-crawling-MongoDBTarget)
+ [DynamoDBTarget 구조](#aws-glue-api-crawler-crawling-DynamoDBTarget)
+ [DeltaTarget 구조](#aws-glue-api-crawler-crawling-DeltaTarget)
+ [IcebergTarget 구조](#aws-glue-api-crawler-crawling-IcebergTarget)
+ [HudiTarget 구조](#aws-glue-api-crawler-crawling-HudiTarget)
+ [CatalogTarget 구조](#aws-glue-api-crawler-crawling-CatalogTarget)
+ [CrawlerMetrics 구조](#aws-glue-api-crawler-crawling-CrawlerMetrics)
+ [CrawlerHistory 구조](#aws-glue-api-crawler-crawling-CrawlerHistory)
+ [CrawlsFilter 구조](#aws-glue-api-crawler-crawling-CrawlsFilter)
+ [SchemaChangePolicy 구조](#aws-glue-api-crawler-crawling-SchemaChangePolicy)
+ [LastCrawlInfo 구조](#aws-glue-api-crawler-crawling-LastCrawlInfo)
+ [RecrawlPolicy 구조](#aws-glue-api-crawler-crawling-RecrawlPolicy)
+ [LineageConfiguration 구조](#aws-glue-api-crawler-crawling-LineageConfiguration)
+ [LakeFormationConfiguration 구조](#aws-glue-api-crawler-crawling-LakeFormationConfiguration)

## 크롤러 구조
<a name="aws-glue-api-crawler-crawling-Crawler"></a>

데이터 원본을 검사하는 크롤러 프로그램을 지정하고 분류자를 사용하여 스키마를 결정합니다. 성공적이면 크롤러는 AWS Glue Data Catalog의 데이터 원본을 고려하여 메타데이터를 기록합니다.

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

  크롤러의 이름입니다.
+ `Role` – UTF-8 문자열입니다.

  Amazon Simple Storage Service(Amazon S3) 데이터 등의 고객 리소스에 액세스하는 데 사용되는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `Targets` – [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다.

  크롤할 대상 모음입니다.
+ `DatabaseName` – UTF-8 문자열입니다.

  크롤러의 출력이 저장되는 데이터베이스의 이름입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  크롤러에 대한 설명.
+ `Classifiers` – UTF-8 문자열의 배열입니다.

  크롤러와 연결된 사용자 지정 분류자를 지정하는 UTF-8 문자열 목록입니다.
+ `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다.

  전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다.
+ `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 및 삭제 동작을 지정하는 정책입니다.
+ `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다.

  크롤러에 대해 데이터 계보가 사용되는지 여부를 지정하는 구성입니다.
+ `State` – UTF-8 문자열입니다(유효 값: `READY` \$1 `RUNNING` \$1 `STOPPING`).

  크롤러가 실행되거나 실행되지 않았는지 여부를 나타냅니다.
+ `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  생성된 테이블 이름에 추가된 접두사.
+ `Schedule` – [일정](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule) 객체입니다.

  일정이 짜여진 크롤러를 위한 크롤러가 실행될 때의 일정.
+ `CrawlElapsedTime` - 숫자(정수)입니다.

  크롤러가 실행되면 마지막 크롤이 시작된 후부터 총 경과 시간.
+ `CreationTime` – 타임스탬프입니다.

  크롤러가 생성된 시간.
+ `LastUpdated` – 타임스탬프입니다.

  크롤러가 마지막으로 업데이트된 시간.
+ `LastCrawl` – [LastCrawlInfo](#aws-glue-api-crawler-crawling-LastCrawlInfo) 객체입니다.

  마지막 크롤 상태 및 오류가 발생한 잠재적 오류 정보.
+ `Version` - 숫자(정수)입니다.

  크롤러 버전.
+ `Configuration` – UTF-8 문자열입니다.

  크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요.
+ `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다.

  크롤러가 IAM 역할 자격 증명 대신 AWS Lake Formation 자격 증명을 크롤러에 사용해야 하는지 지정합니다.

## 일정 구조
<a name="aws-glue-api-crawler-crawling-Schedule"></a>

`cron`을 사용하여 객체의 일정을 정하여 이벤트의 일정을 정합니다.

**Fields**
+ `ScheduleExpression` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `State` – UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`).

  일정 상태

## CrawlerTargets 구조
<a name="aws-glue-api-crawler-crawling-CrawlerTargets"></a>

크롤할 데이터 스토어 지정.

**Fields**
+ `S3Targets` – [S3Target](#aws-glue-api-crawler-crawling-S3Target) 객체의 배열입니다.

  Amazon Simple Storage Service(Amazon S3) 대상을 지정합니다.
+ `JdbcTargets` – [JdbcTarget](#aws-glue-api-crawler-crawling-JdbcTarget) 객체의 배열입니다.

  JDBC 대상 지정
+ `MongoDBTargets` – [MongoDBTarget](#aws-glue-api-crawler-crawling-MongoDBTarget) 객체의 배열입니다.

  Amazon DocumentDB 또는 MongoDB 대상을 지정합니다.
+ `DynamoDBTargets` – [DynamoDBTarget](#aws-glue-api-crawler-crawling-DynamoDBTarget) 객체의 배열입니다.

  Amazon DynamoDB 대상을 지정합니다.
+ `CatalogTargets` – [CatalogTarget](#aws-glue-api-crawler-crawling-CatalogTarget) 객체의 배열입니다.

  AWS Glue Data Catalog 대상을 지정합니다.
+ `DeltaTargets` – [DeltaTarget](#aws-glue-api-crawler-crawling-DeltaTarget) 객체의 배열입니다.

  델타 데이터 스토어 대상을 지정합니다.
+ `IcebergTargets` – [IcebergTarget](#aws-glue-api-crawler-crawling-IcebergTarget) 객체의 배열입니다.

  Apache Iceberg 데이터 스토어 대상을 지정합니다.
+ `HudiTargets` – [HudiTarget](#aws-glue-api-crawler-crawling-HudiTarget) 객체의 배열입니다.

  Apache Hudi 데이터 스토어 대상을 지정합니다.

## S3Target 구조
<a name="aws-glue-api-crawler-crawling-S3Target"></a>

Amazon Simple Storage Service(Amazon S3)의 데이터 스토어를 지정합니다.

**Fields**
+ `Path` – UTF-8 문자열입니다.

  Amazon S3 대상에 대한 경로입니다.
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오.
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  작업 또는 크롤러가 Amazon Virtual Private Cloud 환경(Amazon VPC) 내에서 Amazon S3의 데이터에 액세스할 수 있도록 허용하는 연결 이름입니다.
+ `SampleSize` - 숫자(정수)입니다.

  데이터 집합의 샘플 파일을 크롤링할 때 크롤링할 각 리프 폴더의 파일 수를 설정합니다. 설정하지 않으면 모든 파일이 크롤링됩니다. 유효한 값은 1\$1249의 정수입니다.
+ `EventQueueArn` – UTF-8 문자열입니다.

  유효한 Amazon SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:sqs`입니다.
+ `DlqEventQueueArn` – UTF-8 문자열입니다.

  유효한 Amazon 배달 못한 편지 SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:deadLetterQueue`입니다.

## S3DeltaCatalogTarget 구조
<a name="aws-glue-api-crawler-crawling-S3DeltaCatalogTarget"></a>

AWS Glue 데이터 카탈로그의 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Delta 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.
+ `OutputSchemas` – [GlueSchema](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Delta 카탈로그 대상의 데이터 스키마를 지정합니다.

## S3DeltaDirectTarget 구조
<a name="aws-glue-api-crawler-crawling-S3DeltaDirectTarget"></a>

Amazon S3에서 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 Delta Lake 데이터 소스의 Amazon S3 경로입니다.
+ `Compression` – *필수:* UTF-8 문자열입니다(유효한 값: `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  Amazon S3 전체에 Delta Lake 데이터세트 파일을 배포할 대상 파티션 수를 지정합니다.
+ `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  대상에 대한 데이터 출력 포맷을 지정합니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Delta 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## JdbcTarget 구조
<a name="aws-glue-api-crawler-crawling-JdbcTarget"></a>

크롤할 JDBC 데이터 스토어 지정.

**Fields**
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  JDBC 대상에 연결할 연결 이름입니다.
+ `Path` – UTF-8 문자열입니다.

  JDBC 대상의 경로입니다.
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오.
+ `EnableAdditionalMetadata` – UTF-8 문자열의 배열입니다.

  `RAWTYPES` 또는 `COMMENTS` 값을 지정하여 테이블 응답에서 추가 메타데이터를 활성화합니다. `RAWTYPES`는 기본 레벨 데이터 유형을 제공합니다. `COMMENTS`는 데이터베이스의 열 또는 테이블과 연결된 설명을 제공합니다.

  추가 메타데이터가 필요하지 않은 경우 필드를 비워 두세요.

## MongoDBTarget 구조
<a name="aws-glue-api-crawler-crawling-MongoDBTarget"></a>

크롤링할 Amazon DocumentDB 또는 MongoDB 데이터 스토어를 지정합니다.

**Fields**
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  Amazon DocumentDB 또는 MongoDB 대상에 연결하는 데 사용할 연결 이름입니다.
+ `Path` – UTF-8 문자열입니다.

  Amazon DocumentDB 또는 MongoDB 대상(데이터베이스/컬렉션)의 경로입니다.
+ `ScanAll` – 부울입니다.

  모든 레코드를 스캔할지 또는 테이블에서 행을 샘플링할지 여부를 나타냅니다. 테이블이 높은 처리량 테이블이 아닌 경우 모든 레코드를 스캔하는 데 시간이 오래 걸릴 수 있습니다.

  `true` 값은 모든 레코드를 스캔하는 것을 의미하고 `false` 값은 레코드를 샘플링하는 것을 의미합니다. 값을 지정하지 않으면 기본값은 `true`입니다.

## DynamoDBTarget 구조
<a name="aws-glue-api-crawler-crawling-DynamoDBTarget"></a>

크롤할 Amazon DynamoDB 테이블을 지정합니다.

**Fields**
+ `Path` – UTF-8 문자열입니다.

  크롤할 DynamoDB 테이블의 이름입니다.
+ `scanAll` – 부울입니다.

  모든 레코드를 스캔할지 또는 테이블에서 행을 샘플링할지 여부를 나타냅니다. 테이블이 높은 처리량 테이블이 아닌 경우 모든 레코드를 스캔하는 데 시간이 오래 걸릴 수 있습니다.

  `true` 값은 모든 레코드를 스캔하는 것을 의미하고 `false` 값은 레코드를 샘플링하는 것을 의미합니다. 값을 지정하지 않으면 기본값은 `true`입니다.
+ `scanRate` - 숫자(double)입니다.

  AWS Glue 크롤러에서 사용할 구성된 읽기 용량 단위의 비율입니다. 읽기 용량 단위는 DynamoDB에서 정의한 용어이며, 초당 해당 테이블에서 수행할 수 있는 읽기 수에 대한 속도 제한기 역할을 하는 숫자 값입니다.

  유효한 값은 null 또는 0.1\$11.5의 값입니다. null 값은 사용자가 값을 제공하지 않을 때 사용되며, 기본값은 구성된 읽기 용량 단위의 0.5(프로비저닝된 테이블의 경우) 또는 구성된 최대 읽기 용량 단위의 0.25(온디맨드 모드를 사용하는 테이블의 경우)입니다.

## DeltaTarget 구조
<a name="aws-glue-api-crawler-crawling-DeltaTarget"></a>

하나 이상의 델타 테이블을 크롤링할 델타 데이터 스토어를 지정합니다.

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

  델타 테이블에 대한 Amazon S3 경로 목록입니다.
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  델타 테이블 대상에 연결하는 데 사용할 연결 이름입니다.
+ `WriteManifest` – 부울입니다.

  매니페스트 파일을 델타 테이블 경로에 쓸지 지정합니다.
+ `CreateNativeDeltaTable` – 부울입니다.

  크롤러가 Delta 트랜잭션 로그의 쿼리를 직접 지원하는 쿼리 엔진과 통합할 수 있도록 기본 테이블을 생성할지 여부를 지정합니다.

## IcebergTarget 구조
<a name="aws-glue-api-crawler-crawling-IcebergTarget"></a>

Amazon S3에서 Iceberg 테이블이 저장되는 Apache Iceberg 데이터 소스를 지정합니다.

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

  Iceberg 메타데이터 폴더를 `s3://bucket/prefix`로 포함하는 하나 이상의 Amazon S3 경로입니다.
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  Iceberg 대상에 연결하는 데 사용할 연결 이름입니다.
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오.
+ `MaximumTraversalDepth` - 숫자(정수)입니다.

  크롤러가 Amazon S3 경로에 있는 Iceberg 메타데이터 폴더를 검색하기 위해 탐색할 수 있는 Amazon S3 경로의 최대 깊이입니다. 크롤러 실행 시간을 제한하는 데 사용됩니다.

## HudiTarget 구조
<a name="aws-glue-api-crawler-crawling-HudiTarget"></a>

Apache Hudi 데이터 소스를 지정합니다.

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

  Hudi의 Amazon S3 위치 문자열 배열로, 각각 Hudi 테이블의 메타데이터 파일이 있는 루트 폴더를 나타냅니다. Hudi 폴더는 루트 폴더의 하위 폴더에 있을 수 있습니다.

  크롤러는 경로 아래에 있는 모든 폴더에서 Hudi 폴더를 스캔합니다.
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  Hudi 대상에 연결하는 데 사용할 연결 이름입니다. VPC 인증이 필요한 버킷에 Hudi 파일이 저장된 경우 여기에서 연결 속성을 설정할 수 있습니다.
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  크롤링에서 제외하는 데 사용되는 glob 패턴 목록입니다. 자세한 내용은 [크롤러를 사용하여 테이블 분류](https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html)를 참조하십시오.
+ `MaximumTraversalDepth` - 숫자(정수)입니다.

  크롤러가 Amazon S3 경로에 있는 Hudi 메타데이터 폴더를 검색하기 위해 탐색할 수 있는 Amazon S3 경로의 최대 깊이입니다. 크롤러 실행 시간을 제한하는 데 사용됩니다.

## CatalogTarget 구조
<a name="aws-glue-api-crawler-crawling-CatalogTarget"></a>

AWS Glue Data Catalog 대상을 지정합니다.

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

  동기화할 데이터베이스의 이름입니다.
+ `Tables` – *필수(Required):* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다.

  동기화할 테이블의 목록입니다.
+ `ConnectionName` – UTF-8 문자열입니다(1\$12,048바이트).

  `NETWORK` 연결 유형에 페어링된 `Catalog` 연결 유형을 사용할 때 Amazon S3 기반 데이터 카탈로그 테이블이 크롤링의 대상이 되도록 하는 연결의 이름입니다.
+ `EventQueueArn` – UTF-8 문자열입니다.

  유효한 Amazon SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:sqs`입니다.
+ `DlqEventQueueArn` – UTF-8 문자열입니다.

  유효한 Amazon 배달 못한 편지 SQS ARN입니다. 예를 들어 `arn:aws:sqs:region:account:deadLetterQueue`입니다.

## CrawlerMetrics 구조
<a name="aws-glue-api-crawler-crawling-CrawlerMetrics"></a>

지정한 크롤러에 대한 지표.

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

  크롤러의 이름입니다.
+ `TimeLeftSeconds` – None 이하의 숫자(실수)입니다.

  크롤을 완료할 때까지 남은 예상 시간.
+ `StillEstimating` – 부울입니다.

  이 작업이 완료될 때까지 소요 시간을 여전히 추정하고 있다면 True입니다.
+ `LastRuntimeSeconds` – None 이하의 숫자(실수)입니다.

  초 단위의 크롤러의 최근 작업 실행 지속 시간.
+ `MedianRuntimeSeconds` – None 이하의 숫자(실수)입니다.

  초 단위의 크롤러의 평균 작업 실행 지속 시간.
+ `TablesCreated` – None 이하의 숫자(정수)입니다.

  이 크롤러가 생성한 테이블 수.
+ `TablesUpdated` – None 이하의 숫자(정수)입니다.

  이 크롤러가 업데이트한 테이블 수.
+ `TablesDeleted` – None 이하의 숫자(정수)입니다.

  이 크롤러가 삭제한 테이블 수.

## CrawlerHistory 구조
<a name="aws-glue-api-crawler-crawling-CrawlerHistory"></a>

크롤러 실행에 대한 정보가 포함되어 있습니다.

**Fields**
+ `CrawlId` – UTF-8 문자열입니다.

  각 크롤링에 대한 UUID 식별자입니다.
+ `State` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `COMPLETED` \$1 `FAILED` \$1 `STOPPED`).

  크롤의 상태.
+ `StartTime` – 타임스탬프입니다.

  크롤이 시작된 날짜와 시간입니다.
+ `EndTime` – 타임스탬프입니다.

  크롤이 시작된 날짜와 시간.
+ `Summary` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  JSON의 특정 크롤에 대한 실행 요약. 추가, 업데이트 또는 삭제된 카탈로그 테이블 및 파티션을 포함합니다.
+ `ErrorMessage` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  (오류가 발생한 경우) 크롤과 연결된 오류 메시지.
+ `LogGroup` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id)

  크롤과 연결된 로그 그룹입니다.
+ `LogStream` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id)

  크롤과 연결된 로그 스트림입니다.
+ `MessagePrefix` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 크롤에 관한 CloudWatch 메시지 접두사.
+ `DPUHour` – None 이하의 숫자(실수)입니다.

  크롤에 사용된 DPU(데이터 처리 단위)의 수(시간 단위).

## CrawlsFilter 구조
<a name="aws-glue-api-crawler-crawling-CrawlsFilter"></a>

지정된 크롤러에 대한 크롤러 실행을 필터링하는 데 사용할 수 있는 필드, 비교기 및 값의 목록입니다.

**Fields**
+ `FieldName` – UTF-8 문자열입니다(유효한 값: `CRAWL_ID` \$1 `STATE` \$1 `START_TIME` \$1 `END_TIME` \$1 `DPU_HOUR`).

  지정된 크롤러에 대한 크롤러 실행 필터링에 사용되는 키. 각 필드 이름에 유효한 값은 다음과 같습니다.
  + `CRAWL_ID`: 크롤링의 UUID 식별자를 나타내는 문자열.
  + `STATE`: 크롤의 상태를 나타내는 문자열.
  + `START_TIME` 및 `END_TIME`: 밀리초 단위의 Epoch 타임스탬프.
  + `DPU_HOUR`: 크롤에 사용된 DPU(데이터 처리 단위)의 수(시간 단위).
+ `FilterOperator` – UTF-8 문자열입니다(유효 값: `GT` \$1 `GE` \$1 `LT` \$1 `LE` \$1 `EQ` \$1 `NE`).

  값의 연산을 수행하는 정의된 비교기. 사용 가능한 연산자는 다음과 같습니다.
  + `GT`: 큼.
  + `GE`: 크거나 같음.
  + `LT`: 작음.
  + `LE`: 작거나 같음.
  + `EQ`: 같음.
  + `NE`: 같지 않음.
+ `FieldValue` – UTF-8 문자열입니다.

  크롤 필드에서 비교하기 위해 제공된 값입니다.

## SchemaChangePolicy 구조
<a name="aws-glue-api-crawler-crawling-SchemaChangePolicy"></a>

크롤러에 대한 업데이트 및 삭제 동작을 지정하는 정책입니다.

**Fields**
+ `UpdateBehavior` – UTF-8 문자열입니다(유효 값: `LOG` \$1 `UPDATE_IN_DATABASE`).

  크롤러가 변화된 객체를 찾을 때 업데이트 동작.
+ `DeleteBehavior` – UTF-8 문자열입니다(유효 값: `LOG` \$1 `DELETE_FROM_DATABASE` \$1 `DEPRECATE_IN_DATABASE`).

  크롤러가 변화된 혹은 삭제된 객체를 찾을 때 삭제 동작.

## LastCrawlInfo 구조
<a name="aws-glue-api-crawler-crawling-LastCrawlInfo"></a>

최신 크롤의 상태 및 오류 정보.

**Fields**
+ `Status` – UTF-8 문자열입니다(유효한 값: `SUCCEEDED` \$1 `CANCELLED` \$1 `FAILED`).

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

  오류가 발생할 때 마지막 크롤에 대한 오류 정보.
+ `LogGroup` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id)

  마지막 크롤의 로그 그룹.
+ `LogStream` – 과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다..[Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id)

  마지막 크롤의 로그 스트림.
+ `MessagePrefix` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 크롤 메시지에 대한 접두사.
+ `StartTime` – 타임스탬프입니다.

  크롤이 시작된 시간.

## RecrawlPolicy 구조
<a name="aws-glue-api-crawler-crawling-RecrawlPolicy"></a>

첫 번째 크롤링이 완료된 후 Amazon S3 데이터 원본을 크롤링할 때 전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후에 추가된 폴더만 크롤링할지 지정합니다. 자세한 내용은 SageMaker 개발자 안내서의 [AWS Glue의 증분 크롤링](https://docs.aws.amazon.com/glue/latest/dg/incremental-crawls.html)을 참조하세요.

**Fields**
+ `RecrawlBehavior` – UTF-8 문자열입니다(유효한 값: `CRAWL_EVERYTHING` \$1 `CRAWL_NEW_FOLDERS_ONLY` \$1 `CRAWL_EVENT_MODE`).

  전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정합니다.

  값 `CRAWL_EVERYTHING`은 전체 데이터 집합을 다시 크롤링하도록 지정합니다.

  값 `CRAWL_NEW_FOLDERS_ONLY`는 마지막 크롤러 실행 이후에 추가된 폴더만 크롤링하도록 지정합니다.

  값 `CRAWL_EVENT_MODE`는 Amazon S3 이벤트에서 식별된 변경 사항만 크롤링하도록 지정합니다.

## LineageConfiguration 구조
<a name="aws-glue-api-crawler-crawling-LineageConfiguration"></a>

크롤러에 대한 데이터 계보 구성 설정을 지정합니다.

**Fields**
+ `CrawlerLineageSettings` – UTF-8 문자열입니다(유효 값: `ENABLE` \$1 `DISABLE`).

  크롤러에 데이터 계보가 사용되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
  + [사용(ENABLE)]: 크롤러에 데이터 계보를 사용합니다.
  + [사용 중지(DISABLE)]: 크롤러에 데이터 계보 사용을 중지합니다.

## LakeFormationConfiguration 구조
<a name="aws-glue-api-crawler-crawling-LakeFormationConfiguration"></a>

크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다.

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

  IAM 역할 자격 증명 대신 AWS Lake Formation 자격 증명을 크롤러에 사용해야 하는지 지정합니다.
+ `AccountId` – UTF-8 문자열입니다(12바이트 이하).

  교차 계정 크롤링에 필요합니다. 대상 데이터와 동일한 계정 크롤링의 경우 이 값을 null로 둘 수 있습니다.

## 작업
<a name="aws-glue-api-crawler-crawling-actions"></a>
+ [CreateCrawler 작업(Python: create\$1crawler)](#aws-glue-api-crawler-crawling-CreateCrawler)
+ [DeleteCrawler 작업(Python: delete\$1crawler)](#aws-glue-api-crawler-crawling-DeleteCrawler)
+ [GetCrawler 작업(Python: get\$1crawler)](#aws-glue-api-crawler-crawling-GetCrawler)
+ [GetCrawlers 작업(Python: get\$1crawler)](#aws-glue-api-crawler-crawling-GetCrawlers)
+ [GetCrawlerMetrics Action(Python: get\$1crawler\$1metrics)](#aws-glue-api-crawler-crawling-GetCrawlerMetrics)
+ [UpdateCrawler 작업(Python: update\$1crawler)](#aws-glue-api-crawler-crawling-UpdateCrawler)
+ [StartCrawler 작업(Python: start\$1crawler)](#aws-glue-api-crawler-crawling-StartCrawler)
+ [StopCrawler 작업(Python: stop\$1crawler)](#aws-glue-api-crawler-crawling-StopCrawler)
+ [BatchGetCrawlers 작업(Python: batch\$1get\$1crawlers)](#aws-glue-api-crawler-crawling-BatchGetCrawlers)
+ [ListCrawlers 작업(Python: list\$1crawlers)](#aws-glue-api-crawler-crawling-ListCrawlers)
+ [ListCrawls 작업(Python: list\$1crawls)](#aws-glue-api-crawler-crawling-ListCrawls)

## CreateCrawler 작업(Python: create\$1crawler)
<a name="aws-glue-api-crawler-crawling-CreateCrawler"></a>

지정된 대상, 역할, 구성 및 선택 일정을 통해 새로운 크롤러를 생성합니다. `s3Targets` 필드, `jdbcTargets` 필드 또는 `DynamoDBTargets` 필드에서 크롤 대상을 하나 이상 지정해야 합니다.

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

  새로운 크롤러의 이름.
+ `Role` – *필수(Required):* UTF-8 문자열입니다.

  새로운 크롤러를 사용하여 고객 리소스에 액세스하는 IAM 역할 또는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `DatabaseName` – UTF-8 문자열입니다.

  `arn:aws:daylight:us-east-1::database/sometable/*`와 같은 결과가 작성되는 AWS Glue 데이터베이스입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  새로운 크롤러에 대한 설명.
+ `Targets` – *필수(Required):* [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다.

  크롤할 대상 모음의 기록.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Classifiers` – UTF-8 문자열의 배열입니다.

  사용자가 등록한 사용자 지정 분류자 목록. 기본적으로 모든 기본 설정 분류자는 크롤러에 포함되지만 이 사용자 지정 분류자는 항상 주어진 분류에 대한 기본 분류자를 재정의합니다.
+ `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  생성된 카탈로그 테이블에 사용되는 테이블 접두사입니다.
+ `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다.

  크롤러의 업데이트 및 삭제 동작 정책입니다.
+ `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다.

  전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다.
+ `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다.

  크롤러에 대한 데이터 계보 구성 설정을 지정합니다.
+ `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다.

  크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다.
+ `Configuration` – UTF-8 문자열입니다.

  크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요.
+ `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 크롤러 요청에서 사용할 태그입니다. 태그를 사용하여 크롤러에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.

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

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`

## DeleteCrawler 작업(Python: delete\$1crawler)
<a name="aws-glue-api-crawler-crawling-DeleteCrawler"></a>

크롤러 상태가 `RUNNING`이 아닌 한, AWS Glue Data Catalog에서 지정한 크롤러를 제거합니다.

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

  제거할 크롤러의 이름입니다.

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

**오류**
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

## GetCrawler 작업(Python: get\$1crawler)
<a name="aws-glue-api-crawler-crawling-GetCrawler"></a>

지정한 크롤러의 메타데이터 가져오기

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

  메타데이터를 검색할 크롤러 이름입니다.

**응답**
+ `Crawler` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체입니다.

  지정한 크롤러의 메타데이터

**오류**
+ `EntityNotFoundException`
+ `OperationTimeoutException`

## GetCrawlers 작업(Python: get\$1crawler)
<a name="aws-glue-api-crawler-crawling-GetCrawlers"></a>

사용자 계정에 정의된 모든 크롤러의 메타데이터를 가져옵니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  각 호출에 따라 반환할 크롤러의 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.

**응답**
+ `Crawlers` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체의 배열입니다.

  크롤러 메타데이터의 목록.
+ `NextToken` – UTF-8 문자열입니다.

  이 사용자 계정에 정의된 것들의 끝에 반환된 목록이 도달하지 못한 경우, 지속적인 토큰입니다.

**오류**
+ `OperationTimeoutException`

## GetCrawlerMetrics Action(Python: get\$1crawler\$1metrics)
<a name="aws-glue-api-crawler-crawling-GetCrawlerMetrics"></a>

지정한 크롤러의 지표 가져오기

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

  지표를 가져올 크롤러의 이름 목록.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `CrawlerMetricsList` – [CrawlerMetrics](#aws-glue-api-crawler-crawling-CrawlerMetrics) 객체의 배열입니다.

  지정한 크롤러에 대한 지표 목록.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

**오류**
+ `OperationTimeoutException`

## UpdateCrawler 작업(Python: update\$1crawler)
<a name="aws-glue-api-crawler-crawling-UpdateCrawler"></a>

크롤러 업데이트. 크롤러가 실행 중이면 업데이트하기 전에는 `StopCrawler`를 사용하여 중지해야 합니다.

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

  새로운 크롤러의 이름.
+ `Role` – UTF-8 문자열입니다.

  새로운 크롤러를 사용하여 고객 리소스에 액세스하는 IAM 역할 또는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `DatabaseName` – UTF-8 문자열입니다.

  `arn:aws:daylight:us-east-1::database/sometable/*`와 같은 결과가 저장되는 AWS Glue 데이터베이스입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  새로운 크롤러에 대한 설명.
+ `Targets` – [CrawlerTargets](#aws-glue-api-crawler-crawling-CrawlerTargets) 객체입니다.

  크롤할 대상 목록.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Classifiers` – UTF-8 문자열의 배열입니다.

  사용자가 등록한 사용자 지정 분류자 목록. 기본적으로 모든 기본 설정 분류자는 크롤러에 포함되지만 이 사용자 지정 분류자는 항상 주어진 분류에 대한 기본 분류자를 재정의합니다.
+ `TablePrefix` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  생성된 카탈로그 테이블에 사용되는 테이블 접두사입니다.
+ `SchemaChangePolicy` – [SchemaChangePolicy](#aws-glue-api-crawler-crawling-SchemaChangePolicy) 객체입니다.

  크롤러의 업데이트 및 삭제 동작 정책입니다.
+ `RecrawlPolicy` – [RecrawlPolicy](#aws-glue-api-crawler-crawling-RecrawlPolicy) 객체입니다.

  전체 데이터 집합을 다시 크롤링할지 아니면 마지막 크롤러 실행 이후 추가된 폴더만 크롤링할지 지정하는 정책입니다.
+ `LineageConfiguration` – [LineageConfiguration](#aws-glue-api-crawler-crawling-LineageConfiguration) 객체입니다.

  크롤러에 대한 데이터 계보 구성 설정을 지정합니다.
+ `LakeFormationConfiguration` – [LakeFormationConfiguration](#aws-glue-api-crawler-crawling-LakeFormationConfiguration) 객체입니다.

  크롤러에 대한 AWS Lake Formation 구성 설정을 지정합니다.
+ `Configuration` – UTF-8 문자열입니다.

  크롤러 구성 정보. 이 버전의 JSON 문자열은 사용자가 크롤러 동작을 지정할 수 있게 만듭니다. 자세한 내용을 알아보려면 [크롤러 구성 옵션 설정](https://docs.aws.amazon.com/glue/latest/dg/crawler-configuration.html)을 참조하세요.
+ `CrawlerSecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  이 크롤러가 사용할 `SecurityConfiguration` 구조의 이름입니다.

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

**오류**
+ `InvalidInputException`
+ `VersionMismatchException`
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `OperationTimeoutException`

## StartCrawler 작업(Python: start\$1crawler)
<a name="aws-glue-api-crawler-crawling-StartCrawler"></a>

어떤 일정이든지 지정된 크롤러를 사용하여 크롤러를 시작합니다. 크롤러가 이미 실행 중이면 [CrawlerRunningException](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-exceptions.html#aws-glue-api-exceptions-CrawlerRunningException)을 반환합니다.

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

  시작할 크롤러의 이름.

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

**오류**
+ `EntityNotFoundException`
+ `CrawlerRunningException`
+ `OperationTimeoutException`

## StopCrawler 작업(Python: stop\$1crawler)
<a name="aws-glue-api-crawler-crawling-StopCrawler"></a>

지정된 크롤러가 실행 중이면 크롤러를 중지합니다.

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

  중지할 크롤러의 이름.

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

**오류**
+ `EntityNotFoundException`
+ `CrawlerNotRunningException`
+ `CrawlerStoppingException`
+ `OperationTimeoutException`

## BatchGetCrawlers 작업(Python: batch\$1get\$1crawlers)
<a name="aws-glue-api-crawler-crawling-BatchGetCrawlers"></a>

주어진 크롤러 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. `ListCrawlers` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

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

  크롤러 이름(`ListCrawlers` 작업에서 반환된 이름일 수 있음)의 목록입니다.

**응답**
+ `Crawlers` – [크롤러](#aws-glue-api-crawler-crawling-Crawler) 객체의 배열입니다.

  크롤러 정의 목록.
+ `CrawlersNotFound` – 100개 이하의 문자열로 구성된 UTF-8 문자열입니다.

  찾을 수 없는 크롤러의 이름 목록입니다.

**오류**
+ `InvalidInputException`
+ `OperationTimeoutException`

## ListCrawlers 작업(Python: list\$1crawlers)
<a name="aws-glue-api-crawler-crawling-ListCrawlers"></a>

이 AWS 계정의 모든 크롤러 리소스의 이름 또는 지정된 태그를 가진 리소스를 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 `Tags` 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

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

  계정의 모든 크롤러 또는 지정된 태그를 가진 크롤러의 이름.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

**오류**
+ `OperationTimeoutException`

## ListCrawls 작업(Python: list\$1crawls)
<a name="aws-glue-api-crawler-crawling-ListCrawls"></a>

지정된 크롤러에 대한 모든 크롤이 반환됩니다. 크롤러 기록 기능의 시작 날짜 이후 발생한 크롤만 반환되고 최대 12개월의 크롤만 유지됩니다. 이전의 크롤은 반환되지 않습니다.

이 API를 사용하여 다음을 수행할 수 있습니다.
+ 지정된 크롤러의 모든 크롤을 검색합니다.
+ 제한된 수 내에서 지정된 크롤러의 모든 크롤을 검색합니다.
+ 특정 시간 범위에서 지정된 크롤러의 모든 크롤을 검색합니다.
+ 특정 상태, 크롤 ID 또는 DPU 시간 값을 사용하여 지정된 크롤러의 모든 크롤을 검색합니다.

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

  실행을 검색할 크롤러의 이름입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다. 기본값은 20이고 최대값은 100입니다.
+ `Filters` – [CrawlsFilter](#aws-glue-api-crawler-crawling-CrawlsFilter) 객체의 배열입니다.

  `CrawlsFilter` 객체 목록에서 지정하는 기준에 따라 크롤을 필터링합니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `Crawls` – [CrawlerHistory](#aws-glue-api-crawler-crawling-CrawlerHistory) 객체의 배열입니다.

  기준을 충족하는 크롤 실행을 나타내는 `CrawlerHistory` 객체의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

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

# 열 통계의 API
<a name="aws-glue-api-crawler-column-statistics"></a>

열 통계 AWS Glue API는 테이블의 열에 대한 통계를 반환하기 위한 API를 설명합니다.

## 데이터 타입
<a name="aws-glue-api-crawler-column-statistics-objects"></a>
+ [ColumnStatisticsTaskRun 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun)
+ [ColumnStatisticsTaskSettings 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings)
+ [ExecutionAttempt 구조](#aws-glue-api-crawler-column-statistics-ExecutionAttempt)

## ColumnStatisticsTaskRun 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun"></a>

열 통계 실행의 세부 정보를 표시하는 객체입니다.

**필드**
+ `CustomerId` – UTF-8 문자열입니다(12바이트 이하).

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

  특정 열 통계 작업 실행의 식별자입니다.
+ `DatabaseName` – UTF-8 문자열입니다.

  테이블이 상주하는 데이터베이스.
+ `TableName` – UTF-8 문자열입니다.

  열 통계가 생성되는 테이블의 이름입니다.
+ `ColumnNameList` – UTF-8 문자열의 배열입니다.

  열 이름의 목록입니다. 제공되지 않은 경우 기본적으로 테이블의 모든 열 이름이 사용됩니다.
+ `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  테이블이 존재하는 데이터 카탈로그의 ID. 제공되지 않은 경우 기본적으로 AWS 계정 ID가 사용됩니다.
+ `Role` – UTF-8 문자열입니다.

  서비스가 통계를 생성하기 위해 맡을 IAM 역할.
+ `SampleSize` – 100 이하의 숫자(실수)입니다.

  통계 생성에 사용된 행의 비율. 제공되지 않은 경우 전체 테이블을 사용하여 통계를 생성합니다.
+ `SecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  열 통계 작업 실행의 CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다.
+ `NumberOfWorkers` – 1 이상의 숫자(정수)입니다.

  열 통계를 생성하는 데 사용된 작업자 수입니다. 작업은 인스턴스 25개까지 자동 확장되도록 사전 구성되어 있습니다.
+ `WorkerType` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 생성에 사용되는 작업자 유형. 기본값은 `g.1x`입니다.
+ `ComputationType` – UTF-8 문자열입니다(유효한 값: `FULL` \$1 `INCREMENTAL`).

  열 통계 계산의 유형입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `STOPPED`).

  실행된 작업의 상태입니다.
+ `CreationTime` – 타임스탬프입니다.

  이 작업이 생성된 시각입니다.
+ `LastUpdated` – 타임스탬프입니다.

  이 작업이 마지막으로 수정된 시점.
+ `StartTime` – 타임스탬프입니다.

  이벤트의 시작 시각.
+ `EndTime` – 타임스탬프입니다.

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

  작업에 대한 오류 메시지입니다.
+ `DPUSeconds` – None 이하의 숫자(실수)입니다.

  자동 크기 조정된 모든 작업자의 계산된 DPU 사용량(초 단위).

## ColumnStatisticsTaskSettings 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings"></a>

열 통계 작업의 설정입니다.

**필드**
+ `DatabaseName` – UTF-8 문자열입니다.

  테이블이 있는 데이터베이스의 이름입니다.
+ `TableName` – UTF-8 문자열입니다.

  열 통계를 생성할 테이블의 이름입니다.
+ `Schedule` – [일정](aws-glue-api-crawler-scheduler.md#aws-glue-api-crawler-scheduler-Schedule) 객체입니다.

  CRON 구문에 지정된 열 통계 실행 일정입니다.
+ `ColumnNameList` – UTF-8 문자열의 배열입니다.

  통계를 실행할 열 이름의 목록입니다.
+ `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 카탈로그 ID 문자열입니다.

  데이터베이스가 있는 데이터 카탈로그의 ID입니다.
+ `Role` – UTF-8 문자열입니다.

  열 통계를 실행하는 데 사용되는 역할입니다.
+ `SampleSize` – 100 이하의 숫자(실수)입니다.

  샘플링할 데이터의 백분율입니다.
+ `SecurityConfiguration` – 128바이트 이하 길이의 UTF-8 문자열입니다.

  CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다.
+ `ScheduleType` – UTF-8 문자열입니다(유효한 값: `CRON` \$1 `AUTO`).

  열 통계 작업의 일정 유형입니다. 가능한 값은 `CRON` 또는 `AUTO`입니다.
+ `SettingSource` – UTF-8 문자열입니다(유효한 값: `CATALOG` \$1 `TABLE`).

  열 통계 작업 설정의 소스입니다. 가능한 값은 `CATALOG` 또는 `TABLE`입니다.
+ `LastExecutionAttempt` – [ExecutionAttempt](#aws-glue-api-crawler-column-statistics-ExecutionAttempt) 객체입니다.

  열 통계 작업 실행의 마지막 `ExecutionAttempt`입니다.

## ExecutionAttempt 구조
<a name="aws-glue-api-crawler-column-statistics-ExecutionAttempt"></a>

열 통계 작업 실행의 실행 시도입니다.

**필드**
+ `Status` – UTF-8 문자열입니다(유효한 값: `FAILED` \$1 `STARTED`).

  마지막 열 통계 작업 실행의 상태입니다.
+ `ColumnStatisticsTaskRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  마지막 열 통계 작업 실행의 작업 실행 ID입니다.
+ `ExecutionTimestamp` – 타임스탬프입니다.

  마지막 열 통계 작업 실행이 발생한 타임스탬프입니다.
+ `ErrorMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  마지막 열 통계 작업 실행과 관련한 오류 메시지입니다.

## 운영
<a name="aws-glue-api-crawler-column-statistics-actions"></a>
+ [StartColumnStatisticsTaskRun 작업 (Python: start\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun)
+ [GetColumnStatisticsTaskRun 작업 (Python: get\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun)
+ [GetColumnStatisticsTaskRuns 작업 (Python: get\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns)
+ [ListColumnStatisticsTaskRuns 작업 (Python: list\$1column\$1statistics\$1task\$1runs)](#aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns)
+ [StopColumnStatisticsTaskRun 작업 (Python: stop\$1column\$1statistics\$1task\$1run)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun)
+ [CreateColumnStatisticsTaskSettings 작업(Python: create\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings)
+ [UpdateColumnStatisticsTaskSettings 작업(Python: update\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings)
+ [GetColumnStatisticsTaskSettings 작업(Python: get\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings)
+ [DeleteColumnStatisticsTaskSettings 작업(Python: delete\$1column\$1statistics\$1task\$1settings)](#aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings)
+ [StartColumnStatisticsTaskRunSchedule 작업(Python: start\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule)
+ [StopColumnStatisticsTaskRunSchedule 작업(Python: stop\$1column\$1statistics\$1task\$1run\$1schedule)](#aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule)

## StartColumnStatisticsTaskRun 작업 (Python: start\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRun"></a>

지정된 테이블 및 열에 대해 열 통계 작업 실행을 시작합니다.

**요청**
+ `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 문자열입니다.

  통계를 생성할 테이블의 이름입니다.
+ `ColumnNameList` – UTF-8 문자열의 배열입니다.

  통계를 생성할 열 이름의 목록입니다. 제공되지 않은 경우 기본적으로 테이블의 모든 열 이름이 사용됩니다.
+ `Role` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  서비스가 통계를 생성하기 위해 맡을 IAM 역할.
+ `SampleSize` – 100 이하의 숫자(실수)입니다.

  통계 생성에 사용된 행의 비율. 제공되지 않은 경우 전체 테이블을 사용하여 통계를 생성합니다.
+ `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  열 통계 작업 실행의 CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다.

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

  열 통계 작업 실행의 식별자입니다.

**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ColumnStatisticsTaskRunningException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## GetColumnStatisticsTaskRun 작업 (Python: get\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRun"></a>

작업 실행 ID가 주어지면 작업 실행과 관련된 메타데이터/정보를 가져옵니다.

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

  특정 열 통계 작업 실행의 식별자입니다.

**응답**
+ `ColumnStatisticsTaskRun` – [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun) 객체입니다.

  열 통계 실행의 세부 정보를 나타내는 `ColumnStatisticsTaskRun` 객체입니다.

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

## GetColumnStatisticsTaskRuns 작업 (Python: get\$1column\$1statistics\$1task\$1runs)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskRuns"></a>

지정된 테이블과 관련된 모든 실행에 대한 정보를 검색합니다.

**요청**
+ `DatabaseName` – *필수:* UTF-8 문자열입니다.

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

  테이블의 이름
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  응답의 최대 크기입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `ColumnStatisticsTaskRuns` – [ColumnStatisticsTaskRun](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRun) 객체의 배열입니다.

  실행된 작업의 열 통계 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  실행된 작업이 아직 모두 반환되지 않은 경우의 지속 토큰입니다.

**오류**
+ `OperationTimeoutException`

## ListColumnStatisticsTaskRuns 작업 (Python: list\$1column\$1statistics\$1task\$1runs)
<a name="aws-glue-api-crawler-column-statistics-ListColumnStatisticsTaskRuns"></a>

특정 계정에 대해 실행된 모든 작업을 나열합니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  응답의 최대 크기입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

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

  열 통계 작업 실행 ID 목록.
+ `NextToken` – UTF-8 문자열입니다.

  실행된 작업 ID가 아직 전부 반환되지 않은 경우의 지속 토큰입니다.

**오류**
+ `OperationTimeoutException`

## StopColumnStatisticsTaskRun 작업 (Python: stop\$1column\$1statistics\$1task\$1run)
<a name="aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRun"></a>

지정된 테이블에 대한 작업 실행을 중지합니다.

**요청**
+ `DatabaseName` – *필수:* UTF-8 문자열입니다.

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

  테이블의 이름

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

**오류**
+ `EntityNotFoundException`
+ `ColumnStatisticsTaskNotRunningException`
+ `ColumnStatisticsTaskStoppingException`
+ `OperationTimeoutException`

## CreateColumnStatisticsTaskSettings 작업(Python: create\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-CreateColumnStatisticsTaskSettings"></a>

열 통계 작업에 대한 설정을 생성합니다.

**요청**
+ `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 문자열입니다.

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

  열 통계를 실행하는 데 사용되는 역할입니다.
+ `Schedule` – UTF-8 문자열입니다.

  CRON 구문에 지정된 열 통계 실행 일정입니다.
+ `ColumnNameList` – UTF-8 문자열의 배열입니다.

  통계를 실행할 열 이름의 목록입니다.
+ `SampleSize` – 100 이하의 숫자(실수)입니다.

  샘플링할 데이터의 백분율입니다.
+ `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  태그의 맵입니다.

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

**오류**
+ `AlreadyExistsException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ColumnStatisticsTaskRunningException`

## UpdateColumnStatisticsTaskSettings 작업(Python: update\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-UpdateColumnStatisticsTaskSettings"></a>

열 통계 작업의 설정을 업데이트합니다.

**요청**
+ `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 문자열입니다.

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

  열 통계를 실행하는 데 사용되는 역할입니다.
+ `Schedule` – UTF-8 문자열입니다.

  CRON 구문에 지정된 열 통계 실행 일정입니다.
+ `ColumnNameList` – UTF-8 문자열의 배열입니다.

  통계를 실행할 열 이름의 목록입니다.
+ `SampleSize` – 100 이하의 숫자(실수)입니다.

  샘플링할 데이터의 백분율입니다.
+ `CatalogID` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  CloudWatch 로그를 암호화하는 데 사용되는 보안 구성의 이름입니다.

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

**오류**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `VersionMismatchException`
+ `OperationTimeoutException`

## GetColumnStatisticsTaskSettings 작업(Python: get\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-GetColumnStatisticsTaskSettings"></a>

열 통계 작업의 설정을 가져옵니다.

**요청**
+ `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 문자열입니다.

  열 통계를 검색할 테이블의 이름입니다.

**응답**
+ `ColumnStatisticsTaskSettings` – [ColumnStatisticsTaskSettings](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskSettings) 객체입니다.

  열 통계 작업의 설정을 나타내는 `ColumnStatisticsTaskSettings` 객체입니다.

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

## DeleteColumnStatisticsTaskSettings 작업(Python: delete\$1column\$1statistics\$1task\$1settings)
<a name="aws-glue-api-crawler-column-statistics-DeleteColumnStatisticsTaskSettings"></a>

열 통계 작업의 설정을 삭제합니다.

**요청**
+ `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 문자열입니다.

  열 통계를 삭제할 테이블의 이름입니다.

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

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

## StartColumnStatisticsTaskRunSchedule 작업(Python: start\$1column\$1statistics\$1task\$1run\$1schedule)
<a name="aws-glue-api-crawler-column-statistics-StartColumnStatisticsTaskRunSchedule"></a>

열 통계 작업 실행 일정을 시작합니다.

**요청**
+ `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 문자열입니다.

  열 통계 작업 실행 일정을 시작할 테이블의 이름입니다.

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

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

## StopColumnStatisticsTaskRunSchedule 작업(Python: stop\$1column\$1statistics\$1task\$1run\$1schedule)
<a name="aws-glue-api-crawler-column-statistics-StopColumnStatisticsTaskRunSchedule"></a>

열 통계 작업 실행 일정을 중지합니다.

**요청**
+ `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 문자열입니다.

  열 통계 작업 실행 일정을 중지할 테이블의 이름입니다.

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

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

## 예외
<a name="aws-glue-api-crawler-column-statistics-exceptions"></a>
+ [ColumnStatisticsTaskRunningException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException)
+ [ColumnStatisticsTaskNotRunningException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException)
+ [ColumnStatisticsTaskStoppingException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException)
+ [ColumnStatisticsTaskAutoConcurrencyLimitException 구조](#aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException)
+ [InvalidCatalogSettingException 구조](#aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException)

## ColumnStatisticsTaskRunningException 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskRunningException"></a>

열 통계 생성 작업을 실행하는 동안 다른 작업을 시작하려고 하면 예외가 발생합니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ColumnStatisticsTaskNotRunningException 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskNotRunningException"></a>

실행 중인 작업이 없을 때 작업 실행을 중지하려고 하면 예외가 발생합니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ColumnStatisticsTaskStoppingException 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskStoppingException"></a>

작업 실행을 중지하려고 할 때 발생하는 예외입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ColumnStatisticsTaskAutoConcurrencyLimitException 구조
<a name="aws-glue-api-crawler-column-statistics-ColumnStatisticsTaskAutoConcurrencyLimitException"></a>

동시 자동 통계 작업의 한도에 이미 도달했을 때 발생하는 예외입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InvalidCatalogSettingException 구조
<a name="aws-glue-api-crawler-column-statistics-InvalidCatalogSettingException"></a>

카탈로그 설정에 문제가 있을 때 발생하는 예외입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

# 크롤러 스케줄러 API
<a name="aws-glue-api-crawler-scheduler"></a>

크롤러 스케줄러 API는 크롤러를 생성, 삭제, 업데이트 및 나열하기 위한 API와 함께 AWS Glue 크롤러 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-crawler-scheduler-objects"></a>
+ [일정 구조](#aws-glue-api-crawler-scheduler-Schedule)

## 일정 구조
<a name="aws-glue-api-crawler-scheduler-Schedule"></a>

`cron`을 사용하여 객체의 일정을 정하여 이벤트의 일정을 정합니다.

**필드**
+ `ScheduleExpression` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `State` – UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `NOT_SCHEDULED` \$1 `TRANSITIONING`).

  일정 상태

## 운영
<a name="aws-glue-api-crawler-scheduler-actions"></a>
+ [UpdateCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule)
+ [StartCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StartCrawlerSchedule)
+ [StopCrawlerSchedule 작업(Python: stop\$1crawler\$1schedule)](#aws-glue-api-crawler-scheduler-StopCrawlerSchedule)

## UpdateCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-UpdateCrawlerSchedule"></a>

`cron` 표현식을 사용하여 크롤러의 일정을 업데이트합니다.

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

  업데이트할 일정이 있는 크롤러 이름입니다.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 업데이트된 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.

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

**오류**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `VersionMismatchException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

## StartCrawlerSchedule 작업(Python: start\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StartCrawlerSchedule"></a>

크롤러가 실행 중이거나 일정 상태가 이미 `SCHEDULED`로 되어있지 않는 한 지정된 크롤러의 일정 상태를 `SCHEDULED`로 변경합니다.

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

  일정을 잡을 크롤러의 이름.

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

**오류**
+ `EntityNotFoundException`
+ `SchedulerRunningException`
+ `SchedulerTransitioningException`
+ `NoScheduleException`
+ `OperationTimeoutException`

## StopCrawlerSchedule 작업(Python: stop\$1crawler\$1schedule)
<a name="aws-glue-api-crawler-scheduler-StopCrawlerSchedule"></a>

지정된 크롤러의 일정 상태를 `NOT_SCHEDULED`로 설정하지만 크롤러가 실행되고 있으면 크롤러를 중지하지 않습니다.

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

  설정할 일정이 있는 크롤러 이름.

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

**오류**
+ `EntityNotFoundException`
+ `SchedulerNotRunningException`
+ `SchedulerTransitioningException`
+ `OperationTimeoutException`

# ETL 스크립트 API 자동 생성
<a name="aws-glue-api-etl-script-generation"></a>

ETL 스크립트 생성 API는 AWS Glue에서 ETL 스크립트를 생성하는 API와 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-etl-script-generation-objects"></a>
+ [CodeGenNode 구조](#aws-glue-api-etl-script-generation-CodeGenNode)
+ [CodeGenNodeArg 구조](#aws-glue-api-etl-script-generation-CodeGenNodeArg)
+ [CodeGenEdge 구조](#aws-glue-api-etl-script-generation-CodeGenEdge)
+ [위치 구조](#aws-glue-api-etl-script-generation-Location)
+ [CatalogEntry 구조](#aws-glue-api-etl-script-generation-CatalogEntry)
+ [MappingEntry 구조](#aws-glue-api-etl-script-generation-MappingEntry)

## CodeGenNode 구조
<a name="aws-glue-api-etl-script-generation-CodeGenNode"></a>

DAG(방향성 비순환 그래프)로 노드를 표시합니다

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

  노드 그래프 내 고유한 노드 식별자입니다.
+ `NodeType` – *필수(Required):* UTF-8 문자열입니다.

  노드 유형입니다.
+ `Args` – *필수(Required):* [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg) 객체의 배열이며 구조는 50개 이하입니다.

  이름값 페어 형식인 노드의 속성
+ `LineNumber` - 숫자(정수)입니다.

  노드의 행 수입니다.

## CodeGenNodeArg 구조
<a name="aws-glue-api-etl-script-generation-CodeGenNodeArg"></a>

인수 또는 노드의 속성.

**필드**
+ `Name` – *필수(Required):* UTF-8 문자열입니다.

  인수 또는 속성의 이름입니다.
+ `Value` – *필수(Required):* UTF-8 문자열입니다.

  인수 또는 속성의 값입니다.
+ `Param` – 부울입니다.

  값이 파라미터로 사용되었다면 true입니다.

## CodeGenEdge 구조
<a name="aws-glue-api-etl-script-generation-CodeGenEdge"></a>

DAG(방향성 비순환 그래프)로 방향성 엣지를 표시합니다

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

  엣지가 시작하는 노드의 ID입니다.
+ `Target` – *필수(Required):* [Identifier string pattern](aws-glue-api-common.md#aws-glue-api-regex-id)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  엣지가 끝나는 노드의 ID입니다.
+ `TargetParameter` – UTF-8 문자열입니다.

  엣지의 대상입니다.

## 위치 구조
<a name="aws-glue-api-etl-script-generation-Location"></a>

리소스의 위치입니다.

**필드**
+ `Jdbc` – [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg) 객체의 배열이며 구조는 50개 이하입니다.

  JDBC 위치
+ `S3` – [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg) 객체의 배열이며 구조는 50개 이하입니다.

  Amazon Simple Storage Service(Amazon S3) 위치입니다.
+ `DynamoDB` – [CodeGenNodeArg](#aws-glue-api-etl-script-generation-CodeGenNodeArg) 객체의 배열이며 구조는 50개 이하입니다.

  Amazon DynamoDB 테이블 위치입니다.

## CatalogEntry 구조
<a name="aws-glue-api-etl-script-generation-CatalogEntry"></a>

AWS Glue Data Catalog에서 테이블 정의를 지정합니다.

**필드**
+ `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 문자열입니다.

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

## MappingEntry 구조
<a name="aws-glue-api-etl-script-generation-MappingEntry"></a>

매핑 정의

**필드**
+ `SourceTable` – UTF-8 문자열입니다.

  원본 테이블의 이름.
+ `SourcePath` – UTF-8 문자열입니다.

   소스 경로입니다.
+ `SourceType` – UTF-8 문자열입니다.

  소스 유형
+ `TargetTable` – UTF-8 문자열입니다.

  대상 테이블은 입니다.
+ `TargetPath` – UTF-8 문자열입니다.

  대상 경로
+ `TargetType` – UTF-8 문자열입니다.

  대상 유형입니다.

## 운영
<a name="aws-glue-api-etl-script-generation-actions"></a>
+ [CreateScript 작업(Python: create\$1script)](#aws-glue-api-etl-script-generation-CreateScript)
+ [GetDataflowGraph 작업(Python: get\$1dataflow\$1graph)](#aws-glue-api-etl-script-generation-GetDataflowGraph)
+ [GetMapping 작업(Python: get\$1mapping)](#aws-glue-api-etl-script-generation-GetMapping)
+ [GetPlan 작업(Python: get\$1plan)](#aws-glue-api-etl-script-generation-GetPlan)

## CreateScript 작업(Python: create\$1script)
<a name="aws-glue-api-etl-script-generation-CreateScript"></a>

DAG(방향성 비순환 그래프)를 코드로 변환합니다.

**요청**
+ `DagNodes` – [CodeGenNode](#aws-glue-api-etl-script-generation-CodeGenNode) 객체의 배열입니다.

  DAG 노드 목록.
+ `DagEdges` – [CodeGenEdge](#aws-glue-api-etl-script-generation-CodeGenEdge) 객체의 배열입니다.

  DAG 엣지 목록.
+ `Language` – UTF-8 문자열입니다(유효 값: `PYTHON` \$1 `SCALA`).

  DAG의 결과 코드 프로그래밍 언어.

**응답**
+ `PythonScript` – UTF-8 문자열입니다.

  DAG에서 생성된 Python 스크립트입니다.
+ `ScalaCode` – UTF-8 문자열입니다.

  DAG에서 생성된 Scala 코드입니다.

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

## GetDataflowGraph 작업(Python: get\$1dataflow\$1graph)
<a name="aws-glue-api-etl-script-generation-GetDataflowGraph"></a>

DAG(방향성 비순환 그래프)로 Python 스크립트를 변환합니다.

**요청**
+ `PythonScript` – UTF-8 문자열입니다.

  변환할 Python 스크립트

**응답**
+ `DagNodes` – [CodeGenNode](#aws-glue-api-etl-script-generation-CodeGenNode) 객체의 배열입니다.

  결과 DAG 노드 목록.
+ `DagEdges` – [CodeGenEdge](#aws-glue-api-etl-script-generation-CodeGenEdge) 객체의 배열입니다.

  결과 DAG 엣지 목록.

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

## GetMapping 작업(Python: get\$1mapping)
<a name="aws-glue-api-etl-script-generation-GetMapping"></a>

매핑 생성

**요청**
+ `Source` – *필수(Required):* [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry) 객체입니다.

  원본 테입을 지정합니다.
+ `Sinks` – [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry) 객체의 배열입니다.

  대상 테이블 목록
+ `Location` – [위치](#aws-glue-api-etl-script-generation-Location) 객체입니다.

  매핑 파라미터입니다.

**응답**
+ `Mapping` – **필수(Required): [MappingEntry](#aws-glue-api-etl-script-generation-MappingEntry) 객체의 배열입니다.

  지정한 대상 매핑 목록.

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

## GetPlan 작업(Python: get\$1plan)
<a name="aws-glue-api-etl-script-generation-GetPlan"></a>

지정한 매핑을 실행할 코드 얻기.

**요청**
+ `Mapping` – *필수(Required):* [MappingEntry](#aws-glue-api-etl-script-generation-MappingEntry) 객체의 배열입니다.

  원본 테이블에서 대상 테이블로 매핑하는 목록
+ `Source` – *필수(Required):* [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry) 객체입니다.

  원본 테이블.
+ `Sinks` – [CatalogEntry](#aws-glue-api-etl-script-generation-CatalogEntry) 객체의 배열입니다.

  대상 테이블
+ `Location` – [위치](#aws-glue-api-etl-script-generation-Location) 객체입니다.

  매핑 파라미터입니다.
+ `Language` – UTF-8 문자열입니다(유효 값: `PYTHON` \$1 `SCALA`).

  매핑을 실행할 코드 프로그래밍 언어.
+ `AdditionalPlanOptionsMap` – 키-값 페어의 맵 배열입니다.

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

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

  추가 선택적 키-값 파라미터를 보유하는 맵입니다.

  현재 다음 키-값 페어가 지원됩니다.
  + `inferSchema` - AWS Glue 작업에 의해 생성된 기본 스크립트에 대해 `inferSchema`를 true로 설정할지 아니면 false로 설정할지 지정합니다. 예를 들어 `inferSchema`를 true로 설정하려면 다음 키 값 페어를 전달합니다.

    `--additional-plan-options-map '{"inferSchema":"true"}'`

**응답**
+ `PythonScript` – UTF-8 문자열입니다.

  매핑할 Python 스크립트
+ `ScalaCode` – UTF-8 문자열입니다.

  매핑을 실행할 Scala 코드.

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

# 시각적 작업 API
<a name="aws-glue-api-visual-job-api"></a>

Visual Job API를 사용하면 AWS Glue 작업의 시각적 구성을 나타내는 JSON 객체에서 AWS Glue API를 사용하여 데이터 통합 작업을 생성할 수 있습니다.

생성된 작업에 대한 DAG를 AWS Glue Studio에 등록하고 연관된 코드를 생성하기 위해 생성 또는 업데이트 작업 API에 `CodeGenConfigurationNodes` 목록이 제공됩니다.

## 데이터 타입
<a name="aws-glue-api-visual-job-api-objects"></a>
+ [CodeGenConfigurationNode 구조](#aws-glue-api-visual-job-api-CodeGenConfigurationNode)
+ [JDBCConnectorOptions 구조](#aws-glue-api-visual-job-api-JDBCConnectorOptions)
+ [StreamingDataPreviewOptions 구조](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions)
+ [AthenaConnectorSource 구조](#aws-glue-api-visual-job-api-AthenaConnectorSource)
+ [JDBCConnectorSource 구조](#aws-glue-api-visual-job-api-JDBCConnectorSource)
+ [SparkConnectorSource 구조](#aws-glue-api-visual-job-api-SparkConnectorSource)
+ [CatalogSource 구조](#aws-glue-api-visual-job-api-CatalogSource)
+ [MySQLCatalogSource 구조](#aws-glue-api-visual-job-api-MySQLCatalogSource)
+ [PostgreSQLCatalogSource 구조](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource)
+ [OracleSQLCatalogSource 구조](#aws-glue-api-visual-job-api-OracleSQLCatalogSource)
+ [MicrosoftSQLServerCatalogSource 구조](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource)
+ [CatalogKinesisSource 구조](#aws-glue-api-visual-job-api-CatalogKinesisSource)
+ [DirectKinesisSource 구조](#aws-glue-api-visual-job-api-DirectKinesisSource)
+ [KinesisStreamingSourceOptions 구조](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions)
+ [CatalogKafkaSource 구조](#aws-glue-api-visual-job-api-CatalogKafkaSource)
+ [DirectKafkaSource 구조](#aws-glue-api-visual-job-api-DirectKafkaSource)
+ [KafkaStreamingSourceOptions 구조](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions)
+ [RedshiftSource 구조](#aws-glue-api-visual-job-api-RedshiftSource)
+ [AmazonRedshiftSource 구조](#aws-glue-api-visual-job-api-AmazonRedshiftSource)
+ [AmazonRedshiftNodeData 구조](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData)
+ [AmazonRedshiftAdvancedOption 구조](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption)
+ [옵션 구조](#aws-glue-api-visual-job-api-Option)
+ [S3CatalogSource 구조](#aws-glue-api-visual-job-api-S3CatalogSource)
+ [S3SourceAdditionalOptions 구조](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions)
+ [S3CsvSource 구조](#aws-glue-api-visual-job-api-S3CsvSource)
+ [DirectJDBCSource 구조](#aws-glue-api-visual-job-api-DirectJDBCSource)
+ [S3DirectSourceAdditionalOptions 구조](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions)
+ [S3JsonSource 구조](#aws-glue-api-visual-job-api-S3JsonSource)
+ [S3ParquetSource 구조](#aws-glue-api-visual-job-api-S3ParquetSource)
+ [S3DeltaSource 구조](#aws-glue-api-visual-job-api-S3DeltaSource)
+ [S3CatalogDeltaSource 구조](#aws-glue-api-visual-job-api-S3CatalogDeltaSource)
+ [CatalogDeltaSource 구조](#aws-glue-api-visual-job-api-CatalogDeltaSource)
+ [S3HudiSource 구조](#aws-glue-api-visual-job-api-S3HudiSource)
+ [S3CatalogHudiSource 구조](#aws-glue-api-visual-job-api-S3CatalogHudiSource)
+ [S3ExcelSource 구조](#aws-glue-api-visual-job-api-S3ExcelSource)
+ [CatalogHudiSource 구조](#aws-glue-api-visual-job-api-CatalogHudiSource)
+ [DynamoDBCatalogSource 구조](#aws-glue-api-visual-job-api-DynamoDBCatalogSource)
+ [RelationalCatalogSource 구조](#aws-glue-api-visual-job-api-RelationalCatalogSource)
+ [JDBCConnectorTarget 구조](#aws-glue-api-visual-job-api-JDBCConnectorTarget)
+ [SparkConnectorTarget 구조](#aws-glue-api-visual-job-api-SparkConnectorTarget)
+ [BasicCatalogTarget 구조](#aws-glue-api-visual-job-api-BasicCatalogTarget)
+ [MySQLCatalogTarget 구조](#aws-glue-api-visual-job-api-MySQLCatalogTarget)
+ [PostgreSQLCatalogTarget 구조](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget)
+ [OracleSQLCatalogTarget 구조](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget)
+ [MicrosoftSQLServerCatalogTarget 구조](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget)
+ [RedshiftTarget 구조](#aws-glue-api-visual-job-api-RedshiftTarget)
+ [AmazonRedshiftTarget 구조](#aws-glue-api-visual-job-api-AmazonRedshiftTarget)
+ [UpsertRedshiftTargetOptions 구조](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions)
+ [S3CatalogTarget 구조](#aws-glue-api-visual-job-api-S3CatalogTarget)
+ [S3GlueParquetTarget 구조](#aws-glue-api-visual-job-api-S3GlueParquetTarget)
+ [CatalogSchemaChangePolicy 구조](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy)
+ [S3DirectTarget 구조](#aws-glue-api-visual-job-api-S3DirectTarget)
+ [S3HudiCatalogTarget 구조](#aws-glue-api-visual-job-api-S3HudiCatalogTarget)
+ [S3HudiDirectTarget 구조](#aws-glue-api-visual-job-api-S3HudiDirectTarget)
+ [S3DeltaCatalogTarget 구조](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget)
+ [S3DeltaDirectTarget 구조](#aws-glue-api-visual-job-api-S3DeltaDirectTarget)
+ [S3HyperDirectTarget 구조](#aws-glue-api-visual-job-api-S3HyperDirectTarget)
+ [S3IcebergDirectTarget 구조](#aws-glue-api-visual-job-api-S3IcebergDirectTarget)
+ [DirectSchemaChangePolicy 구조](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy)
+ [ApplyMapping 구조](#aws-glue-api-visual-job-api-ApplyMapping)
+ [Mapping 구조](#aws-glue-api-visual-job-api-Mapping)
+ [SelectFields 구조](#aws-glue-api-visual-job-api-SelectFields)
+ [DropFields 구조](#aws-glue-api-visual-job-api-DropFields)
+ [RenameField 구조](#aws-glue-api-visual-job-api-RenameField)
+ [Spigot 구조](#aws-glue-api-visual-job-api-Spigot)
+ [조인 구조](#aws-glue-api-visual-job-api-Join)
+ [JoinColumn 구조](#aws-glue-api-visual-job-api-JoinColumn)
+ [SplitFields 구조](#aws-glue-api-visual-job-api-SplitFields)
+ [SelectFromCollection 구조](#aws-glue-api-visual-job-api-SelectFromCollection)
+ [FillMissingValues 구조](#aws-glue-api-visual-job-api-FillMissingValues)
+ [Filter 구조](#aws-glue-api-visual-job-api-Filter)
+ [FilterExpression 구조](#aws-glue-api-visual-job-api-FilterExpression)
+ [FilterValue 구조](#aws-glue-api-visual-job-api-FilterValue)
+ [CustomCode 구조](#aws-glue-api-visual-job-api-CustomCode)
+ [SparkSQL 구조](#aws-glue-api-visual-job-api-SparkSQL)
+ [SqlAlias 구조](#aws-glue-api-visual-job-api-SqlAlias)
+ [DropNullFields 구조](#aws-glue-api-visual-job-api-DropNullFields)
+ [NullCheckBoxList 구조](#aws-glue-api-visual-job-api-NullCheckBoxList)
+ [NullValueField 구조](#aws-glue-api-visual-job-api-NullValueField)
+ [데이터 형식 구조](#aws-glue-api-visual-job-api-Datatype)
+ [병합 구조](#aws-glue-api-visual-job-api-Merge)
+ [결합 구조](#aws-glue-api-visual-job-api-Union)
+ [PIIDetection 구조](#aws-glue-api-visual-job-api-PIIDetection)
+ [집계 구조](#aws-glue-api-visual-job-api-Aggregate)
+ [DropDuplicates 구조](#aws-glue-api-visual-job-api-DropDuplicates)
+ [GovernedCatalogTarget 구조](#aws-glue-api-visual-job-api-GovernedCatalogTarget)
+ [GovernedCatalogSource 구조](#aws-glue-api-visual-job-api-GovernedCatalogSource)
+ [AggregateOperation 구조](#aws-glue-api-visual-job-api-AggregateOperation)
+ [GlueSchema 구조](#aws-glue-api-visual-job-api-GlueSchema)
+ [GlueStudioSchemaColumn 구조](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn)
+ [GlueStudioColumn 구조](#aws-glue-api-visual-job-api-GlueStudioColumn)
+ [DynamicTransform 구조](#aws-glue-api-visual-job-api-DynamicTransform)
+ [TransformConfigParameter 구조](#aws-glue-api-visual-job-api-TransformConfigParameter)
+ [EvaluateDataQuality 구조](#aws-glue-api-visual-job-api-EvaluateDataQuality)
+ [DQResultsPublishingOptions 구조](#aws-glue-api-visual-job-api-DQResultsPublishingOptions)
+ [DQStopJobOnFailureOptions 구조](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions)
+ [EvaluateDataQualityMultiFrame 구조](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame)
+ [레시피 구조](#aws-glue-api-visual-job-api-Recipe)
+ [RecipeReference 구조](#aws-glue-api-visual-job-api-RecipeReference)
+ [SnowflakeNodeData 구조](#aws-glue-api-visual-job-api-SnowflakeNodeData)
+ [SnowflakeSource 구조](#aws-glue-api-visual-job-api-SnowflakeSource)
+ [SnowflakeTarget 구조](#aws-glue-api-visual-job-api-SnowflakeTarget)
+ [ConnectorDataSource 구조](#aws-glue-api-visual-job-api-ConnectorDataSource)
+ [ConnectorDataTarget 구조](#aws-glue-api-visual-job-api-ConnectorDataTarget)
+ [RecipeStep 구조](#aws-glue-api-visual-job-api-RecipeStep)
+ [RecipeAction 구조](#aws-glue-api-visual-job-api-RecipeAction)
+ [ConditionExpression 구조](#aws-glue-api-visual-job-api-ConditionExpression)
+ [S3CatalogIcebergSource 구조](#aws-glue-api-visual-job-api-S3CatalogIcebergSource)
+ [CatalogIcebergSource 구조](#aws-glue-api-visual-job-api-CatalogIcebergSource)
+ [S3IcebergCatalogTarget 구조](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget)
+ [DynamoDBELTConnectorSource 구조](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource)
+ [DDBELTConnectionOptions 구조](#aws-glue-api-visual-job-api-DDBELTConnectionOptions)
+ [DDBELTCatalogAdditionalOptions 구조](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions)
+ [Route 구조](#aws-glue-api-visual-job-api-Route)
+ [GroupFilters 구조](#aws-glue-api-visual-job-api-GroupFilters)
+ [AutoDataQuality 구조](#aws-glue-api-visual-job-api-AutoDataQuality)

## CodeGenConfigurationNode 구조
<a name="aws-glue-api-visual-job-api-CodeGenConfigurationNode"></a>

`CodeGenConfigurationNode`는 유효한 모든 노드 유형을 열거합니다. 멤버 변수 중 하나만 채울 수 있습니다.

**Fields**
+ `AthenaConnectorSource` – [AthenaConnectorSource](#aws-glue-api-visual-job-api-AthenaConnectorSource) 객체입니다.

  Amazon Athena 데이터 원본에 대한 커넥터를 지정합니다.
+ `JDBCConnectorSource` – [JDBCConnectorSource](#aws-glue-api-visual-job-api-JDBCConnectorSource) 객체입니다.

  JDBC 데이터 원본에 대한 커넥터를 지정합니다.
+ `SparkConnectorSource` – [SparkConnectorSource](#aws-glue-api-visual-job-api-SparkConnectorSource) 객체입니다.

  Apache Spark 데이터 원본에 대한 커넥터를 지정합니다.
+ `CatalogSource` – [CatalogSource](#aws-glue-api-visual-job-api-CatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 데이터 스토어를 지정합니다.
+ `RedshiftSource` – [RedshiftSource](#aws-glue-api-visual-job-api-RedshiftSource) 객체입니다.

  Amazon Redshift 데이터 스토어를 지정합니다.
+ `S3CatalogSource` – [S3CatalogSource](#aws-glue-api-visual-job-api-S3CatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 Amazon S3 데이터 스토어를 지정합니다.
+ `S3CsvSource` – [S3CsvSource](#aws-glue-api-visual-job-api-S3CsvSource) 객체입니다.

  Amazon S3에 저장된 CSV(쉼표로 구분된 값) 데이터 스토어를 지정합니다.
+ `S3JsonSource` – [S3JsonSource](#aws-glue-api-visual-job-api-S3JsonSource) 객체입니다.

  Amazon S3에 저장된 JSON 데이터 스토어를 지정합니다.
+ `S3ParquetSource` – [S3ParquetSource](#aws-glue-api-visual-job-api-S3ParquetSource) 객체입니다.

  Amazon S3에 저장된 Apache Parquet 데이터 스토어를 지정합니다.
+ `RelationalCatalogSource` – [RelationalCatalogSource](#aws-glue-api-visual-job-api-RelationalCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 관계형 카탈로그 데이터 소스를 지정합니다.
+ `DynamoDBCatalogSource` – [DynamoDBCatalogSource](#aws-glue-api-visual-job-api-DynamoDBCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 DynamoDBC 카탈로그 데이터 스토어를 지정합니다.
+ `JDBCConnectorTarget` – [JDBCConnectorTarget](#aws-glue-api-visual-job-api-JDBCConnectorTarget) 객체입니다.

  Apache Parquet 열 형식 스토리지의 Amazon S3에 쓰는 데이터 대상을 지정합니다.
+ `SparkConnectorTarget` – [SparkConnectorTarget](#aws-glue-api-visual-job-api-SparkConnectorTarget) 객체입니다.

  Apache Spark 커넥터를 사용하는 대상을 지정합니다.
+ `CatalogTarget` – [BasicCatalogTarget](#aws-glue-api-visual-job-api-BasicCatalogTarget) 객체입니다.

  AWS Glue 데이터 카탈로그 테이블을 사용하는 대상을 지정합니다.
+ `RedshiftTarget` – [RedshiftTarget](#aws-glue-api-visual-job-api-RedshiftTarget) 객체입니다.

  Amazon Redshift를 사용하는 대상을 지정합니다.
+ `S3CatalogTarget` – [S3CatalogTarget](#aws-glue-api-visual-job-api-S3CatalogTarget) 객체입니다.

  AWS Glue 데이터 카탈로그를 사용하여 Amazon S3에 쓰는 데이터 대상을 지정합니다.
+ `S3GlueParquetTarget` – [S3GlueParquetTarget](#aws-glue-api-visual-job-api-S3GlueParquetTarget) 객체입니다.

  Apache Parquet 열 형식 스토리지의 Amazon S3에 쓰는 데이터 대상을 지정합니다.
+ `S3DirectTarget` – [S3DirectTarget](#aws-glue-api-visual-job-api-S3DirectTarget) 객체입니다.

  Amazon S3에 쓰는 데이터 대상을 지정합니다.
+ `ApplyMapping` – [ApplyMapping](#aws-glue-api-visual-job-api-ApplyMapping) 객체입니다.

  데이터 원본의 데이터 속성 키를 데이터 대상의 데이터 속성 키에 매핑하는 변환을 지정합니다. 키의 이름을 바꾸고 키의 데이터 유형을 수정하고 데이터 집합에서 삭제할 키를 선택할 수 있습니다.
+ `SelectFields` – [SelectFields](#aws-glue-api-visual-job-api-SelectFields) 객체입니다.

  유지할 데이터 속성 키를 선택하는 변환을 지정합니다.
+ `DropFields` – [DropFields](#aws-glue-api-visual-job-api-DropFields) 객체입니다.

  삭제할 데이터 속성 키를 선택하는 변환을 지정합니다.
+ `RenameField` – [RenameField](#aws-glue-api-visual-job-api-RenameField) 객체입니다.

  단일 데이터 속성 키의 이름을 바꾸는 변환을 지정합니다.
+ `Spigot` – [Spigot](#aws-glue-api-visual-job-api-Spigot) 객체입니다.

  Amazon S3 버킷에 데이터 샘플을 쓰는 변환을 지정합니다.
+ `Join` – [조인](#aws-glue-api-visual-job-api-Join) 객체입니다.

  지정된 데이터 속성 키의 비교 구문을 사용하여 두 데이터 집합을 하나의 데이터 집합으로 조인하는 변환을 지정합니다. 내부, 외부, 왼쪽, 오른쪽, 왼쪽 반 및 왼쪽 안티 조인을 사용할 수 있습니다.
+ `SplitFields` – [SplitFields](#aws-glue-api-visual-job-api-SplitFields) 객체입니다.

  데이터 속성 키를 두 개의 `DynamicFrames`로 분할하는 변환을 지정합니다. 출력은 `DynamicFrames` 컬렉션입니다. 하나에는 선택한 데이터 속성 키가 있고 다른 하나에는 나머지 데이터 속성 키가 있습니다.
+ `SelectFromCollection` – [SelectFromCollection](#aws-glue-api-visual-job-api-SelectFromCollection) 객체입니다.

  `DynamicFrames` 컬렉션에서 하나의 `DynamicFrame`을 선택하는 변환을 지정합니다. 출력은 선택한 `DynamicFrame`입니다.
+ `FillMissingValues` – [FillMissingValues](#aws-glue-api-visual-job-api-FillMissingValues) 객체입니다.

  데이터 집합에서 누락된 값이 있는 레코드를 찾고 대체를 통해 결정된 값으로 새 필드를 추가하는 변환을 지정합니다. 입력 데이터 집합은 누락 값을 결정하는 기계 학습 모델을 훈련하는 데 사용됩니다.
+ `Filter` – [Filter](#aws-glue-api-visual-job-api-Filter) 객체입니다.

  필터 조건에 따라 하나의 데이터 집합을 두 개로 분할하는 변환을 지정합니다.
+ `CustomCode` – [CustomCode](#aws-glue-api-visual-job-api-CustomCode) 객체입니다.

  제공한 사용자 지정 코드를 사용하여 데이터 변환을 수행하는 변환을 지정합니다. 출력은 DynamicFrames의 컬렉션입니다.
+ `SparkSQL` – [SparkSQL](#aws-glue-api-visual-job-api-SparkSQL) 객체입니다.

  데이터를 변환하기 위해 Spark SQL 구문을 사용하여 SQL 쿼리를 입력하는 변환을 지정합니다. 출력은 단일 `DynamicFrame`입니다.
+ `DirectKinesisSource` – [DirectKinesisSource](#aws-glue-api-visual-job-api-DirectKinesisSource) 객체입니다.

  직접적인 Amazon Kinesis 데이터 원본을 지정합니다.
+ `DirectKafkaSource` – [DirectKafkaSource](#aws-glue-api-visual-job-api-DirectKafkaSource) 객체입니다.

  Apache Kafka 데이터 스토어를 지정합니다.
+ `CatalogKinesisSource` – [CatalogKinesisSource](#aws-glue-api-visual-job-api-CatalogKinesisSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 Kinesis 데이터 원본을 지정합니다.
+ `CatalogKafkaSource` – [CatalogKafkaSource](#aws-glue-api-visual-job-api-CatalogKafkaSource) 객체입니다.

  데이터 카탈로그의 Apache Kafka 데이터 스토어를 지정합니다.
+ `DropNullFields` – [DropNullFields](#aws-glue-api-visual-job-api-DropNullFields) 객체입니다.

  열의 모든 값이 'null'인 경우 데이터 집합에서 열을 제거하는 변환을 지정합니다. 기본값으로 AWS Glue Studio는 Null 객체를 인식하지만 빈 문자열, 'null'인 문자열, -1 정수 또는 0과 같은 다른 자리 표시자 등의 일부 값은 자동으로 Null로 인식되지 않습니다.
+ `Merge` – [병합](#aws-glue-api-visual-job-api-Merge) 객체입니다.

  레코드를 식별하기 위해 지정된 기본 키를 기준으로 `DynamicFrame`을 스테이징 `DynamicFrame`과 병합하는 변환을 지정합니다. 중복 레코드(기본 키가 동일한 레코드)는 중복 제거되지 않습니다.
+ `Union` – [Union](#aws-glue-api-visual-job-api-Union) 객체입니다.

  둘 이상 데이터 집합의 행을 단일 결과로 결합하는 변환을 지정합니다.
+ `PIIDetection` – [PIIDetection](#aws-glue-api-visual-job-api-PIIDetection) 객체입니다.

  PII 데이터를 식별, 제거 또는 마스킹하는 변환을 지정합니다.
+ `Aggregate` – [Aggregate](#aws-glue-api-visual-job-api-Aggregate) 객체입니다.

  선택한 필드별로 행을 그룹화하고 지정된 함수에 의해 집계된 값을 계산하는 변환을 지정합니다.
+ `DropDuplicates` – [DropDuplicates](#aws-glue-api-visual-job-api-DropDuplicates) 객체입니다.

  데이터세트에서 반복 데이터의 행을 제거하는 변환을 지정합니다.
+ `GovernedCatalogTarget` – [GovernedCatalogTarget](#aws-glue-api-visual-job-api-GovernedCatalogTarget) 객체입니다.

  관리 카탈로그에 작성하는 데이터 대상을 지정합니다.
+ `GovernedCatalogSource` – [GovernedCatalogSource](#aws-glue-api-visual-job-api-GovernedCatalogSource) 객체입니다.

  관리 데이터 카탈로그의 데이터 소스를 지정합니다.
+ `MicrosoftSQLServerCatalogSource` – [MicrosoftSQLServerCatalogSource](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 Microsoft SQL 서버 데이터 소스를 지정합니다.
+ `MySQLCatalogSource` – [MySQLCatalogSource](#aws-glue-api-visual-job-api-MySQLCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 MySQL 데이터 소스를 지정합니다.
+ `OracleSQLCatalogSource` – [OracleSQLCatalogSource](#aws-glue-api-visual-job-api-OracleSQLCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 Oracle 데이터 소스를 지정합니다.
+ `PostgreSQLCatalogSource` – [PostgreSQLCatalogSource](#aws-glue-api-visual-job-api-PostgreSQLCatalogSource) 객체입니다.

  AWS Glue 데이터 카탈로그의 PostgresSQL 데이터 소스를 지정합니다.
+ `MicrosoftSQLServerCatalogTarget` – [MicrosoftSQLServerCatalogTarget](#aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget) 객체입니다.

  Microsoft SQL을 사용하는 대상을 지정합니다.
+ `MySQLCatalogTarget` – [MySQLCatalogTarget](#aws-glue-api-visual-job-api-MySQLCatalogTarget) 객체입니다.

  MySQL을 사용하는 대상을 지정합니다.
+ `OracleSQLCatalogTarget` – [OracleSQLCatalogTarget](#aws-glue-api-visual-job-api-OracleSQLCatalogTarget) 객체입니다.

  Oracle SQL을 사용하는 대상을 지정합니다.
+ `PostgreSQLCatalogTarget` – [PostgreSQLCatalogTarget](#aws-glue-api-visual-job-api-PostgreSQLCatalogTarget) 객체입니다.

  Postgres SQL을 사용하는 대상을 지정합니다.
+ `Route` – [경로](#aws-glue-api-visual-job-api-Route) 객체입니다.

  정의된 필터링 조건에 따라 데이터를 다른 출력 경로로 보내는 라우팅 노드를 지정합니다.
+ `DynamicTransform` – [DynamicTransform](#aws-glue-api-visual-job-api-DynamicTransform) 객체입니다.

  사용자가 생성한 사용자 지정 시각적 변환을 지정합니다.
+ `EvaluateDataQuality` – [EvaluateDataQuality](#aws-glue-api-visual-job-api-EvaluateDataQuality) 객체입니다.

  데이터 품질 평가 기준을 지정합니다.
+ `S3CatalogHudiSource` – [S3CatalogHudiSource](#aws-glue-api-visual-job-api-S3CatalogHudiSource) 객체입니다.

  AWS Glue 데이터 카탈로그에 등록된 Hudi 데이터 소스를 지정합니다. 데이터 소스를 Amazon S3에 저장해야 합니다.
+ `CatalogHudiSource` – [CatalogHudiSource](#aws-glue-api-visual-job-api-CatalogHudiSource) 객체입니다.

  AWS Glue 데이터 카탈로그에 등록된 Hudi 데이터 소스를 지정합니다.
+ `S3HudiSource` – [S3HudiSource](#aws-glue-api-visual-job-api-S3HudiSource) 객체입니다.

  Amazon S3에 저장된 Hudi 데이터 소스를 지정합니다.
+ `S3HudiCatalogTarget` – [S3HudiCatalogTarget](#aws-glue-api-visual-job-api-S3HudiCatalogTarget) 객체입니다.

  AWS Glue 데이터 카탈로그의 Hudi 데이터 소스에 작성하는 데이터 대상을 지정합니다.
+ `S3HudiDirectTarget` – [S3HudiDirectTarget](#aws-glue-api-visual-job-api-S3HudiDirectTarget) 객체입니다.

  Amazon S3에서 Hudi 데이터 소스에 작성하는 대상을 지정합니다.
+ `S3CatalogDeltaSource` – [S3CatalogDeltaSource](#aws-glue-api-visual-job-api-S3CatalogDeltaSource) 객체입니다.

  AWS Glue 데이터 카탈로그에 등록된 Delta Lake 데이터 소스를 지정합니다. 데이터 소스를 Amazon S3에 저장해야 합니다.
+ `CatalogDeltaSource` – [CatalogDeltaSource](#aws-glue-api-visual-job-api-CatalogDeltaSource) 객체입니다.

  AWS Glue 데이터 카탈로그에 등록된 Delta Lake 데이터 소스를 지정합니다.
+ `S3DeltaSource` – [S3DeltaSource](#aws-glue-api-visual-job-api-S3DeltaSource) 객체입니다.

  Amazon S3에 저장된 Delta Lake 데이터 소스를 지정합니다.
+ `S3DeltaCatalogTarget` – [S3DeltaCatalogTarget](#aws-glue-api-visual-job-api-S3DeltaCatalogTarget) 객체입니다.

  AWS Glue 데이터 카탈로그의 Delta Lake 데이터 소스에 작성하는 데이터 대상을 지정합니다.
+ `S3DeltaDirectTarget` – [S3DeltaDirectTarget](#aws-glue-api-visual-job-api-S3DeltaDirectTarget) 객체입니다.

  Amazon S3에서 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다.
+ `AmazonRedshiftSource` – [AmazonRedshiftSource](#aws-glue-api-visual-job-api-AmazonRedshiftSource) 객체입니다.

  Amazon Redshift에서 데이터 소스에 작성하는 대상을 지정합니다.
+ `AmazonRedshiftTarget` – [AmazonRedshiftTarget](#aws-glue-api-visual-job-api-AmazonRedshiftTarget) 객체입니다.

  Amazon Redshift에서 데이터 대상에 작성하는 대상을 지정합니다.
+ `EvaluateDataQualityMultiFrame` – [EvaluateDataQualityMultiFrame](#aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame) 객체입니다.

  데이터 품질 평가 기준을 지정합니다. 여러 입력 데이터를 허용하고 동적 프레임 컬렉션을 반환합니다.
+ `Recipe` – [Recipe](#aws-glue-api-visual-job-api-Recipe) 객체입니다.

  AWS Glue DataBrew 레시피 노드를 지정합니다.
+ `SnowflakeSource` – [SnowflakeSource](#aws-glue-api-visual-job-api-SnowflakeSource) 객체입니다.

  Snowflake 데이터 소스를 지정합니다.
+ `SnowflakeTarget` – [SnowflakeTarget](#aws-glue-api-visual-job-api-SnowflakeTarget) 객체입니다.

  Snowflake 데이터 소스에 작성하는 대상을 지정합니다.
+ `ConnectorDataSource` – [ConnectorDataSource](#aws-glue-api-visual-job-api-ConnectorDataSource) 객체입니다.

  표준 연결 옵션으로 생성된 소스를 지정합니다.
+ `ConnectorDataTarget` – [ConnectorDataTarget](#aws-glue-api-visual-job-api-ConnectorDataTarget) 객체입니다.

  표준 연결 옵션으로 생성된 대상을 지정합니다.
+ `S3CatalogIcebergSource` – [S3CatalogIcebergSource](#aws-glue-api-visual-job-api-S3CatalogIcebergSource) 객체입니다.

  AWS Glue Data Catalog에 등록된 Apache Iceberg 데이터 소스를 지정합니다. Iceberg 데이터 소스를 Amazon S3에 저장해야 합니다.
+ `CatalogIcebergSource` – [CatalogIcebergSource](#aws-glue-api-visual-job-api-CatalogIcebergSource) 객체입니다.

  AWS Glue Data Catalog에 등록된 Apache Iceberg 데이터 소스를 지정합니다.
+ `S3IcebergCatalogTarget` – [S3IcebergCatalogTarget](#aws-glue-api-visual-job-api-S3IcebergCatalogTarget) 객체입니다.

  Amazon S3에 데이터를 쓰고 AWS Glue Data Catalog에 테이블을 등록하는 Apache Iceberg 카탈로그 대상을 지정합니다.
+ `S3IcebergDirectTarget` – [S3IcebergDirectTarget](#aws-glue-api-visual-job-api-S3IcebergDirectTarget) 객체입니다.

  데이터를 Amazon S3에 Apache Iceberg 테이블로 쓰기 위한 구성 파라미터를 정의합니다.
+ `S3ExcelSource` – [S3ExcelSource](#aws-glue-api-visual-job-api-S3ExcelSource) 객체입니다.

  Amazon S3에서 Excel 파일을 읽기 위한 구성 파라미터를 정의합니다.
+ `S3HyperDirectTarget` – [S3HyperDirectTarget](#aws-glue-api-visual-job-api-S3HyperDirectTarget) 객체입니다.

  HyperDirect 최적화를 사용하여 데이터를 Amazon S3에 쓰기 위한 구성 파라미터를 정의합니다.
+ `DynamoDBELTConnectorSource` – [DynamoDBELTConnectorSource](#aws-glue-api-visual-job-api-DynamoDBELTConnectorSource) 객체입니다.

  DynamoDB 테이블에서 데이터를 추출하기 위한 DynamoDB ELT 커넥터 소스를 지정합니다.

## JDBCConnectorOptions 구조
<a name="aws-glue-api-visual-job-api-JDBCConnectorOptions"></a>

커넥터에 대한 추가 연결 옵션입니다.

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

  소스에서 데이터를 필터링하기 위한 추가 조건 절입니다. 예:

  `BillingCity='Mountain View'`

  테이블 이름 대신 쿼리를 사용하는 경우 쿼리가 지정된 `filterPredicate`에서 작동하는지 검증해야 합니다.
+ `PartitionColumn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  분할에 사용되는 정수 열의 이름입니다. 이 옵션은 `lowerBound`, `upperBound` 및 `numPartitions`에 포함되는 경우에만 작동합니다. 이 옵션은 Spark SQL JDBC 리더에서와 같은 방식으로 작동합니다.
+ `LowerBound` – None 이하의 숫자(정수)입니다.

  파티션 스트라이드를 결정하는 데 사용되는 `partitionColumn`의 최소값입니다.
+ `UpperBound` – None 이하의 숫자(정수)입니다.

  파티션 스트라이드를 결정하는 데 사용되는 `partitionColumn`의 최대값입니다.
+ `NumPartitions` – None 이하의 숫자(정수)입니다.

  파티션 수입니다. 이 값은 `lowerBound`(포함) 및 `upperBound`(배타)와 함께 `partitionColumn`을 분할하는 데 사용되는 생성된 `WHERE` 절 표현에 대한 파티션 스트라이드를 형성합니다.
+ `JobBookmarkKeys` – UTF-8 문자열의 배열입니다.

  정렬할 작업 북마크 키의 이름입니다.
+ `JobBookmarkKeysSortOrder` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  오름차순 또는 내림차순 정렬 순서를 지정합니다.
+ `DataTypeMapping` – 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열입니다(유효한 값: `ARRAY` \$1 `BIGINT` \$1 `BINARY` \$1 `BIT` \$1 `BLOB` \$1 `BOOLEAN` \$1 `CHAR` \$1 `CLOB` \$1 `DATALINK` \$1 `DATE` \$1 `DECIMAL` \$1 `DISTINCT` \$1 `DOUBLE` \$1 `FLOAT` \$1 `INTEGER` \$1 `JAVA_OBJECT` \$1 `LONGNVARCHAR` \$1 `LONGVARBINARY` \$1 `LONGVARCHAR` \$1 `NCHAR` \$1 `NCLOB` \$1 `NULL` \$1 `NUMERIC` \$1 `NVARCHAR` \$1 `OTHER` \$1 `REAL` \$1 `REF` \$1 `REF_CURSOR` \$1 `ROWID` \$1 `SMALLINT` \$1 `SQLXML` \$1 `STRUCT` \$1 `TIME` \$1 `TIME_WITH_TIMEZONE` \$1 `TIMESTAMP` \$1 `TIMESTAMP_WITH_TIMEZONE` \$1 `TINYINT` \$1 `VARBINARY` \$1 `VARCHAR`).

  각 값은 UTF-8 문자열입니다(유효한 값: `DATE` \$1 `STRING` \$1 `TIMESTAMP` \$1 `INT` \$1 `FLOAT` \$1 `LONG` \$1 `BIGDECIMAL` \$1 `BYTE` \$1 `SHORT` \$1 `DOUBLE`).

  JDBC 데이터 유형에서 AWS Glue 데이터 유형으로의 매핑을 구축하는 사용자 지정 데이터 유형 매핑입니다. 예를 들어 `"dataTypeMapping":{"FLOAT":"STRING"}` 옵션은 드라이버의 `ResultSet.getString()` 메서드를 호출하여 JDBC 유형 `FLOAT`의 데이터 필드를 Java `String` 유형으로 매핑하고 이를 AWS Glue 레코드를 구축하는 데 사용합니다. `ResultSet` 객체는 각 드라이버에 의해 구현되므로 동작은 사용하는 드라이버에 따라 다릅니다. 드라이버가 변환을 수행하는 방법을 이해하려면 JDBC 드라이버에 대한 설명서를 참조하세요.

## StreamingDataPreviewOptions 구조
<a name="aws-glue-api-visual-job-api-StreamingDataPreviewOptions"></a>

데이터 샘플을 보기 위한 데이터 미리 보기와 관련된 옵션을 지정합니다.

**Fields**
+ `PollingTime` - 최소 10 이상의 숫자(long)입니다.

  밀리초 단위의 폴링 시간입니다.
+ `RecordPollingLimit` - 최소 1 이상의 숫자(long)입니다.

  폴링되는 레코드 수에 대한 제한입니다.

## AthenaConnectorSource 구조
<a name="aws-glue-api-visual-job-api-AthenaConnectorSource"></a>

Amazon Athena 데이터 원본에 대한 커넥터를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터와 연관된 연결 이름입니다.
+ `ConnectorName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue Studio에서 데이터 스토어에 액세스하는 데 도움이 되는 커넥터의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Amazon Athena 데이터 스토어에 대한 연결을 지정하는 marketplace.athena 또는 custom.athena와 같은 연결 유형입니다.
+ `ConnectionTable` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터 원본에 있는 테이블의 이름입니다.
+ `SchemaName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 CloudWatch 로그 그룹의 이름입니다. 예: `/aws-glue/jobs/output`.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  사용자 지정 Athena 소스에 대한 데이터 스키마를 지정합니다.

## JDBCConnectorSource 구조
<a name="aws-glue-api-visual-job-api-JDBCConnectorSource"></a>

JDBC 데이터 원본에 대한 커넥터를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터와 연관된 연결 이름입니다.
+ `ConnectorName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue Studio에서 데이터 스토어에 액세스하는 데 도움이 되는 커넥터의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 데이터 스토어에 대한 연결을 지정하는 marketplace.jdbc 또는 custom.jdbc와 같은 연결 유형입니다.
+ `AdditionalOptions` – [JDBCConnectorOptions](#aws-glue-api-visual-job-api-JDBCConnectorOptions) 객체입니다.

  커넥터에 대한 추가 연결 옵션입니다.
+ `ConnectionTable` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터 원본에 있는 테이블의 이름입니다.
+ `Query` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #62](aws-glue-api-common.md#regex_62)

  데이터를 가져올 테이블 또는 SQL 쿼리입니다. `ConnectionTable` 또는 `query`을 지정할 수 있지만 둘 다 함께 지정할 수는 없습니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  사용자 지정 JDBC 소스에 대한 데이터 스키마를 지정합니다.

## SparkConnectorSource 구조
<a name="aws-glue-api-visual-job-api-SparkConnectorSource"></a>

Apache Spark 데이터 원본에 대한 커넥터를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터와 연관된 연결 이름입니다.
+ `ConnectorName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue Studio에서 데이터 스토어에 액세스하는 데 도움이 되는 커넥터의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Apache Spark 데이터 스토어에 대한 연결을 지정하는 marketplace.spark 또는 custom.spark와 같은 연결 유형입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  사용자 지정 Spark 소스에 대한 데이터 스키마를 지정합니다.

## CatalogSource 구조
<a name="aws-glue-api-visual-job-api-CatalogSource"></a>

AWS Glue 데이터 카탈로그의 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `PartitionPredicate` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

   이 조건자를 충족하는 파티션이 삭제됩니다. 이러한 파티션에서 보존 기간 내에 있는 파일은 삭제되지 않습니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  카탈로그 소스에 대한 데이터 스키마를 지정합니다.

## MySQLCatalogSource 구조
<a name="aws-glue-api-visual-job-api-MySQLCatalogSource"></a>

AWS Glue 데이터 카탈로그의 MySQL 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.

## PostgreSQLCatalogSource 구조
<a name="aws-glue-api-visual-job-api-PostgreSQLCatalogSource"></a>

AWS Glue 데이터 카탈로그의 PostgresSQL 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.

## OracleSQLCatalogSource 구조
<a name="aws-glue-api-visual-job-api-OracleSQLCatalogSource"></a>

AWS Glue 데이터 카탈로그의 Oracle 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.

## MicrosoftSQLServerCatalogSource 구조
<a name="aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogSource"></a>

AWS Glue 데이터 카탈로그의 Microsoft SQL 서버 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.

## CatalogKinesisSource 구조
<a name="aws-glue-api-visual-job-api-CatalogKinesisSource"></a>

AWS Glue 데이터 카탈로그의 Kinesis 데이터 원본을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `WindowSize` – None 이하의 숫자(정수)입니다.

  각 마이크로 배치를 처리하는 데 사용할 시간입니다.
+ `DetectSchema` – 부울입니다.

  들어오는 데이터의 스키마를 자동으로 결정할지 여부입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `StreamingOptions` – [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions) 객체입니다.

  Kinesis 스트리밍 데이터 원본에 대한 추가 옵션입니다.
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 객체입니다.

  데이터 미리 보기에 대한 추가 옵션입니다.

## DirectKinesisSource 구조
<a name="aws-glue-api-visual-job-api-DirectKinesisSource"></a>

직접적인 Amazon Kinesis 데이터 원본을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `WindowSize` – None 이하의 숫자(정수)입니다.

  각 마이크로 배치를 처리하는 데 사용할 시간입니다.
+ `DetectSchema` – 부울입니다.

  들어오는 데이터의 스키마를 자동으로 결정할지 여부입니다.
+ `StreamingOptions` – [KinesisStreamingSourceOptions](#aws-glue-api-visual-job-api-KinesisStreamingSourceOptions) 객체입니다.

  Kinesis 스트리밍 데이터 원본에 대한 추가 옵션입니다.
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 객체입니다.

  데이터 미리 보기에 대한 추가 옵션입니다.

## KinesisStreamingSourceOptions 구조
<a name="aws-glue-api-visual-job-api-KinesisStreamingSourceOptions"></a>

Amazon Kinesis 스트리밍 데이터 원본에 대한 추가 옵션입니다.

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

  Kinesis 엔드포인트의 URL입니다.
+ `StreamName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  Kinesis 데이터 스트림의 이름입니다.
+ `Classification` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  선택적 분류입니다.
+ `Delimiter` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  구분 기호 문자열을 지정합니다.
+ `StartingPosition` – UTF-8 문자열입니다(유효한 값: `latest="LATEST"` \$1 `trim_horizon="TRIM_HORIZON"` \$1 `earliest="EARLIEST"` \$1 `timestamp="TIMESTAMP"`).

  데이터를 읽을 Kinesis 데이터 스트림의 시작 위치입니다. 가능한 값은 `"latest"`, `"trim_horizon"`, `"earliest"` 또는 `yyyy-mm-ddTHH:MM:SSZ` 패턴에서 UTC 형식의 타임스탬프 문자열입니다(여기서, `Z`는 UTC 시간대 오프셋(\$1/-)임, 예: '2023-04-04T08:00:00-04:00'). 기본값은 `"latest"`입니다.

  참고: 'startingPosition'에서 UTC 형식의 타임스탬프 문자열 값을 사용하는 것은 AWS Glue 버전 4.0 이상에서만 지원됩니다.
+ `MaxFetchTimeInMs` – None 이하의 숫자(정수)입니다.

  작업 실행기가 Kinesis 데이터 스트림에서 현재 배치에 대한 레코드를 읽는 데 걸리는 최대 시간(밀리초(ms) 단위로 지정)입니다. 이 시간 내에 여러 개의 `GetRecords` API 호출을 할 수 있습니다. 기본값은 `1000`입니다.
+ `MaxFetchRecordsPerShard` – None 이하의 숫자(정수)입니다.

  마이크로 배치에 따라 Kinesis 데이터 스트림에서 샤드당 가져올 최대 레코드 수입니다. 참고: 스트리밍 작업이 이미 Kinesis의 동일한 get-records 호출에서 추가 레코드를 읽은 경우 클라이언트가 이 제한을 초과할 수 있습니다. `MaxFetchRecordsPerShard`가 엄격해야 한다면 `MaxRecordPerRead`의 배수여야 합니다. 기본값은 `100000`입니다.
+ `MaxRecordPerRead` – None 이하의 숫자(정수)입니다.

  각 getRecords 작업에서 Kinesis 데이터 스트림으로부터 가져올 최대 레코드 수입니다. 기본값은 `10000`입니다.
+ `AddIdleTimeBetweenReads` – 부울입니다.

  두 개의 연속 getRecords 작업 사이에 시간 지연을 추가합니다. 기본값은 `"False"`입니다. 이 옵션은 AWS Glue 버전 2.0 이상에서만 구성할 수 있습니다.
+ `IdleTimeBetweenReadsInMs` – None 이하의 숫자(정수)입니다.

  두 개의 연속 getRecords 작업 사이의 최소 시간 지연으로, ms 단위로 지정됩니다. 기본값은 `1000`입니다. 이 옵션은 AWS Glue 버전 2.0 이상에서만 구성할 수 있습니다.
+ `DescribeShardInterval` – None 이하의 숫자(정수)입니다.

  스크립트가 리샤딩을 고려하기 위한 두 개의 ListShards API 호출 사이의 최소 시간 간격입니다. 기본값은 `1s`입니다.
+ `NumRetries` – None 이하의 숫자(정수)입니다.

  Kinesis Data Streams API 요청의 최대 재시도 횟수입니다. 기본값은 `3`입니다.
+ `RetryIntervalMs` – None 이하의 숫자(정수)입니다.

  Kinesis Data Streams API 호출을 재시도하기 전의 휴지 기간(ms 단위로 지정)입니다. 기본값은 `1000`입니다.
+ `MaxRetryIntervalMs` – None 이하의 숫자(정수)입니다.

  Kinesis Data Streams API 호출을 두 번 재시도하는 사이의 최대 휴지 시간(ms 단위로 지정)입니다. 기본값은 `10000`입니다.
+ `AvoidEmptyBatches` – 부울입니다.

  배치가 시작되기 전에 Kinesis 데이터 스트림에서 읽지 않은 데이터를 확인하여 빈 마이크로 배치 작업 생성을 방지합니다. 기본값은 `"False"`입니다.
+ `StreamArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  Kinesis 데이터 스트림의 Amazon 리소스 이름(ARN)입니다.
+ `RoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  AWS Security Token Service(AWS STS)를 사용하여 맡을 역할의 Amazon 리소스 이름(ARN)입니다. 이 역할에는 Kinesis 데이터 스트림에 대한 레코드 작업을 설명하거나 읽을 수 있는 권한이 있어야 합니다. 다른 계정의 데이터 스트림에 액세스할 때 이 파라미터를 사용해야 합니다. `"awsSTSSessionName"`과(와) 함께 사용합니다.
+ `RoleSessionName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  AWS STS를 사용하여 역할을 맡는 세션의 식별자입니다. 다른 계정의 데이터 스트림에 액세스할 때 이 파라미터를 사용해야 합니다. `"awsSTSRoleARN"`과(와) 함께 사용합니다.
+ `AddRecordTimestamp` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 옵션이 'true'로 설정되면 데이터 출력에는 이름이 '\$1\$1src\$1timestamp'라는 추가 열이 포함됩니다. 이 열은 스트림에서 해당 레코드를 수신한 시간을 나타냅니다. 기본값은 'false'입니다. 이 옵션은 AWS Glue 버전 4.0 이상에서 지원됩니다.
+ `EmitConsumerLagMetrics` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 옵션을 'true'로 설정하면 각 배치에 대해 스트림에서 수신한 가장 오래된 레코드와 AWS Glue에 도착한 시간 사이의 지표를 CloudWatch로 내보냅니다. 지표의 이름은 'glue.driver.streaming.maxConsumerLagInMs'입니다. 기본값은 'false'입니다. 이 옵션은 AWS Glue 버전 4.0 이상에서 지원됩니다.
+ `StartingTimestamp` – UTF-8 문자열입니다.

  Kinesis 데이터 스트림에서 데이터 읽기를 시작하는 레코드의 타임스탬프입니다. 가능한 값은 `yyyy-mm-ddTHH:MM:SSZ` 패턴에서 UTC 형식의 타임스탬프 문자열입니다(여기서, Z는 UTC 시간대 오프셋(\$1/-)임, 예: '2023-04-04T08:00:00\$108:00').
+ `FanoutConsumerARN` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  Kinesis 데이터 스트림 향상된 팬아웃 소비자의 Amazon 리소스 이름(ARN)입니다. 지정할 경우 전용 처리량을 지원하고 데이터 소비의 지연 시간을 줄이기 위해 향상된 팬아웃을 활성화합니다.

## CatalogKafkaSource 구조
<a name="aws-glue-api-visual-job-api-CatalogKafkaSource"></a>

데이터 카탈로그의 Apache Kafka 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `WindowSize` – None 이하의 숫자(정수)입니다.

  각 마이크로 배치를 처리하는 데 사용할 시간입니다.
+ `DetectSchema` – 부울입니다.

  들어오는 데이터의 스키마를 자동으로 결정할지 여부입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `StreamingOptions` – [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions) 객체입니다.

  스트리밍 옵션을 지정합니다.
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 객체입니다.

  데이터 샘플을 보기 위한 데이터 미리 보기와 관련된 옵션을 지정합니다.

## DirectKafkaSource 구조
<a name="aws-glue-api-visual-job-api-DirectKafkaSource"></a>

Apache Kafka 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `StreamingOptions` – [KafkaStreamingSourceOptions](#aws-glue-api-visual-job-api-KafkaStreamingSourceOptions) 객체입니다.

  스트리밍 옵션을 지정합니다.
+ `WindowSize` – None 이하의 숫자(정수)입니다.

  각 마이크로 배치를 처리하는 데 사용할 시간입니다.
+ `DetectSchema` – 부울입니다.

  들어오는 데이터의 스키마를 자동으로 결정할지 여부입니다.
+ `DataPreviewOptions` – [StreamingDataPreviewOptions](#aws-glue-api-visual-job-api-StreamingDataPreviewOptions) 객체입니다.

  데이터 샘플을 보기 위한 데이터 미리 보기와 관련된 옵션을 지정합니다.

## KafkaStreamingSourceOptions 구조
<a name="aws-glue-api-visual-job-api-KafkaStreamingSourceOptions"></a>

스트리밍에 대한 추가 옵션입니다.

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

  부트스트랩 서버 URL 목록입니다(예: `b-1.vpc-test-2.o4q88o.c6.kafka.us-east-1.amazonaws.com:9094`). 이 옵션은 API 호출에 지정하거나 데이터 카탈로그의 테이블 메타데이터에 정의해야 합니다.
+ `SecurityProtocol` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  브로커와 통신하는 데 사용되는 프로토콜입니다. 가능한 값은 `"SSL"` 또는 `"PLAINTEXT"`입니다.
+ `ConnectionName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  연결의 이름입니다.
+ `TopicName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  Apache Kafka에 지정된 주제 이름입니다. `"topicName"`, `"assign"` 또는 `"subscribePattern"` 중 하나 이상을 지정해야 합니다.
+ `Assign` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  사용할 특정 `TopicPartitions`입니다. `"topicName"`, `"assign"` 또는 `"subscribePattern"` 중 하나 이상을 지정해야 합니다.
+ `SubscribePattern` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  구독할 주제 목록을 식별하는 Java 정규식 문자열입니다. `"topicName"`, `"assign"` 또는 `"subscribePattern"` 중 하나 이상을 지정해야 합니다.
+ `Classification` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  선택적 분류입니다.
+ `Delimiter` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  구분 기호 문자열을 지정합니다.
+ `StartingOffsets` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터를 읽을 Kafka 주제의 시작 위치입니다. 가능한 값은 `"earliest"` 또는 `"latest"`입니다. 기본값은 `"latest"`입니다.
+ `EndingOffsets` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  배치 쿼리가 종료되는 엔드포인트입니다. 가능한 값은 `"latest"` 또는 각 `TopicPartition`의 끝 오프셋을 지정하는 JSON 문자열입니다.
+ `PollTimeoutMs` – None 이하의 숫자(정수)입니다.

  Spark 작업 실행기에서 Kafka의 데이터를 폴링하는 시간 제한(밀리초)입니다. 기본값은 `512`입니다.
+ `NumRetries` – None 이하의 숫자(정수)입니다.

  Kafka 오프셋 가져오기에 실패하기 전에 재시도할 횟수입니다. 기본값은 `3`입니다.
+ `RetryIntervalMs` – None 이하의 숫자(정수)입니다.

  Kafka 오프셋 가져오기를 재시도하기 전에 대기할 시간(밀리초)입니다. 기본값은 `10`입니다.
+ `MaxOffsetsPerTrigger` – None 이하의 숫자(정수)입니다.

  트리거 간격당 처리되는 최대 오프셋 수에 대한 속도 제한입니다. 지정된 총 오프셋 수는 서로 다른 볼륨의 `topicPartitions`에 비례하여 분할됩니다. 기본값은 null입니다. 즉, 소비자가 알려진 최신 오프셋까지 모든 오프셋을 읽습니다.
+ `MinPartitions` – None 이하의 숫자(정수)입니다.

  Kafka에서 읽을 원하는 최소 파티션 수입니다. 기본값은 null이며 이는 Spark 파티션의 수가 Kafka 파티션의 수와 동일함을 의미합니다.
+ `IncludeHeaders` – 부울입니다.

  Kafka 헤더를 포함할지 여부입니다. 옵션이 "true"로 설정되면 데이터 출력에는 유형이 `Array[Struct(key: String, value: String)]`인 "glue\$1streaming\$1kafka\$1headers"라는 추가 열이 포함됩니다. 기본값은 "false"입니다. 이 옵션은 AWS Glue 버전 3.0 이상에서만 사용할 수 있습니다.
+ `AddRecordTimestamp` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 옵션이 'true'로 설정되면 데이터 출력에는 이름이 '\$1\$1src\$1timestamp'라는 추가 열이 포함됩니다. 이 열은 주제에서 해당 레코드를 수신한 시간을 나타냅니다. 기본값은 'false'입니다. 이 옵션은 AWS Glue 버전 4.0 이상에서 지원됩니다.
+ `EmitConsumerLagMetrics` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 옵션을 'true'로 설정하면 각 배치에 대해 주제에서 수신한 가장 오래된 레코드와 AWS Glue에 도착한 시간 사이의 지표를 CloudWatch로 내보냅니다. 지표의 이름은 'glue.driver.streaming.maxConsumerLagInMs'입니다. 기본값은 'false'입니다. 이 옵션은 AWS Glue 버전 4.0 이상에서 지원됩니다.
+ `StartingTimestamp` – UTF-8 문자열입니다.

  Kafka 주제에서 데이터 읽기를 시작하는 레코드의 타임스탬프입니다. 가능한 값은 `yyyy-mm-ddTHH:MM:SSZ` 패턴에서 UTC 형식의 타임스탬프 문자열입니다(여기서, Z는 UTC 시간대 오프셋(\$1/-)임, 예: '2023-04-04T08:00:00\$108:00').

  `StartingTimestamp` 또는 `StartingOffsets` 중 하나만 설정해야 합니다.

## RedshiftSource 구조
<a name="aws-glue-api-visual-job-api-RedshiftSource"></a>

Amazon Redshift 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Amazon Redshift 데이터 스토어의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스 테이블입니다.
+ `RedshiftTmpDir` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터베이스 외부에서 복사할 때 임시 데이터를 스테이징할 수 있는 Amazon S3 경로입니다.
+ `TmpDirIAMRole` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  권한이 있는 IAM 역할입니다.

## AmazonRedshiftSource 구조
<a name="aws-glue-api-visual-job-api-AmazonRedshiftSource"></a>

Amazon Redshift 소스를 지정합니다.

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

  Amazon Redshift 소스의 이름입니다.
+ `Data` – [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData) 객체입니다.

  Amazon Resshift 소스 노드의 데이터를 지정합니다.

## AmazonRedshiftNodeData 구조
<a name="aws-glue-api-visual-job-api-AmazonRedshiftNodeData"></a>

Amazon Redshift 노드를 지정합니다.

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

  Redshift 연결을 위한 액세스 유형입니다. 직접 연결 또는 카탈로그 연결일 수 있습니다.
+ `SourceType` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  특정 테이블이 소스인지 또는 사용자 지정 쿼리인지를 지정하기 위한 소스 유형입니다.
+ `Connection` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  Redshift 클러스터에 대한 AWS Glue 연결입니다.
+ `Schema` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  직접 연결로 작업하는 경우 Redshift 스키마 이름입니다.
+ `Table` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  직접 연결로 작업하는 경우 Redshift 테이블 이름입니다.
+ `CatalogDatabase` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  데이터 카탈로그로 작업하는 경우 AWS Glue 데이터 카탈로그 데이터베이스의 이름입니다.
+ `CatalogTable` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  데이터 카탈로그로 작업하는 경우 AWS Glue 데이터 카탈로그 테이블의 이름입니다.
+ `CatalogRedshiftSchema` – UTF-8 문자열입니다.

  데이터 카탈로그로 작업하는 경우 Redshift 스키마 이름입니다.
+ `CatalogRedshiftTable` – UTF-8 문자열입니다.

  읽어야 할 데이터베이스 테이블입니다.
+ `TempDir` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터베이스 외부에서 복사할 때 임시 데이터를 스테이징할 수 있는 Amazon S3 경로입니다.
+ `IamRole` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  선택 사항입니다. S3에 연결할 때 사용하는 역할 이름입니다. 비어 있는 경우 IAM 역할은 기본적으로 작업의 역할을 사용합니다.
+ `AdvancedOptions` – [AmazonRedshiftAdvancedOption](#aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption) 객체의 배열입니다.

  Redshift 클러스터에 연결하는 경우 선택적 값입니다.
+ `SampleQuery` – UTF-8 문자열입니다.

  SourceType이 '쿼리'인 경우 Redshift 소스에서 데이터를 가져오는 데 사용되는 SQL입니다.
+ `PreAction` – UTF-8 문자열입니다.

  업서트와 함께 MERGE 또는 APPEND를 실행하기 전에 사용되는 SQL입니다.
+ `PostAction` – UTF-8 문자열입니다.

  업서트와 함께 MERGE 또는 APPEND를 실행하기 전에 사용되는 SQL입니다.
+ `Action` – UTF-8 문자열입니다.

  Redshift 클러스터에 쓰는 방법을 지정합니다.
+ `TablePrefix` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  테이블의 접두사를 지정합니다.
+ `Upsert` – 부울입니다.

  APPEND를 수행하는 경우 Redshift 싱크에서 사용되는 작업입니다.
+ `MergeAction` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  Redshift 싱크에서 MERGE 처리 방식을 결정할 때 사용되는 작업입니다.
+ `MergeWhenMatched` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  기존 레코드가 새 레코드와 일치하는 경우 Redshift 싱크에서 MERGE 처리 방식을 결정할 때 사용되는 작업입니다.
+ `MergeWhenNotMatched` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  기존 레코드가 새 레코드와 일치하지 않는 경우 Redshift 싱크에서 MERGE 처리 방식을 결정할 때 사용되는 작업입니다.
+ `MergeClause` – UTF-8 문자열입니다.

  일치하는 레코드를 처리하기 위해 사용자 지정 병합에 사용되는 SQL입니다.
+ `CrawlerConnection` – UTF-8 문자열입니다.

  사용된 카탈로그 테이블과 연관된 연결 이름을 지정합니다.
+ `TableSchema` – [옵션](#aws-glue-api-visual-job-api-Option) 객체의 배열입니다.

  지정된 노드에 대한 스키마 출력 배열입니다.
+ `StagingTable` – UTF-8 문자열입니다.

  업서트와 함께 MERGE 또는 APPEND를 수행할 때 사용되는 임시 스테이징 테이블의 이름입니다.
+ `SelectedColumns` – [옵션](#aws-glue-api-visual-job-api-Option) 객체의 배열입니다.

  업서트와 함께 MERGE 또는 APPEND를 수행할 때 일치하는 레코드를 결정하는 데 사용되는 열 이름 목록입니다.

## AmazonRedshiftAdvancedOption 구조
<a name="aws-glue-api-visual-job-api-AmazonRedshiftAdvancedOption"></a>

Redshift 클러스터에 연결할 때 선택적 값을 지정합니다.

**Fields**
+ `Key` – UTF-8 문자열입니다.

  추가 연결 옵션의 키입니다.
+ `Value` – UTF-8 문자열입니다.

  추가 연결 옵션의 값입니다.

## 옵션 구조
<a name="aws-glue-api-visual-job-api-Option"></a>

옵션 값을 지정합니다.

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

  옵션 값을 지정합니다.
+ `Label` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  옵션의 레이블을 지정합니다.
+ `Description` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  옵션에 대한 설명을 지정합니다.

## S3CatalogSource 구조
<a name="aws-glue-api-visual-job-api-S3CatalogSource"></a>

AWS Glue 데이터 카탈로그의 Amazon S3 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스 테이블입니다.
+ `PartitionPredicate` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 조건자를 충족하는 파티션이 삭제됩니다. 이러한 파티션에서 보존 기간 내에 있는 파일은 삭제되지 않습니다. 기본적으로 `""`(비움)로 설정합니다.
+ `AdditionalOptions` – [S3SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions) 객체입니다.

  추가 연결 옵션을 지정합니다.

## S3SourceAdditionalOptions 구조
<a name="aws-glue-api-visual-job-api-S3SourceAdditionalOptions"></a>

Amazon S3 데이터 스토어에 대한 추가 연결 옵션을 지정합니다.

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

  처리될 데이터 집합의 대상 크기에 대한 상한을 바이트 단위로 설정합니다.
+ `BoundedFiles` - 숫자(정수)입니다.

  처리될 대상 파일 수에 대한 상한을 설정합니다.

## S3CsvSource 구조
<a name="aws-glue-api-visual-job-api-S3CsvSource"></a>

Amazon S3에 저장된 CSV(쉼표로 구분된 값) 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  읽을 Amazon S3 경로 목록입니다.
+ `CompressionType` – UTF-8 문자열입니다(유효 값: `gzip="GZIP"` \$1 `bzip2="BZIP2"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  제외할 Unix 스타일 glob 패턴의 JSON 목록이 포함된 문자열입니다. 예를 들어 "[\$1"\$1\$1.pdf\$1"]"는 모든 PDF 파일을 배제합니다.
+ `GroupSize` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  대상 그룹 크기(바이트)입니다. 입력 데이터 크기와 클러스터 크기에 따라 기본값을 계산합니다. 입력 파일이 50,000개 미만일 때는 `"groupFiles"`을 `"inPartition"`으로 설정해야 적용됩니다.
+ `GroupFiles` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  입력에 50,000개 이상의 파일이 포함된 경우 기본값으로 파일 그룹화가 설정됩니다. 50,000개 미만인 파일로 그룹화를 설정하려면 이 파라미터를 "inPartition"으로 설정합니다. 파일이 50,000개 이상일 때 그룹화를 비활성화하려면 이 파라미터를 `"none"`으로 설정합니다.
+ `Recurse` – 부울입니다.

  true로 설정할 경우 지정된 경로의 모든 하위 디렉터리에 있는 파일을 재귀적으로 읽습니다.
+ `MaxBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 s3 목록이 일정하게 유지되기 시작할 가능성이 있는 기간(밀리초)을 제어합니다. JobBookmarks를 사용하여 Amazon S3 최종 일관성을 처리할 때 수정 타임스탬프가 마지막 maxBand 밀리초에 속하는 파일은 특별히 추적됩니다. 대부분의 사용자는 이 옵션을 설정할 필요가 없습니다. 기본값은 900,000밀리초 또는 15분입니다.
+ `MaxFilesInBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 마지막 maxBand초부터 저장할 최대 파일 수를 지정합니다. 이 수를 초과할 경우 추가 파일은 건너뛰고 다음 작업 실행에서만 처리됩니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  추가 연결 옵션을 지정합니다.
+ `Separator` – *필수:* UTF-8 문자열입니다(유효한 값: `comma="COMMA"` \$1 `ctrla="CTRLA"` \$1 `pipe="PIPE"` \$1 `semicolon="SEMICOLON"` \$1 `tab="TAB"`).

  구분 기호 문자열을 지정합니다. 기본값은 쉼표(",")지만 다른 문자도 지정할 수 있습니다.
+ `Escaper` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이스케이프에 사용할 문자를 지정합니다. 이 옵션은 CSV 파일을 읽을 때만 사용됩니다. 기본값은 `none`입니다. 활성화된 경우 바로 다음에 나오는 문자가 잘 알려진 이스케이프 세트(`\n`, `\r`, `\t` 및 `\0`)를 제외하고는 있는 그대로 사용됩니다.
+ `QuoteChar` – *필수:* UTF-8 문자열입니다(유효한 값: `quote="QUOTE"` \$1 `quillemet="QUILLEMET"` \$1 `single_quote="SINGLE_QUOTE"` \$1 `disabled="DISABLED"`).

  인용에 사용할 문자를 지정합니다. 기본 문자는 큰 따옴표(")입니다: `'"'`. 전체 인용을 해제하려면 이 값을 `-1`로 설정합니다.
+ `Multiline` – 부울입니다.

  단일 기록이 다양한 라인을 포괄할 수 있는지 여부를 지정하는 부울 값입니다. 필드가 인용된 새로운 라인 문자를 포함할 때 발생합니다. 레코드가 여러 줄에 걸쳐 있는 경우 이 옵션을 True로 설정해야 합니다. 기본값은 `False`이라서 파싱 동안 더 많은 공격적 파일 쪼개기가 가능합니다.
+ `WithHeader` – 부울입니다.

  첫 번째 라인을 헤더로 취급할지 여부를 지정하는 부울 값입니다. 기본값은 `False`입니다.
+ `WriteHeader` – 부울입니다.

  헤더를 작성하여 출력할지 여부를 지정하는 부울 값입니다. 기본값은 `True`입니다.
+ `SkipFirst` – 부울입니다.

  첫 번째 데이터 라인을 건너뛸지 여부를 지정하는 부울 값입니다. 기본값은 `False`입니다.
+ `OptimizePerformance` – 부울입니다.

  Apache Arrow 기반 열 형식 메모리 포맷과 함께 고급 SIMD CSV 리더를 사용할지 여부를 지정하는 부울 값입니다. AWS Glue 버전 3.0에서만 사용할 수 있습니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 CSV 소스에 대한 데이터 스키마를 지정합니다.

## DirectJDBCSource 구조
<a name="aws-glue-api-visual-job-api-DirectJDBCSource"></a>

직접 JDBC 소스 연결을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 소스 연결의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 소스 연결의 데이터베이스입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 소스 연결의 테이블입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 소스의 연결 이름입니다.
+ `ConnectionType` – *필수:* UTF-8 문자열입니다(유효한 값: `sqlserver` \$1 `mysql` \$1 `oracle` \$1 `postgresql` \$1 `redshift`).

  JDBC 소스의 연결 유형입니다.
+ `RedshiftTmpDir` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  JDBC Redshift 소스의 임시 디렉터리입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  직접 JDBC 소스에 대한 데이터 스키마를 지정합니다.

## S3DirectSourceAdditionalOptions 구조
<a name="aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions"></a>

Amazon S3 데이터 스토어에 대한 추가 연결 옵션을 지정합니다.

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

  처리될 데이터 집합의 대상 크기에 대한 상한을 바이트 단위로 설정합니다.
+ `BoundedFiles` - 숫자(정수)입니다.

  처리될 대상 파일 수에 대한 상한을 설정합니다.
+ `EnableSamplePath` – 부울입니다.

  샘플 경로를 사용 설정하는 옵션을 설정합니다.
+ `SamplePath` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  사용 설정된 경우 샘플 경로를 지정합니다.

## S3JsonSource 구조
<a name="aws-glue-api-visual-job-api-S3JsonSource"></a>

Amazon S3에 저장된 JSON 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  읽을 Amazon S3 경로 목록입니다.
+ `CompressionType` – UTF-8 문자열입니다(유효 값: `gzip="GZIP"` \$1 `bzip2="BZIP2"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  제외할 Unix 스타일 glob 패턴의 JSON 목록이 포함된 문자열입니다. 예를 들어 "[\$1"\$1\$1.pdf\$1"]"는 모든 PDF 파일을 배제합니다.
+ `GroupSize` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  대상 그룹 크기(바이트)입니다. 입력 데이터 크기와 클러스터 크기에 따라 기본값을 계산합니다. 입력 파일이 50,000개 미만일 때는 `"groupFiles"`을 `"inPartition"`으로 설정해야 적용됩니다.
+ `GroupFiles` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  입력에 50,000개 이상의 파일이 포함된 경우 기본값으로 파일 그룹화가 설정됩니다. 50,000개 미만인 파일로 그룹화를 설정하려면 이 파라미터를 "inPartition"으로 설정합니다. 파일이 50,000개 이상일 때 그룹화를 비활성화하려면 이 파라미터를 `"none"`으로 설정합니다.
+ `Recurse` – 부울입니다.

  true로 설정할 경우 지정된 경로의 모든 하위 디렉터리에 있는 파일을 재귀적으로 읽습니다.
+ `MaxBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 s3 목록이 일정하게 유지되기 시작할 가능성이 있는 기간(밀리초)을 제어합니다. JobBookmarks를 사용하여 Amazon S3 최종 일관성을 처리할 때 수정 타임스탬프가 마지막 maxBand 밀리초에 속하는 파일은 특별히 추적됩니다. 대부분의 사용자는 이 옵션을 설정할 필요가 없습니다. 기본값은 900,000밀리초 또는 15분입니다.
+ `MaxFilesInBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 마지막 maxBand초부터 저장할 최대 파일 수를 지정합니다. 이 수를 초과할 경우 추가 파일은 건너뛰고 다음 작업 실행에서만 처리됩니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  추가 연결 옵션을 지정합니다.
+ `JsonPath` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  JSON 데이터를 정의하는 JsonPath 문자열입니다.
+ `Multiline` – 부울입니다.

  단일 기록이 다양한 라인을 포괄할 수 있는지 여부를 지정하는 부울 값입니다. 필드가 인용된 새로운 라인 문자를 포함할 때 발생합니다. 레코드가 여러 줄에 걸쳐 있는 경우 이 옵션을 True로 설정해야 합니다. 기본값은 `False`이라서 파싱 동안 더 많은 공격적 파일 쪼개기가 가능합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 JSON 소스에 대한 데이터 스키마를 지정합니다.

## S3ParquetSource 구조
<a name="aws-glue-api-visual-job-api-S3ParquetSource"></a>

Amazon S3에 저장된 Apache Parquet 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  읽을 Amazon S3 경로 목록입니다.
+ `CompressionType` – UTF-8 문자열입니다(유효한 값: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  제외할 Unix 스타일 glob 패턴의 JSON 목록이 포함된 문자열입니다. 예를 들어 "[\$1"\$1\$1.pdf\$1"]"는 모든 PDF 파일을 배제합니다.
+ `GroupSize` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  대상 그룹 크기(바이트)입니다. 입력 데이터 크기와 클러스터 크기에 따라 기본값을 계산합니다. 입력 파일이 50,000개 미만일 때는 `"groupFiles"`을 `"inPartition"`으로 설정해야 적용됩니다.
+ `GroupFiles` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  입력에 50,000개 이상의 파일이 포함된 경우 기본값으로 파일 그룹화가 설정됩니다. 50,000개 미만인 파일로 그룹화를 설정하려면 이 파라미터를 "inPartition"으로 설정합니다. 파일이 50,000개 이상일 때 그룹화를 비활성화하려면 이 파라미터를 `"none"`으로 설정합니다.
+ `Recurse` – 부울입니다.

  true로 설정할 경우 지정된 경로의 모든 하위 디렉터리에 있는 파일을 재귀적으로 읽습니다.
+ `MaxBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 s3 목록이 일정하게 유지되기 시작할 가능성이 있는 기간(밀리초)을 제어합니다. JobBookmarks를 사용하여 Amazon S3 최종 일관성을 처리할 때 수정 타임스탬프가 마지막 maxBand 밀리초에 속하는 파일은 특별히 추적됩니다. 대부분의 사용자는 이 옵션을 설정할 필요가 없습니다. 기본값은 900,000밀리초 또는 15분입니다.
+ `MaxFilesInBand` – None 이하의 숫자(정수)입니다.

  이 옵션은 마지막 maxBand초부터 저장할 최대 파일 수를 지정합니다. 이 수를 초과할 경우 추가 파일은 건너뛰고 다음 작업 실행에서만 처리됩니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Parquet 소스에 대한 데이터 스키마를 지정합니다.

## S3DeltaSource 구조
<a name="aws-glue-api-visual-job-api-S3DeltaSource"></a>

Amazon S3에 저장된 Delta Lake 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Delta Lake 소스의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  읽을 Amazon S3 경로 목록입니다.
+ `AdditionalDeltaOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  커넥터의 추가 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Delta Lake 소스에 대한 데이터 스키마를 지정합니다.

## S3CatalogDeltaSource 구조
<a name="aws-glue-api-visual-job-api-S3CatalogDeltaSource"></a>

AWS Glue 데이터 카탈로그에 등록된 Delta Lake 데이터 소스를 지정합니다. 데이터 소스를 Amazon S3에 저장해야 합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Delta Lake 데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalDeltaOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Delta Lake 소스에 대한 데이터 스키마를 지정합니다.

## CatalogDeltaSource 구조
<a name="aws-glue-api-visual-job-api-CatalogDeltaSource"></a>

AWS Glue 데이터 카탈로그에 등록된 Delta Lake 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Delta Lake 데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalDeltaOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Delta Lake 소스에 대한 데이터 스키마를 지정합니다.

## S3HudiSource 구조
<a name="aws-glue-api-visual-job-api-S3HudiSource"></a>

Amazon S3에 저장된 Hudi 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Hudi 테이블의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  읽을 Amazon S3 경로 목록입니다.
+ `AdditionalHudiOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  커넥터의 추가 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Hudi 소스에 대한 데이터 스키마를 지정합니다.

## S3CatalogHudiSource 구조
<a name="aws-glue-api-visual-job-api-S3CatalogHudiSource"></a>

AWS Glue 데이터 카탈로그에 등록된 Hudi 데이터 소스를 지정합니다. Hudi 데이터 소스를 Amazon S3에 저장해야 합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Hudi 데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalHudiOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Hudi 소스에 대한 데이터 스키마를 지정합니다.

## S3ExcelSource 구조
<a name="aws-glue-api-visual-job-api-S3ExcelSource"></a>

S3 Excel 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  S3 Excel 데이터 소스의 이름입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  Excel 파일이 있는 S3 경로입니다.
+ `CompressionType` – UTF-8 문자열입니다(유효한 값: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  Excel 파일에 사용되는 압축 형식입니다.
+ `Exclusions` – UTF-8 문자열의 배열입니다.

  처리에서 특정 파일 또는 경로를 제외하는 패턴입니다.
+ `GroupSize` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  배치 처리에 사용할 파일 그룹의 크기를 정의합니다.
+ `GroupFiles` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  처리할 때 파일을 그룹화하는 방법을 지정합니다.
+ `Recurse` – 부울입니다.

  하위 디렉터리를 재귀적으로 처리할지 여부를 나타냅니다.
+ `MaxBand` – None 이하의 숫자(정수)입니다.

  사용할 최대 처리 밴드 수입니다.
+ `MaxFilesInBand` – None 이하의 숫자(정수)입니다.

  각 밴드에서 처리할 최대 파일 수입니다.
+ `AdditionalOptions` – [S3DirectSourceAdditionalOptions](#aws-glue-api-visual-job-api-S3DirectSourceAdditionalOptions) 객체입니다.

  S3 직접 소스 처리를 위한 추가 구성 옵션입니다.
+ `NumberRows` - 숫자(정수)입니다.

  각 Excel 파일에서 처리할 행 수입니다.
+ `SkipFooter` – None 이하의 숫자(정수)입니다.

  각 Excel 파일의 끝에서 건너뛸 행 수입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  처리된 데이터에 적용할 AWS Glue 스키마입니다.

## CatalogHudiSource 구조
<a name="aws-glue-api-visual-job-api-CatalogHudiSource"></a>

AWS Glue 데이터 카탈로그에 등록된 Hudi 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Hudi 데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalHudiOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Hudi 소스에 대한 데이터 스키마를 지정합니다.

## DynamoDBCatalogSource 구조
<a name="aws-glue-api-visual-job-api-DynamoDBCatalogSource"></a>

AWS Glue 데이터 카탈로그의 DynamoDB 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `PitrEnabled` – 부울입니다.

  DynamoDB 테이블에 대해 시점 복구(PITR)를 활성화할지 여부를 지정합니다. `true`로 설정하면 특정 시점에서 읽을 수 있습니다. 기본값은 `false`입니다.
+ `AdditionalOptions` – [DDBELTCatalogAdditionalOptions](#aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions) 객체입니다.

  DynamoDB 데이터 소스의 추가 연결 옵션을 지정합니다.

## RelationalCatalogSource 구조
<a name="aws-glue-api-visual-job-api-RelationalCatalogSource"></a>

AWS Glue 데이터 카탈로그의 관계형 데이터베이스 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 원본의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.

## JDBCConnectorTarget 구조
<a name="aws-glue-api-visual-job-api-JDBCConnectorTarget"></a>

Apache Parquet 열 형식 스토리지의 Amazon S3에 쓰는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터와 연관된 연결 이름입니다.
+ `ConnectionTable` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상에 있는 테이블의 이름입니다.
+ `ConnectorName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  사용할 커넥터의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  JDBC 데이터 대상에 대한 연결을 지정하는 marketplace.jdbc 또는 custom.jdbc와 같은 연결 유형입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  JDBC 대상의 데이터 스키마를 지정합니다.

## SparkConnectorTarget 구조
<a name="aws-glue-api-visual-job-api-SparkConnectorTarget"></a>

Apache Spark 커넥터를 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `ConnectionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Apache Spark 커넥터에 대한 연결 이름입니다.
+ `ConnectorName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Apache Spark 커넥터의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Apache Spark 데이터 스토어에 대한 연결을 지정하는 marketplace.spark 또는 custom.spark와 같은 연결 유형입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  사용자 지정 Spark 대상에 대한 데이터 스키마를 지정합니다.

## BasicCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-BasicCatalogTarget"></a>

AWS Glue 데이터 카탈로그 테이블을 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  특정 키 또는 키 세트를 기반으로 여러 파티션 또는 샤드에 데이터를 분산하는 데 사용되는 파티션 키.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  대상으로 사용할 테이블이 포함된 데이터베이스입니다. 이 데이터베이스가 데이터 카탈로그에 이미 존재해야 합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  출력 데이터의 스키마를 정의하는 테이블입니다. 이 테이블이 데이터 카탈로그에 이미 존재해야 합니다.

## MySQLCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-MySQLCatalogTarget"></a>

MySQL을 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.

## PostgreSQLCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-PostgreSQLCatalogTarget"></a>

Postgres SQL을 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.

## OracleSQLCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-OracleSQLCatalogTarget"></a>

Oracle SQL을 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.

## MicrosoftSQLServerCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-MicrosoftSQLServerCatalogTarget"></a>

Microsoft SQL을 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.

## RedshiftTarget 구조
<a name="aws-glue-api-visual-job-api-RedshiftTarget"></a>

Amazon Redshift를 사용하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `RedshiftTmpDir` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터베이스 외부에서 복사할 때 임시 데이터를 스테이징할 수 있는 Amazon S3 경로입니다.
+ `TmpDirIAMRole` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  권한이 있는 IAM 역할입니다.
+ `UpsertRedshiftOptions` – [UpsertRedshiftTargetOptions](#aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions) 객체입니다.

  Redshift 대상에 쓸 때 업서트 작업을 구성하는 옵션 세트입니다.

## AmazonRedshiftTarget 구조
<a name="aws-glue-api-visual-job-api-AmazonRedshiftTarget"></a>

Amazon Redshift 대상을 지정합니다.

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

  Amazon Redshift 대상의 이름입니다.
+ `Data` – [AmazonRedshiftNodeData](#aws-glue-api-visual-job-api-AmazonRedshiftNodeData) 객체입니다.

  Amazon Redshift 대상 노드의 데이터를 지정합니다.
+ `Inputs` – UTF-8 문자열의 배열입니다(1개의 문자열).

  데이터 대상에 대한 입력인 노드입니다.

## UpsertRedshiftTargetOptions 구조
<a name="aws-glue-api-visual-job-api-UpsertRedshiftTargetOptions"></a>

Redshift 대상에 쓸 때 업서트 작업을 구성하는 옵션입니다.

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

  Redshift 테이블의 물리적 위치입니다.
+ `ConnectionName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  Redshift에 쓰는 데 사용할 연결 이름입니다.
+ `UpsertKeys` – UTF-8 문자열의 배열입니다.

  업데이트 또는 삽입 수행 여부를 결정하는 데 사용되는 키입니다.

## S3CatalogTarget 구조
<a name="aws-glue-api-visual-job-api-S3CatalogTarget"></a>

AWS Glue 데이터 카탈로그를 사용하여 Amazon S3에 쓰는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## S3GlueParquetTarget 구조
<a name="aws-glue-api-visual-job-api-S3GlueParquetTarget"></a>

Apache Parquet 열 형식 스토리지의 Amazon S3에 쓰는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 단일 Amazon S3 경로입니다.
+ `Compression` – UTF-8 문자열입니다(유효한 값: `snappy="SNAPPY"` \$1 `lzo="LZO"` \$1 `gzip="GZIP"` \$1 `brotli="BROTLI"` \$1 `lz4="LZ4"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `none="NONE"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  AWS Glue를 사용하여 Amazon S3에 쓸 때 Parquet 파일의 대상 파티션 수를 지정합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 AWS Glue Parquet 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## CatalogSchemaChangePolicy 구조
<a name="aws-glue-api-visual-job-api-CatalogSchemaChangePolicy"></a>

크롤러에 대한 업데이트 동작을 지정하는 정책입니다.

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

  크롤러가 변경된 스키마를 찾았을 때 지정된 업데이트 동작을 사용할지 여부입니다.
+ `UpdateBehavior` – UTF-8 문자열입니다(유효 값: `UPDATE_IN_DATABASE` \$1 `LOG`).

  크롤러가 변화된 객체를 찾을 때 업데이트 동작.

## S3DirectTarget 구조
<a name="aws-glue-api-visual-job-api-S3DirectTarget"></a>

Amazon S3에 쓰는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 단일 Amazon S3 경로입니다.
+ `Compression` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  데이터를 Amazon S3에 직접 쓸 때 대상 파티션 수를 지정합니다.
+ `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  대상에 대한 데이터 출력 포맷을 지정합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 직접 대상의 데이터 스키마를 지정합니다.

## S3HudiCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-S3HudiCatalogTarget"></a>

AWS Glue 데이터 카탈로그의 Hudi 데이터 소스에 작성하는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `AdditionalOptions` – *필수(Required):* 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Hudi 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Hudi 카탈로그 대상의 데이터 스키마를 지정합니다.

## S3HudiDirectTarget 구조
<a name="aws-glue-api-visual-job-api-S3HudiDirectTarget"></a>

Amazon S3에서 Hudi 데이터 소스에 작성하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 Hudi 데이터 소스의 Amazon S3 경로입니다.
+ `Compression` – *필수:* UTF-8 문자열입니다(유효한 값: `gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  Amazon S3 전체에 Hudi 데이터세트 파일을 배포할 대상 파티션 수를 지정합니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  대상에 대한 데이터 출력 포맷을 지정합니다.
+ `AdditionalOptions` – *필수(Required):* 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Hudi 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## S3DeltaCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-S3DeltaCatalogTarget"></a>

AWS Glue 데이터 카탈로그의 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Delta 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Delta 카탈로그 대상의 데이터 스키마를 지정합니다.

## S3DeltaDirectTarget 구조
<a name="aws-glue-api-visual-job-api-S3DeltaDirectTarget"></a>

Amazon S3에서 Delta Lake 데이터 소스에 작성하는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 Delta Lake 데이터 소스의 Amazon S3 경로입니다.
+ `Compression` – *필수:* UTF-8 문자열입니다(유효한 값: `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  데이터 압축 방식을 지정합니다. 이 작업은 데이터에 표준 파일 확장자가 있는 경우에는 필요하지 않습니다. 가능한 값은 `"gzip"` 및 `"bzip"`입니다).
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  Amazon S3 전체에 Delta Lake 데이터세트 파일을 배포할 대상 파티션 수를 지정합니다.
+ `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  대상에 대한 데이터 출력 포맷을 지정합니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  커넥터에 대한 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  크롤러에 대한 업데이트 동작을 지정하는 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Delta 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## S3HyperDirectTarget 구조
<a name="aws-glue-api-visual-job-api-S3HyperDirectTarget"></a>

Amazon S3에 쓰는 HyperDirect 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  HyperDirect 대상 노드의 고유 식별자입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  HyperDirect 대상의 입력 소스를 지정합니다.
+ `Format` – UTF-8 문자열입니다(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  HyperDirect 대상에 대한 데이터 출력 포맷을 지정합니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  출력 데이터에 대한 파티셔닝 전략을 정의합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  출력 데이터를 기록할 S3 위치입니다.
+ `Compression` – UTF-8 문자열입니다(유효한 값: `uncompressed="UNCOMPRESSED"`).

  출력 데이터에 적용할 압축 유형입니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  쓰기 작업 중에 스키마 변경 사항을 처리하는 방법을 정의합니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Hyper 직접 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Hyper 직접 대상의 데이터 스키마를 지정합니다.

## S3IcebergDirectTarget 구조
<a name="aws-glue-api-visual-job-api-S3IcebergDirectTarget"></a>

Amazon S3에서 Iceberg 데이터 소스에 쓰는 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 파이프라인의 Iceberg 대상 노드에 대한 고유 식별자를 지정합니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  이 Iceberg 대상에 데이터를 제공하는 단일 입력 소스를 정의합니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  S3에서 Iceberg 테이블 데이터를 파티셔닝하는 데 사용되는 열을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 테이블 데이터가 저장될 S3 위치를 정의합니다.
+ `Format` – *필수:* UTF-8 문자열(유효한 값: `json="JSON"` \$1 `csv="CSV"` \$1 `avro="AVRO"` \$1 `orc="ORC"` \$1 `parquet="PARQUET"` \$1 `hudi="HUDI"` \$1 `delta="DELTA"` \$1 `iceberg="ICEBERG"` \$1 `hyper="HYPER"` \$1 `xml="XML"`).

  Iceberg 테이블 데이터 저장에 사용되는 파일 형식(예: Parquet, ORC)을 지정합니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 테이블 동작을 사용자 지정하기 위한 추가 구성 옵션을 제공합니다.
+ `SchemaChangePolicy` – [DirectSchemaChangePolicy](#aws-glue-api-visual-job-api-DirectSchemaChangePolicy) 객체입니다.

  Iceberg 테이블에 데이터를 쓸 때 스키마 변경 사항을 처리하는 방법을 정의합니다.
+ `Compression` – *필수:* UTF-8 문자열입니다(유효한 값: `gzip="GZIP"` \$1 `lzo="LZO"` \$1 `uncompressed="UNCOMPRESSED"` \$1 `snappy="SNAPPY"`).

  S3의 Iceberg 테이블 파일에 사용되는 압축 코덱을 지정합니다.
+ `NumberTargetPartitions` – UTF-8 문자열입니다.

  S3에 Iceberg 테이블 파일을 배포하기 위한 대상 파티션 수를 설정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  S3 Iceberg 직접 대상의 데이터 스키마를 지정합니다.

## DirectSchemaChangePolicy 구조
<a name="aws-glue-api-visual-job-api-DirectSchemaChangePolicy"></a>

크롤러에 대한 업데이트 동작을 지정하는 정책입니다.

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

  크롤러가 변경된 스키마를 찾았을 때 지정된 업데이트 동작을 사용할지 여부입니다.
+ `UpdateBehavior` – UTF-8 문자열입니다(유효 값: `UPDATE_IN_DATABASE` \$1 `LOG`).

  크롤러가 변화된 객체를 찾을 때 업데이트 동작.
+ `Table` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  스키마 변경 정책이 적용되는 데이터베이스의 테이블을 지정합니다.
+ `Database` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  스키마 변경 정책이 적용되는 데이터베이스를 지정합니다.

## ApplyMapping 구조
<a name="aws-glue-api-visual-job-api-ApplyMapping"></a>

데이터 원본의 데이터 속성 키를 데이터 대상의 데이터 속성 키에 매핑하는 변환을 지정합니다. 키의 이름을 바꾸고 키의 데이터 유형을 수정하고 데이터 집합에서 삭제할 키를 선택할 수 있습니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Mapping` – *필수:* [매핑](#aws-glue-api-visual-job-api-Mapping) 객체의 배열입니다.

  데이터 원본의 데이터 속성 키를 데이터 대상의 데이터 속성 키에 매핑하도록 지정합니다.

## Mapping 구조
<a name="aws-glue-api-visual-job-api-Mapping"></a>

데이터 속성 키의 매핑을 지정합니다.

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

  매핑을 적용한 후의 열 이름입니다. `FromPath`와 같을 수 있습니다.
+ `FromPath` – UTF-8 문자열의 배열입니다.

  수정할 테이블 또는 열입니다.
+ `FromType` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  수정할 데이터 유형입니다.
+ `ToType` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  데이터가 수정되는 데이터 유형입니다.
+ `Dropped` – 부울입니다.

  true인 경우 열이 제거됩니다.
+ `Children` – [매핑](#aws-glue-api-visual-job-api-Mapping) 객체의 배열입니다.

  중첩된 데이터 구조에만 적용됩니다. 상위 구조뿐만 아니라 하위 구조 중 하나도 변경하려는 경우 이 데이터 구조를 작성할 수 있습니다. 마찬가지로 `Mapping`이지만 해당 `FromPath`도 상위 구조의 `FromPath`와 이 구조의 `FromPath`가 됩니다.

  하위 부분의 경우 다음과 같은 구조가 있다고 가정합니다.

  `{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`

  다음과 같은 `Mapping`을 지정할 수 있습니다.

  `{ "FromPath": "OuterStructure", "ToKey": "OuterStructure", "ToType": "Struct", "Dropped": false, "Chidlren": [{ "FromPath": "inner", "ToKey": "inner", "ToType": "Double", "Dropped": false, }] }`

## SelectFields 구조
<a name="aws-glue-api-visual-job-api-SelectFields"></a>

유지할 데이터 속성 키를 선택하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  데이터 구조의 변수에 대한 JSON 경로입니다.

## DropFields 구조
<a name="aws-glue-api-visual-job-api-DropFields"></a>

삭제할 데이터 속성 키를 선택하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  데이터 구조의 변수에 대한 JSON 경로입니다.

## RenameField 구조
<a name="aws-glue-api-visual-job-api-RenameField"></a>

단일 데이터 속성 키의 이름을 바꾸는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `SourcePath` – *필수:* UTF-8 문자열의 배열입니다.

  소스 데이터에 대한 데이터 구조의 변수에 대한 JSON 경로입니다.
+ `TargetPath` – *필수:* UTF-8 문자열의 배열입니다.

  대상 데이터에 대한 데이터 구조의 변수에 대한 JSON 경로입니다.

## Spigot 구조
<a name="aws-glue-api-visual-job-api-Spigot"></a>

Amazon S3 버킷에 데이터 샘플을 쓰는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  변환이 데이터 집합의 레코드 하위 집합을 Amazon S3 버킷의 JSON 파일에 쓰는 Amazon S3의 경로입니다.
+ `Topk` – 100 이하의 숫자(정수)입니다.

  데이터 집합의 시작 부분부터 쓸 레코드 수를 지정합니다.
+ `Prob` – 1 이하의 숫자(double)입니다.

  지정된 레코드를 선택할 확률(최대값이 1인 소수 값)입니다. 값 1은 데이터 집합에서 읽은 각 행이 샘플 출력에 포함되어야 함을 나타냅니다.

## 조인 구조
<a name="aws-glue-api-visual-job-api-Join"></a>

지정된 데이터 속성 키의 비교 구문을 사용하여 두 데이터 집합을 하나의 데이터 집합으로 조인하는 변환을 지정합니다. 내부, 외부, 왼쪽, 오른쪽, 왼쪽 반 및 왼쪽 안티 조인을 사용할 수 있습니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(2개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `JoinType` – *필수:* UTF-8 문자열입니다(유효한 값: `equijoin="EQUIJOIN"` \$1 `left="LEFT"` \$1 `right="RIGHT"` \$1 `outer="OUTER"` \$1 `leftsemi="LEFT_SEMI"` \$1 `leftanti="LEFT_ANTI"`).

  데이터 집합에서 수행할 조인 유형을 지정합니다.
+ `Columns` – *필수(Required):* 2개 이상의 구조로 이루어진 [JoinColumn](#aws-glue-api-visual-job-api-JoinColumn) 객체의 배열입니다.

  조인할 두 열의 목록입니다.

## JoinColumn 구조
<a name="aws-glue-api-visual-job-api-JoinColumn"></a>

조인할 열을 지정합니다.

**Fields**
+ `From` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  조인할 열입니다.
+ `Keys` – *필수:* UTF-8 문자열의 배열입니다.

  조인할 열의 키입니다.

## SplitFields 구조
<a name="aws-glue-api-visual-job-api-SplitFields"></a>

데이터 속성 키를 두 개의 `DynamicFrames`로 분할하는 변환을 지정합니다. 출력은 `DynamicFrames` 컬렉션입니다. 하나에는 선택한 데이터 속성 키가 있고 다른 하나에는 나머지 데이터 속성 키가 있습니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Paths` – *필수:* UTF-8 문자열의 배열입니다.

  데이터 구조의 변수에 대한 JSON 경로입니다.

## SelectFromCollection 구조
<a name="aws-glue-api-visual-job-api-SelectFromCollection"></a>

`DynamicFrames` 컬렉션에서 하나의 `DynamicFrame`을 선택하는 변환을 지정합니다. 출력은 선택한 `DynamicFrame`입니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Index` – *필수(Required):* None 이하의 숫자(정수)입니다.

  선택할 DynamicFrame의 인덱스입니다.

## FillMissingValues 구조
<a name="aws-glue-api-visual-job-api-FillMissingValues"></a>

데이터 집합에서 누락된 값이 있는 레코드를 찾고 대체를 통해 결정된 값으로 새 필드를 추가하는 변환을 지정합니다. 입력 데이터 집합은 누락 값을 결정하는 기계 학습 모델을 훈련하는 데 사용됩니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `ImputedPath` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  대체된 데이터 집합에 대한 데이터 구조의 변수에 대한 JSON 경로입니다.
+ `FilledPath` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  작성된 데이터 집합에 대한 데이터 구조의 변수에 대한 JSON 경로입니다.

## Filter 구조
<a name="aws-glue-api-visual-job-api-Filter"></a>

필터 조건에 따라 하나의 데이터 집합을 두 개로 분할하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `LogicalOperator` – *필수:* UTF-8 문자열입니다(유효한 값: `AND` \$1 `OR`).

  키 값을 지정된 값과 비교하여 행을 필터링하는 데 사용되는 연산자입니다.
+ `Filters` – **필수(Required): [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression) 객체의 배열입니다.

  필터 표현식을 지정합니다.

## FilterExpression 구조
<a name="aws-glue-api-visual-job-api-FilterExpression"></a>

필터 표현식을 지정합니다.

**Fields**
+ `Operation` – *필수:* UTF-8 문자열입니다(유효한 값: `EQ` \$1 `LT` \$1 `GT` \$1 `LTE` \$1 `GTE` \$1 `REGEX` \$1 `ISNULL`).

  표현식에서 수행할 작업의 유형입니다.
+ `Negated` – 부울입니다.

  표현식을 부정할지 여부입니다.
+ `Values` – **필수(Required): [FilterValue](#aws-glue-api-visual-job-api-FilterValue) 객체의 배열입니다.

  필터 값 목록입니다.

## FilterValue 구조
<a name="aws-glue-api-visual-job-api-FilterValue"></a>

`FilterExpression`의 값 목록에 있는 단일 항목을 나타냅니다.

**Fields**
+ `Type` – *필수:* UTF-8 문자열입니다(유효한 값: `COLUMNEXTRACTED` \$1 `CONSTANT`).

  필터 값 유형입니다.
+ `Value` – *필수:* UTF-8 문자열의 배열입니다.

  연결할 값입니다.

## CustomCode 구조
<a name="aws-glue-api-visual-job-api-CustomCode"></a>

제공한 사용자 지정 코드를 사용하여 데이터 변환을 수행하는 변환을 지정합니다. 출력은 DynamicFrames의 컬렉션입니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Code` – *필수:* [Custom string pattern #54](aws-glue-api-common.md#regex_54)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 변환을 수행하는 데 사용되는 사용자 지정 코드입니다.
+ `ClassName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  사용자 지정 코드 노드 클래스에 대해 정의된 이름입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  사용자 지정 코드 변환에 대한 데이터 스키마를 지정합니다.

## SparkSQL 구조
<a name="aws-glue-api-visual-job-api-SparkSQL"></a>

데이터를 변환하기 위해 Spark SQL 구문을 사용하여 SQL 쿼리를 입력하는 변환을 지정합니다. 출력은 단일 `DynamicFrame`입니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다.

  노드 이름으로 식별된 데이터 입력입니다. SQL 쿼리에 사용할 각 입력 노드와 테이블 이름을 연결할 수 있습니다. 선택한 이름은 Spark SQL 이름 지정 제한을 충족해야 합니다.
+ `SqlQuery` – *필수:* [Custom string pattern #62](aws-glue-api-common.md#regex_62)과(와) 일치하는 UTF-8 문자열입니다.

  Spark SQL 구문을 사용하고 단일 데이터 집합을 반환해야 하는 SQL 쿼리입니다.
+ `SqlAliases` – **필수(Required): [SqlAlias](#aws-glue-api-visual-job-api-SqlAlias) 객체의 배열입니다.

  별칭 목록입니다. 별칭을 사용하면 지정된 입력에 대해 SQL에서 사용할 이름을 지정할 수 있습니다. 예를 들어 'MyDataSource'라는 데이터 원본이 있습니다. `From`을 MyDataSource로, `Alias`를 SqlName으로 지정할 경우 SQL에서 다음을 수행할 수 있습니다.

  `select * from SqlName`

  그러면 MyDataSource에서 데이터를 가져옵니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  SparkSQL 변환에 대한 데이터 스키마를 지정합니다.

## SqlAlias 구조
<a name="aws-glue-api-visual-job-api-SqlAlias"></a>

`SqlAliases`의 값 목록에 있는 단일 항목을 나타냅니다.

**Fields**
+ `From` – *필수:* [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  테이블 또는 테이블의 열입니다.
+ `Alias` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  테이블 또는 테이블의 열에 지정된 임시 이름입니다.

## DropNullFields 구조
<a name="aws-glue-api-visual-job-api-DropNullFields"></a>

열의 모든 값이 'null'인 경우 데이터 집합에서 열을 제거하는 변환을 지정합니다. 기본값으로 AWS Glue Studio는 Null 객체를 인식하지만 빈 문자열, 'null'인 문자열, -1 정수 또는 0과 같은 다른 자리 표시자 등의 일부 값은 자동으로 Null로 인식되지 않습니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `NullCheckBoxList` – [NullCheckBoxList](#aws-glue-api-visual-job-api-NullCheckBoxList) 객체입니다.

  특정 값을 제거하기 위해 Null 값으로 인식할지 여부를 나타내는 구조입니다.
+ `NullTextList` – [NullValueField](#aws-glue-api-visual-job-api-NullValueField) 객체의 배열이며 구조는 50개 이하입니다.

  0이나 데이터 집합에 고유한 Null 자리 표시자로 사용되는 다른 값과 같은 사용자 지정 Null 값을 나타내는 NullValueField 구조 목록을 지정하는 구조입니다.

  `DropNullFields` 변환은 Null 자리 표시자의 값과 데이터 유형이 모두 데이터와 일치하는 경우에만 사용자 지정 Null 값을 제거합니다.

## NullCheckBoxList 구조
<a name="aws-glue-api-visual-job-api-NullCheckBoxList"></a>

제거를 위해 특정 값을 Null 값으로 인식할지 여부를 나타냅니다.

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

  빈 문자열이 Null 값으로 간주되도록 지정합니다.
+ `IsNullString` – 부울입니다.

  'null'이라는 단어의 철자를 사용하는 값이 Null 값으로 간주되도록 지정합니다.
+ `IsNegOne` – 부울입니다.

  정수 값 -1이 Null 값으로 간주되도록 지정합니다.

## NullValueField 구조
<a name="aws-glue-api-visual-job-api-NullValueField"></a>

0이나 데이터 집합에 고유한 Null 자리 표시자로 사용되는 다른 값과 같은 사용자 지정 Null 값을 나타냅니다.

**Fields**
+ `Value` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Null 자리 표시자의 값입니다.
+ `Datatype` – *필수(Required):* [데이터 형식](#aws-glue-api-visual-job-api-Datatype) 객체입니다.

  값의 데이터 유형입니다.

## 데이터 형식 구조
<a name="aws-glue-api-visual-job-api-Datatype"></a>

값의 데이터 유형을 나타내는 구조입니다.

**Fields**
+ `Id` – *필수:* [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  값의 데이터 유형입니다.
+ `Label` – *필수:* [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 유형에 할당된 레이블입니다.

## 병합 구조
<a name="aws-glue-api-visual-job-api-Merge"></a>

레코드를 식별하기 위해 지정된 기본 키를 기준으로 `DynamicFrame`을 스테이징 `DynamicFrame`과 병합하는 변환을 지정합니다. 중복 레코드(기본 키가 동일한 레코드)는 중복 제거되지 않습니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(2개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Source` – *필수:* [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  스테이징 `DynamicFrame`과 병합되는 소스 `DynamicFrame`입니다.
+ `PrimaryKeys` – *필수:* UTF-8 문자열의 배열입니다.

  소스 및 스테이징 동적 프레임의 레코드와 일치시킬 기본 키 필드 목록입니다.

## 결합 구조
<a name="aws-glue-api-visual-job-api-Union"></a>

둘 이상 데이터 집합의 행을 단일 결과로 결합하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(2개 이상)입니다.

  노드 ID가 변환에 입력됩니다.
+ `UnionType` – *필수:* UTF-8 문자열입니다(유효한 값: `ALL` \$1 `DISTINCT`).

  Union 변환 유형을 나타냅니다.

  데이터 원본의 모든 행을 결과 DynamicFrame에 조인하려면 `ALL`을 지정합니다. 결과 union 구조는 중복 행을 제거하지 않습니다.

  결과 DynamicFrame에서 중복 행을 제거하려면 `DISTINCT`를 지정합니다.

## PIIDetection 구조
<a name="aws-glue-api-visual-job-api-PIIDetection"></a>

PII 데이터를 식별, 제거 또는 마스킹하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 ID가 변환에 입력됩니다.
+ `PiiType` – **필수: UTF-8 문자열입니다(유효한 값: `RowAudit` \$1 `RowHashing` \$1 `RowMasking` \$1 `RowPartialMasking` \$1 `ColumnAudit` \$1 `ColumnHashing` \$1 `ColumnMasking`).

  PIIDetection 변환 유형을 나타냅니다.
+ `EntityTypesToDetect` – *필수:* UTF-8 문자열의 배열입니다.

  PIIDetection 변환이 PII 데이터로 식별할 엔터티 유형을 나타냅니다.

   PII 유형 엔터티는 다음을 포함합니다. PERSON\$1NAME, DATE, USA\$1SNN, EMAIL, USA\$1ITIN, USA\$1PASSPORT\$1NUMBER, PHONE\$1NUMBER, BANK\$1ACCOUNT, IP\$1ADDRESS, MAC\$1ADDRESS, USA\$1CPT\$1CODE, USA\$1HCPCS\$1CODE, USA\$1NATIONAL\$1DRUG\$1CODE, USA\$1MEDICARE\$1BENEFICIARY\$1IDENTIFIER, USA\$1HEALTH\$1INSURANCE\$1CLAIM\$1NUMBER,CREDIT\$1CARD,USA\$1NATIONAL\$1PROVIDER\$1IDENTIFIER,USA\$1DEA\$1NUMBER,USA\$1DRIVING\$1LICENSE 
+ `OutputColumnName` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  해당 행에서 감지된 모든 엔터티 유형을 포함할 출력 열 이름을 나타냅니다.
+ `SampleFraction` – 1 이하의 숫자(실수)입니다.

  PII 엔터티를 스캔할 때 샘플링할 데이터의 비율을 나타냅니다.
+ `ThresholdFraction` – 1 이하의 숫자(실수)입니다.

  열을 PII 데이터로 식별하기 위해 충족되어야 하는 데이터의 비율을 나타냅니다.
+ `MaskValue` – 과(와) 일치하는 256바이트 이하 길이의 UTF-8 문자열입니다..[Custom string pattern #58](aws-glue-api-common.md#regex_58)

  감지된 개체를 대체할 값을 나타냅니다.
+ `RedactText` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  감지된 PII 텍스트를 수정할지 여부를 지정합니다. `true`로 설정하면 PII 콘텐츠가 수정 문자로 대체됩니다.
+ `RedactChar` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  수정이 활성화된 경우 감지된 PII 콘텐츠를 대체하는 데 사용되는 문자입니다. 기본 수정 문자는 `*`입니다.
+ `MatchPattern` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  표준 탐지 알고리즘 외에, 추가 PII 콘텐츠를 식별하는 데 사용되는 정규 표현식 패턴입니다.
+ `NumLeftCharsToExclude` – None 이하의 숫자(정수)입니다.

  탐지된 PII 콘텐츠 왼쪽의 수정 내용에서 제외할 문자 수입니다. 이를 통해 민감한 데이터와 관련한 컨텍스트를 보존할 수 있습니다.
+ `NumRightCharsToExclude` – None 이하의 숫자(정수)입니다.

  탐지된 PII 콘텐츠 오른쪽의 수정 내용에서 제외할 문자 수입니다. 이를 통해 민감한 데이터와 관련한 컨텍스트를 보존할 수 있습니다.
+ `DetectionParameters` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  PII 감지 동작 및 민감도 설정을 구성하기 위한 추가 파라미터입니다.
+ `DetectionSensitivity` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  PII 감지의 민감도 수준입니다. 민감도 수준이 높을수록 잠재적 PII가 더 많이 감지되지만, 오탐이 더 많이 발생할 수 있습니다.

## 집계 구조
<a name="aws-glue-api-visual-job-api-Aggregate"></a>

선택한 필드별로 행을 그룹화하고 지정된 함수에 의해 집계된 값을 계산하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  집계 변환에 대해 입력으로 사용할 필드와 행을 지정합니다.
+ `Groups` – *필수:* UTF-8 문자열의 배열입니다.

  그룹화할 필드를 지정합니다.
+ `Aggs` – *필수(Required):* [AggregateOperation](#aws-glue-api-visual-job-api-AggregateOperation) 객체의 배열이며 구조는 1\$130개입니다.

  지정된 필드에서 수행할 집계 함수를 지정합니다.

## DropDuplicates 구조
<a name="aws-glue-api-visual-job-api-DropDuplicates"></a>

데이터세트에서 반복 데이터의 행을 제거하는 변환을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  변환 노드의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  노드 이름으로 식별된 데이터 입력입니다.
+ `Columns` – UTF-8 문자열의 배열입니다.

  반복될 경우 병합하거나 제거할 열의 이름입니다.

## GovernedCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-GovernedCatalogTarget"></a>

AWS Glue 데이터 카탈로그를 사용하여 Amazon S3에 쓰는 데이터 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 대상의 이름입니다.
+ `Inputs` – *필수(Required):* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 대상에 대한 입력인 노드입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  일련의 키를 사용하여 기본 분할을 지정합니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  관리 카탈로그에 대한 업데이트 동작을 지정하는 정책입니다.

## GovernedCatalogSource 구조
<a name="aws-glue-api-visual-job-api-GovernedCatalogSource"></a>

관리 AWS Glue 데이터 카탈로그의 데이터 스토어를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 스토어의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽어야 할 데이터베이스 테이블입니다.
+ `PartitionPredicate` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 조건자를 충족하는 파티션이 삭제됩니다. 이러한 파티션에서 보존 기간 내에 있는 파일은 삭제되지 않습니다. 기본적으로 `""`(비움)로 설정합니다.
+ `AdditionalOptions` – [S3SourceAdditionalOptions](#aws-glue-api-visual-job-api-S3SourceAdditionalOptions) 객체입니다.

  추가 연결 옵션을 지정합니다.

## AggregateOperation 구조
<a name="aws-glue-api-visual-job-api-AggregateOperation"></a>

집계 변환에서 집계를 수행하는 데 필요한 파라미터 세트를 지정합니다.

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

  집계 함수가 적용될 데이터 세트의 열을 지정합니다.
+ `AggFunc` – *필수(Required):* UTF-8 문자열입니다(유효 값: `avg` \$1 `countDistinct` \$1 `count` \$1 `first` \$1 `last` \$1 `kurtosis` \$1 `max` \$1 `min` \$1 `skewness` \$1 `stddev_samp` \$1 `stddev_pop` \$1 `sum` \$1 `sumDistinct` \$1 `var_samp` \$1 `var_pop`).

  적용할 집계 함수를 지정합니다.

  가능한 집계 함수로는 평균 개수별, 개수, 첫 번째, 마지막, kurtosis, 최대, 최소, 왜도, stddev\$1samp, stddev\$1pop, 합계, sumDistinct, var\$1samp, var\$1pop 등이 있습니다.

## GlueSchema 구조
<a name="aws-glue-api-visual-job-api-GlueSchema"></a>

스키마를 AWS Glue에서 결정할 수 없는 경우 사용자 정의 스키마를 지정합니다.

**Fields**
+ `Columns` – [GlueStudioSchemaColumn](#aws-glue-api-visual-job-api-GlueStudioSchemaColumn) 객체의 배열입니다.

  AWS Glue 스키마를 구성하는 열 정의를 지정합니다.

## GlueStudioSchemaColumn 구조
<a name="aws-glue-api-visual-job-api-GlueStudioSchemaColumn"></a>

AWS Glue 스키마 정의에서 단일 열을 지정합니다.

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

  AWS Glue Studio 스키마의 열 이름입니다.
+ `Type` – 과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  AWS Glue Studio 스키마의 이 열에 대한 하이브 유형입니다.
+ `GlueStudioType` – 과(와) 일치하는 131,072바이트 이하 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  AWS Glue Studio에 정의되어 있는, 열의 데이터 유형입니다.

## GlueStudioColumn 구조
<a name="aws-glue-api-visual-job-api-GlueStudioColumn"></a>

AWS Glue Studio에서 단일 열을 지정합니다.

**Fields**
+ `Key` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue Studio에서 열의 키입니다.
+ `FullPath` – *필수:* UTF-8 문자열의 배열입니다.

  AWS Glue Studio에서 열의 전체 URL입니다.
+ `Type` – *필수:* UTF-8 문자열(유효한 값: `array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`).

  AWS Glue Studio에서 열의 유형입니다.
+ `Children` - 구조의 배열입니다.

  AWS Glue Studio에서 상위 열의 하위 요소입니다.
+ `GlueStudioType` – UTF-8 문자열(유효한 값: `array="ARRAY"` \$1 `bigint="BIGINT"` \$1 `bigint array="BIGINT_ARRAY"` \$1 `binary="BINARY"` \$1 `binary array="BINARY_ARRAY"` \$1 `boolean="BOOLEAN"` \$1 `boolean array="BOOLEAN_ARRAY"` \$1 `byte="BYTE"` \$1 `byte array="BYTE_ARRAY"` \$1 `char="CHAR"` \$1 `char array="CHAR_ARRAY"` \$1 `choice="CHOICE"` \$1 `choice array="CHOICE_ARRAY"` \$1 `date="DATE"` \$1 `date array="DATE_ARRAY"` \$1 `decimal="DECIMAL"` \$1 `decimal array="DECIMAL_ARRAY"` \$1 `double="DOUBLE"` \$1 `double array="DOUBLE_ARRAY"` \$1 `enum="ENUM"` \$1 `enum array="ENUM_ARRAY"` \$1 `float="FLOAT"` \$1 `float array="FLOAT_ARRAY"` \$1 `int="INT"` \$1 `int array="INT_ARRAY"` \$1 `interval="INTERVAL"` \$1 `interval array="INTERVAL_ARRAY"` \$1 `long="LONG"` \$1 `long array="LONG_ARRAY"` \$1 `object="OBJECT"` \$1 `short="SHORT"` \$1 `short array="SHORT_ARRAY"` \$1 `smallint="SMALLINT"` \$1 `smallint array="SMALLINT_ARRAY"` \$1 `string="STRING"` \$1 `string array="STRING_ARRAY"` \$1 `timestamp="TIMESTAMP"` \$1 `timestamp array="TIMESTAMP_ARRAY"` \$1 `tinyint="TINYINT"` \$1 `tinyint array="TINYINT_ARRAY"` \$1 `varchar="VARCHAR"` \$1 `varchar array="VARCHAR_ARRAY"` \$1 `null="NULL"` \$1 `unknown="UNKNOWN"` \$1 `unknown array="UNKNOWN_ARRAY"`).

  AWS Glue Studio에 정의되어 있는, 열의 데이터 유형입니다.

## DynamicTransform 구조
<a name="aws-glue-api-visual-job-api-DynamicTransform"></a>

동적 변환을 수행하는 데 필요한 파라미터 세트를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  동적 변환의 이름을 지정합니다.
+ `TransformName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue Studio 시각적 편집기에 표시되는 동적 변환의 이름을 지정합니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  필요한 동적 변환에 대한 입력을 지정합니다.
+ `Parameters` – [TransformConfigParameter](#aws-glue-api-visual-job-api-TransformConfigParameter) 객체의 배열입니다.

  동적 변환의 파라미터를 지정합니다.
+ `FunctionName` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  동적 변환의 함수 이름을 지정합니다.
+ `Path` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  동적 변환 소스 및 구성 파일의 경로를 지정합니다.
+ `Version` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  이 필드는 사용되지 않으며 향후 릴리스에서 사용 중단됩니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  동적 변환에 대한 데이터 스키마를 지정합니다.

## TransformConfigParameter 구조
<a name="aws-glue-api-visual-job-api-TransformConfigParameter"></a>

동적 변환 구성 파일의 파라미터를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  동적 변환 구성 파일의 파라미터 이름을 지정합니다.
+ `Type` – **필수: UTF-8 문자열입니다(유효한 값: `str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`).

  동적 변환 구성 파일의 파라미터 유형을 지정합니다.
+ `ValidationRule` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  동적 변환 구성 파일의 검증 규칙을 지정합니다.
+ `ValidationMessage` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  동적 변환 구성 파일의 검증 메시지를 지정합니다.
+ `Value` – UTF-8 문자열의 배열입니다.

  동적 변환 구성 파일의 파라미터 값을 지정합니다.
+ `ListType` – UTF-8 문자열입니다(유효한 값: `str="STR"` \$1 `int="INT"` \$1 `float="FLOAT"` \$1 `complex="COMPLEX"` \$1 `bool="BOOL"` \$1 `list="LIST"` \$1 `null="NULL"`).

  동적 변환 구성 파일의 파라미터 목록 유형을 지정합니다.
+ `IsOptional` – 부울입니다.

  파라미터가 동적 변환 구성 파일에서 선택 사항인지 여부를 지정합니다.

## EvaluateDataQuality 구조
<a name="aws-glue-api-visual-job-api-EvaluateDataQuality"></a>

데이터 품질 평가 기준을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 품질 평가의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  데이터 품질 평가의 입력입니다.
+ `Ruleset` – **필수: [Custom string pattern #59](aws-glue-api-common.md#regex_59)과(와) 일치하는 1\$165536바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 평가를 위한 규칙 세트입니다.
+ `Output` – UTF-8 문자열입니다(유효한 값: `PrimaryInput` \$1 `EvaluationResults`).

  데이터 품질 평가의 출력입니다.
+ `PublishingOptions` – [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions) 객체입니다.

  결과 게시 방법을 구성하는 옵션입니다.
+ `StopJobOnFailureOptions` – [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions) 객체입니다.

  데이터 품질 평가에 실패할 경우 작업을 중지하는 방법을 구성하는 옵션입니다.

## DQResultsPublishingOptions 구조
<a name="aws-glue-api-visual-job-api-DQResultsPublishingOptions"></a>

데이터 품질 평가 결과 게시 방법을 구성하는 옵션입니다.

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

  평가의 컨텍스트입니다.
+ `ResultsS3Prefix` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  결과 앞에 Amazon S3 접두사가 추가되었습니다.
+ `CloudWatchMetricsEnabled` – 부울입니다.

  데이터 품질 결과에 대한 지표를 활성화합니다.
+ `ResultsPublishingEnabled` – 부울입니다.

  데이터 품질 결과에 대한 게시를 활성화합니다.

## DQStopJobOnFailureOptions 구조
<a name="aws-glue-api-visual-job-api-DQStopJobOnFailureOptions"></a>

데이터 품질 평가에 실패할 경우 작업을 중지하는 방법을 구성하는 옵션입니다.

**Fields**
+ `StopJobOnFailureTiming` – UTF-8 문자열입니다(유효한 값: `Immediate` \$1 `AfterDataLoad`).

  데이터 품질 평가에 실패할 경우에 작업을 중지할 시점입니다. 옵션은 Immediate 또는 AfterDataLoad입니다.

## EvaluateDataQualityMultiFrame 구조
<a name="aws-glue-api-visual-job-api-EvaluateDataQualityMultiFrame"></a>

데이터 품질 평가 기준을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 품질 평가의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열이며 문자열은 1개 이상입니다.

  데이터 품질 평가의 입력입니다. 이 목록의 첫 번째 입력은 기본 데이터 소스입니다.
+ `AdditionalDataSources` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  기본을 제외한 모든 데이터 소스의 별칭입니다.
+ `Ruleset` – **필수: [Custom string pattern #59](aws-glue-api-common.md#regex_59)과(와) 일치하는 1\$165536바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 평가를 위한 규칙 세트입니다.
+ `PublishingOptions` – [DQResultsPublishingOptions](#aws-glue-api-visual-job-api-DQResultsPublishingOptions) 객체입니다.

  결과 게시 방법을 구성하는 옵션입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 UTF-8 문자열(유효 값: `performanceTuning.caching="CacheOption"` \$1 `observations.scope="ObservationsOption"` \$1 `compositeRuleEvaluation.method="CompositeOption"`)입니다.

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

  변환의 런타임 동작을 구성하는 옵션입니다.
+ `StopJobOnFailureOptions` – [DQStopJobOnFailureOptions](#aws-glue-api-visual-job-api-DQStopJobOnFailureOptions) 객체입니다.

  데이터 품질 평가에 실패할 경우 작업을 중지하는 방법을 구성하는 옵션입니다.

## 레시피 구조
<a name="aws-glue-api-visual-job-api-Recipe"></a>

AWS Glue 작업에서 AWS Glue DataBrew 레시피를 사용하는 AWS Glue 스튜디오 노드입니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  AWS Glue 스튜디오 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  레시피 노드에 대한 입력에 해당하는 노드로, ID로 식별됩니다.
+ `RecipeReference` – [RecipeReference](#aws-glue-api-visual-job-api-RecipeReference) 객체입니다.

  노드에서 사용하는 DataBrew 레시피에 대한 참조입니다.
+ `RecipeSteps` – [RecipeStep](#aws-glue-api-visual-job-api-RecipeStep) 객체의 배열입니다.

  레시피 노드에서 사용되는 변환 단계.

## RecipeReference 구조
<a name="aws-glue-api-visual-job-api-RecipeReference"></a>

레시피에 대한 AWS Glue DataBrew 참조입니다.

**Fields**
+ `RecipeArn` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  DataBrew 레시피의 ARN입니다.
+ `RecipeVersion` – *필수:* 1\$116바이트 길이의 UTF-8 문자열입니다.

  DataBrew 레시피의 RecipeVersion입니다.

## SnowflakeNodeData 구조
<a name="aws-glue-api-visual-job-api-SnowflakeNodeData"></a>

AWS Glue Studio에서 Snowflake 노드에 대한 구성을 지정합니다.

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

  검색된 데이터를 지정하는 방법을 지정합니다. 유효한 값: `"table"`, ` "query"`.
+ `Connection` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  Snowflake 엔드포인트에 대한 AWS Glue 데이터 카탈로그 연결을 지정합니다.
+ `Schema` – UTF-8 문자열입니다.

  노드에서 사용할 Snowflake 데이터베이스 스키마를 지정합니다.
+ `Table` – UTF-8 문자열입니다.

  노드에서 사용할 Snowflake 테이블을 지정합니다.
+ `Database` – UTF-8 문자열입니다.

  노드에서 사용할 Snowflake 데이터베이스를 지정합니다.
+ `TempDir` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  현재 사용 중이지 않습니다.
+ `IamRole` – [옵션](#aws-glue-api-visual-job-api-Option) 객체입니다.

  현재 사용 중이지 않습니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Snowflake 커넥터에 전달되는 추가 옵션을 지정합니다. 이 노드의 다른 위치에서 옵션이 지정된 경우 이 옵션이 우선합니다.
+ `SampleQuery` – UTF-8 문자열입니다.

  `query` 소스 유형의 데이터를 검색하는 데 사용되는 SQL 문자열입니다.
+ `PreAction` – UTF-8 문자열입니다.

  Snowflake 커넥터가 표준 작업을 수행하기 전에 실행되는 SQL 문자열입니다.
+ `PostAction` – UTF-8 문자열입니다.

  Snowflake 커넥터가 표준 작업을 수행한 후에 실행되는 SQL 문자열입니다.
+ `Action` – UTF-8 문자열입니다.

  기존 데이터가 있는 테이블에 쓸 때 수행할 작업을 지정합니다. 유효한 값: ` append`, `merge`, `truncate`, `drop`.
+ `Upsert` – 부울입니다.

  `append` 작업일 때 사용됩니다. 행이 이미 있는 경우 확인 동작을 지정합니다. true인 경우 기존 행이 업데이트됩니다. false인 경우 해당 행이 삽입됩니다.
+ `MergeAction` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  병합 작업을 지정합니다. 유효한 값: `simple`, `custom`. simple인 경우 병합 동작은 `MergeWhenMatched` 및 ` MergeWhenNotMatched`로 정의됩니다. custom인 경우 `MergeClause`로 정의됩니다.
+ `MergeWhenMatched` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  병합 시 기존 데이터와 일치하는 레코드를 확인하는 방법을 지정합니다. 유효한 값: ` update`, `delete`.
+ `MergeWhenNotMatched` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #60](aws-glue-api-common.md#regex_60)

  병합 시 기존 데이터와 일치하지 않는 레코드를 처리하는 방법을 지정합니다. 유효한 값: `insert`, `none`.
+ `MergeClause` – UTF-8 문자열입니다.

  사용자 지정 병합 동작을 지정하는 SQL 문입니다.
+ `StagingTable` – UTF-8 문자열입니다.

  `merge` 또는 업서트 `append` 작업을 수행할 때 사용되는 스테이징 테이블의 이름입니다. 데이터가 이 테이블에 기록된 후에는 생성된 사후 작업에 의해 `table`로 이동됩니다.
+ `SelectedColumns` – [옵션](#aws-glue-api-visual-job-api-Option) 객체의 배열입니다.

  병합 및 업서트에서 일치하는 항목을 감지할 때 레코드를 식별하기 위해 결합된 열을 지정합니다. `value`, `label` 및 ` description` 키가 있는 구조 목록입니다. 각 구조는 열을 설명합니다.
+ `AutoPushdown` – 부울입니다.

  자동 쿼리 푸시다운의 활성화 여부를 지정합니다. 푸시다운이 활성화된 경우 Spark에서 쿼리를 실행할 때 쿼리의 일부를 Snowflake 서버로 '푸시다운'할 수 있으면 해당 쿼리가 푸시다운됩니다. 이렇게 하면 일부 쿼리의 성능이 향상됩니다.
+ `TableSchema` – [옵션](#aws-glue-api-visual-job-api-Option) 객체의 배열입니다.

  노드의 대상 스키마를 수동으로 정의합니다. `value`, `label` 및 `description` 키가 있는 구조 목록입니다. 각 구조는 열을 정의합니다.

## SnowflakeSource 구조
<a name="aws-glue-api-visual-job-api-SnowflakeSource"></a>

Snowflake 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Snowflake 데이터 소스의 이름입니다.
+ `Data` – **필수(Required): [SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData) 객체입니다.

  Snowflake 데이터 소스의 구성입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  출력 데이터에 대한 사용자 정의 스키마를 지정합니다.

## SnowflakeTarget 구조
<a name="aws-glue-api-visual-job-api-SnowflakeTarget"></a>

Snowflake 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Snowflake 대상의 이름입니다.
+ `Data` – **필수(Required): [SnowflakeNodeData](#aws-glue-api-visual-job-api-SnowflakeNodeData) 객체입니다.

  Snowflake 대상 노드의 데이터를 지정합니다.
+ `Inputs` – UTF-8 문자열의 배열입니다(1개의 문자열).

  데이터 대상에 대한 입력인 노드입니다.

## ConnectorDataSource 구조
<a name="aws-glue-api-visual-job-api-ConnectorDataSource"></a>

표준 연결 옵션으로 생성된 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  이 소스 노드의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  `connectionType`은 기본 AWS Glue 라이브러리에 제공된 값입니다. 노드 유형은 다음과 같은 연결 유형을 지원합니다.
  + `opensearch`
  + `azuresql`
  + `azurecosmos`
  + `bigquery`
  + `saphana`
  + `teradata`
  + `vertica`
+ `Data` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

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

  노드에 대한 연결 옵션을 지정하는 맵입니다. AWS Glue 설명서의 연결 [매개변수 섹션](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html)에서 해당 연결 유형에 대한 표준 연결 옵션을 찾을 수 있습니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  이 소스에 대한 데이터 스키마를 지정합니다.

## ConnectorDataTarget 구조
<a name="aws-glue-api-visual-job-api-ConnectorDataTarget"></a>

표준 연결 옵션으로 생성된 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  이 대상 노드의 이름입니다.
+ `ConnectionType` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  `connectionType`은 기본 AWS Glue 라이브러리에 제공된 값입니다. 노드 유형은 다음과 같은 연결 유형을 지원합니다.
  + `opensearch`
  + `azuresql`
  + `azurecosmos`
  + `bigquery`
  + `saphana`
  + `teradata`
  + `vertica`
+ `Data` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

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

  노드에 대한 연결 옵션을 지정하는 맵입니다. AWS Glue 설명서의 연결 [매개변수 섹션](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-connect.html)에서 해당 연결 유형에 대한 표준 연결 옵션을 찾을 수 있습니다.
+ `Inputs` – UTF-8 문자열의 배열입니다(1개의 문자열).

  데이터 대상에 대한 입력인 노드입니다.

## RecipeStep 구조
<a name="aws-glue-api-visual-job-api-RecipeStep"></a>

AWS Glue Studio 데이터 준비 레시피 노드에서 사용되는 레시피 단계.

**Fields**
+ `Action` – *필수:* [RecipeAction](#aws-glue-api-visual-job-api-RecipeAction) 객체입니다.

  레시피 단계의 변환 작업.
+ `ConditionExpressions` – [ConditionExpression](#aws-glue-api-visual-job-api-ConditionExpression) 객체의 배열입니다.

  레시피 단계에 대한 조건 표현식.

## RecipeAction 구조
<a name="aws-glue-api-visual-job-api-RecipeAction"></a>

AWS Glue Studio 데이터 준비 레시피 노드에 정의된 작업.

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

  레시피 작업.
+ `Parameters` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #57](aws-glue-api-common.md#regex_57)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

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

  레시피 작업의 파라미터.

## ConditionExpression 구조
<a name="aws-glue-api-visual-job-api-ConditionExpression"></a>

AWS Glue Studio 데이터 준비 레시피 노드에 정의된 조건 표현식.

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

  조건 표현식의 조건.
+ `Value` – UTF-8 문자열(1,024바이트 이하).

  조건 표현식의 값.
+ `TargetColumn` – **필수: 1\$11,024바이트 길이의 UTF-8 문자열입니다.

  조건 표현식의 대상 열.

## S3CatalogIcebergSource 구조
<a name="aws-glue-api-visual-job-api-S3CatalogIcebergSource"></a>

AWS Glue Data Catalog에 등록된 Apache Iceberg 데이터 소스를 지정합니다. Iceberg 데이터 소스를 Amazon S3에 저장해야 합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalIcebergOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 데이터 소스의 추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Iceberg 소스에 대한 데이터 스키마를 지정합니다.

## CatalogIcebergSource 구조
<a name="aws-glue-api-visual-job-api-CatalogIcebergSource"></a>

AWS Glue Data Catalog에 등록된 Apache Iceberg 데이터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  데이터 소스의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스의 이름입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  읽을 데이터베이스 테이블의 이름입니다.
+ `AdditionalIcebergOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 데이터 소스의 추가 연결 옵션을 지정합니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  Iceberg 소스에 대한 데이터 스키마를 지정합니다.

## S3IcebergCatalogTarget 구조
<a name="aws-glue-api-visual-job-api-S3IcebergCatalogTarget"></a>

Amazon S3에 데이터를 쓰고 AWS Glue Data Catalog에 테이블을 등록하는 Apache Iceberg 카탈로그 대상을 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 카탈로그 대상의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  Iceberg 카탈로그 대상의 입력 연결입니다.
+ `PartitionKeys` – UTF-8 문자열의 배열입니다.

  Iceberg 테이블의 파티션 키 목록입니다.
+ `Table` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  카탈로그에 쓸 테이블의 이름입니다.
+ `Database` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  쓰기를 수행할 데이터베이스의 이름입니다.
+ `AdditionalOptions` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  Iceberg 카탈로그 대상의 추가 연결 옵션을 지정합니다.
+ `SchemaChangePolicy` – [CatalogSchemaChangePolicy](#aws-glue-api-visual-job-api-CatalogSchemaChangePolicy) 객체입니다.

  카탈로그 대상의 스키마 변경을 처리하기 위한 정책입니다.
+ `AutoDataQuality` – [AutoDataQuality](#aws-glue-api-visual-job-api-AutoDataQuality) 객체입니다.

  S3 Iceberg 카탈로그 대상에 대한 데이터 품질 평가를 자동으로 활성화할지 여부를 지정합니다. `true`로 설정하면 쓰기 작업 중에 데이터 품질 검사가 자동으로 수행됩니다.

## DynamoDBELTConnectorSource 구조
<a name="aws-glue-api-visual-job-api-DynamoDBELTConnectorSource"></a>

DynamoDB 테이블에서 데이터를 추출하기 위한 DynamoDB ELT 커넥터 소스를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  DynamoDB ELT 커넥터 소스의 이름입니다.
+ `ConnectionOptions` – [DDBELTConnectionOptions](#aws-glue-api-visual-job-api-DDBELTConnectionOptions) 객체입니다.

  DynamoDB ELT 커넥터 소스의 연결 옵션입니다.
+ `OutputSchemas` – [GlueSchema](#aws-glue-api-visual-job-api-GlueSchema) 객체의 배열입니다.

  DynamoDB ELT 커넥터 소스의 데이터 스키마를 지정합니다.

## DDBELTConnectionOptions 구조
<a name="aws-glue-api-visual-job-api-DDBELTConnectionOptions"></a>

DynamoDB ELT(추출, 로드, 변환) 작업의 연결 옵션을 지정합니다. 이 구조에는 ELT 커넥터를 사용하여 DynamoDB 테이블에 연결하고 테이블에서 데이터를 추출하기 위한 구성 파라미터가 포함됩니다.

**Fields**
+ `DynamodbExport` – UTF-8 문자열입니다(유효한 값: `ddb` \$1 `s3`).

  DynamoDB 데이터 추출을 위한 내보내기 유형을 지정합니다. 이 파라미터는 ELT 프로세스 실행 중에 DynamoDB 테이블에서 데이터를 내보내는 방법을 결정합니다.
+ `DynamodbUnnestDDBJson` – 부울입니다.

  데이터 추출 중에 DynamoDB JSON 형식의 중첩을 해제할지 여부를 지정하는 부울 값입니다. `true`로 설정하면 커넥터가 DynamoDB 항목에서 중첩된 JSON 구조를 평면화합니다. `false`로 설정하면 원래 DynamoDB JSON 구조가 보존됩니다.
+ `DynamodbTableArn` – *필수:* [Custom string pattern #61](aws-glue-api-common.md#regex_61)과(와) 일치하는 UTF-8 문자열입니다.

  데이터를 추출할 DynamoDB 테이블의 Amazon 리소스 이름(ARN)입니다. 이 파라미터는 ELT 작업의 소스 테이블을 지정합니다.
+ `DynamodbS3Bucket` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  DynamoDB ELT 프로세스 중에 중간 스토리지로 사용되는 Amazon S3 버킷의 이름입니다. 이 버킷은 ELT 작업에서 처리하기 전에 내보낸 DynamoDB 데이터를 임시로 저장하는 데 사용됩니다.
+ `DynamodbS3Prefix` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  DynamoDB ELT 프로세스 중에 중간 S3 버킷에 저장되는 파일의 S3 객체 키 접두사입니다. 이 접두사는 데이터 추출 중에 생성된 임시 파일을 구성하고 식별하는 데 유용합니다.
+ `DynamodbS3BucketOwner` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  AWS에 지정된 S3 버킷 소유자의 `DynamodbS3Bucket` 계정 ID입니다. 이 파라미터는 ELT 작업을 실행하는 계정 이외의 AWS 계정이 S3 버킷을 소유하여 중간 스토리지 버킷에 대한 교차 계정 액세스가 가능할 경우에 필요합니다.
+ `DynamodbStsRoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  ELT 작업 중에 DynamoDB 및 S3 리소스에 액세스하기 위해 부여받을 AWS Security Token Service(STS) 역할의 Amazon 리소스 이름(ARN)입니다. 이 역할에는 DynamoDB 테이블에서 데이터를 읽고 중간 S3 버킷에 쓰는 데 필요한 권한이 있어야 합니다.

## DDBELTCatalogAdditionalOptions 구조
<a name="aws-glue-api-visual-job-api-DDBELTCatalogAdditionalOptions"></a>

DynamoDB ELT 카탈로그 작업의 추가 옵션을 지정합니다.

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

  ELT 작업의 DynamoDB 내보내기 구성을 지정합니다.
+ `DynamodbUnnestDDBJson` – 부울입니다.

  DynamoDB JSON 형식의 중첩을 해제할지 여부를 지정합니다. `true`로 설정하면 DynamoDB 항목의 중첩된 JSON 구조가 평면화됩니다.

## Route 구조
<a name="aws-glue-api-visual-job-api-Route"></a>

정의된 필터링 조건에 따라 데이터를 다른 출력 경로로 보내는 라우팅 노드를 지정합니다.

**Fields**
+ `Name` – *필수:* [Custom string pattern #63](aws-glue-api-common.md#regex_63)과(와) 일치하는 UTF-8 문자열입니다.

  라우팅 노드의 이름입니다.
+ `Inputs` – *필수:* UTF-8 문자열의 배열(1개 이상)입니다.

  라우팅 노드의 입력 연결입니다.
+ `GroupFiltersList` – **필수(Required): [GroupFilters](#aws-glue-api-visual-job-api-GroupFilters) 객체의 배열입니다.

  데이터를 다른 출력 경로로 전달하기 위한 라우팅 조건 및 기준을 정의하는 그룹 필터 목록입니다.

## GroupFilters 구조
<a name="aws-glue-api-visual-job-api-GroupFilters"></a>

어떻게 필터를 결합하여 라우팅 조건을 평가할지 결정하는 논리 연산자를 사용하여 필터 그룹을 지정합니다.

**Fields**
+ `GroupName` – *필수:* [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  필터 그룹의 이름입니다.
+ `Filters` – **필수(Required): [FilterExpression](#aws-glue-api-visual-job-api-FilterExpression) 객체의 배열입니다.

  이 그룹의 조건을 정의하는 필터 표현식의 목록입니다.
+ `LogicalOperator` – *필수:* UTF-8 문자열입니다(유효한 값: `AND` \$1 `OR`).

  이 그룹의 필터를 결합하는 데 사용되는 논리 연산자입니다. 모든 필터가 일치해야 하는지(AND) 아니면 필터 중 하나만 일치하면 되는지(OR) 결정합니다.

## AutoDataQuality 구조
<a name="aws-glue-api-visual-job-api-AutoDataQuality"></a>

AWS Glue 작업의 자동 데이터 품질 평가를 위한 구성 옵션을 지정합니다. 이 구조를 통해 ETL 작업 중에 자동화된 데이터 품질 검사 및 모니터링을 수행할 수 있으므로, 수작업 없이 데이터 무결성과 신뢰성을 보장할 수 있습니다.

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

  자동 데이터 품질 평가를 활성화할지 여부를 지정합니다. `true`로 설정하면 데이터 품질 검사가 자동으로 수행됩니다.
+ `EvaluationContext` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #61](aws-glue-api-common.md#regex_61)

  자동 데이터 품질 검사를 위한 평가 컨텍스트입니다. 데이터 품질 평가의 범위와 파라미터를 정의합니다.

# 작업 API
<a name="aws-glue-api-jobs"></a>

작업 API는 작업 데이터 유형을 설명하며 AWS Glue에서 작업, 작업 실행, 트리거로 작업하기 위한 API를 포함합니다.

**Topics**
+ [작업](aws-glue-api-jobs-job.md)
+ [작업 실행](aws-glue-api-jobs-runs.md)
+ [트리거](aws-glue-api-jobs-trigger.md)

# 작업
<a name="aws-glue-api-jobs-job"></a>

작업 API는 AWS Glue에서의 작업 생성, 업데이트, 삭제 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-jobs-job-objects"></a>
+ [작업 구조](#aws-glue-api-jobs-job-Job)
+ [ExecutionProperty 구조](#aws-glue-api-jobs-job-ExecutionProperty)
+ [NotificationProperty 구조](#aws-glue-api-jobs-job-NotificationProperty)
+ [JobCommand 구조](#aws-glue-api-jobs-job-JobCommand)
+ [ConnectionsList 구조](#aws-glue-api-jobs-job-ConnectionsList)
+ [JobUpdate 구조](#aws-glue-api-jobs-job-JobUpdate)
+ [SourceControlDetails 구조](#aws-glue-api-jobs-job-SourceControlDetails)

## 작업 구조
<a name="aws-glue-api-jobs-job-Job"></a>

작업 정의를 지정합니다.

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

  이 작업 정의에 할당하는 이름입니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  작업 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `CreatedOn` – 타임스탬프입니다.

  작업 정의가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  이 작업 정의가 수정된 마지막 시점입니다.
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다.
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  JobRun이 실패한 후 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업 실행에 따라 할당된 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다.

  AWS Glue는 다양한 워크로드 요구 사항을 수용할 수 있도록 여러 개의 작업자 유형을 제공합니다.

  G 작업자 유형(범용 컴퓨팅 작업자):
  + G.025X: DPU 0.25개(vCPU 2개, 메모리 4GB, 디스크 84GB)
  + G.1X: DPU 1개(vCPU 4개, 메모리 16GB, 디스크 94GB)
  + G.2X: DPU 2개(vCPU 8개, 메모리 32GB, 디스크 138GB)
  + G.4X: DPU 4개(vCPU 16개, 메모리 64GB, 디스크 256GB)
  + G.8X: DPU 8개(vCPU 32개, 메모리 128GB, 디스크 512GB)
  + G.12X: DPU 12개(vCPU 48개, 메모리 192GB, 디스크 768GB)
  + G.16X: DPU 16개(vCPU 64개, 메모리 256GB, 디스크 1,024GB)

  R 작업자 유형(메모리 최적화 작업자):
  + R.1X: DPU 1개(vCPU 4개, 메모리 32GB, 디스크 94GB)
  + R.2X: DPU 2개(vCPU 8개, 메모리 64GB, 디스크 128GB)
  + R.4X: DPU 4개(vCPU 16개, 메모리 128GB, 디스크 256GB)
  + R.8X: DPU 8개(vCPU 32개, 메모리 256GB, 디스크 512GB)
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `Running` – 부울입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

## ExecutionProperty 구조
<a name="aws-glue-api-jobs-job-ExecutionProperty"></a>

작업의 실행 속성입니다.

**필드**
+ `MaxConcurrentRuns` - 숫자(정수)입니다.

  작업에 허용된 최대 동시 실행 수입니다. 기본 값은 1입니다. 이 임곗값에 도달하면 오류가 반환됩니다. 지정할 수 있는 최대값은 서비스 제한에 따라 통제됩니다.

## NotificationProperty 구조
<a name="aws-glue-api-jobs-job-NotificationProperty"></a>

알림의 구성 속성을 지정합니다.

**필드**
+ `NotifyDelayAfter` – 1 이상의 숫자(정수)입니다.

  작업 실행 시작 후 작업 실행 대기 알림을 전송하기 전까지 대기하는 시간(분)입니다.

## JobCommand 구조
<a name="aws-glue-api-jobs-job-JobCommand"></a>

작업이 실행될 때 실행되는 코드를 지정합니다.

**필드**
+ `Name` – UTF-8 문자열입니다.

  작업 명령의 이름입니다. Apache Spark ETL 작업의 경우, `glueetl`이어야 합니다. Python 셸 작업의 경우, `pythonshell`이어야 합니다. Apache Spark 스트리밍 ETL 작업의 경우, `gluestreaming`이어야 합니다. Ray 작업의 경우 `glueray`이어야 합니다.
+ `ScriptLocation` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  작업을 실행하는 스크립트의 Amazon Simple Storage Service(Amazon S3) 경로를 지정합니다.
+ `PythonVersion` – [Custom string pattern #49](aws-glue-api-common.md#regex_49)과(와) 일치하는 UTF-8 문자열입니다.

  Python 셸 작업을 실행하는 데 사용되는 Python 버전입니다. 허용되는 값은 2 또는 3입니다.
+ `Runtime` – [Custom string pattern #33](aws-glue-api-common.md#regex_33)과 일치하는 64바이트 이하 길이의 UTF-8 문자열입니다.

  Ray 작업에서 런타임은 사용자 환경에서 사용 가능한 Ray, Python 및 추가 라이브러리의 버전을 지정하는 데 사용됩니다. 이 필드는 다른 작업 유형에서 사용되지 않습니다. 지원되는 런타임 환경 값은 AWS Glue 개발자 안내서에서 [지원되는 Ray 런타임 환경](https://docs.aws.amazon.com/glue/latest/dg/ray-jobs-section.html)을 참조하세요.

## ConnectionsList 구조
<a name="aws-glue-api-jobs-job-ConnectionsList"></a>

작업이 사용한 연결을 지정합니다.

**필드**
+ `Connections` – 1,000개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  작업이 사용한 연결 목록입니다.

## JobUpdate 구조
<a name="aws-glue-api-jobs-job-JobUpdate"></a>

기존 작업 정의 업데이트에 사용된 정보를 지정합니다. 이전 작업 정의를 이 정보로 완전히 덮어씁니다.

**필드**
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  정의된 작업에 대한 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다(필수).
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다(필수).
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  실패한 경우 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다. 자세한 내용은 [Spark 작업을 위한 작업 속성 정의](https://docs.aws.amazon.com/glue/latest/dg/add-job.html#create-job)를 참조하세요.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

## SourceControlDetails 구조
<a name="aws-glue-api-jobs-job-SourceControlDetails"></a>

작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.

**필드**
+ `Provider` – UTF-8 문자열입니다(유효 값: `GITHUB` \$1 `AWS_CODE_COMMIT`).

  원격 리포지토리의 공급자입니다.
+ `Repository` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  작업 아티팩트가 포함된 원격 리포지토리의 이름입니다.
+ `Owner` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  작업 아티팩트가 포함된 원격 리포지토리의 소유자입니다.
+ `Branch` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 선택적 브랜치입니다.
+ `Folder` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 선택적 폴더입니다.
+ `LastCommitId` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  원격 리포지토리의 커밋에 대한 마지막 커밋 ID입니다.
+ `LastSyncTimestamp` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  마지막 작업 동기화가 수행된 날짜와 시간입니다.
+ `AuthStrategy` – UTF-8 문자열입니다(유효 값: `PERSONAL_ACCESS_TOKEN` \$1 `AWS_SECRETS_MANAGER`).

  인증 유형으로, AWS Secrets Manager에 저장된 인증 토큰이거나 개인 액세스 토큰일 수 있습니다.
+ `AuthToken` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  인증 토큰의 값입니다.

## 운영
<a name="aws-glue-api-jobs-job-actions"></a>
+ [CreateJob 작업(Python: create\$1job)](#aws-glue-api-jobs-job-CreateJob)
+ [UpdateJob 작업(Python: update\$1job)](#aws-glue-api-jobs-job-UpdateJob)
+ [GetJob 작업(Python: get\$1job)](#aws-glue-api-jobs-job-GetJob)
+ [GetJobs 작업(Python: get\$1jobs)](#aws-glue-api-jobs-job-GetJobs)
+ [DeleteJob 작업(Python: delete\$1job)](#aws-glue-api-jobs-job-DeleteJob)
+ [ListJobs 작업(Python: list\$1jobs)](#aws-glue-api-jobs-job-ListJobs)
+ [BatchGetJobs 작업(Python: batch\$1get\$1jobs)](#aws-glue-api-jobs-job-BatchGetJobs)

## CreateJob 작업(Python: create\$1job)
<a name="aws-glue-api-jobs-job-CreateJob"></a>

새로운 작업 정의를 만듭니다.

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

  이 작업 정의에 할당하는 이름입니다. 계정에서 고유해야 합니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  이 작업에 대한 작업 실행을 위해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.

  이 필드가 작업 실행에 설정된 값과 일치하지 않으면 작업 실행 필드의 값이 사용됩니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  정의된 작업에 대한 설명입니다.
+ `LogUri` – UTF-8 문자열입니다.

  이 필드는 향후 사용하기 위해 예약되어 있습니다.
+ `Role` – *필수(Required):* UTF-8 문자열입니다.

  이 작업과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `ExecutionProperty` – [ExecutionProperty](#aws-glue-api-jobs-job-ExecutionProperty) 객체입니다.

  `ExecutionProperty`는 이 작업에 허용된 최대 동시 실행 수를 지정합니다.
+ `Command` – *필수(Required):* [JobCommand](#aws-glue-api-jobs-job-JobCommand) 객체입니다.

  이 작업을 실행하는 `JobCommand`입니다.
+ `DefaultArguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 작업의 모든 실행에서 기본 인수(이름 값 페어로 지정됨)입니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `NonOverridableArguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업 실행 시 작업 인수를 제공할 때 재정의되지 않는 이 작업의 인수(이름 값 페어로 지정됨)입니다.
+ `Connections` – [ConnectionsList](aws-glue-api-interactive-sessions.md#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  이 작업에 사용된 연결입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  실패한 경우 이 작업을 다시 시도할 수 있는 최대 횟수입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 파라미터는 이제 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 작업에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  작업 타임아웃(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 작업에서 사용할 태그입니다. 태그를 사용하여 작업에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 다음 AWS 리전에서 실행되는 Spark ETL 작업의 AWS Glue 버전 3.0 이상에서만 사용할 수 있습니다: 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(캘리포니아 북부), 미국 서부(오리건), 아시아 태평양(뭄바이), 아시아 태평양(서울), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(런던), 유럽(스페인), 유럽(스톡홀름) 
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `CodeGenConfigurationNodes` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #60](aws-glue-api-common.md#regex_60)과(와) 일치하는 UTF-8 문자열입니다.

  각 값은 [CodeGenConfigurationNode](aws-glue-api-visual-job-api.md#aws-glue-api-visual-job-api-CodeGenConfigurationNode) 객체입니다.

  Glue Studio 시각적 구성 요소 및 Glue Studio 코드 생성의 기반이 되는 방향성 비순환 그래프의 표현입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `SourceControlDetails` – [SourceControlDetails](#aws-glue-api-jobs-job-SourceControlDetails) 객체입니다.

  작업에 대한 소스 제어 구성에 대한 세부 정보로, 원격 리포지토리와의 작업 아티팩트 동기화를 허용합니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

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

  이 작업 정의를 위해 제공된 고유 이름입니다.

**오류**
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## UpdateJob 작업(Python: update\$1job)
<a name="aws-glue-api-jobs-job-UpdateJob"></a>

기존 작업 정의를 업데이트합니다. 이전 작업 정의를 이 정보로 완전히 덮어씁니다.

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

  업데이트할 작업 정의 이름입니다.
+ `JobUpdate` – *필수(Required):* [JobUpdate](#aws-glue-api-jobs-job-JobUpdate) 객체입니다.

  작업 정의를 업데이트하여 값을 지정합니다. 지정되지 않은 구성은 제거되거나 기본값으로 재설정됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업과 연결된 AWS Glue 사용 프로필의 이름입니다.

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

  업데이트된 작업 정의 이름을 반환합니다.

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

## GetJob 작업(Python: get\$1job)
<a name="aws-glue-api-jobs-job-GetJob"></a>

기존 작업 정의를 가져옵니다.

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

  가져올 작업 정의 이름입니다.

**응답**
+ `Job` – [작업](#aws-glue-api-jobs-job-Job) 객체입니다.

  요청한 작업 정의.

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

## GetJobs 작업(Python: get\$1jobs)
<a name="aws-glue-api-jobs-job-GetJobs"></a>

현재 모든 작업 정의를 가져옵니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

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

  응답의 최대 크기입니다.

**응답**
+ `Jobs` – [작업](#aws-glue-api-jobs-job-Job) 객체의 배열입니다.

  작업 정의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  모든 작업 정의가 반환하지 않은 경우의 지속 토큰입니다.

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

## DeleteJob 작업(Python: delete\$1job)
<a name="aws-glue-api-jobs-job-DeleteJob"></a>

지정한 작업 정의를 삭제합니다. 작업 정의를 못 찾으면 어떤 예외도 없습니다.

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

  삭제할 작업 정의 이름입니다.

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

  삭제된 작업 정의 이름입니다.

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

## ListJobs 작업(Python: list\$1jobs)
<a name="aws-glue-api-jobs-job-ListJobs"></a>

이 AWS 계정의 모든 작업 리소스 또는 지정된 태그를 가진 리소스를 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 `Tags` 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

**응답**
+ `JobNames` – UTF-8 문자열의 배열입니다.

  계정의 모든 작업 또는 지정된 태그를 가진 작업의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

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

## BatchGetJobs 작업(Python: batch\$1get\$1jobs)
<a name="aws-glue-api-jobs-job-BatchGetJobs"></a>

주어진 작업 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. `ListJobs` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

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

  작업 이름(`ListJobs` 작업에서 반환된 이름일 수 있음)의 목록입니다.

**응답**
+ `Jobs` – [작업](#aws-glue-api-jobs-job-Job) 객체의 배열입니다.

  작업 정의 목록입니다.
+ `JobsNotFound` – UTF-8 문자열의 배열입니다.

  찾을 수 없는 작업의 이름 목록입니다.

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

# 작업 실행
<a name="aws-glue-api-jobs-runs"></a>

 작업 실행 API는 AWS Glue에서의 작업 실행 시작, 중지 또는 확인과 작업 북마크 재설정과 관련된 API 및 데이터 유형에 대해 설명합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다.

## 데이터 타입
<a name="aws-glue-api-jobs-runs-objects"></a>
+ [JobRun 구조](#aws-glue-api-jobs-runs-JobRun)
+ [이전 구조](#aws-glue-api-jobs-runs-Predecessor)
+ [JobBookmarkEntry 구조](#aws-glue-api-jobs-runs-JobBookmarkEntry)
+ [BatchStopJobRunSuccessfulSubmission 구조](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission)
+ [BatchStopJobRunError 구조](#aws-glue-api-jobs-runs-BatchStopJobRunError)
+ [NotificationProperty 구조](#aws-glue-api-jobs-runs-NotificationProperty)

## JobRun 구조
<a name="aws-glue-api-jobs-runs-JobRun"></a>

작업 실행에 관한 정보를 포함합니다.

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

  이 작업 실행의 ID.
+ `Attempt` - 숫자(정수)입니다.

  이 작업을 실행하고자 시도했던 수입니다.
+ `PreviousRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업의 이전 실행 ID입니다. 예를 들어 `StartJobRun` 작업에 지정된 `JobRunId`입니다.
+ `TriggerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업을 시작한 트리거의 이름입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용된 작업 정의 이름입니다.
+ `JobMode` – UTF-8 문자열입니다(유효한 값: `SCRIPT=""` \$1 `VISUAL=""` \$1 `NOTEBOOK=""`).

  작업이 생성된 방법을 설명하는 모드입니다. 유효값은 다음과 같습니다.
  + `SCRIPT` - AWS Glue Studio 스크립트 편집기를 사용하여 작업을 생성했습니다.
  + `VISUAL` - AWS Glue Studio 시각적 편집기를 사용하여 작업을 생성했습니다.
  + `NOTEBOOK` - 대화형 세션 노트북을 사용하여 작업을 생성했습니다.

  `JobMode` 필드가 없거나 null인 경우 기본값으로 `SCRIPT`가 할당됩니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  해당 작업 실행에 대해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 작업이 시작된 날짜 및 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  이 작업 실행이 수정된 마지막 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 작업 실행이 완료된 날짜 및 시간입니다.
+ `JobRunState` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  작업 실행의 현재 상태입니다. 비정상적으로 종료된 작업의 상태에 대한 자세한 내용은 [AWS Glue 작업 실행 상태](https://docs.aws.amazon.com/glue/latest/dg/job-run-statuses.html)를 참조하세요.
+ `Arguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업과 연결되어 있는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `ErrorMessage` – UTF-8 문자열입니다.

  이 작업의 실행과 연결된 오류 메시지입니다.
+ `PredecessorRuns` – [이전 기록](#aws-glue-api-jobs-runs-Predecessor) 객체의 배열입니다.

  이 작업을 실행하기 이전의 기록입니다.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 JobRun에 할당된 AWS Glue 데이터 처리 장치(DPU) 수입니다. 2\$1100DPU가 할당될 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 작업이 리소스를 소비한 시간(초).
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 이 값은 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.025X=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `G.12X=""` \$1 `G.16X=""` \$1 `R.1X=""` \$1 `R.2X=""` \$1 `R.4X=""` \$1 `R.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.025X, G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X 또는 R.8X 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(스톡홀름)과 같은AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `LogGroupName` – UTF-8 문자열입니다.

  AWS KMS를 사용하여 Amazon CloudWatch에서 서버 측 암호화가 가능한 보안 로깅용 로그 그룹의 이름입니다. 이 이름은 `/aws-glue/jobs/`일 수 있으며, 그 기본 암호화는 `NONE`입니다. 역할 이름과 `SecurityConfiguration` 이름(즉, `/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/`)을 추가하면 로그 그룹 암호화에 이 보안 구성이 사용됩니다.
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `GlueVersion` – [Custom string pattern #48](aws-glue-api-common.md#regex_48)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  Spark 작업에서 `GlueVersion`에 따라 AWS Glue에서 작업에 사용할 수 있는 Apache Spark 및 Python 버전이 결정됩니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

  Ray 작업에서는 `GlueVersion`을 `4.0` 이상으로 설정해야 합니다. 그러나 Ray 작업에서 사용할 수 있는 Ray, Python 및 추가 라이브러리의 버전은 Job 명령의 `Runtime` 파라미터에 의해 결정됩니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 작업은 Glue 0.9로 기본 지정됩니다.
+ `DPUSeconds` - 숫자(double)입니다.

  이 필드는 실행 클래스가 `FLEX`인 작업 실행이거나 Auto Scaling이 활성화된 경우에 설정할 수 있으며, 작업 실행 수명 주기 동안 각 실행기가 실행된 총 시간(초)에 DPU 계수(작업자는 1(`G.1X`), 2(`G.2X`) 또는 0.25(`G.025X`))를 곱한 값을 나타냅니다. 이 값은 Auto Scaling 작업의 경우처럼 `executionEngineRuntime` \$1 `MaxCapacity`와 다를 수 있습니다. 지정된 시간에 실행 중인 실행기 수가 `MaxCapacity`보다 작을 수 있기 때문입니다. 따라서, `DPUSeconds` 값이 `executionEngineRuntime` \$1 `MaxCapacity`보다 작을 수 있습니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `MaintenanceWindow` – [Custom string pattern #34](aws-glue-api-common.md#regex_34)과(와) 일치하는 UTF-8 문자열입니다.

  이 필드는 스트리밍 작업에 대한 유지 관리 기간의 요일과 시간을 지정합니다. AWS Glue에서는 정기적으로 유지 관리 작업을 수행합니다. 이러한 유지 관리 기간 동안에는 AWS Glue에서 스트리밍 작업을 다시 시작해야 합니다.

  AWS Glue에서는 지정된 유지 관리 기간으로부터 3시간 이내에 작업을 다시 시작합니다. 예를 들어, 유지 관리 기간을 GMT 기준 월요일 오전 10시로 설정하면 작업이 GMT 기준 오전 10시에서 오후 1시 사이에 다시 시작됩니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행과 연결된 AWS Glue 사용 프로필의 이름입니다.
+ `StateDetail` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  이 필드에는 작업 실행 상태와 관련된 세부 정보가 들어 있습니다. 이 필드는 null을 사용할 수 없습니다.

  예를 들어 작업 실행 큐의 결과로 작업 실행이 대기 상태인 경우 필드에는 작업 실행이 해당 상태인 이유가 표시됩니다.
+ `ExecutionRoleSessionPolicy` – UTF-8 문자열입니다(2\$12,048바이트).

  StartJobRun API에 대한 이 인라인 세션 정책을 사용하면 추가 IAM 역할을 생성할 필요 없이 작업 범위에 대해 지정된 실행 역할의 권한을 동적으로 제한할 수 있습니다.

## 이전 구조
<a name="aws-glue-api-jobs-runs-Predecessor"></a>

이 작업을 실행할 수 있도록 조건적 트리거를 조건으로 한 작업입니다.

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

  이 이전 작업에 사용된 작업 정의 이름입니다.
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업의 이전 작업 실행 ID입니다.

## JobBookmarkEntry 구조
<a name="aws-glue-api-jobs-runs-JobBookmarkEntry"></a>

작업이 프로세싱을 다시 시작할 수 있는 포인트를 정의합니다.

**필드**
+ `JobName` – UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `Version` - 숫자(정수)입니다.

  작업의 버전입니다.
+ `Run` - 숫자(정수)입니다.

  실행 ID 숫자입니다.
+ `Attempt` - 숫자(정수)입니다.

  시도 ID 숫자입니다.
+ `PreviousRunId` – UTF-8 문자열입니다.

  이전의 작업 실행과 연결된 고유의 실행 식별자입니다.
+ `RunId` – UTF-8 문자열입니다.

  실행 ID 숫자입니다.
+ `JobBookmark` – UTF-8 문자열입니다.

  그 자체를 즐겨찾습니다.

## BatchStopJobRunSuccessfulSubmission 구조
<a name="aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission"></a>

지정된 `JobRun`을 중지한 성공적인 요청을 기록합니다.

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

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

  중지된 작업 실행의 `JobRunId`입니다.

## BatchStopJobRunError 구조
<a name="aws-glue-api-jobs-runs-BatchStopJobRunError"></a>

지정된 작업을 중지하고자 할 때 발생하는 오류를 기록합니다.

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

  문제의 작업 실행에 사용된 작업 정의 이름입니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  문제의 작업 실행 `JobRunId`입니다.
+ `ErrorDetail` – [ErrorDetail](aws-glue-api-common.md#aws-glue-api-common-ErrorDetail) 객체입니다.

  발생한 오류에 대한 추가 세부 정보를 지정합니다.

## NotificationProperty 구조
<a name="aws-glue-api-jobs-runs-NotificationProperty"></a>

알림의 구성 속성을 지정합니다.

**필드**
+ `NotifyDelayAfter` – 1 이상의 숫자(정수)입니다.

  작업 실행 시작 후 작업 실행 대기 알림을 전송하기 전까지 대기하는 시간(분)입니다.

## 운영
<a name="aws-glue-api-jobs-runs-actions"></a>
+ [StartJobRun 작업(Python: start\$1job\$1run)](#aws-glue-api-jobs-runs-StartJobRun)
+ [BatchStopJobRun 작업(Python: batch\$1stop\$1job\$1run)](#aws-glue-api-jobs-runs-BatchStopJobRun)
+ [GetJobRun 작업(Python: get\$1job\$1run)](#aws-glue-api-jobs-runs-GetJobRun)
+ [GetJobRuns 작업(Python: get\$1job\$1runs)](#aws-glue-api-jobs-runs-GetJobRuns)
+ [GetJobBookmark 작업(Python: get\$1job\$1bookmark)](#aws-glue-api-jobs-runs-GetJobBookmark)
+ [GetJobBookmarks 작업(Python: get\$1job\$1bookmarks)](#aws-glue-api-jobs-runs-GetJobBookmarks)
+ [ResetJobBookmark 작업(Python: reset\$1job\$1bookmark)](#aws-glue-api-jobs-runs-ResetJobBookmark)

## StartJobRun 작업(Python: start\$1job\$1run)
<a name="aws-glue-api-jobs-runs-StartJobRun"></a>

작업 정의를 사용한 작업 시작하기

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

  사용할 작업 정의의 이름입니다.
+ `JobRunQueuingEnabled` – 부울입니다.

  해당 작업 실행에 대해 작업 실행 대기열을 활성화할지 여부를 지정합니다.

  값이 true이면 해당 작업 실행에 대해 작업 실행 큐가 활성화됩니다. false이거나 채워지지 않은 경우 작업 실행은 대기열에 포함되는 것으로 간주되지 않습니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  재시도할 이전 `JobRun`의 ID입니다.
+ `Arguments` – 키-값 페어의 맵 배열입니다.

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

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

  작업과 연결되어 있는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  Spark 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [AWS Glue에서 사용하는 특별 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html) 주제를 참조하세요.

  Ray 작업을 구성할 때 이 필드에 제공할 수 있는 인수에 대한 자세한 내용은 개발자 안내서의 [Ray 작업에서 작업 파라미터 사용](https://docs.aws.amazon.com/glue/latest/dg/author-job-ray-job-parameters.html)을 참조하세요.
+ `AllocatedCapacity` - 숫자(정수)입니다.

  이 필드는 더 이상 사용되지 않습니다. 대신 `MaxCapacity`을 사용하세요.

  이 JobRun에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다. 최소 2DPU를 할당할 수 있습니다. 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 이 값은 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `MaxCapacity` - 숫자(double)입니다.

  Glue 버전 1.0 이전 적업의 경우 표준 작업자 유형을 사용하여 이 작업을 실행할 때 할당할 수 있는 AWS Glue 데이터 처리 장치(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  Glue 버전 2.0 이상 작업의 경우 `Maximum capacity`를 지정할 수 없습니다. 그 대신 `Worker type` 및 `Number of workers`를 지정해야 합니다.

  `WorkerType` 및 `NumberOfWorkers`를 사용하는 경우, `MaxCapacity`를 설정하지 마세요.

  `MaxCapacity`에 할당할 수 있는 값은 Python 셸 작업을 실행하는지 또는 Apache Spark ETL 작업 또는 Apache Spark 스트리밍 ETL 작업을 실행하는지에 따라 다릅니다.
  + Python 셸 작업(`JobCommand.Name`="pythonshell")을 지정하면 0.0625 또는 1 DPU를 할당할 수 있습니다. 기본값은 0.0625 DPU입니다.
  + Apache Spark ETL 작업(`JobCommand.Name`="glueetl") 또는 Apache Spark 스트리밍 ETL 작업 (`JobCommand.Name`="gluestreaming") 을 지정하면 2에서 100 DPU를 할당할 수 있습니다. 기본값은 10 DPU입니다. 이 작업 유형에는 부분적인 DPU 할당을 사용할 수 없습니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업 실행에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.1X, G.2X, G.4X, G.8X 또는 G.025X의 값을 허용합니다. Ray 작업에 대해 Z.2X 값을 허용합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(스톡홀름)과 같은AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.12X` 작업자 유형의 경우, 각 작업자가 768GB의 디스크가 있는 12DPU(48개의 vCPU, 192GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.16X` 작업자 유형의 경우, 각 작업자가 1024GB의 디스크가 있는 16DPU(64개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드가 매우 큰 작업에는 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `G.025X` 작업자 유형의 경우, 각 작업자가 84GB의 디스크가 있는 0.25DPU(2개의 vCPU, 4GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 볼륨이 낮은 스트리밍 작업에 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 3.0 이상 스트리밍 작업에만 사용할 수 있습니다.
  + `R.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.2X` 작업자 유형의 경우, 각 작업자가 128GB의 디스크가 있는 2DPU(8개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `R.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 256GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 워크로드의 경우 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 AWS Glue 버전 4.0 이상 Spark ETL 작업에만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `ExecutionClass` - 16바이트 미만의 UTF-8 문자열입니다(유효한 값: `FLEX=""` \$1 `STANDARD=""`).

  작업이 표준 또는 유연한 실행 클래스로 실행되는지 여부를 나타냅니다. 표준 실행 클래스는 빠른 작업 시작 및 전용 리소스가 필요한 시간에 민감한 워크로드에 적합합니다.

  유연한 실행 클래스는 시작 및 완료 시간이 다를 수 있는 시간에 민감하지 않은 작업에 적합합니다.

  AWS Glue 버전 3.0 이상 및 명령 유형 `glueetl`을 사용하는 작업만 `ExecutionClass`가 `FLEX`로 설정됩니다. 유연한 실행 클래스는 Spark 작업에 사용할 수 있습니다.
+ `ProfileName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행과 연결된 AWS Glue 사용 프로필의 이름입니다.
+ `ExecutionRoleSessionPolicy` – UTF-8 문자열입니다(2\$12,048바이트).

  StartJobRun API에 대한 이 인라인 세션 정책을 사용하면 추가 IAM 역할을 생성할 필요 없이 작업 범위에 대해 지정된 실행 역할의 권한을 동적으로 제한할 수 있습니다.

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

  이 작업 실행에 할당된 ID.

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

## BatchStopJobRun 작업(Python: batch\$1stop\$1job\$1run)
<a name="aws-glue-api-jobs-runs-BatchStopJobRun"></a>

지정된 작업을 정의하기 위해서 하나 이상의 작업을 중지합니다.

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

  작업이 실행되지 않고 중지하기 위한 작업 정의 이름입니다.
+ `JobRunIds` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다.

  이 작업을 정의하기 위해서 중지되어야 하는 `JobRunIds`의 목록입니다.

**응답**
+ `SuccessfulSubmissions` – [BatchStopJobRunSuccessfulSubmission](#aws-glue-api-jobs-runs-BatchStopJobRunSuccessfulSubmission) 객체의 배열입니다.

  중지할 목적으로 성공적으로 제출된 JobRun입니다.
+ `Errors` – [BatchStopJobRunError](#aws-glue-api-jobs-runs-BatchStopJobRunError) 객체의 배열입니다.

  `JobRuns`를 중지할 때 발생하는 오류 목록은 오류에 대한 상세 정보와 함께 각 오류가 발생한 `JobRunId`를 포함합니다.

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

## GetJobRun 작업(Python: get\$1job\$1run)
<a name="aws-glue-api-jobs-runs-GetJobRun"></a>

작업 실행 시 메타데이터 가져오기 워크플로 및 작업 실행의 경우 작업 실행 기록을 365일 동안 액세스할 수 있습니다.

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

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

  이 작업 실행의 ID.
+ `PredecessorsIncluded` – 부울입니다.

  이전 작업 실행 목록이 반환되어야 하면 True입니다.

**응답**
+ `JobRun` – [JobRun](#aws-glue-api-jobs-runs-JobRun) 객체입니다.

  요청한 작업 실행 메타데이터.

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

## GetJobRuns 작업(Python: get\$1job\$1runs)
<a name="aws-glue-api-jobs-runs-GetJobRuns"></a>

주어진 작업 정의의 모든 실행 시 메타데이터 가져오기

`GetJobRuns`는 작업 실행을 시간순으로 반환합니다. 이때 최신 작업을 먼저 반환합니다.

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

  모든 작업을 실행하기 위한 작업 정의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  응답의 최대 크기입니다.

**응답**
+ `JobRuns` – [JobRun](#aws-glue-api-jobs-runs-JobRun) 객체의 배열입니다.

  작업 실행 메타데이터 객체의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  요청된 모든 작업 실행이 반환하지 않은 경우의 지속 토큰입니다.

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

## GetJobBookmark 작업(Python: get\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-GetJobBookmark"></a>

작업 북마크 항목에 대한 정보를 반환합니다.

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `Version` - 숫자(정수)입니다.

  작업의 버전입니다.
+ `RunId` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체입니다.

  작업이 처리를 다시 시작할 수 있는 포인트를 정의하는 구조입니다.

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

## GetJobBookmarks 작업(Python: get\$1job\$1bookmarks)
<a name="aws-glue-api-jobs-runs-GetJobBookmarks"></a>

작업 북마크 항목에 대한 정보를 반환합니다. 목록은 버전 번호가 감소되는 순서로 정렬됩니다.

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `MaxResults` - 숫자(정수)입니다.

  응답의 최대 크기입니다.
+ `NextToken` - 숫자(정수)입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `JobBookmarkEntries` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체의 배열입니다.

  작업이 처리를 다시 시작할 수 있는 포인트를 정의하는 작업 북마크 항목의 목록입니다.
+ `NextToken` - 숫자(정수)입니다.

  모든 항목이 반환된 경우에는 1, 요청된 작업 실행 중 일부가 반환되지 않은 경우 1보다 큰 값이 있는 연속 토큰입니다.

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

## ResetJobBookmark 작업(Python: reset\$1job\$1bookmark)
<a name="aws-glue-api-jobs-runs-ResetJobBookmark"></a>

북마크 입력 재설정

작업 북마크에 대한 자세한 내용을 알아보려면 다음을 참조하세요.
+ [처리된 데이터를 작업 북마크로 추적](https://docs.aws.amazon.com/glue/latest/dg/monitor-continuations.html)
+ [AWS Glue에서 사용하는 작업 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)
+ [작업 구조](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html#aws-glue-api-jobs-job-Job)

**요청**
+ `JobName` – *필수(Required):* UTF-8 문자열입니다.

  문제의 작업 이름입니다.
+ `RunId` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 고유의 실행 식별자입니다.

**응답**
+ `JobBookmarkEntry` – [JobBookmarkEntry](#aws-glue-api-jobs-runs-JobBookmarkEntry) 객체입니다.

  북마크 입력 재설정

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

# 트리거
<a name="aws-glue-api-jobs-trigger"></a>

트리거 API는 AWS Glue에서의 작업 트리거 생성, 업데이트 또는 삭제 및 시작/중지와 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-jobs-trigger-objects"></a>
+ [트리거 구조](#aws-glue-api-jobs-trigger-Trigger)
+ [TriggerUpdate 구조](#aws-glue-api-jobs-trigger-TriggerUpdate)
+ [조건자 구조](#aws-glue-api-jobs-trigger-Predicate)
+ [조건 구조](#aws-glue-api-jobs-trigger-Condition)
+ [작업 구조](#aws-glue-api-jobs-trigger-Action)
+ [EventBatchingCondition 구조](#aws-glue-api-jobs-trigger-EventBatchingCondition)

## 트리거 구조
<a name="aws-glue-api-jobs-trigger-Trigger"></a>

특정 트리거에 대한 정보

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

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

  트리거와 연결된 워크플로의 이름입니다.
+ `Id` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  추후 사용 예약.
+ `Type` – UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `EVENT`).

  트리거 유형입니다.
+ `State` – UTF-8 문자열입니다(유효 값: `CREATING` \$1 `CREATED` \$1 `ACTIVATING` \$1 `ACTIVATED` \$1 `DEACTIVATING` \$1 `DEACTIVATED` \$1 `DELETING` \$1 `UPDATING`).

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

  이 트리거에 대한 설명입니다.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Actions` – [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  이 트리거에 의해 시작되는 작업
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

  트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

  EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

## TriggerUpdate 구조
<a name="aws-glue-api-jobs-trigger-TriggerUpdate"></a>

트리거를 업데이트하기 위해 정보를 제공하는 데 사용되는 구조입니다. 이 객체는 이전 트리거 정의를 완전히 덮어써서 업데이트합니다.

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

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

  이 트리거에 대한 설명입니다.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.
+ `Actions` – [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  이 트리거에 의해 시작되는 작업
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

  트리거가 실행되는 시기를 결정하는 이 트리거의 조건자입니다.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

  EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

## 조건자 구조
<a name="aws-glue-api-jobs-trigger-Predicate"></a>

트리거가 실행되는 시기를 결정하는 트리거의 조건자를 정의합니다.

**필드**
+ `Logical` – UTF-8 문자열입니다(유효한 값: `AND` \$1 `ANY`).

  오직 하나의 조건이 기록되어 있다면 조건부 필드입니다. 다수의 조건이 있을 때 이 필드가 필요합니다.
+ `Conditions` – [Condition](#aws-glue-api-jobs-trigger-Condition) 객체의 배열이며 구조는 500개 이하입니다.

  트리거가 언제 발생하는지 확인하는 조건 목록입니다.

## 조건 구조
<a name="aws-glue-api-jobs-trigger-Condition"></a>

어떤 트리거가 시작되는지에 대한 조건을 결정합니다.

**필드**
+ `LogicalOperator` – UTF-8 문자열입니다(유효한 값: `EQUALS`).

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

  `JobRuns`에 조건이 적용되고 트리거가 대기하는 작업의 이름입니다.
+ `State` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  조건 상태입니다. 현재 트리거가 수신할 수 있는 유일한 작업은 `SUCCEEDED`, `STOPPED`, `FAILED` 및 `TIMEOUT`입니다. 트리거가 수신할 수 있는 유일한 Crawler는 `SUCCEEDED`, `FAILED` 및 `CANCELLED`입니다.
+ `CrawlerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 조건이 적용되는 크롤러의 이름입니다.
+ `CrawlState` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`).

  이 조건이 적용되는 크롤러의 상태입니다.

## 작업 구조
<a name="aws-glue-api-jobs-trigger-Action"></a>

트리거에 의해 시작한 작업을 결정합니다.

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

  실행할 작업의 이름입니다.
+ `Arguments` – 키-값 페어의 맵 배열입니다.

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

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

  이 트리거가 작동할 때 사용되는 작업 인수입니다. 이 작업 실행에서 작업 정의 자체에 설정된 기본 인수를 바꿉니다.

  AWS Glue 자체가 사용하는 인수는 물론 사용자의 작업 실행 스크립트가 사용하는 인수를 지정할 수 있습니다.

  자체 작업 인수를 지정하고 사용하는 방법에 대한 자세한 내용은 개발자 가이드의 [Python에서 AWS Glue Glue API](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-python-calling.html) 호출을 참조하세요.

  AWS Glue가 작업을 설정하는 데 사용하는 키 값 페어에 대한 자세한 내용은 개발자 가이드의 [AWS Glue가 사용하는 특정 파라미터](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html)를 참조하세요.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  `JobRun` 제한 시간(분)입니다. 작업을 실행하여 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 상위 작업에 설정된 제한 시간 값을 재정의합니다.

  작업의 시간 제한 값은 7일 또는 10,080분 미만이어야 합니다. 그렇지 않으면 작업에서 예외가 발생합니다.

  값을 비워 두면 제한 시간은 기본적으로 2,880분으로 설정됩니다.

  제한 시간 값이 7일을 초과하는 기존 AWS Glue 작업은 기본적으로 7일로 설정됩니다. 예를 들어 배치 작업에 20일의 제한 시간을 지정한 경우 7일째 되는 날에 작업이 중지됩니다.

  스트리밍 작업은 유지 관리 기간을 설정한 경우 7일 후 유지 관리 기간 중에 작업이 다시 시작됩니다.
+ `SecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 `SecurityConfiguration` 구조의 이름입니다.
+ `NotificationProperty` – [NotificationProperty](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-NotificationProperty) 객체입니다.

  작업 실행 알림의 구성 속성을 지정합니다.
+ `CrawlerName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 작업에 사용할 크롤러의 이름입니다.

## EventBatchingCondition 구조
<a name="aws-glue-api-jobs-trigger-EventBatchingCondition"></a>

EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

**필드**
+ `BatchSize` – *필수(Required):* 1\$1100의 숫자(정수)입니다.

  EventBridge 이벤트 트리거가 실행되기 전에 Amazon EventBridge에서 수신해야 하는 이벤트 수입니다.
+ `BatchWindow` – 1\$1900의 숫자(정수)입니다.

  EventBridge 이벤트 트리거가 실행된 후의 기간(초)입니다. 첫 번째 이벤트가 수신되면 기간이 시작됩니다.

## 운영
<a name="aws-glue-api-jobs-trigger-actions"></a>
+ [CreateTrigger 작업(Python: create\$1trigger)](#aws-glue-api-jobs-trigger-CreateTrigger)
+ [StartTrigger 작업(Python: start\$1trigger)](#aws-glue-api-jobs-trigger-StartTrigger)
+ [GetTrigger 작업(Python: get\$1trigger)](#aws-glue-api-jobs-trigger-GetTrigger)
+ [GetTrigger 작업(Python: get\$1triggers)](#aws-glue-api-jobs-trigger-GetTriggers)
+ [UpdateTrigger 작업(Python: update\$1trigger)](#aws-glue-api-jobs-trigger-UpdateTrigger)
+ [StopTrigger 작업(Python: stop\$1trigger)](#aws-glue-api-jobs-trigger-StopTrigger)
+ [DeleteTrigger 작업(Python: delete\$1trigger)](#aws-glue-api-jobs-trigger-DeleteTrigger)
+ [ListTriggers 작업(Python: list\$1triggers)](#aws-glue-api-jobs-trigger-ListTriggers)
+ [BatchGetTriggers 작업(Python: batch\$1get\$1triggers)](#aws-glue-api-jobs-trigger-BatchGetTriggers)

## CreateTrigger 작업(Python: create\$1trigger)
<a name="aws-glue-api-jobs-trigger-CreateTrigger"></a>

새로운 트리거를 만듭니다.

작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

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

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

  트리거와 연결된 워크플로의 이름입니다.
+ `Type` – *필수(Required):* UTF-8 문자열입니다(유효 값: `SCHEDULED` \$1 `CONDITIONAL` \$1 `ON_DEMAND` \$1 `EVENT`).

  새로운 트리거의 유형입니다.
+ `Schedule` – UTF-8 문자열입니다.

  일정을 지정하는 데 사용되는 `cron` 표현식입니다([작업 및 크롤러의 시간 기반 일정](https://docs.aws.amazon.com/glue/latest/dg/monitor-data-warehouse-schedule.html) 참조). 예를 들어, 매일 오후 12시 15분(UTC)에 실행하려면 `cron(15 12 * * ? *)`을 지정합니다.

  트리거 유형이 SCHEDULED(예정)되면 필드가 필요합니다.
+ `Predicate` – [조건자](#aws-glue-api-jobs-trigger-Predicate) 객체입니다.

  새로운 트리거가 시작할 시기를 지정하는 조건자입니다.

  트리거 유형이 `CONDITIONAL`이면 이 필드는 필수입니다.
+ `Actions` – *필수(Required):* [작업](#aws-glue-api-jobs-trigger-Action) 객체의 배열입니다.

  트리거가 발생하면 이 트리거가 시작되는 작업입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  새로운 트리거에 대한 설명.
+ `StartOnCreation` – 부울입니다.

  생성 시 `SCHEDULED` 및 `CONDITIONAL` 트리거를 시작하려면 `true`로 설정합니다. `ON_DEMAND` 트리거에는 True가 지원되지 않습니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 트리거에서 사용할 태그입니다. 태그를 사용하여 트리거에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `EventBatchingCondition` – [EventBatchingCondition](#aws-glue-api-jobs-trigger-EventBatchingCondition) 객체입니다.

  EventBridge 이벤트 트리거가 실행되기 전에 충족되어야 하는 배치 조건(수신된 이벤트의 지정된 수 또는 배치 기간이 만료됨).

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

  트리거의 이름입니다.

**오류**
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

## StartTrigger 작업(Python: start\$1trigger)
<a name="aws-glue-api-jobs-trigger-StartTrigger"></a>

기존 트리거 시작. 다른 유형의 트리거가 시작하는 방법에 대한 자세한 내용은 [작업 트리거](https://docs.aws.amazon.com/glue/latest/dg/trigger-job.html)를 참조하십시오.

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

  시작할 트리거의 이름입니다.

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

  시작된 트리거의 이름입니다.

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

## GetTrigger 작업(Python: get\$1trigger)
<a name="aws-glue-api-jobs-trigger-GetTrigger"></a>

트리거의 정의를 검색합니다.

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

  가져올 트리거의 이름입니다.

**응답**
+ `Trigger` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체입니다.

  요청한 트리거 정의입니다.

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

## GetTrigger 작업(Python: get\$1triggers)
<a name="aws-glue-api-jobs-trigger-GetTriggers"></a>

이 작업과 연결된 모든 트리거를 얻습니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.
+ `DependentJobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  트리거를 가져올 작업 이름입니다. 이 작업을 시작할 수 있는 트리거가 반환되고, 이런 트리거가 없으면 모든 트리거가 반환됩니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  응답의 최대 크기입니다.

**응답**
+ `Triggers` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체의 배열입니다.

  지정된 작업에 대한 트리거 목록.
+ `NextToken` – UTF-8 문자열입니다.

  모든 요청된 트리거가 반환하지 않은 경우의 지속 토큰입니다.

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

## UpdateTrigger 작업(Python: update\$1trigger)
<a name="aws-glue-api-jobs-trigger-UpdateTrigger"></a>

트리거 정의 업데이트

작업 인수가 로깅될 수 있습니다. 일반 텍스트 보안 암호를 인수로 전달하지 마세요. 보안 암호를 작업 내에 보관하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

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

  업데이트할 트리거의 이름입니다.
+ `TriggerUpdate` – *필수(Required):* [TriggerUpdate](#aws-glue-api-jobs-trigger-TriggerUpdate) 객체입니다.

  트리거를 업데이트하여 얻은 새로운 값입니다.

**응답**
+ `Trigger` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체입니다.

  결과 트리거 정의입니다.

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

## StopTrigger 작업(Python: stop\$1trigger)
<a name="aws-glue-api-jobs-trigger-StopTrigger"></a>

지정된 트리거를 중지합니다.

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

  중지할 트리거의 이름입니다.

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

  중지된 트리거의 이름입니다.

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

## DeleteTrigger 작업(Python: delete\$1trigger)
<a name="aws-glue-api-jobs-trigger-DeleteTrigger"></a>

지정된 트리거를 삭제합니다. 트리거를 못 찾으면 어떤 예외도 없습니다.

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

  삭제할 트리거의 이름입니다.

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

  삭제된 트리거의 이름입니다.

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

## ListTriggers 작업(Python: list\$1triggers)
<a name="aws-glue-api-jobs-trigger-ListTriggers"></a>

AWS 계정의 모든 트리거 리소스 또는 지정된 태그를 가진 리소스의 이름을 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 `Tags` 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `DependentJobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

   트리거를 가져올 작업 이름 이 작업을 시작할 수 있는 트리거가 반환됩니다. 그런 트리거가 없으면 모든 트리거가 반환됩니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

**응답**
+ `TriggerNames` – UTF-8 문자열의 배열입니다.

  계정의 모든 트리거 또는 지정된 태그를 가진 트리거의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

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

## BatchGetTriggers 작업(Python: batch\$1get\$1triggers)
<a name="aws-glue-api-jobs-trigger-BatchGetTriggers"></a>

주어진 트리거 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. `ListTriggers` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

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

  트리거 이름(`ListTriggers` 작업에서 반환된 이름일 수 있음)의 목록입니다.

**응답**
+ `Triggers` – [트리거](#aws-glue-api-jobs-trigger-Trigger) 객체의 배열입니다.

  트리거 정의 목록입니다.
+ `TriggersNotFound` – UTF-8 문자열의 배열입니다.

  찾을 수 없는 트리거의 이름 목록입니다.

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

# AWS Glue의 통합 API
<a name="aws-glue-api-integrations"></a>

## 데이터 타입
<a name="aws-glue-api-integrations-objects"></a>
+ [통합 구조](#aws-glue-api-integrations-Integration)
+ [IntegrationConfig 구조](#aws-glue-api-integrations-IntegrationConfig)
+ [IntegrationPartition 구조](#aws-glue-api-integrations-IntegrationPartition)
+ [IntegrationError 구조](#aws-glue-api-integrations-IntegrationError)
+ [IntegrationFilter 구조](#aws-glue-api-integrations-IntegrationFilter)
+ [InboundIntegration 구조](#aws-glue-api-integrations-InboundIntegration)
+ [SourceProcessingProperties 구조](#aws-glue-api-integrations-SourceProcessingProperties)
+ [TargetProcessingProperties 구조](#aws-glue-api-integrations-TargetProcessingProperties)
+ [SourceTableConfig 구조](#aws-glue-api-integrations-SourceTableConfig)
+ [TargetTableConfig 구조](#aws-glue-api-integrations-TargetTableConfig)

## 통합 구조
<a name="aws-glue-api-integrations-Integration"></a>

제로 ETL 통합에 대해 설명합니다.

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

  통합 소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 대상의 ARN입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `IntegrationName` – *필수*: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 고유 이름입니다.
+ `IntegrationArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `KmsKeyId` – UTF-8 문자열입니다(1\$12,048바이트).

  채널을 암호화하는 데 사용되는 KMS 키의 ARN입니다.
+ `AdditionalEncryptionContext` – 키-값 페어의 맵 배열입니다.

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

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

  암호화에 대한 추가 컨텍스트 정보가 포함된 비밀이 아닌 선택적 키-값 페어 세트입니다. `KMSKeyId`가 제공된 경우에만 제공할 수 있습니다.
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열입니다.

  키-값 페어 목록으로 구성된 리소스에 할당되는 메타데이터입니다.
+ `Status` – **필수: UTF-8 문자열입니다(유효한 값: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  가능한 상태는 다음과 같습니다.
  + CREATING: 통합이 생성 중입니다.
  + ACTIVE: 통합 생성이 성공적으로 실행됩니다.
  + MODIFYING: 통합을 수정하는 중입니다.
  + FAILED: 통합 생성이 실패했습니다.
  + DELETING: 통합이 삭제됩니다.
  + SYNCING: 통합이 동기화 중입니다.
  + NEEDS\$1ATTENTION: 동기화 등으로 인해 통합과 관련하여 주의가 필요합니다.
+ `CreateTime` – **필수(Required): 타임스탬프입니다.

  통합을 생성한 시간(UTC)입니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  통합과 관련한 속성입니다.
+ `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) 객체의 배열입니다.

  통합과 관련한 오류의 목록입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.

## IntegrationConfig 구조
<a name="aws-glue-api-integrations-IntegrationConfig"></a>

통합과 관련한 속성입니다.

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

  변경 데이터 캡처(CDC) 풀 또는 증분 로드가 발생하는 빈도를 지정합니다. 이 파라미터는 특정 데이터 업데이트 패턴, 시스템 로드 고려 사항 및 성능 최적화 목표에 맞게 새로 고침 빈도를 조정할 수 있는 유연성을 제공합니다. 시간 증분은 15분\$18640분(6일)으로 설정할 수 있습니다.
+ `SourceProperties` – 키-값 페어의 맵 배열입니다.

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

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

   통합 소스에 대한 추가 속성을 지정하는 키-값 페어의 컬렉션입니다. 이러한 속성은 데이터 통합 작업 중 ODB 소스의 동작을 사용자 지정하는 데 사용할 수 있는 구성 옵션을 제공합니다.
+ `ContinuousSync` – 부울입니다.

  1) SaaS 애플리케이션에서 Amazon Redshift 및 Amazon S3와 같은 AWS 데이터 서비스로, 2) DynamoDB에서 Amazon S3로 온디맨드 데이터를 추출하기 위한 지속적 동기화를 활성화합니다.

## IntegrationPartition 구조
<a name="aws-glue-api-integrations-IntegrationPartition"></a>

대상에서 데이터를 분할하는 방법을 설명하는 구조입니다.

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

  대상의 데이터를 분할하는 데 사용되는 필드 이름입니다. 'LastModifiedTimestamp' 또는 'SystemModTimeStamp'와 같이 각 행에 고유한 값이 있는 열을 파티션 열로 사용하지 마세요. 이러한 열은 많은 수의 작은 파티션을 생성하여 성능 문제가 발생할 수 있으므로 파티셔닝에 적합하지 않습니다.
+ `FunctionSpec` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  대상의 데이터를 분할하는 데 사용되는 함수를 지정합니다. 이 파라미터에 허용되는 값은 다음과 같습니다.
  + `identity` - 변환 없이 소스 값을 직접 사용
  + `year` - 타임스탬프 값에서 연도 추출(예: 2023)
  + `month` - 타임스탬프 값에서 월 추출(예: 2023-01)
  + `day` - 타임스탬프 값에서 날짜 추출(예: 2023-01-15)
  + `hour` - 타임스탬프 값에서 시간 추출(예: 2023-01-15-14)
+ `ConversionSpec` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스 데이터의 타임스탬프 형식을 지정합니다. 유효값은 다음과 같습니다.
  + `epoch_sec` - 초 단위의 Unix 에포크 타임스탬프
  + `epoch_milli` - 밀리초 단위의 Unix 에포크 타임스탬프
  + `iso` - ISO 8601 형식의 타임스탬프
**참고**  
 타임스탬프 기반 파티션 함수(년, 월, 일 또는 시간)를 사용할 때만 `ConversionSpec`을 지정합니다. AWS Glue 제로 ETL은 파티셔닝 전에 이 파라미터를 사용하여 소스 데이터를 타임스탬프 형식으로 올바르게 변환합니다.  
 `identity` 파티션 함수에는 카디널리티가 높은 열을 사용하지 마세요. 카디널리티가 높은 열은 다음과 같습니다.  
프라이머리 키
타임스탬프 필드(예: `LastModifiedTimestamp`, `CreatedDate`)
시스템 생성 타임스탬프
 ID 파티셔닝과 함께 높은 카디널리티 열을 사용하면 작은 파티션이 많이 생성되어 수집 성능이 크게 저하될 수 있습니다.

## IntegrationError 구조
<a name="aws-glue-api-integrations-IntegrationError"></a>

제로 ETL 통합과 관련한 오류입니다.

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

  이 오류와 연결된 코드입니다.
+ `ErrorMessage` – UTF-8 문자열입니다(1\$12,048바이트).

  메시지에서 오류를 설명합니다.

## IntegrationFilter 구조
<a name="aws-glue-api-integrations-IntegrationFilter"></a>

`DescribeIntegrations` 요청을 간접적으로 호출할 때 사용할 수 있는 필터입니다.

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

  필터의 이름.
+ `Values` – UTF-8 문자열의 배열입니다.

  필터 값 목록입니다.

## InboundIntegration 구조
<a name="aws-glue-api-integrations-InboundIntegration"></a>

리소스에 데이터를 쓰는 통합의 구조입니다.

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

  통합을 위한 소스 리소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합을 위한 대상 리소스의 ARN입니다.
+ `IntegrationArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  제로 ETL 통합의 ARN입니다.
+ `Status` – **필수: UTF-8 문자열입니다(유효한 값: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  가능한 상태는 다음과 같습니다.
  + CREATING: 통합이 생성 중입니다.
  + ACTIVE: 통합 생성이 성공적으로 실행됩니다.
  + MODIFYING: 통합을 수정하는 중입니다.
  + FAILED: 통합 생성이 실패했습니다.
  + DELETING: 통합이 삭제됩니다.
  + SYNCING: 통합이 동기화 중입니다.
  + NEEDS\$1ATTENTION: 동기화 등으로 인해 통합과 관련하여 주의가 필요합니다.
+ `CreateTime` – **필수(Required): 타임스탬프입니다.

  통합을 생성한 시간(UTC)입니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  통합과 관련한 속성입니다.
+ `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) 객체의 배열입니다.

  통합과 관련한 오류의 목록입니다.

## SourceProcessingProperties 구조
<a name="aws-glue-api-integrations-SourceProcessingProperties"></a>

통합 소스와 관련한 리소스 속성입니다.

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

  AWS Glue 연결에 액세스할 IAM 역할입니다.

## TargetProcessingProperties 구조
<a name="aws-glue-api-integrations-TargetProcessingProperties"></a>

통합 대상과 관련한 리소스 속성입니다.

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

  AWS Glue 데이터베이스에 액세스할 IAM 역할입니다.
+ `KmsArn` – UTF-8 문자열입니다(1\$12,048바이트).

  암호화에 사용되는 KMS 키의 ARN입니다.
+ `ConnectionName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  고객 VPC에서 실행 중인 AWS Glue 작업을 구성하기 위한 AWS Glue 네트워크 연결입니다.
+ `EventBusArn` – UTF-8 문자열입니다(1\$12,048바이트).

  통합 상태 알림을 수신할 Eventbridge 이벤트 버스의 ARN입니다.

## SourceTableConfig 구조
<a name="aws-glue-api-integrations-SourceTableConfig"></a>

소스 레그에서 소스의 데이터를 처리하는 데 사용하는 속성입니다.

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

  열 수준 필터링에 사용되는 필드 목록입니다. 현재 지원되지 않습니다.
+ `FilterPredicate` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  행 수준 필터링에 사용되는 조건 절입니다. 현재 지원되지 않습니다.
+ `PrimaryKey` – UTF-8 문자열의 배열입니다.

  이 테이블의 프라이머리 키 세트를 제공합니다. 현재는 요청 시 SAP `EntityOf` 엔터티에 대해 지원됩니다. 이 기능을 사용하려면 AWS Support에 문의하세요.
+ `RecordUpdateField` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  증분 풀 타임스탬프 기반 필드입니다. 현재 지원되지 않습니다.

## TargetTableConfig 구조
<a name="aws-glue-api-integrations-TargetTableConfig"></a>

대상 레그에서 대상의 데이터를 분할하는 데 사용하는 속성입니다.

**필드**
+ `UnnestSpec` – UTF-8 문자열입니다(유효한 값: `TOPLEVEL` \$1 `FULL` \$1 `NOUNNEST`).

  중첩된 객체를 최상위 요소로 평면화하는 방법을 지정합니다. 유효한 값은 'TOPLEVEL', 'FULL' 또는 'NOUNNEST'입니다.
+ `PartitionSpec` – [IntegrationPartition](#aws-glue-api-integrations-IntegrationPartition) 객체의 배열입니다.

  대상의 파일 레이아웃을 결정합니다.
+ `TargetTableName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  대상 테이블의 선택적 이름입니다.

## 운영
<a name="aws-glue-api-integrations-actions"></a>
+ [CreateIntegration 작업(Python: create\$1integration)](#aws-glue-api-integrations-CreateIntegration)
+ [ModifyIntegration 작업(Python: modify\$1integration)](#aws-glue-api-integrations-ModifyIntegration)
+ [DescribeIntegrations 작업(Python: describe\$1integrations)](#aws-glue-api-integrations-DescribeIntegrations)
+ [DeleteIntegration 작업(Python: delete\$1integration)](#aws-glue-api-integrations-DeleteIntegration)
+ [DescribeInboundIntegrations 작업(Python: describe\$1inbound\$1integrations)](#aws-glue-api-integrations-DescribeInboundIntegrations)
+ [CreateIntegrationTableProperties 작업(Python: create\$1integration\$1table\$1properties)](#aws-glue-api-integrations-CreateIntegrationTableProperties)
+ [UpdateIntegrationTableProperties 작업(Python: update\$1integration\$1table\$1properties)](#aws-glue-api-integrations-UpdateIntegrationTableProperties)
+ [GetIntegrationTableProperties 작업(Python: get\$1integration\$1table\$1properties)](#aws-glue-api-integrations-GetIntegrationTableProperties)
+ [DeleteIntegrationTableProperties 작업(Python: delete\$1integration\$1table\$1properties)](#aws-glue-api-integrations-DeleteIntegrationTableProperties)
+ [CreateIntegrationResourceProperty 작업(Python: create\$1integration\$1resource\$1property)](#aws-glue-api-integrations-CreateIntegrationResourceProperty)
+ [UpdateIntegrationResourceProperty 작업(Python: update\$1integration\$1resource\$1property)](#aws-glue-api-integrations-UpdateIntegrationResourceProperty)
+ [GetIntegrationResourceProperty 작업(Python: get\$1integration\$1resource\$1property)](#aws-glue-api-integrations-GetIntegrationResourceProperty)
+ [UntagResource 작업(Python: untag\$1resource)](#aws-glue-api-integrations-UntagResource)
+ [ListTagsForResource 작업(Python: list\$1tags\$1for\$1resource)](#aws-glue-api-integrations-ListTagsForResource)

## CreateIntegration 작업(Python: create\$1integration)
<a name="aws-glue-api-integrations-CreateIntegration"></a>

Amazon 리소스 이름(ARN)이 있는 두 리소스, 즉 `SourceArn` 및 `TargetArn` 간에 제로 ETL 통합을 호출자 계정에 생성합니다.

**요청**
+ `IntegrationName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue에서 통합의 고유 이름입니다.
+ `SourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합을 위한 소스 리소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합을 위한 대상 리소스의 ARN입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.
+ `KmsKeyId` – UTF-8 문자열입니다(1\$12,048바이트).

  채널을 암호화하는 데 사용되는 KMS 키의 ARN입니다.
+ `AdditionalEncryptionContext` – 키-값 페어의 맵 배열입니다.

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

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

  암호화에 대한 추가 컨텍스트 정보가 포함된 비밀이 아닌 선택적 키-값 페어 세트입니다. `KMSKeyId`가 제공된 경우에만 제공할 수 있습니다.
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열입니다.

  키-값 페어 목록으로 구성된 리소스에 할당되는 메타데이터입니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  구성 설정입니다.

**응답**
+ `SourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합을 위한 소스 리소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합을 위한 대상 리소스의 ARN입니다.
+ `IntegrationName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue에서 통합의 고유 이름입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `IntegrationArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  생성된 통합의 Amazon 리소스 이름(ARN)입니다.
+ `KmsKeyId` – UTF-8 문자열입니다(1\$12,048바이트).

  채널을 암호화하는 데 사용되는 KMS 키의 ARN입니다.
+ `AdditionalEncryptionContext` – 키-값 페어의 맵 배열입니다.

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

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

  암호화에 대한 추가 컨텍스트 정보가 포함된 비밀이 아닌 선택적 키-값 페어 세트입니다.
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열입니다.

  키-값 페어 목록으로 구성된 리소스에 할당되는 메타데이터입니다.
+ `Status` – **필수: UTF-8 문자열입니다(유효한 값: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  생성 중인 통합의 상태입니다.

  가능한 상태는 다음과 같습니다.
  + CREATING: 통합이 생성 중입니다.
  + ACTIVE: 통합 생성이 성공적으로 실행됩니다.
  + MODIFYING: 통합을 수정하는 중입니다.
  + FAILED: 통합 생성이 실패했습니다.
  + DELETING: 통합이 삭제됩니다.
  + SYNCING: 통합이 동기화 중입니다.
  + NEEDS\$1ATTENTION: 동기화 등으로 인해 통합과 관련하여 주의가 필요합니다.
+ `CreateTime` – **필수(Required): 타임스탬프입니다.

  통합이 생성된 시점의 시각(UTC)입니다.
+ `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) 객체의 배열입니다.

  통합 생성과 관련된 오류의 목록입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  구성 설정입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `IntegrationConflictOperationFault`
+ `IntegrationQuotaExceededFault`
+ `KMSKeyNotAccessibleFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## ModifyIntegration 작업(Python: modify\$1integration)
<a name="aws-glue-api-integrations-ModifyIntegration"></a>

호출자의 계정에서 제로 ETL 통합을 수정합니다.

**요청**
+ `IntegrationIdentifier` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  통합에 대한 구성 설정. 현재는 RefreshInterval만 수정할 수 있습니다.
+ `IntegrationName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue에서 통합의 고유 이름입니다.

**응답**
+ `SourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 대상의 ARN입니다.
+ `IntegrationName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue에서 통합의 고유 이름입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `IntegrationArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `KmsKeyId` – UTF-8 문자열입니다(1\$12,048바이트).

  채널을 암호화하는 데 사용되는 KMS 키의 ARN입니다.
+ `AdditionalEncryptionContext` – 키-값 페어의 맵 배열입니다.

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

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

  암호화에 대한 추가 컨텍스트 정보가 포함된 비밀이 아닌 선택적 키-값 페어 세트입니다.
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열입니다.

  키-값 페어 목록으로 구성된 리소스에 할당되는 메타데이터입니다.
+ `Status` – **필수: UTF-8 문자열입니다(유효한 값: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  수정 중인 통합의 상태입니다.

  가능한 상태는 다음과 같습니다.
  + CREATING: 통합이 생성 중입니다.
  + ACTIVE: 통합 생성이 성공적으로 실행됩니다.
  + MODIFYING: 통합을 수정하는 중입니다.
  + FAILED: 통합 생성이 실패했습니다.
  + DELETING: 통합이 삭제됩니다.
  + SYNCING: 통합이 동기화 중입니다.
  + NEEDS\$1ATTENTION: 동기화 등으로 인해 통합과 관련하여 주의가 필요합니다.
+ `CreateTime` – **필수(Required): 타임스탬프입니다.

  통합이 생성된 시점의 시각(UTC)입니다.
+ `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) 객체의 배열입니다.

  통합 수정과 관련된 오류의 목록입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.
+ `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 객체입니다.

  통합에 대한 업데이트된 구성 설정.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `IntegrationConflictOperationFault`
+ `InvalidIntegrationStateFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `InvalidStateException`
+ `InvalidInputException`

## DescribeIntegrations 작업(Python: describe\$1integrations)
<a name="aws-glue-api-integrations-DescribeIntegrations"></a>

이 API는 통합의 목록을 검색하는 데 사용됩니다.

**요청**
+ `IntegrationIdentifier` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `Marker` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  후속 요청에서 다음 응답 레코드 세트의 시작점을 나타내는 값입니다.
+ `MaxRecords` - 숫자(정수)입니다.

  출력에서 반환되는 항목의 총 수입니다.
+ `Filters` – [IntegrationFilter](#aws-glue-api-integrations-IntegrationFilter) 객체의 배열입니다.

  결과를 필터링하기 위한 키와 값의 목록입니다. 지원되는 키는 'Status', 'IntegrationName' 및 'SourceArn'입니다. IntegrationName은 하나의 값으로만 제한됩니다.

**응답**
+ `Integrations` – [통합](#aws-glue-api-integrations-Integration) 객체의 배열입니다.

  제로 ETL 통합의 목록입니다.
+ `Marker` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  후속 요청에서 다음 응답 레코드 세트의 시작점을 나타내는 값입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## DeleteIntegration 작업(Python: delete\$1integration)
<a name="aws-glue-api-integrations-DeleteIntegration"></a>

지정된 제로 ETL 통합을 삭제합니다.

**요청**
+ `IntegrationIdentifier` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.

**응답**
+ `SourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 소스의 ARN입니다.
+ `TargetArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 대상의 ARN입니다.
+ `IntegrationName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  AWS Glue에서 통합의 고유 이름입니다.
+ `Description` – [Custom string pattern #12](aws-glue-api-common.md#regex_12)과(와) 일치하는 1,000바이트 이하 길이의 UTF-8 문자열입니다.

  통합에 대한 설명입니다.
+ `IntegrationArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `KmsKeyId` – UTF-8 문자열입니다(1\$12,048바이트).

  채널을 암호화하는 데 사용되는 KMS 키의 ARN입니다.
+ `AdditionalEncryptionContext` – 키-값 페어의 맵 배열입니다.

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

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

  암호화에 대한 추가 컨텍스트 정보가 포함된 비밀이 아닌 선택적 키-값 페어 세트입니다.
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열입니다.

  키-값 페어 목록으로 구성된 리소스에 할당되는 메타데이터입니다.
+ `Status` – **필수: UTF-8 문자열입니다(유효한 값: `CREATING` \$1 `ACTIVE` \$1 `MODIFYING` \$1 `FAILED` \$1 `DELETING` \$1 `SYNCING` \$1 `NEEDS_ATTENTION`).

  삭제 중인 통합의 상태입니다.

  가능한 상태는 다음과 같습니다.
  + CREATING: 통합이 생성 중입니다.
  + ACTIVE: 통합 생성이 성공적으로 실행됩니다.
  + MODIFYING: 통합을 수정하는 중입니다.
  + FAILED: 통합 생성이 실패했습니다.
  + DELETING: 통합이 삭제됩니다.
  + SYNCING: 통합이 동기화 중입니다.
  + NEEDS\$1ATTENTION: 동기화 등으로 인해 통합과 관련하여 주의가 필요합니다.
+ `CreateTime` – **필수(Required): 타임스탬프입니다.

  통합이 생성된 시점의 시각(UTC)입니다.
+ `Errors` – [IntegrationError](#aws-glue-api-integrations-IntegrationError) 객체의 배열입니다.

  통합과 관련한 오류의 목록입니다.
+ `DataFilter` – UTF-8 문자열입니다(1\$12,048바이트).

  Maxwell 필터 구문을 사용하여 통합의 소스 테이블을 선택합니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `IntegrationConflictOperationFault`
+ `InvalidIntegrationStateFault`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `ConflictException`
+ `InvalidStateException`
+ `InvalidInputException`

## DescribeInboundIntegrations 작업(Python: describe\$1inbound\$1integrations)
<a name="aws-glue-api-integrations-DescribeInboundIntegrations"></a>

지정된 통합의 인바운드 통합 목록을 반환합니다.

**요청**
+ `IntegrationArn` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합의 Amazon 리소스 이름(ARN)입니다.
+ `Marker` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  페이지 매김을 시작할 위치를 지정하기 위한 토큰입니다. 이는 이전에 잘린 응답에서 도출된 마커입니다.
+ `MaxRecords` - 숫자(정수)입니다.

  출력에서 반환되는 항목의 총 수입니다.
+ `TargetArn` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합에 포함된 대상 리소스의 Amazon 리소스 이름(ARN)입니다.

**응답**
+ `InboundIntegrations` – [InboundIntegration](#aws-glue-api-integrations-InboundIntegration) 객체의 배열입니다.

  인바운드 통합의 목록입니다.
+ `Marker` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  후속 요청에서 다음 응답 레코드 세트의 시작점을 나타내는 값입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `IntegrationNotFoundFault`
+ `TargetResourceNotFound`
+ `OperationNotSupportedException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## CreateIntegrationTableProperties 작업(Python: create\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-CreateIntegrationTableProperties"></a>

이 API는 복제할 테이블에 대한 선택적 재정의 속성을 제공하는 데 사용됩니다. 이러한 속성에는 소스 및 대상 테이블에 대한 필터링 및 파티셔닝 속성이 포함될 수 있습니다. 소스 속성과 대상 속성을 모두 설정하려면 각각 `SourceTableConfig`에서 `ResourceArn`을 AWS Glue 연결 ARN으로 사용하고, `TargetTableConfig`에서 `ResourceArn`을 AWS Glue 데이터베이스 ARN으로 사용하여 동일한 API를 간접적으로 호출해야 합니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 테이블 속성을 생성할 대상 테이블의 Amazon 리소스 이름(ARN)입니다. 현재 이 API는 대상 테이블에 대한 통합 테이블 속성 생성만 지원하며 제공된 ARN은 AWS Glue 데이터 카탈로그에 있는 대상 테이블의 ARN이어야 합니다. 소스 연결(연결 ARN 사용)에 대한 통합 테이블 속성 생성 기능 지원은 아직 구현되지 않았으며 향후 릴리스에서 추가될 예정입니다.
+ `TableName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  복제할 테이블의 이름입니다.
+ `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) 객체입니다.

  소스 테이블 구성의 구조입니다. 지원되는 소스 속성 목록을 보려면 `SourceTableConfig` 구조를 참조하세요.
+ `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) 객체입니다.

  대상 테이블 구성의 구조입니다.

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

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UpdateIntegrationTableProperties 작업(Python: update\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-UpdateIntegrationTableProperties"></a>

이 API는 복제할 테이블에 대한 선택적 재정의 속성을 제공하는 데 사용됩니다. 이러한 속성에는 소스 및 대상 테이블에 대한 필터링 및 파티셔닝 속성이 포함될 수 있습니다. 소스 속성과 대상 속성을 모두 설정하려면 각각 `SourceTableConfig`에서 `ResourceArn`을 AWS Glue 연결 ARN으로 사용하고, `TargetTableConfig`에서 `ResourceArn`을 AWS Glue 데이터베이스 ARN으로 사용하여 동일한 API를 간접적으로 호출해야 합니다.

재정의는 동일한 `ResourceArn` 및 소스 테이블을 사용하여 모든 통합에 반영됩니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `TableName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  복제할 테이블의 이름입니다.
+ `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) 객체입니다.

  소스 테이블 구성의 구조입니다.
+ `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) 객체입니다.

  대상 테이블 구성의 구조입니다.

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

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## GetIntegrationTableProperties 작업(Python: get\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-GetIntegrationTableProperties"></a>

이 API는 복제할 테이블에 대한 선택적 재정의 속성을 검색하는 데 사용됩니다. 이러한 속성에는 소스 및 대상 테이블에 대한 필터링 및 파티션 속성이 포함될 수 있습니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 테이블 속성을 검색할 대상 테이블의 Amazon 리소스 이름(ARN)입니다. 현재 이 API는 대상 테이블에 대한 속성 검색만 지원하며 제공된 ARN은 AWS Glue 데이터 카탈로그에 있는 대상 테이블의 ARN이어야 합니다. 소스 연결(연결 ARN 사용)에 대한 통합 테이블 속성 검색 기능 지원은 아직 구현되지 않았으며 향후 릴리스에서 추가될 예정입니다.
+ `TableName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  복제할 테이블의 이름입니다.

**응답**
+ `ResourceArn` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  통합 테이블 속성을 검색할 대상 테이블의 Amazon 리소스 이름(ARN)입니다. 현재 이 API는 대상 테이블에 대한 속성 검색만 지원하며 제공된 ARN은 AWS Glue 데이터 카탈로그에 있는 대상 테이블의 ARN이어야 합니다. 소스 연결(연결 ARN 사용)에 대한 통합 테이블 속성 검색 기능 지원은 아직 구현되지 않았으며 향후 릴리스에서 추가될 예정입니다.
+ `TableName` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  복제할 테이블의 이름입니다.
+ `SourceTableConfig` – [SourceTableConfig](#aws-glue-api-integrations-SourceTableConfig) 객체입니다.

  소스 테이블 구성의 구조입니다.
+ `TargetTableConfig` – [TargetTableConfig](#aws-glue-api-integrations-TargetTableConfig) 객체입니다.

  대상 테이블 구성의 구조입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## DeleteIntegrationTableProperties 작업(Python: delete\$1integration\$1table\$1properties)
<a name="aws-glue-api-integrations-DeleteIntegrationTableProperties"></a>

복제할 테이블에 대해 생성된 테이블 속성을 삭제합니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `TableName` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  복제할 테이블의 이름입니다.

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

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ResourceNotFoundException`
+ `InternalServerException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## CreateIntegrationResourceProperty 작업(Python: create\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-CreateIntegrationResourceProperty"></a>

이 API는 AWS Glue 연결(소스의 경우)의 `ResourceProperty` 또는 AWS Glue 데이터베이스 ARN(대상의 경우)을 설정하는 데 사용할 수 있습니다. 이러한 속성에는 연결 또는 데이터베이스에 액세스하는 역할이 포함될 수 있습니다. 소스 속성과 대상 속성을 모두 설정하려면 각각 `SourceProcessingProperties`에서 `ResourceArn`을 AWS Glue 연결 ARN으로 사용하고, `TargetProcessingProperties`에서 `ResourceArn`을 AWS Glue 데이터베이스 ARN으로 사용하여 동일한 API를 간접적으로 호출해야 합니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 객체입니다.

  통합 소스와 관련한 리소스 속성입니다.
+ `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 객체입니다.

  통합 대상과 관련한 리소스 속성입니다.

**응답**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 객체입니다.

  통합 소스와 관련한 리소스 속성입니다.
+ `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 객체입니다.

  통합 대상과 관련한 리소스 속성입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `ConflictException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UpdateIntegrationResourceProperty 작업(Python: update\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-UpdateIntegrationResourceProperty"></a>

이 API는 AWS Glue 연결(소스의 경우)의 `ResourceProperty` 또는 AWS Glue 데이터베이스 ARN(대상의 경우)을 업데이트하는 데 사용할 수 있습니다. 이러한 속성에는 연결 또는 데이터베이스에 액세스하는 역할이 포함될 수 있습니다. 동일한 리소스를 여러 통합에서 사용할 수 있으므로 리소스 속성을 업데이트하면 이를 사용하는 모든 통합에 영향을 미칩니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 객체입니다.

  통합 소스와 관련한 리소스 속성입니다.
+ `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 객체입니다.

  통합 대상과 관련한 리소스 속성입니다.

**응답**
+ `ResourceArn` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 객체입니다.

  통합 소스와 관련한 리소스 속성입니다.
+ `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 객체입니다.

  통합 대상과 관련한 리소스 속성입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## GetIntegrationResourceProperty 작업(Python: get\$1integration\$1resource\$1property)
<a name="aws-glue-api-integrations-GetIntegrationResourceProperty"></a>

이 API는 AWS Glue 연결(소스의 경우) 또는 AWS Glue 데이터베이스 ARN(대상의 경우)의 `ResourceProperty`를 가져오는 데 사용됩니다.

**요청**
+ `ResourceArn` – **필수: 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.

**응답**
+ `ResourceArn` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  소스의 연결 ARN 또는 대상의 데이터베이스 ARN입니다.
+ `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 객체입니다.

  통합 소스와 관련한 리소스 속성입니다.
+ `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 객체입니다.

  통합 대상과 관련한 리소스 속성입니다.

**오류**
+ `ValidationException`
+ `AccessDeniedException`
+ `InternalServerException`
+ `ResourceNotFoundException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `InvalidInputException`

## UntagResource 작업(Python: untag\$1resource)
<a name="aws-glue-api-integrations-UntagResource"></a>

통합 리소스에서 지정된 태그를 제거합니다.

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

  통합 리소스의 Amazon 리소스 이름(ARN)입니다.
+ `TagsToRemove` – *필수(Required):* 50개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  리소스에서 제거할 메타데이터 태그의 목록입니다.

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

**오류**
+ `ResourceNotFoundException`

## ListTagsForResource 작업(Python: list\$1tags\$1for\$1resource)
<a name="aws-glue-api-integrations-ListTagsForResource"></a>

지정된 리소스에 할당한 메타데이터 태그를 나열합니다.

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

  리소스의 리소스 ARN입니다.

**응답**
+ `Tags` – [태그](aws-glue-api-common.md#aws-glue-api-common-Tag) 객체의 배열이며 구조는 10개 이하입니다.

  태그의 목록입니다.

**오류**
+ `ResourceNotFoundException`

## 예외
<a name="aws-glue-api-integrations-exceptions"></a>
+ [ResourceNotFoundException 구조](#aws-glue-api-integrations-ResourceNotFoundException)
+ [InternalServerException 구조](#aws-glue-api-integrations-InternalServerException)
+ [IntegrationAlreadyExistsFault 구조](#aws-glue-api-integrations-IntegrationAlreadyExistsFault)
+ [IntegrationConflictOperationFault 구조](#aws-glue-api-integrations-IntegrationConflictOperationFault)
+ [IntegrationQuotaExceededFault 구조](#aws-glue-api-integrations-IntegrationQuotaExceededFault)
+ [KMSKeyNotAccessibleFault 구조](#aws-glue-api-integrations-KMSKeyNotAccessibleFault)
+ [IntegrationNotFoundFault 구조](#aws-glue-api-integrations-IntegrationNotFoundFault)
+ [TargetResourceNotFound 구조](#aws-glue-api-integrations-TargetResourceNotFound)
+ [InvalidIntegrationStateFault 구조](#aws-glue-api-integrations-InvalidIntegrationStateFault)

## ResourceNotFoundException 구조
<a name="aws-glue-api-integrations-ResourceNotFoundException"></a>

리소스를 찾을 수 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InternalServerException 구조
<a name="aws-glue-api-integrations-InternalServerException"></a>

내부 서버 오류가 발생했습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## IntegrationAlreadyExistsFault 구조
<a name="aws-glue-api-integrations-IntegrationAlreadyExistsFault"></a>

지정된 통합이 이미 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## IntegrationConflictOperationFault 구조
<a name="aws-glue-api-integrations-IntegrationConflictOperationFault"></a>

요청된 작업이 다른 작업과 충돌합니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## IntegrationQuotaExceededFault 구조
<a name="aws-glue-api-integrations-IntegrationQuotaExceededFault"></a>

통합을 통해 처리된 데이터가 할당량을 초과했습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## KMSKeyNotAccessibleFault 구조
<a name="aws-glue-api-integrations-KMSKeyNotAccessibleFault"></a>

지정된 KMS 키에 액세스할 수 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## IntegrationNotFoundFault 구조
<a name="aws-glue-api-integrations-IntegrationNotFoundFault"></a>

지정된 통합을 찾을 수 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## TargetResourceNotFound 구조
<a name="aws-glue-api-integrations-TargetResourceNotFound"></a>

대상 리소스를 찾을 수 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InvalidIntegrationStateFault 구조
<a name="aws-glue-api-integrations-InvalidIntegrationStateFault"></a>

통합 상태가 잘못되었습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

# 대화형 세션 API
<a name="aws-glue-api-interactive-sessions"></a>

대화형 세션 API는 AWS Glue 대화형 세션을 사용하여 데이터 통합을 위한 추출, 변환, 로드 스크립트를 빌드하고 테스트하는 것과 관련된 AWS Glue API를 설명합니다.

## 데이터 타입
<a name="aws-glue-api-interactive-sessions-objects"></a>
+ [세션 구조](#aws-glue-api-interactive-sessions-Session)
+ [SessionCommand 구조](#aws-glue-api-interactive-sessions-SessionCommand)
+ [명령문 구조](#aws-glue-api-interactive-sessions-Statement)
+ [StatementOutput 구조](#aws-glue-api-interactive-sessions-StatementOutput)
+ [StatementOutputData 구조](#aws-glue-api-interactive-sessions-StatementOutputData)
+ [ConnectionsList 구조](#aws-glue-api-interactive-sessions-ConnectionsList)

## 세션 구조
<a name="aws-glue-api-interactive-sessions-Session"></a>

원격 Spark 런타임 환경이 실행되는 기간입니다.

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

  세션의 ID입니다.
+ `CreatedOn` – 타임스탬프입니다.

  세션이 생성된 시간 및 날짜입니다.
+ `Status` – UTF-8 문자열입니다(유효 값: `PROVISIONING` \$1 `READY` \$1 `FAILED` \$1 `TIMEOUT` \$1 `STOPPING` \$1 `STOPPED`).

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

  세션 중 표시되는 오류 메시지입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  세션에 대한 설명입니다.
+ `Role` – 과 일치하는 UTF-8 문자열입니다(20\$12,048바이트).)[Custom string pattern #30](aws-glue-api-common.md#regex_30).

  세션과 연결된 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `Command` – [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand) 객체입니다.

  명령 객체입니다. SessionCommand를 참조하세요.
+ `DefaultArguments` – 75개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 UTF-8 문자열(4,096바이트 이하)입니다.

  키-값 페어의 맵 배열입니다. 최대 75페어입니다.
+ `Connections` – [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  세션에 사용되는 연결 수입니다.
+ `Progress` - 숫자(double)입니다.

  세션의 코드 실행 진행률입니다.
+ `MaxCapacity` - 숫자(double)입니다.

  작업이 실행될 때 할당할 수 있는 AWS Glue 데이터 처리 단위(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 용량과 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다.
+ `SecurityConfiguration` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  세션과 함께 사용할 SecurityConfiguration 구조의 이름입니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  AWS Glue 버전은 AWS Glue가 지원하는 Apache Spark 및 Python 버전을 결정합니다. GlueVersion은 2.0보다 커야 합니다.
+ `DataAccessId` – UTF-8 문자열입니다(1\$136바이트 이하)

  세션의 데이터 액세스 ID입니다.
+ `PartitionId` – UTF-8 문자열입니다(1\$136바이트 이하)

  세션의 파티션 ID입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  세션에 사용할 정의된 `WorkerType`의 작업자 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  세션이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 세션에 대해 `G.1X`, `G.2X`, `G.4X` 또는 `G.8X`의 값을 허용합니다. Ray 세션에 대해 `Z.2X`의 값을 허용합니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 세션이 완료된 날짜 및 시간입니다.
+ `ExecutionTime` - 숫자(double)입니다.

  세션이 실행된 총 시간입니다.
+ `DPUSeconds` - 숫자(double)입니다.

  세션에서 소비된 DPU입니다(공식: ExecutionTime \$1 MaxCapacity).
+ `IdleTimeout` - 숫자(정수)입니다.

  세션 시간이 초과되기까지 유휴 상태의 시간(분)입니다.
+ `ProfileName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  세션과 연결된 AWS Glue 사용 프로필의 이름입니다.

## SessionCommand 구조
<a name="aws-glue-api-interactive-sessions-SessionCommand"></a>

작업을 실행하는 `SessionCommand`입니다.

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

  SessionCommand의 이름을 지정합니다. 'glueetl' 또는 'gluestreaming'일 수 있습니다.
+ `PythonVersion` – 과(와) 일치하는 UTF-8 문자열입니다..[Custom string pattern #49](aws-glue-api-common.md#regex_49)

  Python 버전을 지정합니다. Python의 버전으로 Spark 유형의 작업에 대해 지원되는 버전을 확인할 수 있습니다.

## 명령문 구조
<a name="aws-glue-api-interactive-sessions-Statement"></a>

세션에서 발생할 특정 작업에 대한 명령문 또는 요청입니다.

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

  문의 ID입니다.
+ `Code` – UTF-8 문자열입니다.

  문의 실행 코드입니다.
+ `State` – UTF-8 문자열입니다(유효 값: `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`).

  요청이 실행되는 동안의 상태입니다.
+ `Output` – [StatementOutput](#aws-glue-api-interactive-sessions-StatementOutput) 객체입니다.

  JSON의 출력입니다.
+ `Progress` - 숫자(double)입니다.

  코드 실행 진행률입니다.
+ `StartedOn` - 숫자(정수)입니다.

  작업 정의가 시작된 Unix 시간 및 날짜입니다.
+ `CompletedOn` - 숫자(정수)입니다.

  작업 정의가 완료된 Unix 시간 및 날짜입니다.

## StatementOutput 구조
<a name="aws-glue-api-interactive-sessions-StatementOutput"></a>

JSON 형식의 코드 실행 출력입니다.

**Fields**
+ `Data` – [StatementOutputData](#aws-glue-api-interactive-sessions-StatementOutputData) 객체입니다.

  코드 실행 출력입니다.
+ `ExecutionCount` - 숫자(정수)입니다.

  출력의 실행 수입니다.
+ `Status` – UTF-8 문자열입니다(유효 값: `WAITING` \$1 `RUNNING` \$1 `AVAILABLE` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `ERROR`).

  코드 실행 출력의 상태입니다.
+ `ErrorName` – UTF-8 문자열입니다.

  출력의 오류 이름입니다.
+ `ErrorValue` – UTF-8 문자열입니다.

  출력의 오류 값입니다.
+ `Traceback` – UTF-8 문자열의 배열입니다.

  출력의 트레이스백입니다.

## StatementOutputData 구조
<a name="aws-glue-api-interactive-sessions-StatementOutputData"></a>

JSON 형식의 코드 실행 출력입니다.

**Fields**
+ `TextPlain` – UTF-8 문자열입니다.

  텍스트 형식의 코드 실행 출력입니다.

## ConnectionsList 구조
<a name="aws-glue-api-interactive-sessions-ConnectionsList"></a>

작업이 사용한 연결을 지정합니다.

**Fields**
+ `Connections` – 1,000개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  작업이 사용한 연결 목록입니다.

## 작업
<a name="aws-glue-api-interactive-sessions-actions"></a>
+ [CreateSession 작업(Python: create\$1session)](#aws-glue-api-interactive-sessions-CreateSession)
+ [StopSession 작업(Python: stop\$1session)](#aws-glue-api-interactive-sessions-StopSession)
+ [DeleteSession 작업(Python: delete\$1session)](#aws-glue-api-interactive-sessions-DeleteSession)
+ [GetSession 작업(Python: get\$1session)](#aws-glue-api-interactive-sessions-GetSession)
+ [ListSessions 작업(Python: list\$1sessions)](#aws-glue-api-interactive-sessions-ListSessions)
+ [RunStatement 작업(Python: run\$1statement)](#aws-glue-api-interactive-sessions-RunStatement)
+ [CancelStatement 작업(Python: cancel\$1statement)](#aws-glue-api-interactive-sessions-CancelStatement)
+ [GetStatement 작업(Python: get\$1statement)](#aws-glue-api-interactive-sessions-GetStatement)
+ [ListStatements 작업(Python: list\$1statements)](#aws-glue-api-interactive-sessions-ListStatements)
+ [GetGlueIdentityCenterConfiguration 작업(Python: get\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration)
+ [UpdateGlueIdentityCenterConfiguration 작업(Python: update\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration)
+ [CreateGlueIdentityCenterConfiguration 작업(Python: create\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration)
+ [DeleteGlueIdentityCenterConfiguration 작업(Python: delete\$1glue\$1identity\$1center\$1configuration)](#aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration)

## CreateSession 작업(Python: create\$1session)
<a name="aws-glue-api-interactive-sessions-CreateSession"></a>

새 세션을 생성합니다.

**요청**

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

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

  세션에 대한 설명입니다.
+ `Role` – *필수:* [Custom string pattern #30](aws-glue-api-common.md#regex_30)과 일치하는 UTF-8 문자열입니다(20\$12,048바이트).

  IAM 역할 ARN 
+ `Command` – **필수(Required): [SessionCommand](#aws-glue-api-interactive-sessions-SessionCommand) 객체입니다.

  작업을 실행하는 `SessionCommand`입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

   세션 시간이 초과되기 전 경과되는 시간(분)입니다. Spark ETL 작업의 기본값은 48시간(2,880분)입니다. 다른 작업 유형에 대해서는 설명서를 참조하세요.
+ `IdleTimeout` – 1 이상의 숫자(정수)입니다.

   세션 시간이 초과되기까지 유휴 상태의 시간(초)입니다. Spark ETL 작업의 기본값은 시간 제한 값입니다. 다른 작업 유형에 대해서는 설명서를 참조하세요.
+ `DefaultArguments` – 75개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 UTF-8 문자열(4,096바이트 이하)입니다.

  키-값 페어의 맵 배열입니다. 최대 75페어입니다.
+ `Connections` – [ConnectionsList](#aws-glue-api-interactive-sessions-ConnectionsList) 객체입니다.

  세션에 사용할 연결 수입니다.
+ `MaxCapacity` - 숫자(double)입니다.

  작업이 실행될 때 할당할 수 있는 AWS Glue 데이터 처리 단위(DPU) 수입니다. DPU는 4 vCPU의 컴퓨팅 용량과 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  세션에 사용할 정의된 `WorkerType`의 작업자 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  작업이 실행될 때 할당되는 미리 정의된 작업자 유형입니다. Spark 작업에 대해 G.1X, G.2X, G.4X 또는 G.8X의 값을 허용합니다. Ray 노트북에 대해 Z.2X 값을 허용합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 94GB의 디스크가 있는 1DPU(4개의 vCPU, 16GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 138GB의 디스크가 있는 2DPU(8개의 vCPU, 32GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 대부분의 작업을 실행할 수 있는 확장 가능하고 비용 효율적인 방법을 제공하기 위해 데이터 변환, 조인, 쿼리와 같은 워크로드에서 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.4X` 작업자 유형의 경우, 각 작업자가 256GB의 디스크가 있는 4DPU(16개의 vCPU, 64GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 미국 동부(오하이오), 미국 동부(버지니아 북부), 미국 서부(오레곤), 아시아 태평양(싱가포르), 아시아 태평양(시드니), 아시아 태평양(도쿄), 캐나다(중부), 유럽(프랑크푸르트), 유럽(아일랜드), 유럽(스톡홀름)과 같은AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `G.8X` 작업자 유형의 경우, 각 작업자가 512GB의 디스크가 있는 8DPU(32개의 vCPU, 128GB 메모리)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 워크로드에 가장 까다로운 변환, 집계, 조인 및 쿼리가 포함된 작업에서 이 작업자 유형을 사용하는 것이 좋습니다. 이 작업자 유형은 `G.4X` 작업자 유형에 지원되는 동일한 AWS 리전에서 AWS Glue 버전 3.0 이상 Spark ETL 작업에 대해서만 사용할 수 있습니다.
  + `Z.2X` 작업자 유형의 경우, 각 작업자는 128GB 디스크에서 2개의 M-DPU(vCPU 8개, 메모리 64GB)에 매핑되고, Autoscaler에 따라 최대 8개의 Ray 작업자를 제공합니다.
+ `SecurityConfiguration` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  세션과 함께 사용할 SecurityConfiguration 구조의 이름입니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  AWS Glue 버전은 AWS Glue가 지원하는 Apache Spark 및 Python 버전을 결정합니다. GlueVersion은 2.0보다 커야 합니다.
+ `DataAccessId` – UTF-8 문자열입니다(1\$136바이트 이하)

  세션의 데이터 액세스 ID입니다.
+ `PartitionId` – UTF-8 문자열입니다(1\$136바이트 이하)

  세션의 파티션 ID입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  세션에 속하는 키 값 페어(태그)의 맵입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

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

  세션과 연결된 AWS Glue 사용 프로필의 이름입니다.

**응답**
+ `Session` – [세션](#aws-glue-api-interactive-sessions-Session) 객체입니다.

  응답으로 세션 객체를 반환합니다.

**오류**
+ `AccessDeniedException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`

## StopSession 작업(Python: stop\$1session)
<a name="aws-glue-api-interactive-sessions-StopSession"></a>

세션을 중지합니다.

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

  중지할 세션의 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  요청의 오리진입니다.

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

  중지된 세션의 ID를 반환합니다.

**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## DeleteSession 작업(Python: delete\$1session)
<a name="aws-glue-api-interactive-sessions-DeleteSession"></a>

세션을 삭제합니다.

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

  삭제되는 세션의 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  세션 삭제 요청의 오리진 이름입니다.

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

  삭제된 세션의 ID를 반환합니다.

**오류**
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `IllegalSessionStateException`
+ `ConcurrentModificationException`

## GetSession 작업(Python: get\$1session)
<a name="aws-glue-api-interactive-sessions-GetSession"></a>

세션을 검색합니다.

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

  세션의 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  요청의 오리진입니다.

**응답**
+ `Session` – [세션](#aws-glue-api-interactive-sessions-Session) 객체입니다.

  세션 객체가 응답으로 반환됩니다.

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

## ListSessions 작업(Python: list\$1sessions)
<a name="aws-glue-api-interactive-sessions-ListSessions"></a>

세션 목록을 검색합니다.

**요청**
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  다음 결과 세트를 가져오기 위한 토큰이지만 결과가 더 없는 경우에는 null 값을 갖습니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  최대 결과 수입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  세션에 속한 태그입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  요청의 오리진입니다.

**응답**
+ `Ids` – UTF-8 문자열의 배열입니다.

  세션의 ID를 반환합니다.
+ `Sessions` – [세션](#aws-glue-api-interactive-sessions-Session) 객체의 배열입니다.

  세션 객체를 반환합니다.
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  다음 결과 세트를 가져오기 위한 토큰이지만 결과가 더 없는 경우에는 null 값을 갖습니다.

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

## RunStatement 작업(Python: run\$1statement)
<a name="aws-glue-api-interactive-sessions-RunStatement"></a>

문을 실행합니다.

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

  실행할 문의 세션 ID입니다.
+ `Code` – *필수:* UTF-8 문자열입니다(68,000바이트 이하).

  실행할 문 코드입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  요청의 오리진입니다.

**응답**
+ `Id` - 숫자(정수)입니다.

  실행된 문의 ID를 반환합니다.

**오류**
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`
+ `IllegalSessionStateException`

## CancelStatement 작업(Python: cancel\$1statement)
<a name="aws-glue-api-interactive-sessions-CancelStatement"></a>

문을 취소합니다.

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

  취소할 문의 세션 ID입니다.
+ `Id` – **필수(Required): 숫자(정수)입니다.

  취소할 문의 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  문 취소 요청의 오리진입니다.

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

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

## GetStatement 작업(Python: get\$1statement)
<a name="aws-glue-api-interactive-sessions-GetStatement"></a>

문을 검색합니다.

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

  문의 세션 ID입니다.
+ `Id` – **필수(Required): 숫자(정수)입니다.

  문의 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  요청의 오리진입니다.

**응답**
+ `Statement` – [문](#aws-glue-api-interactive-sessions-Statement) 객체입니다.

  문을 반환합니다.

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

## ListStatements 작업(Python: list\$1statements)
<a name="aws-glue-api-interactive-sessions-ListStatements"></a>

세션에 대한 문을 나열합니다.

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

  문의 세션 ID입니다.
+ `RequestOrigin` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #31](aws-glue-api-common.md#regex_31)

  문 나열 요청의 오리진입니다.
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `Statements` – [문](#aws-glue-api-interactive-sessions-Statement) 객체의 배열입니다.

  문 목록을 반환합니다.
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  모든 문이 아직 반환되지 않은 경우의 지속 토큰입니다.

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

## GetGlueIdentityCenterConfiguration 작업(Python: get\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-GetGlueIdentityCenterConfiguration"></a>

연결된 Identity Center 인스턴스 및 애플리케이션 정보를 포함하여 현재 AWS Glue Identity Center 구성 세부 정보를 검색합니다.

**요청**
+ *요청 파라미터가 없습니다.*

**응답**

AWS Glue Identity Center 구성 세부 정보가 포함된 응답.
+ `ApplicationArn` – UTF-8 문자열입니다(10\$11,224바이트).

  AWS Glue 구성과 연결된 Identity Center 애플리케이션의 Amazon 리소스 이름(ARN).
+ `InstanceArn` – UTF-8 문자열입니다(10\$11,224바이트).

  AWS Glue 구성과 연결된 Identity Center 인스턴스의 Amazon 리소스 이름(ARN).
+ `Scopes` – UTF-8 문자열의 배열입니다.

  AWS Glue 구성에 대한 권한 및 액세스 수준을 정의하는 Identity Center 범위 목록.

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

## UpdateGlueIdentityCenterConfiguration 작업(Python: update\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-UpdateGlueIdentityCenterConfiguration"></a>

통합에 대한 범위 및 권한을 수정할 수 있도록 기존 AWS Glue Identity Center 구성을 업데이트합니다.

**요청**

기존 AWS Glue Identity Center 구성 업데이트를 요청합니다.
+ `Scopes` – UTF-8 문자열의 배열입니다(1\$150개 문자열).

  AWS Glue 구성에 대한 업데이트된 권한 및 액세스 수준을 정의하는 Identity Center 범위 목록.

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

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

## CreateGlueIdentityCenterConfiguration 작업(Python: create\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-CreateGlueIdentityCenterConfiguration"></a>

인증 및 권한 부여를 위해 AWS Glue와 AWS IAM Identity Center 간의 통합을 활성화하는 새 AWS Glue Identity Center 구성을 생성합니다.

**요청**

새 AWS Glue Identity Center 구성 생성을 요청합니다.
+ `InstanceArn` – *필수:* 10\$11,224바이트 길이의 UTF-8 문자열입니다.

  AWS Glue 구성과 연결될 Identity Center 인스턴스의 Amazon 리소스 이름(ARN).
+ `Scopes` – UTF-8 문자열의 배열입니다(1\$150개 문자열).

  AWS Glue 구성에 대한 권한 및 액세스 수준을 정의하는 Identity Center 범위 목록.

**응답**

새 AWS Glue Identity Center 구성 생성의 응답.
+ `ApplicationArn` – UTF-8 문자열입니다(10\$11,224바이트).

  AWS Glue 구성에 대해 생성된 Identity Center 애플리케이션의 Amazon 리소스 이름(ARN).

**오류**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `AccessDeniedException`
+ `ConcurrentModificationException`

## DeleteGlueIdentityCenterConfiguration 작업(Python: delete\$1glue\$1identity\$1center\$1configuration)
<a name="aws-glue-api-interactive-sessions-DeleteGlueIdentityCenterConfiguration"></a>

기존 AWS Glue Identity Center 구성을 삭제하여 AWS Glue와 AWS IAM Identity Center 간의 통합을 제거합니다.

**요청**
+ *요청 파라미터가 없습니다.*

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

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

# 개발 엔드포인트 API
<a name="aws-glue-api-dev-endpoint"></a>

개발 엔드포인트 API는 사용자 지정 DevEndpoint를 사용한 테스트와 관련된 AWS Glue API에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-dev-endpoint-objects"></a>
+ [DevEndpoint 구조](#aws-glue-api-dev-endpoint-DevEndpoint)
+ [DevEndpointCustomLibraries 구조](#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries)

## DevEndpoint 구조
<a name="aws-glue-api-dev-endpoint-DevEndpoint"></a>

개발자가 원격으로 ETL(추출, 변환 및 로드) 스크립트를 디버그할 수 있는 개발 엔드포인트입니다.

**Fields**
+ `EndpointName` – UTF-8 문자열입니다.

  `DevEndpoint`의 이름입니다.
+ `RoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id)

  이 `DevEndpoint`에 사용되는 IAM 역할의 Amazon 리소스 이름(ARN)입니다.
+ `SecurityGroupIds` – UTF-8 문자열의 배열입니다.

  이 `DevEndpoint`에 사용된 보안 그룹 식별자 목록입니다.
+ `SubnetId` – UTF-8 문자열입니다.

  이 `DevEndpoint`에 대한 서브넷 ID입니다.
+ `YarnEndpointAddress` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 사용하는 YARN 엔드포인트 주소입니다.
+ `PrivateAddress` – UTF-8 문자열입니다.

  `DevEndpoint`가 하나의 VPC에 생성되었다면 VPC 내 `DevEndpoint`에 액세스할 수 있는 프라이빗 IP 주소입니다. `PrivateAddress` 필드는 VPC 내에 `DevEndpoint`를 생성할 때만 표시됩니다.
+ `ZeppelinRemoteSparkInterpreterPort` - 숫자(정수)입니다.

  원격 Apache Spark 인터프리터용 Apache Zeppelin 포트입니다.
+ `PublicAddress` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 사용하는 퍼블릭 IP 주소입니다. `PublicAddress` 필드는 비Virtual Private Cloud(VPC) `DevEndpoint`를 생성할 때만 표시됩니다.
+ `Status` – UTF-8 문자열입니다.

  이 `DevEndpoint`의 현재 상태입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  개발 엔드포인트로 할당되는 미리 정의된 작업자 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 1DPU(4vCPU, 16GB 메모리, 64GB 디스크)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 작업의 경우 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 2DPU(8vCPU, 32GB 메모리, 128GB 디스크)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 작업의 경우 이 작업자 유형을 사용하는 것이 좋습니다.

  알려진 문제: 개발 엔드포인트가 `G.2X` `WorkerType` 구성으로 만들어질 경우 개발 엔드포인트의 Spark 드라이버가 4 vCPU, 16GB 메모리 및 64GB 디스크에서 실행됩니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  Glue 버전에 따라AWS Glue에서 지원하는 Apache Spark와 Python의 버전이 정해집니다. Python 버전은 개발 엔드포인트에서 ETL 스크립트를 실행하기 위해 지원되는 버전을 나타냅니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 개발 엔드포인트는 Glue 0.9로 기본 지정됩니다.

  `Arguments` 또는 `CreateDevEndpoint` API의 `UpdateDevEndpoint` 파라미터를 사용하여 개발 엔드포인트에 지원되는 Python 버전을 지정할 수 있습니다. 인수가 제공되지 않으면 버전은 기본적으로 Python 2입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  개발 엔드포인트로 할당되는 정의된 `workerType`의 작업자 수입니다.

  정의할 수 있는 최대 작업자 수는 `G.1X`의 경우 299개, `G.2X`의 경우 149개입니다.
+ `NumberOfNodes` - 숫자(정수)입니다.

  이 `DevEndpoint`에 할당된 AWS Glue Glue 데이터 처리 장치(DPU) 수입니다.
+ `AvailabilityZone` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 위치한 AWS 가용 영역입니다.
+ `VpcId` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 사용한 Virtual Private Cloud(VPC)의 ID입니다.
+ `ExtraPythonLibsS3Path` – UTF-8 문자열입니다.

  `DevEndpoint`에서 로드되어야 할 Amazon S3 버킷에 있는 하나 이상의 Python 라이브러리에 대한 경로입니다. 여러 값은 쉼표(,)로 구분된 완전한 경로여야 합니다.
**참고**  
`DevEndpoint`에서는 순수 Python 라이브러리만 사용할 수 있습니다. [pandas](http://pandas.pydata.org/) Python 데이터 분석 라이브러리 등 C 확장을 활용하는 라이브러리는 현재 지원되지 않습니다.
+ `ExtraJarsS3Path` – UTF-8 문자열입니다.

  `.jar`에서 로드되어야 할 S3 버킷에 있는 하나 이상의 Java `DevEndpoint` 파일에 대한 경로입니다.
**참고**  
`DevEndpoint`에서는 순수 Java/Scala 라이브러리만 사용할 수 있습니다.
+ `FailureReason` – UTF-8 문자열입니다.

  이 `DevEndpoint`의 현재 실패 이유입니다.
+ `LastUpdateStatus` – UTF-8 문자열입니다.

  마지막 업데이트의 상태입니다.
+ `CreatedTimestamp` – 타임스탬프입니다.

  이 DevEndpoint가 생성된 시점.
+ `LastModifiedTimestamp` – 타임스탬프입니다.

  이 `DevEndpoint`가 마지막으로 수정된 시점.
+ `PublicKey` – UTF-8 문자열입니다.

  인증용으로 이 `DevEndpoint`에서 사용될 퍼블릭 키입니다. 사용할 권장 속성이 퍼블릭 키이므로 이전 버전과의 호환성을 위해 이 속성이 제공됩니다.
+ `PublicKeys` – 5개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  인증용으로 `DevEndpoints`에서 사용될 퍼블릭 키 목록입니다. 퍼블릭 키를 사용하면 클라이언트마다 다른 프라이빗 키를 지정할 수 있으므로 이 속성의 사용이 단일 퍼블릭 키보다 우선됩니다.
**참고**  
이전에 퍼블릭 키로 엔드포인트를 생성한 경우, 퍼블릭 키 목록을 설정할 수 있으려면 해당 키를 제거해야 합니다. `UpdateDevEndpoint` 속성의 퍼블릭 키 콘텐츠와 `deletePublicKeys` 속성의 새 키 목록을 사용하여 `addPublicKeys` API를 호출하십시오.
+ `SecurityConfiguration` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 `SecurityConfiguration`에 사용할 `DevEndpoint` 구조의 이름입니다.
+ `Arguments` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  `DevEndpoint` 구성에 사용되는 인수의 맵입니다.

  유효한 인수는 다음과 같습니다.
  + `"--enable-glue-datacatalog": ""`

  `Arguments` 또는 `CreateDevEndpoint` API의 `UpdateDevEndpoint` 파라미터를 사용하여 개발 엔드포인트에 지원되는 Python 버전을 지정할 수 있습니다. 인수가 제공되지 않으면 버전은 기본적으로 Python 2입니다.

## DevEndpointCustomLibraries 구조
<a name="aws-glue-api-dev-endpoint-DevEndpointCustomLibraries"></a>

개발 엔드포인트에 로드될 사용자 지정 라이브러리입니다.

**Fields**
+ `ExtraPythonLibsS3Path` – UTF-8 문자열입니다.

  `DevEndpoint`에서 로드되어야 할 Amazon Simple Storage Service(Amazon S3) 버킷에 있는 하나 이상의 Python 라이브러리에 대한 경로입니다. 여러 값은 쉼표(,)로 구분된 완전한 경로여야 합니다.
**참고**  
`DevEndpoint`에서는 순수 Python 라이브러리만 사용할 수 있습니다. [pandas](http://pandas.pydata.org/) Python 데이터 분석 라이브러리 등 C 확장을 활용하는 라이브러리는 현재 지원되지 않습니다.
+ `ExtraJarsS3Path` – UTF-8 문자열입니다.

  `.jar`에서 로드되어야 할 S3 버킷에 있는 하나 이상의 Java `DevEndpoint` 파일에 대한 경로입니다.
**참고**  
`DevEndpoint`에서는 순수 Java/Scala 라이브러리만 사용할 수 있습니다.

## 작업
<a name="aws-glue-api-dev-endpoint-actions"></a>
+ [CreateDevEndpoint 작업(Python: create\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-CreateDevEndpoint)
+ [UpdateDevEndpoint 작업(Python: update\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-UpdateDevEndpoint)
+ [DeleteDevEndpoint 작업(Python: delete\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-DeleteDevEndpoint)
+ [GetDevEndpoint 작업(Python: get\$1dev\$1endpoint)](#aws-glue-api-dev-endpoint-GetDevEndpoint)
+ [GetDevEndpoints 작업(Python: get\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-GetDevEndpoints)
+ [BatchGetDevEndpoints 작업(Python: batch\$1get\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-BatchGetDevEndpoints)
+ [ListDevEndpoints 작업(Python: list\$1dev\$1endpoints)](#aws-glue-api-dev-endpoint-ListDevEndpoints)

## CreateDevEndpoint 작업(Python: create\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-CreateDevEndpoint"></a>

새 개발 엔드포인트를 생성합니다.

**요청**
+ `EndpointName` – *필수(Required):* UTF-8 문자열입니다.

  새 `DevEndpoint`에 지정된 이름입니다.
+ `RoleArn` – *필수(Required):* [AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id)과(와) 일치하는 UTF-8 문자열입니다.

  `DevEndpoint`의 IAM 역할입니다.
+ `SecurityGroupIds` – UTF-8 문자열의 배열입니다.

  새로운 `DevEndpoint`가 사용할 보안 그룹의 보안 그룹 ID입니다.
+ `SubnetId` – UTF-8 문자열입니다.

  사용할 새 `DevEndpoint`의 서브넷 ID입니다.
+ `PublicKey` – UTF-8 문자열입니다.

  인증용으로 이 `DevEndpoint`에서 사용될 퍼블릭 키입니다. 사용할 권장 속성이 퍼블릭 키이므로 이전 버전과의 호환성을 위해 이 속성이 제공됩니다.
+ `PublicKeys` – 5개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  인증용으로 개발 엔드포인트에서 사용될 퍼블릭 키 목록입니다. 퍼블릭 키를 사용하면 클라이언트마다 다른 프라이빗 키를 지정할 수 있으므로 이 속성의 사용이 단일 퍼블릭 키보다 우선됩니다.
**참고**  
이전에 퍼블릭 키로 엔드포인트를 생성한 경우, 퍼블릭 키 목록을 설정할 수 있으려면 해당 키를 제거해야 합니다. `UpdateDevEndpoint` 속성의 퍼블릭 키 콘텐츠와 `deletePublicKeys` 속성의 새 키 목록을 사용하여 `addPublicKeys` API를 호출하십시오.
+ `NumberOfNodes` - 숫자(정수)입니다.

  이 `DevEndpoint`에 할당할 AWS Glue 데이터 처리 장치(DPU) 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  개발 엔드포인트로 할당되는 미리 정의된 작업자 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 1DPU(4vCPU, 16GB 메모리, 64GB 디스크)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 작업의 경우 이 작업자 유형을 사용하는 것이 좋습니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 2DPU(8vCPU, 32GB 메모리, 128GB 디스크)에 매핑되고, 작업자당 실행기 1개를 제공합니다. 메모리 집약적인 작업의 경우 이 작업자 유형을 사용하는 것이 좋습니다.

  알려진 문제: 개발 엔드포인트가 `G.2X` `WorkerType` 구성으로 만들어질 경우 개발 엔드포인트의 Spark 드라이버가 4 vCPU, 16GB 메모리 및 64GB 디스크에서 실행됩니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  Glue 버전에 따라AWS Glue에서 지원하는 Apache Spark와 Python의 버전이 정해집니다. Python 버전은 개발 엔드포인트에서 ETL 스크립트를 실행하기 위해 지원되는 버전을 나타냅니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.

  Glue 버전 지정 없이 생성된 개발 엔드포인트는 Glue 0.9로 기본 지정됩니다.

  `Arguments` 또는 `CreateDevEndpoint` API의 `UpdateDevEndpoint` 파라미터를 사용하여 개발 엔드포인트에 지원되는 Python 버전을 지정할 수 있습니다. 인수가 제공되지 않으면 버전은 기본적으로 Python 2입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  개발 엔드포인트로 할당되는 정의된 `workerType`의 작업자 수입니다.

  정의할 수 있는 최대 작업자 수는 `G.1X`의 경우 299개, `G.2X`의 경우 149개입니다.
+ `ExtraPythonLibsS3Path` – UTF-8 문자열입니다.

  `DevEndpoint`에서 로드되어야 할 Amazon S3 버킷에 있는 하나 이상의 Python 라이브러리에 대한 경로입니다. 여러 값은 쉼표(,)로 구분된 완전한 경로여야 합니다.
**참고**  
`DevEndpoint`에서는 순수 Python 라이브러리만 사용할 수 있습니다. [pandas](http://pandas.pydata.org/) Python 데이터 분석 라이브러리 등 C 확장을 활용하는 라이브러리는 아직 지원되지 않습니다.
+ `ExtraJarsS3Path` – UTF-8 문자열입니다.

  `.jar`에서 로드되어야 할 S3 버킷에 있는 하나 이상의 Java `DevEndpoint` 파일에 대한 경로입니다.
+ `SecurityConfiguration` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 `SecurityConfiguration`에 사용할 `DevEndpoint` 구조의 이름입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 DevEndpoint에서 사용할 태그입니다. 태그를 사용하여 DevEndpoint에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `Arguments` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  `DevEndpoint` 구성에 사용되는 인수의 맵입니다.

**응답**
+ `EndpointName` – UTF-8 문자열입니다.

  새로운 `DevEndpoint`에 할당된 이름입니다.
+ `Status` – UTF-8 문자열입니다.

  새 `DevEndpoint`의 현재 상태입니다.
+ `SecurityGroupIds` – UTF-8 문자열의 배열입니다.

  새로운 `DevEndpoint`에 지정된 보안 그룹입니다.
+ `SubnetId` – UTF-8 문자열입니다.

  새로운 `DevEndpoint`에 지정된 서브넷 ID입니다.
+ `RoleArn` – 과(와) 일치하는 UTF-8 문자열입니다..[AWS IAM ARN string pattern](aws-glue-api-common.md#aws-glue-api-regex-aws-iam-arn-id)

  새로운 `DevEndpoint`에 할당된 역할의 Amazon 리소스 이름(ARN)입니다.
+ `YarnEndpointAddress` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 사용하는 YARN 엔드포인트 주소입니다.
+ `ZeppelinRemoteSparkInterpreterPort` - 숫자(정수)입니다.

  원격 Apache Spark 인터프리터용 Apache Zeppelin 포트입니다.
+ `NumberOfNodes` - 숫자(정수)입니다.

  이 DevEndpoint에 할당된 AWS Glue 데이터 처리 장치(DPU) 수입니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  개발 엔드포인트로 할당되는 미리 정의된 작업자 유형입니다. Standard, G.1X 또는 G.2X 값일 수 있습니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  Glue 버전에 따라AWS Glue에서 지원하는 Apache Spark와 Python의 버전이 정해집니다. Python 버전은 개발 엔드포인트에서 ETL 스크립트를 실행하기 위해 지원되는 버전을 나타냅니다.

  이용 가능한 AWS Glue 버전과 그에 상응하는 Spark 및 Python 버전에 대한 자세한 내용은 개발자 안내서의 [Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/add-job.html)을 참조하세요.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  개발 엔드포인트로 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `AvailabilityZone` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 위치한 AWS 가용 영역입니다.
+ `VpcId` – UTF-8 문자열입니다.

  이 `DevEndpoint`가 사용한 Virtual Private Cloud(VPC)의 ID입니다.
+ `ExtraPythonLibsS3Path` – UTF-8 문자열입니다.

  `DevEndpoint`에서 로드되는 S3 버킷에 있는 하나 이상의 Python 라이브러리에 대한 경로입니다.
+ `ExtraJarsS3Path` – UTF-8 문자열입니다.

  `.jar`에서 로드되는 S3 버킷에 있는 하나 이상의 Java `DevEndpoint`에 대한 경로입니다.
+ `FailureReason` – UTF-8 문자열입니다.

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

  이 `SecurityConfiguration`에 사용 중인 `DevEndpoint` 구조의 이름입니다.
+ `CreatedTimestamp` – 타임스탬프입니다.

  이 `DevEndpoint`가 생성된 시점입니다.
+ `Arguments` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 `DevEndpoint`를 구성하는 데 사용되는 인수의 맵입니다.

  유효한 인수는 다음과 같습니다.
  + `"--enable-glue-datacatalog": ""`

  `Arguments` 또는 `CreateDevEndpoint` API의 `UpdateDevEndpoint` 파라미터를 사용하여 개발 엔드포인트에 지원되는 Python 버전을 지정할 수 있습니다. 인수가 제공되지 않으면 버전은 기본적으로 Python 2입니다.

**오류**
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `InvalidInputException`
+ `ValidationException`
+ `ResourceNumberLimitExceededException`

## UpdateDevEndpoint 작업(Python: update\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-UpdateDevEndpoint"></a>

지정한 개발 엔드포인트를 업데이트합니다.

**요청**
+ `EndpointName` – *필수(Required):* UTF-8 문자열입니다.

  업데이트할 `DevEndpoint`의 이름입니다.
+ `PublicKey` – UTF-8 문자열입니다.

  사용할 `DevEndpoint`의 퍼블릭 키입니다.
+ `AddPublicKeys` – 5개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  사용할 `DevEndpoint`의 퍼블릭 키 목록입니다.
+ `DeletePublicKeys` – 5개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  `DevEndpoint`에서 삭제할 퍼블릭 키 목록입니다.
+ `CustomLibraries` – [DevEndpointCustomLibraries](#aws-glue-api-dev-endpoint-DevEndpointCustomLibraries) 객체입니다.

  이 `DevEndpoint`에 로드될 사용자 지정 Python 또는 Java 라이브러리입니다.
+ `UpdateEtlLibraries` – 부울입니다.

  개발 엔드포인트에 로드될 사용자 지정 라이브러리 목록을 업데이트해야 하면 `True`이고 그렇지 않으면 `False`입니다.
+ `DeleteArguments` – UTF-8 문자열의 배열입니다.

  `DevEndpoint` 구성에 사용되는 인수의 맵에서 삭제할 인수 키의 목록입니다.
+ `AddArguments` – 100개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  `DevEndpoint` 구성에 사용되는 인수의 맵을 추가하기 위한 인수의 맵입니다.

  유효한 인수는 다음과 같습니다.
  + `"--enable-glue-datacatalog": ""`

  `Arguments` 또는 `CreateDevEndpoint` API의 `UpdateDevEndpoint` 파라미터를 사용하여 개발 엔드포인트에 지원되는 Python 버전을 지정할 수 있습니다. 인수가 제공되지 않으면 버전은 기본적으로 Python 2입니다.

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

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

## DeleteDevEndpoint 작업(Python: delete\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-DeleteDevEndpoint"></a>

지정한 개발 엔드포인트를 삭제합니다.

**요청**
+ `EndpointName` – *필수(Required):* UTF-8 문자열입니다.

  `DevEndpoint`의 이름입니다.

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

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

## GetDevEndpoint 작업(Python: get\$1dev\$1endpoint)
<a name="aws-glue-api-dev-endpoint-GetDevEndpoint"></a>

지정된 개발 엔드포인트에 대한 정보를 가져옵니다.

**참고**  
Virtual Private Cloud(VPC)에서 개발 엔드포인트를 생성하면, AWS Glue은(는) 프라이빗 IP 주소만 반환하며 퍼블릭 IP 주소 필드는 입력되지 않습니다. 비 VPC 개발 엔드포인트를 생성할 때 AWS Glue은(는) 퍼블릭 IP 주소만 반환합니다.

**요청**
+ `EndpointName` – *필수(Required):* UTF-8 문자열입니다.

  정보를 검색할 `DevEndpoint`의 이름입니다.

**응답**
+ `DevEndpoint` – [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint) 객체입니다.

  `DevEndpoint` 정의입니다.

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

## GetDevEndpoints 작업(Python: get\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-GetDevEndpoints"></a>

이 AWS 계정에서 모든 개발 엔드포인트를 검색합니다.

**참고**  
Virtual Private Cloud(VPC)에서 개발 엔드포인트를 생성하면, AWS Glue는 프라이빗 IP 주소만 반환하며 퍼블릭 IP 주소 필드는 입력되지 않습니다. 비 VPC 개발 엔드포인트를 생성할 때 AWS Glue은(는) 퍼블릭 IP 주소만 반환합니다.

**요청**
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 정보의 최대 크기.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `DevEndpoints` – [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint) 객체의 배열입니다.

  `DevEndpoint` 정의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  모든 `DevEndpoint` 정의가 아직 반환되지 않은 경우의 지속 토큰입니다.

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

## BatchGetDevEndpoints 작업(Python: batch\$1get\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-BatchGetDevEndpoints"></a>

주어진 개발 엔드포인트 이름 목록에 대한 리소스 메타데이터 목록을 반환합니다. `ListDevEndpoints` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

**요청**
+ `customerAccountId` – UTF-8 문자열입니다.

  AWS 계정 ID입니다.
+ `DevEndpointNames` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다.

  `DevEndpoint` 이름(`ListDevEndpoint` 작업에서 반환된 이름일 수 있음)의 목록입니다.

**응답**
+ `DevEndpoints` – [DevEndpoint](#aws-glue-api-dev-endpoint-DevEndpoint) 객체의 배열입니다.

  `DevEndpoint` 정의 목록입니다.
+ `DevEndpointsNotFound` – 1\$125개 문자열로 구성된 UTF-8 문자열의 배열입니다.

  찾을 수 없는 `DevEndpoints` 목록입니다.

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

## ListDevEndpoints 작업(Python: list\$1dev\$1endpoints)
<a name="aws-glue-api-dev-endpoint-ListDevEndpoints"></a>

이 AWS 계정의 모든 `DevEndpoint` 리소스 또는 지정된 태그를 가진 리소스의 이름을 검색합니다. 이 작업을 통해 계정에서 사용 가능한 리소스와 그 이름을 확인할 수 있습니다.

이 작업을 수행하면 응답에서 필터로 사용할 수 있는 선택 사항인 `Tags` 필드가 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

**응답**
+ `DevEndpointNames` – UTF-8 문자열의 배열입니다.

  계정의 모든 `DevEndpoint` 또는 지정된 태그를 가진 `DevEndpoint`의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

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

# Schema Registry
<a name="aws-glue-api-schema-registry-api"></a>

스키마 레지스트리 API는 AWS Glue에서의 스키마 작업과 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-schema-registry-api-objects"></a>
+ [RegistryId 구조](#aws-glue-api-schema-registry-api-RegistryId)
+ [RegistryListItem 구조](#aws-glue-api-schema-registry-api-RegistryListItem)
+ [MetadataInfo 구조](#aws-glue-api-schema-registry-api-MetadataInfo)
+ [OtherMetadataValueListItem 구조](#aws-glue-api-schema-registry-api-OtherMetadataValueListItem)
+ [SchemaListItem 구조](#aws-glue-api-schema-registry-api-SchemaListItem)
+ [SchemaVersionListItem 구조](#aws-glue-api-schema-registry-api-SchemaVersionListItem)
+ [MetadataKeyValuePair 구조](#aws-glue-api-schema-registry-api-MetadataKeyValuePair)
+ [SchemaVersionErrorItem 구조](#aws-glue-api-schema-registry-api-SchemaVersionErrorItem)
+ [ErrorDetails 구조](#aws-glue-api-schema-registry-api-ErrorDetails)
+ [SchemaVersionNumber 구조](#aws-glue-api-schema-registry-api-SchemaVersionNumber)
+ [SchemaId 구조](#aws-glue-api-schema-registry-api-SchemaId)

## RegistryId 구조
<a name="aws-glue-api-schema-registry-api-RegistryId"></a>

레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

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

  레지스트리의 이름입니다. 조회에만 사용됩니다. `RegistryArn` 또는 `RegistryName` 중 하나가 제공되어야 합니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  업데이트할 레지스트리의 ARN입니다. `RegistryArn` 또는 `RegistryName` 중 하나가 제공되어야 합니다.

## RegistryListItem 구조
<a name="aws-glue-api-schema-registry-api-RegistryListItem"></a>

레지스트리에 대한 세부 정보를 포함하는 구조입니다.

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

  레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  레지스트리에 대한 설명입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `DELETING`).

  레지스트리의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  레지스트리가 생성된 데이터입니다.
+ `UpdatedTime` – UTF-8 문자열입니다.

  레지스트리가 업데이트된 날짜입니다.

## MetadataInfo 구조
<a name="aws-glue-api-schema-registry-api-MetadataInfo"></a>

스키마 버전에 대한 메타데이터 정보를 포함하는 구조입니다.

**Fields**
+ `MetadataValue` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키의 해당하는 값입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  항목이 생성된 시간입니다.
+ `OtherMetadataValueList` – [OtherMetadataValueListItem](#aws-glue-api-schema-registry-api-OtherMetadataValueListItem) 객체의 배열입니다.

  동일한 메타데이터 키에 속하는 다른 메타데이터입니다.

## OtherMetadataValueListItem 구조
<a name="aws-glue-api-schema-registry-api-OtherMetadataValueListItem"></a>

동일한 메타데이터 키에 속하는 스키마 버전에 대한 다른 메타데이터를 포함하는 구조입니다.

**Fields**
+ `MetadataValue` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  동일한 메타데이터 키에 속하는 스키마 버전에 대한 다른 메타데이터를 포함하는 구조입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  항목이 생성된 시간입니다.

## SchemaListItem 구조
<a name="aws-glue-api-schema-registry-api-SchemaListItem"></a>

스키마에 대한 최소한의 세부 정보를 포함하는 객체입니다.

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

  스키마가 있는 레지스트리의 이름입니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  스키마에 대한 설명입니다.
+ `SchemaStatus` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  스키마의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  스키마가 생성된 날짜 및 시간입니다.
+ `UpdatedTime` – UTF-8 문자열입니다.

  스키마가 업데이트된 날짜 및 시간입니다.

## SchemaVersionListItem 구조
<a name="aws-glue-api-schema-registry-api-SchemaVersionListItem"></a>

스키마 버전에 대한 세부 정보를 포함하는 객체입니다.

**Fields**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN).
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 식별자입니다.
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  스키마 버전의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  스키마 버전이 생성된 날짜 및 시간입니다.

## MetadataKeyValuePair 구조
<a name="aws-glue-api-schema-registry-api-MetadataKeyValuePair"></a>

메타데이터에 대한 키 값 페어를 포함하는 구조입니다.

**Fields**
+ `MetadataKey` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키입니다.
+ `MetadataValue` – 과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키의 해당하는 값입니다.

## SchemaVersionErrorItem 구조
<a name="aws-glue-api-schema-registry-api-SchemaVersionErrorItem"></a>

스키마 버전에 대한 작업에 대한 오류 세부 정보가 포함된 객체입니다.

**Fields**
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.
+ `ErrorDetails` – [ErrorDetails](#aws-glue-api-schema-registry-api-ErrorDetails) 객체입니다.

  스키마 버전에 대한 오류 세부 정보입니다.

## ErrorDetails 구조
<a name="aws-glue-api-schema-registry-api-ErrorDetails"></a>

오류 세부 정보가 포함된 객체입니다.

**Fields**
+ `ErrorCode` – UTF-8 문자열입니다.

  오류에 대한 오류 코드입니다.
+ `ErrorMessage` – UTF-8 문자열입니다.

  오류에 대한 오류 메시지입니다.

## SchemaVersionNumber 구조
<a name="aws-glue-api-schema-registry-api-SchemaVersionNumber"></a>

스키마 버전 정보를 포함하는 구조입니다.

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

  스키마에 사용할 수 있는 최신 버전입니다.
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

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

## SchemaId 구조
<a name="aws-glue-api-schema-registry-api-SchemaId"></a>

AWS Glue 스키마 레지스트리에 있는 스키마의 고유 ID입니다.

**Fields**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN). `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  해당 스키마가 포함된 스키마 레지스트리의 이름입니다.

## 작업
<a name="aws-glue-api-schema-registry-api-actions"></a>
+ [CreateRegistry 작업(Python: create\$1registry)](#aws-glue-api-schema-registry-api-CreateRegistry)
+ [CreateSchema 작업(Python: create\$1schema)](#aws-glue-api-schema-registry-api-CreateSchema)
+ [GetSchema 작업(Python: get\$1schema)](#aws-glue-api-schema-registry-api-GetSchema)
+ [ListSchemaVersions 작업(Python: list\$1schema\$1versions)](#aws-glue-api-schema-registry-api-ListSchemaVersions)
+ [GetSchemaVersion 작업(Python: get\$1schema\$1version)](#aws-glue-api-schema-registry-api-GetSchemaVersion)
+ [GetSchemaVersionsDiff 작업(Python: get\$1schema\$1versions\$1diff)](#aws-glue-api-schema-registry-api-GetSchemaVersionsDiff)
+ [ListRegistries 작업(Python: list\$1registries)](#aws-glue-api-schema-registry-api-ListRegistries)
+ [ListSchemas 작업(Python: list\$1schemas)](#aws-glue-api-schema-registry-api-ListSchemas)
+ [RegisterSchemaVersion 작업(Python: register\$1schema\$1version)](#aws-glue-api-schema-registry-api-RegisterSchemaVersion)
+ [UpdateSchema 작업(Python: update\$1schema)](#aws-glue-api-schema-registry-api-UpdateSchema)
+ [CheckSchemaVersionValidity 작업(Python: check\$1schema\$1version\$1validity)](#aws-glue-api-schema-registry-api-CheckSchemaVersionValidity)
+ [UpdateRegistry 작업(Python: update\$1registry)](#aws-glue-api-schema-registry-api-UpdateRegistry)
+ [GetSchemaByDefinition 작업(Python: get\$1schema\$1by\$1definition)](#aws-glue-api-schema-registry-api-GetSchemaByDefinition)
+ [GetRegistry 작업(Python: get\$1registry)](#aws-glue-api-schema-registry-api-GetRegistry)
+ [PutSchemaVersionMetadata 작업(Python: put\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-PutSchemaVersionMetadata)
+ [QuerySchemaVersionMetadata 작업(Python: query\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata)
+ [RemoveSchemaVersionMetadata 작업(Python: remove\$1schema\$1version\$1metadata)](#aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata)
+ [DeleteRegistry 작업(Python: delete\$1registry)](#aws-glue-api-schema-registry-api-DeleteRegistry)
+ [DeleteSchema 작업(Python: delete\$1schema)](#aws-glue-api-schema-registry-api-DeleteSchema)
+ [DeleteSchemaVersions 작업(Python: delete\$1schema\$1versions)](#aws-glue-api-schema-registry-api-DeleteSchemaVersions)

## CreateRegistry 작업(Python: create\$1registry)
<a name="aws-glue-api-schema-registry-api-CreateRegistry"></a>

스키마 컬렉션을 보유하는 데 사용할 수 있는 새 레지스트리를 생성합니다.

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

  레지스트리 이름은 최대 255자이며 문자, 숫자, 하이픈, 밑줄, 달러 기호 또는 해시 표시만 포함할 수 있습니다. 공백은 없습니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  레지스트리에 대한 설명입니다. 설명이 제공되지 않으면 이에 대한 기본값이 없습니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  AWS키 값 페어가 포함된 태그이며 콘솔, 명령줄 또는 API로 검색할 수 있습니다.

**응답**
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  새로 생성된 레지스트리의 Amazon 리소스 이름(ARN)입니다.
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

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

  레지스트리에 대한 설명입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  레지스트리에 대한 태그입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## CreateSchema 작업(Python: create\$1schema)
<a name="aws-glue-api-schema-registry-api-CreateSchema"></a>

새 스키마 집합을 생성하고 스키마 정의를 등록합니다. 실제로 버전을 등록하지 않고 스키마 집합이 이미 존재하는 경우 오류를 반환합니다.

스키마 집합이 생성되면 버전 체크포인트가 첫 번째 버전으로 설정됩니다. 호환성 모드 "DISABLED"는 첫 번째 스키마 버전 이후에 추가되는 모든 추가 스키마 버전을 제한합니다. 다른 모든 호환성 모드의 경우 호환성 설정의 검증은 `RegisterSchemaVersion` API를 사용할 때 두 번째 버전부터만 적용됩니다.

이 API가 `RegistryId` 없이 호출되면 레지스트리 데이터베이스 테이블에 "default-registry" 항목이 생성됩니다(아직 없는 경우).

**요청**
+ `RegistryId` – [RegistryId](#aws-glue-api-schema-registry-api-RegistryId) 객체입니다.

   이것은 레지스트리 자격 증명 필드를 포함하는 래퍼 셰이프입니다. 제공되지 않으면 기본 레지스트리가 사용됩니다. 동일한 ARN 포맷은 `arn:aws:glue:us-east-2:<customer id>:registry/default-registry:random-5-letter-id`입니다.
+ `SchemaName` – *필수(Required):* [Custom string pattern #46](aws-glue-api-common.md#regex_46)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  스키마 이름은 최대 255자이며 문자, 숫자, 하이픈, 밑줄, 달러 기호 또는 해시 표시만 포함할 수 있습니다. 공백은 없습니다.
+ `DataFormat` – *필수:* UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `Compatibility` – UTF-8 문자열입니다(유효한 값: `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  스키마의 호환성 모드입니다. 가능한 값은 다음과 같습니다.
  +  *NONE*: 호환 모드가 적용되지 않습니다. 개발 시나리오에서 또는 스키마에 적용할 호환성 모드를 모르는 경우 이 선택 사항을 사용할 수 있습니다. 추가된 모든 새 버전은 호환성 검사를 거치지 않고 수락됩니다.
  +  *DISABLED*: 이 호환성 선택 항목은 특정 스키마에 대한 버전 관리를 방지합니다. 이 선택 사항을 사용하여 스키마의 향후 버전 관리를 방지할 수 있습니다.
  +  *BACKWARD*: 이 호환성 선택 항목은 데이터 수신자가 현재 및 하나의 이전 스키마 버전을 모두 읽을 수 있도록 하므로 권장됩니다. 즉, 예를 들어 새 스키마 버전은 데이터 필드를 삭제하거나 이러한 필드의 유형을 변경할 수 없으므로 이전 버전을 사용하는 리더가 읽을 수 없습니다.
  +  *BACKWARD\$1ALL*: 이 호환성 선택을 통해 데이터 수신자는 현재 및 모든 이전 스키마 버전을 모두 읽을 수 있습니다. 필드를 삭제하거나 선택적 필드를 추가하고 모든 이전 스키마 버전과의 호환성을 확인해야 할 때 이 선택 사항을 사용할 수 있습니다.
  +  *FORWARD*: 이 호환성 선택을 통해 데이터 수신기는 현재 및 하나의 다음 스키마 버전을 모두 읽을 수 있지만 반드시 이후 버전은 아닙니다. 필드를 추가하거나 선택적 필드를 삭제해야 할 때 이 선택 사항을 사용할 수 있지만 마지막 스키마 버전과의 호환성만 확인합니다.
  +  *FORWARD\$1ALL*: 이 호환성 선택을 통해 데이터 수신기는 새로 등록된 스키마의 생산자가 작성한 내용을 읽을 수 있습니다. 필드를 추가하거나 선택적 필드를 삭제하고 모든 이전 스키마 버전과의 호환성을 확인해야 할 때 이 선택 사항을 사용할 수 있습니다.
  +  *FULL*: 이 호환성 선택을 통해 데이터 수신자는 이전 또는 다음 버전의 스키마를 사용하여 생산자가 작성한 데이터를 읽을 수 있지만 반드시 이전 또는 이후 버전은 아닙니다. 선택적 필드를 추가하거나 제거해야 할 때 이 선택 사항을 사용할 수 있지만 마지막 스키마 버전과의 호환성만 확인합니다.
  +  *FULL\$1ALL*: 이 호환성 선택을 통해 데이터 수신자는 모든 이전 스키마 버전을 사용하여 생산자가 작성한 데이터를 읽을 수 있습니다. 선택적 필드를 추가 또는 제거하고 모든 이전 스키마 버전과의 호환성을 확인해야 할 때 이 선택 사항을 사용할 수 있습니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  스키마에 대한 설명입니다(선택 사항). 설명이 제공되지 않으면 이에 대한 자동 기본값이 없습니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  AWS키 값 페어가 포함된 태그이며 콘솔, 명령줄 또는 API로 검색할 수 있습니다. 지정된 경우AWS tags-on-create 패턴을 따릅니다.
+ `SchemaDefinition` – 과(와) 일치하는 1\$1170,000바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #13](aws-glue-api-common.md#regex_13)

  `DataFormat`에 대해 `SchemaName` 설정을 사용하는 스키마 정의입니다.

**응답**
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  레지스트리의 Amazon 리소스 이름(ARN)입니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  스키마에 대한 설명입니다(생성 시 지정한 경우).
+ `DataFormat` – UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `Compatibility` – UTF-8 문자열입니다(유효한 값: `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  스키마 호환성 모드입니다.
+ `SchemaCheckpoint` - 1\$1100,000의 숫자(정수)입니다.

  체크포인트의 버전 번호(호환성 모드가 마지막으로 변경된 시간)입니다.
+ `LatestSchemaVersion` - 1\$1100,000의 숫자(정수)입니다.

  반환된 스키마 정의와 연결된 스키마의 최신 버전입니다.
+ `NextSchemaVersion` - 1\$1100,000의 숫자(정수)입니다.

  반환된 스키마 정의와 연결된 스키마의 다음 버전입니다.
+ `SchemaStatus` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  스키마의 상태입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  스키마의 태그입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  첫 번째 스키마 버전의 고유 식별자입니다.
+ `SchemaVersionStatus` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  생성된 첫 번째 스키마 버전의 상태입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchema 작업(Python: get\$1schema)
<a name="aws-glue-api-schema-registry-api-GetSchema"></a>

지정된 스키마를 자세히 설명합니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.

**응답**
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  레지스트리의 Amazon 리소스 이름(ARN)입니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  스키마에 대한 설명입니다(생성 시 지정한 경우).
+ `DataFormat` – UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `Compatibility` – UTF-8 문자열입니다(유효한 값: `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  스키마의 호환성 모드입니다.
+ `SchemaCheckpoint` - 1\$1100,000의 숫자(정수)입니다.

  체크포인트의 버전 번호(호환성 모드가 마지막으로 변경된 시간)입니다.
+ `LatestSchemaVersion` - 1\$1100,000의 숫자(정수)입니다.

  반환된 스키마 정의와 연결된 스키마의 최신 버전입니다.
+ `NextSchemaVersion` - 1\$1100,000의 숫자(정수)입니다.

  반환된 스키마 정의와 연결된 스키마의 다음 버전입니다.
+ `SchemaStatus` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  스키마의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  스키마가 생성된 날짜 및 시간입니다.
+ `UpdatedTime` – UTF-8 문자열입니다.

  스키마가 업데이트된 날짜 및 시간입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListSchemaVersions 작업(Python: list\$1schema\$1versions)
<a name="aws-glue-api-schema-registry-api-ListSchemaVersions"></a>

최소한의 정보로 생성한 스키마 버전 목록을 반환합니다. [삭제됨(Deleted)] 상태의 스키마 버전은 결과에 포함되지 않습니다. 사용 가능한 스키마 버전이 없으면 빈 결과가 반환됩니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

  페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `Schemas` – [SchemaVersionListItem](#aws-glue-api-schema-registry-api-SchemaVersionListItem) 객체의 배열입니다.

  각 스키마 버전의 세부 정보를 포함하는 `SchemaVersionList` 객체의 배열입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaVersion 작업(Python: get\$1schema\$1version)
<a name="aws-glue-api-schema-registry-api-GetSchemaVersion"></a>

스키마 버전을 생성하거나 등록할 때 할당된 고유 ID로 지정된 스키마를 가져옵니다. [삭제됨(Deleted)] 상태의 스키마 버전은 결과에 포함되지 않습니다.

**요청**
+ `SchemaId` – [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 `SchemaVersionId`입니다. 이 필드는 스키마 ID로 가져오기 위해 필요합니다. 이것 또는 `SchemaId` 래퍼를 제공해야 합니다.
+ `SchemaVersionNumber` – [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

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

**응답**
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 `SchemaVersionId`입니다.
+ `SchemaDefinition` – 과(와) 일치하는 1\$1170,000바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #13](aws-glue-api-common.md#regex_13)

  스키마 ID에 대한 스키마 정의입니다.
+ `DataFormat` – UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN).
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  스키마 버전의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  스키마 버전이 생성된 날짜 및 시간입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaVersionsDiff 작업(Python: get\$1schema\$1versions\$1diff)
<a name="aws-glue-api-schema-registry-api-GetSchemaVersionsDiff"></a>

Schema Registry에 저장된 두 스키마 버전 간에 지정된 차이 유형의 스키마 버전 차이를 가져옵니다.

이 API를 사용하면 동일한 스키마 아래의 두 스키마 정의 간에 두 스키마 버전을 비교할 수 있습니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
+ `FirstSchemaVersionNumber` – *필수(Required):* [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  비교할 두 스키마 버전 중 첫 번째 버전입니다.
+ `SecondSchemaVersionNumber` – *필수(Required):* [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  비교할 두 스키마 버전 중 두 번째 버전입니다.
+ `SchemaDiffType` – *필수:* UTF-8 문자열입니다(유효한 값: `SYNTAX_DIFF`).

  현재 지원되는 diff 유형인 `SYNTAX_DIFF`를 나타냅니다.

**응답**
+ `Diff` – 과(와) 일치하는 1\$1340,000바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #13](aws-glue-api-common.md#regex_13)

  JsonPatch 포맷의 문자열로 스키마 간의 차이점입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListRegistries 작업(Python: list\$1registries)
<a name="aws-glue-api-schema-registry-api-ListRegistries"></a>

최소한의 레지스트리 정보로 생성한 레지스트리 목록을 반환합니다. `Deleting` 상태의 레지스트리는 결과에 포함되지 않습니다. 사용 가능한 레지스트리가 없으면 빈 결과가 반환됩니다.

**요청**
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

  페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `Registries` – [RegistryListItem](#aws-glue-api-schema-registry-api-RegistryListItem) 객체의 배열입니다.

  각 레지스트리에 대한 최소한의 세부 정보를 포함하는 `RegistryDetailedListItem` 객체의 배열입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## ListSchemas 작업(Python: list\$1schemas)
<a name="aws-glue-api-schema-registry-api-ListSchemas"></a>

최소한의 세부 정보가 포함된 스키마 목록을 반환합니다. [삭제 중(Deleting)] 상태의 스키마는 결과에 포함되지 않습니다. 사용 가능한 스키마가 없으면 빈 결과가 반환됩니다.

`RegistryId`가 제공되지 않으면 레지스트리 전체의 모든 스키마가 API 응답의 일부가 됩니다.

**요청**
+ `RegistryId` – [RegistryId](#aws-glue-api-schema-registry-api-RegistryId) 객체입니다.

  레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.
+ `MaxResults` – 1\$1100의 숫자(정수)입니다.

  페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `Schemas` – [SchemaListItem](#aws-glue-api-schema-registry-api-SchemaListItem) 객체의 배열입니다.

  각 스키마의 세부 정보를 포함하는 `SchemaListItem` 객체의 배열입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## RegisterSchemaVersion 작업(Python: register\$1schema\$1version)
<a name="aws-glue-api-schema-registry-api-RegisterSchemaVersion"></a>

기존 스키마에 새 버전을 추가합니다. 새 버전의 스키마가 스키마 집합의 호환성 요구 사항을 충족하지 않는 경우 오류를 반환합니다. 이 API는 새 스키마 집합을 생성하지 않으며 스키마 집합이 Schema Registry에 아직 없는 경우 404 오류를 반환합니다.

이것이 Schema Registry에 등록되는 첫 번째 스키마 정의인 경우 이 API는 스키마 버전을 저장하고 즉시 반환합니다. 그렇지 않으면 이 호출은 호환성 모드로 인해 다른 작업보다 더 오래 실행될 가능성이 있습니다. `SchemaVersionId`로 `GetSchemaVersion` API를 호출하여 호환 모드를 확인할 수 있습니다.

동일한 스키마 정의가 이미 Schema Registry에 버전으로 저장되어 있는 경우 기존 스키마의 스키마 ID가 호출자에게 반환됩니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 및 `RegistryName`이 제공되어야 합니다.
+ `SchemaDefinition` – *필수(Required):* [Custom string pattern #13](aws-glue-api-common.md#regex_13)과(와) 일치하는 1\$1170,000바이트 길이의 UTF-8 문자열입니다.

  `SchemaName`에 대해 `DataFormat` 설정을 사용하는 스키마 정의입니다.

**응답**
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  이 스키마의 버전을 나타내는 고유 ID입니다.
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  이 스키마의 버전입니다(동기화 흐름 전용, 이것이 첫 번째 버전인 경우).
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  스키마 버전의 상태입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ResourceNumberLimitExceededException`
+ `ThrottlingException`
+ `ConcurrentModificationException`
+ `InternalServiceException`

## UpdateSchema 작업(Python: update\$1schema)
<a name="aws-glue-api-schema-registry-api-UpdateSchema"></a>

스키마 집합에 대한 설명, 호환성 설정 또는 버전 검사점을 업데이트합니다.

호환성 설정을 업데이트하기 위해 호출은 새 호환성 설정을 사용하여 전체 스키마 버전 집합에 대한 호환성을 확인하지 않습니다. `Compatibility` 값이 제공되면 `VersionNumber`(체크포인트)도 필요합니다. API는 일관성을 위해 체크포인트 버전 번호를 검증합니다.

`VersionNumber`(체크포인트) 값이 제공되면 `Compatibility`는 선택 사항이며 스키마에 대한 검사점을 설정/재설정하는 데 사용할 수 있습니다.

이 업데이트는 스키마가 AVAILABLE 상태인 경우에만 발생합니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
+ `SchemaVersionNumber` – [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  체크 포인팅에 필요한 버전 번호입니다. `VersionNumber` 또는 `Compatibility` 중 하나가 제공되어야 합니다.
+ `Compatibility` – UTF-8 문자열입니다(유효한 값: `NONE` \$1 `DISABLED` \$1 `BACKWARD` \$1 `BACKWARD_ALL` \$1 `FORWARD` \$1 `FORWARD_ALL` \$1 `FULL` \$1 `FULL_ALL`).

  스키마에 대한 새 호환성 설정입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  스키마에 대한 새 설명입니다.

**응답**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN).
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  해당 스키마가 포함된 레지스트리의 이름입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## CheckSchemaVersionValidity 작업(Python: check\$1schema\$1version\$1validity)
<a name="aws-glue-api-schema-registry-api-CheckSchemaVersionValidity"></a>

제공된 스키마를 검증합니다. 이 호출은 부작용이 없으며 단순히 `DataFormat`을 포맷으로 사용하여 제공된 스키마를 사용하여 검증합니다. 스키마 집합 이름을 사용하지 않으므로 호환성 검사가 수행되지 않습니다.

**요청**
+ `DataFormat` – *필수:* UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `SchemaDefinition` – *필수(Required):* [Custom string pattern #13](aws-glue-api-common.md#regex_13)과(와) 일치하는 1\$1170,000바이트 길이의 UTF-8 문자열입니다.

  검증해야 하는 스키마의 정의입니다.

**응답**
+ `Valid` – 부울입니다.

  스키마가 유효하면 true를 반환하고 그렇지 않으면 false를 반환합니다.
+ `Error` – 1\$15,000바이트 길이의 UTF-8 문자열입니다.

  검증 실패 메시지입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `InternalServiceException`

## UpdateRegistry 작업(Python: update\$1registry)
<a name="aws-glue-api-schema-registry-api-UpdateRegistry"></a>

스키마 컬렉션을 보유하는 데 사용되는 기존 레지스트리를 업데이트합니다. 업데이트된 속성은 레지스트리와 관련되며 레지스트리 내의 스키마를 수정하지 않습니다.

**요청**
+ `RegistryId` – *필수(Required):* [RegistryId](#aws-glue-api-schema-registry-api-RegistryId) 객체입니다.

  이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.
+ `Description` – *필수(Required):* [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  레지스트리에 대한 설명입니다. 설명이 제공되지 않으면 이 필드는 업데이트되지 않습니다.

**응답**
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  업데이트된 레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  업데이트된 레지스트리의 Amazon 리소스 이름(ARN)입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ConcurrentModificationException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetSchemaByDefinition 작업(Python: get\$1schema\$1by\$1definition)
<a name="aws-glue-api-schema-registry-api-GetSchemaByDefinition"></a>

`SchemaDefinition`으로 스키마를 검색합니다. 스키마 정의는 Schema Registry로 전송되고 정규화되고 해시됩니다. 해시가 `SchemaName` 또는 ARN의 범위 내에서 일치하는 경우(또는 제공되지 않은 경우 기본 레지스트리) 해당 스키마의 메타데이터가 반환됩니다. 그렇지 않으면 404 또는 NotFound 오류가 반환됩니다. `Deleted` 상태의 스키마 버전은 결과에 포함되지 않습니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 자격 증명 필드를 포함하는 래퍼 구조입니다. 구조에는 다음이 포함됩니다.
  + SchemaId\$1SchemaArn: 스키마의 Amazon 리소스 이름(ARN)입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
  + SchemaId\$1SchemaName: 스키마의 이름입니다. `SchemaArn` 또는 `SchemaName` 중 하나가 제공되어야 합니다.
+ `SchemaDefinition` – *필수(Required):* [Custom string pattern #13](aws-glue-api-common.md#regex_13)과(와) 일치하는 1\$1170,000바이트 길이의 UTF-8 문자열입니다.

  스키마 세부 정보가 필요한 스키마의 정의입니다.

**응답**
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 스키마 ID입니다.
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN).
+ `DataFormat` – UTF-8 문자열입니다(유효한 값: `AVRO` \$1 `JSON` \$1 `PROTOBUF`).

  스키마 정의의 데이터 형식입니다. 현재 `AVRO`, `JSON` 및 `PROTOBUF`가 지원됩니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `FAILURE` \$1 `DELETING`).

  스키마 버전의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  스키마가 생성된 날짜 및 시간입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## GetRegistry 작업(Python: get\$1registry)
<a name="aws-glue-api-schema-registry-api-GetRegistry"></a>

지정된 레지스트리를 자세히 설명합니다.

**요청**
+ `RegistryId` – *필수(Required):* [RegistryId](#aws-glue-api-schema-registry-api-RegistryId) 객체입니다.

  이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

**응답**
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

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

  레지스트리에 대한 설명입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `DELETING`).

  레지스트리의 상태입니다.
+ `CreatedTime` – UTF-8 문자열입니다.

  레지스트리가 생성된 날짜 및 시간입니다.
+ `UpdatedTime` – UTF-8 문자열입니다.

  레지스트리가 업데이트된 날짜 및 시간입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `InternalServiceException`

## PutSchemaVersionMetadata 작업(Python: put\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-PutSchemaVersionMetadata"></a>

지정된 스키마 버전 ID에 대한 메타데이터 키 값 페어를 넣습니다. 스키마 버전당 최대 10개의 키 값 페어가 허용됩니다. 하나 이상의 호출을 통해 추가할 수 있습니다.

**요청**
+ `SchemaId` – [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마의 고유 ID입니다.
+ `SchemaVersionNumber` – [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  스키마의 버전 번호입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 버전 ID입니다.
+ `MetadataKeyValue` – *필수(Required):* [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair) 객체입니다.

  메타데이터 키의 해당하는 값입니다.

**응답**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN)입니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  레지스트리의 이름입니다.
+ `LatestVersion` – 부울입니다.

  스키마의 최신 버전입니다.
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 버전 ID입니다.
+ `MetadataKey` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키입니다.
+ `MetadataValue` –과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키의 값입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `EntityNotFoundException`
+ `ThrottlingException`
+ `ResourceNumberLimitExceededException`

## QuerySchemaVersionMetadata 작업(Python: query\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-QuerySchemaVersionMetadata"></a>

스키마 버전 메타데이터 정보에 대한 쿼리입니다.

**요청**
+ `SchemaId` – [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.
+ `SchemaVersionNumber` – [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  스키마의 버전 번호입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 버전 ID입니다.
+ `MetadataList` – [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair) 객체의 배열입니다.

  메타데이터에 대한 키-값 페어를 검색합니다. 제공되지 않으면 모든 메타데이터 정보를 가져옵니다.
+ `MaxResults` – 1\$150의 숫자(정수)입니다.

  페이지당 필요한 최대 결과 수입니다. 값이 제공되지 않으면 페이지당 기본값이 25로 설정됩니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰입니다.

**응답**
+ `MetadataInfoMap` – 키-값 페어의 맵 배열입니다.

  각 키는 [Custom string pattern #14](aws-glue-api-common.md#regex_14)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  각 값은 [MetadataInfo](#aws-glue-api-schema-registry-api-MetadataInfo) 객체입니다.

  메타데이터 키 및 관련 값의 맵입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 버전 ID입니다.
+ `NextToken` – UTF-8 문자열입니다.

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

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `EntityNotFoundException`

## RemoveSchemaVersionMetadata 작업(Python: remove\$1schema\$1version\$1metadata)
<a name="aws-glue-api-schema-registry-api-RemoveSchemaVersionMetadata"></a>

지정된 스키마 버전 ID에 대한 스키마 버전 메타데이터에서 키 값 페어를 제거합니다.

**요청**
+ `SchemaId` – [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.
+ `SchemaVersionNumber` – [SchemaVersionNumber](#aws-glue-api-schema-registry-api-SchemaVersionNumber) 객체입니다.

  스키마의 버전 번호입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전의 고유한 버전 ID입니다.
+ `MetadataKeyValue` – *필수(Required):* [MetadataKeyValuePair](#aws-glue-api-schema-registry-api-MetadataKeyValuePair) 객체입니다.

  메타데이터 키의 값입니다.

**응답**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  스키마의 Amazon 리소스 이름(ARN).
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  스키마의 이름입니다.
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  레지스트리의 이름입니다.
+ `LatestVersion` – 부울입니다.

  스키마의 최신 버전입니다.
+ `VersionNumber` - 1\$1100,000의 숫자(정수)입니다.

  스키마의 버전 번호입니다.
+ `SchemaVersionId` – 과(와) 일치하는 36바이트 이상 길이의 UTF-8 문자열입니다..[Custom string pattern #45](aws-glue-api-common.md#regex_45)

  스키마 버전에 대한 버전 ID입니다.
+ `MetadataKey` – 과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키입니다.
+ `MetadataValue` –과(와) 일치하는 1\$1256바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #14](aws-glue-api-common.md#regex_14)

  메타데이터 키의 값입니다.

**오류**
+ `InvalidInputException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `EntityNotFoundException`

## DeleteRegistry 작업(Python: delete\$1registry)
<a name="aws-glue-api-schema-registry-api-DeleteRegistry"></a>

스키마와 모든 해당 버전을 포함한 전체 레지스트리를 삭제합니다. 삭제 작업의 상태를 얻으려면 비동기 호출 후 `GetRegistry` API를 호출할 수 있습니다. 레지스트리를 삭제하면 `UpdateRegistry`, `CreateSchema`, `UpdateSchema` 및 `RegisterSchemaVersion` API와 같은 레지스트리에 대한 모든 온라인 작업이 비활성화됩니다.

**요청**
+ `RegistryId` – *필수(Required):* [RegistryId](#aws-glue-api-schema-registry-api-RegistryId) 객체입니다.

  이는 레지스트리 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

**응답**
+ `RegistryName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  삭제되는 레지스트리의 이름입니다.
+ `RegistryArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  삭제 중인 레지스트리의 Amazon 리소스 이름(ARN)입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `DELETING`).

  레지스트리의 상태입니다. 작업이 성공하면 `Deleting` 상태가 반환됩니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

## DeleteSchema 작업(Python: delete\$1schema)
<a name="aws-glue-api-schema-registry-api-DeleteSchema"></a>

스키마 집합 및 모든 해당 버전을 포함하여 전체 스키마 집합을 삭제합니다. 삭제 작업의 상태를 얻으려면 비동기 호출 후 `GetSchema` API를 호출할 수 있습니다. 레지스트리를 삭제하면 `GetSchemaByDefinition` 및 `RegisterSchemaVersion` API와 같은 스키마에 대한 모든 온라인 작업이 비활성화됩니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  이는 스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.

**응답**
+ `SchemaArn` – 과(와) 일치하는 1\$110,240바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #50](aws-glue-api-common.md#regex_50)

  삭제 중인 스키마의 Amazon 리소스 이름(ARN)입니다.
+ `SchemaName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #46](aws-glue-api-common.md#regex_46)

  삭제 중인 스키마의 이름입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `AVAILABLE` \$1 `PENDING` \$1 `DELETING`).

  스키마의 상태입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

## DeleteSchemaVersions 작업(Python: delete\$1schema\$1versions)
<a name="aws-glue-api-schema-registry-api-DeleteSchemaVersions"></a>

지정된 스키마에서 버전을 제거합니다. 버전 번호 또는 범위가 제공될 수 있습니다. 호환 모드가 BACKWARDS\$1FULL과 같이 필요한 버전의 삭제를 금지하는 경우 오류가 반환됩니다. 이 호출 후 `GetSchemaVersions` API를 호출하면 삭제된 버전의 상태가 나열됩니다.

버전 번호 범위에 체크포인트 버전이 포함된 경우 API는 409 충돌을 반환하고 삭제를 진행하지 않습니다. 이 API를 사용하기 전에 먼저 `DeleteSchemaCheckpoint` API를 사용하여 체크포인트를 제거해야 합니다.

`DeleteSchemaVersions` API를 사용하여 스키마 집합의 첫 번째 스키마 버전을 삭제할 수 없습니다. 첫 번째 스키마 버전은 `DeleteSchema` API로만 삭제할 수 있습니다. 이 작업은 스키마 버전 아래에 첨부된 `SchemaVersionMetadata`도 삭제합니다. 영구 삭제는 데이터베이스에 적용됩니다.

호환 모드가 BACKWARDS\$1FULL과 같이 필요한 버전의 삭제를 금지하는 경우 오류가 반환됩니다.

**요청**
+ `SchemaId` – *필수(Required):* [SchemaId](#aws-glue-api-schema-registry-api-SchemaId) 객체입니다.

  이는 스키마 이름과 Amazon 리소스 이름(ARN)을 포함할 수 있는 래퍼 구조입니다.
+ `Versions` – *필수(Required):* [Custom string pattern #15](aws-glue-api-common.md#regex_15)과(와) 일치하는 1\$1100,000바이트 길이의 UTF-8 문자열입니다.

  다음 포맷의 버전 범위가 제공될 수 있습니다.
  + 단일 버전 번호, 5
  + 범위, 5\$18 : 버전 5, 6, 7, 8을 삭제합니다.

**응답**
+ `SchemaVersionErrors` – [SchemaVersionErrorItem](#aws-glue-api-schema-registry-api-SchemaVersionErrorItem) 객체의 배열입니다.

  각각 오류 및 스키마 버전을 포함하는 `SchemaVersionErrorItem` 객체 목록입니다.

**오류**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `AccessDeniedException`
+ `ThrottlingException`
+ `ConcurrentModificationException`

# 워크플로
<a name="aws-glue-api-workflow"></a>

 워크플로 API는 AWS Glue에서의 워크플로 생성, 업데이트 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다.

## 데이터 타입
<a name="aws-glue-api-workflow-objects"></a>
+ [JobNodeDetails 구조](#aws-glue-api-workflow-JobNodeDetails)
+ [CrawlerNodeDetails 구조](#aws-glue-api-workflow-CrawlerNodeDetails)
+ [TriggerNodeDetails 구조](#aws-glue-api-workflow-TriggerNodeDetails)
+ [크롤 구조](#aws-glue-api-workflow-Crawl)
+ [노드 구조](#aws-glue-api-workflow-Node)
+ [엣지 구조](#aws-glue-api-workflow-Edge)
+ [워크플루 구조](#aws-glue-api-workflow-Workflow)
+ [WorkflowGraph 구조](#aws-glue-api-workflow-WorkflowGraph)
+ [WorkflowRun 구조](#aws-glue-api-workflow-WorkflowRun)
+ [WorkflowRunStatistics 구조](#aws-glue-api-workflow-WorkflowRunStatistics)
+ [StartingEventBatchCondition 구조](#aws-glue-api-workflow-StartingEventBatchCondition)
+ [블루프린트 구조](#aws-glue-api-workflow-Blueprint)
+ [BlueprintDetails 구조](#aws-glue-api-workflow-BlueprintDetails)
+ [LastActiveDefinition 구조](#aws-glue-api-workflow-LastActiveDefinition)
+ [BlueprintRun 구조](#aws-glue-api-workflow-BlueprintRun)

## JobNodeDetails 구조
<a name="aws-glue-api-workflow-JobNodeDetails"></a>

워크플로에 있는 작업 노드의 세부 정보입니다.

**필드**
+ `JobRuns` – [JobRun](aws-glue-api-jobs-runs.md#aws-glue-api-jobs-runs-JobRun) 객체의 배열입니다.

  작업 노드가 나타내는 작업 실행에 대한 정보입니다.

## CrawlerNodeDetails 구조
<a name="aws-glue-api-workflow-CrawlerNodeDetails"></a>

워크플로에 있는 크롤러 노드의 세부 정보입니다.

**필드**
+ `Crawls` – [Crawl](#aws-glue-api-workflow-Crawl) 객체의 배열입니다.

  크롤 노드가 나타내는 크롤의 목록입니다.

## TriggerNodeDetails 구조
<a name="aws-glue-api-workflow-TriggerNodeDetails"></a>

워크플로에 있는 트리거 노드의 세부 정보입니다.

**필드**
+ `Trigger` – [트리거](aws-glue-api-jobs-trigger.md#aws-glue-api-jobs-trigger-Trigger) 객체입니다.

  트리거 노드가 나타내는 트리거의 정보입니다.

## 크롤 구조
<a name="aws-glue-api-workflow-Crawl"></a>

워크플로에 있는 크롤의 세부 정보입니다.

**필드**
+ `State` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `CANCELLING` \$1 `CANCELLED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ERROR`).

  크롤러의 상태입니다.
+ `StartedOn` – 타임스탬프입니다.

  크롤이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  크롤이 완료된 날짜와 시간입니다.
+ `ErrorMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  크롤과 연결된 오류 메시지입니다.
+ `LogGroup` – [Log group string pattern](aws-glue-api-common.md#aws-glue-api-regex-logGroup-id)과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다.

  크롤과 연결된 로그 그룹입니다.
+ `LogStream` – [Log-stream string pattern](aws-glue-api-common.md#aws-glue-api-regex-logStream-id)과(와) 일치하는 1\$1512바이트 길이의 UTF-8 문자열입니다.

  크롤과 연결된 로그 스트림입니다.

## 노드 구조
<a name="aws-glue-api-workflow-Node"></a>

노드는 워크플로 그래프에서 AWS Glue 구성 요소(트리거, 크롤러 또는 작업)를 나타냅니다.

**필드**
+ `Type` – UTF-8 문자열입니다(유효한 값: `CRAWLER` \$1 `JOB` \$1 `TRIGGER`).

  노드가 나타내는 AWS Glue 구성 요소의 유형입니다.
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  노드가 나타내는 AWS Glue 구성 요소의 이름입니다.
+ `UniqueId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  워크플로 내의 노드에 할당된 고유 ID입니다.
+ `TriggerDetails` – [TriggerNodeDetails](#aws-glue-api-workflow-TriggerNodeDetails) 객체입니다.

  노드가 트리거를 나타낼 때 트리거의 세부 정보입니다.
+ `JobDetails` – [JobNodeDetails](#aws-glue-api-workflow-JobNodeDetails) 객체입니다.

  노드가 작업을 나타낼 때 작업의 세부 정보입니다.
+ `CrawlerDetails` – [CrawlerNodeDetails](#aws-glue-api-workflow-CrawlerNodeDetails) 객체입니다.

  노드가 크롤러를 나타낼 때 크롤러의 세부 정보입니다.

## 엣지 구조
<a name="aws-glue-api-workflow-Edge"></a>

엣지는 엣지가 속한 워크플로의 일부인 두 개의 AWS Glue 구성 요소 간에 방향이 있는 연결을 나타냅니다.

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

  엣지가 시작되는 워크플로 내 노드의 고유 ID입니다.
+ `DestinationId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  엣지가 종료되는 워크플로 내 노드의 고유 ID입니다.

## 워크플루 구조
<a name="aws-glue-api-workflow-Workflow"></a>

워크플로는 복잡한 ETL 태스크를 완료하기 위해 실행되는 여러 종속 AWS Glue 작업 및 크롤러의 모음입니다. 워크플로는 모든 작업 및 크롤러의 실행 및 모니터링을 관리합니다.

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

  워크플로의 이름입니다.
+ `Description` – UTF-8 문자열입니다.

  워크플로에 대한 설명입니다.
+ `DefaultRunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  워크플로의 각 실행의 일부로 사용할 속성 모음입니다. 실행 속성은 워크플로의 각 작업에서 사용할 수 있습니다. 작업은 흐름의 다음 작업에 대한 속성을 수정할 수 있습니다.
+ `CreatedOn` – 타임스탬프입니다.

  워크플로가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  워크플로가 마지막으로 수정된 날짜와 시간입니다.
+ `LastRun` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체입니다.

  워크플로의 마지막 실행에 대한 정보입니다.
+ `Graph` – [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph) 객체입니다.

  워크플로에 속하는 모든 AWS Glue 구성 요소를 이들 간의 방향 있는 연결과 노드를 엣지로 나타내는 그래프입니다.
+ `CreationStatus` – UTF-8 문자열입니다(유효 값: `CREATING` \$1 `CREATED` \$1 `CREATION_FAILED`).

  워크플로의 생성 상태입니다.
+ `MaxConcurrentRuns` - 숫자(정수)입니다.

  이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다.
+ `BlueprintDetails` – [BlueprintDetails](#aws-glue-api-workflow-BlueprintDetails) 객체입니다.

  이 구조는 이 특정 워크플로가 생성된 블루프린트의 세부 정보를 나타냅니다.

## WorkflowGraph 구조
<a name="aws-glue-api-workflow-WorkflowGraph"></a>

워크플로 그래프는 워크플로에 있는 모든 AWS Glue 구성 요소와 그 사이의 모든 방향 있는 연결이 포함된 완전한 워크플로를 나타냅니다.

**필드**
+ `Nodes` – [노드](#aws-glue-api-workflow-Node) 객체의 배열입니다.

  노드로 나타내는 워크플로에 속한 AWS Glue 구성 요소의 목록입니다.
+ `Edges` – [Edge](#aws-glue-api-workflow-Edge) 객체의 배열입니다.

  워크플로에 속한 노드 간의 모든 방향 있는 연결의 목록입니다.

## WorkflowRun 구조
<a name="aws-glue-api-workflow-WorkflowRun"></a>

워크플로 실행은 모든 실행 시간 정보를 제공하는 워크플로의 실행입니다.

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

  실행된 워크플로의 이름입니다.
+ `WorkflowRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  이전 워크플로 실행의 ID입니다.
+ `WorkflowRunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  실행 중에 설정된 워크플로 실행 속성입니다.
+ `StartedOn` – 타임스탬프입니다.

  워크플로 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  워크플로 실행이 완료된 날짜와 시간입니다.
+ `Status` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `COMPLETED` \$1 `STOPPING` \$1 `STOPPED` \$1 `ERROR`).

  워크플로 실행의 상태입니다.
+ `ErrorMessage` – UTF-8 문자열입니다.

  이 오류 메시지는 워크플로 실행을 시작할 때 발생할 수 있는 모든 오류에 대해 설명합니다. 현재 유일한 오류 메시지는 "워크플로에 대한 동시 실행 초과(Concurrent runs exceeded for workflow): `foo`"입니다.
+ `Statistics` – [WorkflowRunStatistics](#aws-glue-api-workflow-WorkflowRunStatistics) 객체입니다.

  실행의 통계입니다.
+ `Graph` – [WorkflowGraph](#aws-glue-api-workflow-WorkflowGraph) 객체입니다.

  워크플로에 속하는 모든 AWS Glue 구성 요소를 이들 간의 방향 있는 연결과 노드를 엣지로 나타내는 그래프입니다.
+ `StartingEventBatchCondition` – [StartingEventBatchCondition](#aws-glue-api-workflow-StartingEventBatchCondition) 객체입니다.

  워크플로 실행을 시작한 배치 조건입니다.

## WorkflowRunStatistics 구조
<a name="aws-glue-api-workflow-WorkflowRunStatistics"></a>

워크플로 실행 통계는 워크플로 실행에 대한 통계를 제공합니다.

**필드**
+ `TotalActions` - 숫자(정수)입니다.

  워크플로 실행에 있는 총 작업 수입니다.
+ `TimeoutActions` - 숫자(정수)입니다.

  시간 초과된 총 작업 수입니다.
+ `FailedActions` - 숫자(정수)입니다.

  실패한 총 작업 수입니다.
+ `StoppedActions` - 숫자(정수)입니다.

  중지된 총 작업 수입니다.
+ `SucceededActions` - 숫자(정수)입니다.

  성공한 총 작업 수입니다.
+ `RunningActions` - 숫자(정수)입니다.

  실행 상태의 총 작업 수입니다.
+ `ErroredActions` - 숫자(정수)입니다.

  워크플로 실행에서 ERROR 상태의 작업 실행 수를 나타냅니다.
+ `WaitingActions` - 숫자(정수)입니다.

  워크플로 실행에서 WAITING 상태의 작업 실행 수를 나타냅니다.

## StartingEventBatchCondition 구조
<a name="aws-glue-api-workflow-StartingEventBatchCondition"></a>

워크플로 실행을 시작한 배치 조건입니다. BatchSize 멤버가 0이 아닌 경우 배치 크기의 이벤트 수가 도착했거나 BatchWindow 멤버가 0이 아닌 경우 배치 기간이 만료되었습니다.

**필드**
+ `BatchSize` - 숫자(정수)입니다.

  배치의 이벤트 수입니다.
+ `BatchWindow` - 숫자(정수)입니다.

  배치 기간의 기간(초)입니다.

## 블루프린트 구조
<a name="aws-glue-api-workflow-Blueprint"></a>

블루프린트의 세부 정보입니다.

**필드**
+ `Name` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  블루프린트의 이름입니다.
+ `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  블루프린트에 대한 설명입니다.
+ `CreatedOn` – 타임스탬프입니다.

  블루프린트가 등록된 날짜 및 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  블루프린트가 마지막으로 수정된 날짜 및 시간입니다.
+ `ParameterSpec` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다.

  블루프린트에 대한 파라미터 사양 목록을 나타내는 JSON 문자열입니다.
+ `BlueprintLocation` – UTF-8 문자열입니다.

  블루프린트가 게시되는 Amazon S3의 경로를 지정합니다.
+ `BlueprintServiceLocation` – UTF-8 문자열입니다.

  `CreateBlueprint/UpdateBlueprint`를 호출하여 AWS Glue에 블루프린트를 등록할 때 블루프린트가 복사되는 Amazon S3의 경로를 지정합니다.
+ `Status` – UTF-8 문자열입니다(유효 값: `CREATING` \$1 `ACTIVE` \$1 `UPDATING` \$1 `FAILED`).

  블루프린트 등록의 상태입니다.
  + [생성(Creating)] - 블루프린트 등록이 진행 중입니다.
  + [활성(Active)] - 블루프린트가 성공적으로 등록되었습니다.
  + [업데이트 중(Updating)] - 블루프린트 등록에 대한 업데이트가 진행 중입니다.
  + [실패(Failed)] - 블루프린트 등록에 실패했습니다.
+ `ErrorMessage` – UTF-8 문자열입니다.

  오류 메시지입니다.
+ `LastActiveDefinition` – [LastActiveDefinition](#aws-glue-api-workflow-LastActiveDefinition) 객체입니다.

  블루프린트의 여러 버전이 있고 최신 버전에 일부 오류가 있는 경우 이 속성은 서비스에서 사용할 수 있는 마지막으로 성공한 블루프린트 정의를 나타냅니다.

## BlueprintDetails 구조
<a name="aws-glue-api-workflow-BlueprintDetails"></a>

블루프린트의 세부 정보입니다.

**필드**
+ `BlueprintName` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

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

  이 블루프린트의 실행 ID입니다.

## LastActiveDefinition 구조
<a name="aws-glue-api-workflow-LastActiveDefinition"></a>

블루프린트의 여러 버전이 있고 최신 버전에 일부 오류가 있는 경우 이 속성은 서비스에서 사용할 수 있는 마지막으로 성공한 블루프린트 정의를 나타냅니다.

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

  블루프린트에 대한 설명입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  블루프린트가 마지막으로 수정된 날짜 및 시간입니다.
+ `ParameterSpec` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다.

  블루프린트의 파라미터를 지정하는 JSON 문자열입니다.
+ `BlueprintLocation` – UTF-8 문자열입니다.

  AWS Glue 개발자가 블루프린트를 게시하는 Amazon S3의 경로를 지정합니다.
+ `BlueprintServiceLocation` – UTF-8 문자열입니다.

  블루프린트를 생성하거나 업데이트할 때 블루프린트가 복사되는 Amazon S3의 경로를 지정합니다.

## BlueprintRun 구조
<a name="aws-glue-api-workflow-BlueprintRun"></a>

블루프린트 실행의 세부 정보입니다.

**필드**
+ `BlueprintName` – [Custom string pattern #31](aws-glue-api-common.md#regex_31)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

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

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

  성공적인 블루프린트 실행의 결과로 생성된 워크플로의 이름입니다. 블루프린트 실행에 오류가 있으면 워크플로가 생성되지 않습니다.
+ `State` – UTF-8 문자열입니다(유효 값: `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `ROLLING_BACK`).

  블루프린트 실행 상태입니다. 가능한 값은 다음과 같습니다.
  + [실행 중(Running)] - 블루프린트 실행이 진행 중입니다.
  + [성공(Succeeded)] - 블루프린트 실행이 성공적으로 완료되었습니다.
  + [실패(Failed)] - 블루프린트 실행이 실패하고 롤백이 완료되었습니다.
  + [롤백 중(Rolling Back)] - 블루프린트 실행이 실패하여 롤백이 진행 중입니다.
+ `StartedOn` – 타임스탬프입니다.

  블루프린트 실행이 시작된 날짜 및 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  블루프린트 실행이 완료된 날짜 및 시간입니다.
+ `ErrorMessage` – UTF-8 문자열입니다.

  블루프린트를 실행하는 동안 표시되는 모든 오류를 나타냅니다.
+ `RollbackErrorMessage` – UTF-8 문자열입니다.

  워크플로의 엔터티를 생성하는 동안 오류가 발생하면 해당 시점까지 생성된 엔터티를 롤백하고 삭제하려고 합니다. 이 속성은 생성된 엔터티를 삭제하는 동안 발생한 오류를 나타냅니다.
+ `Parameters` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다.

  블루프린트 파라미터(문자열). `Blueprint$ParameterSpec`에 정의된 파라미터 사양에서 필요한 각 키에 대한 값을 제공해야 합니다.
+ `RoleArn` – [Custom string pattern #30](aws-glue-api-common.md#regex_30)과(와) 일치하는 1\$11,024바이트 길이의 UTF-8 문자열입니다.

  역할 ARN입니다. 이 역할은 AWS Glue 서비스에서 수임하며 워크플로 및 워크플로의 기타 엔터티를 생성하는 데 사용됩니다.

## 운영
<a name="aws-glue-api-workflow-actions"></a>
+ [CreateWorkflow 작업(Python: create\$1workflow)](#aws-glue-api-workflow-CreateWorkflow)
+ [UpdateWorkflow 작업(Python: update\$1workflow)](#aws-glue-api-workflow-UpdateWorkflow)
+ [DeleteWorkflow 작업(Python: delete\$1workflow)](#aws-glue-api-workflow-DeleteWorkflow)
+ [GetWorkflow 작업(Python: get\$1workflow)](#aws-glue-api-workflow-GetWorkflow)
+ [ListWorkflows 작업(Python: list\$1workflows)](#aws-glue-api-workflow-ListWorkflows)
+ [BatchGetWorkflows 작업(Python: batch\$1get\$1workflows)](#aws-glue-api-workflow-BatchGetWorkflows)
+ [GetWorkflowRun 작업(Python: get\$1workflow\$1run)](#aws-glue-api-workflow-GetWorkflowRun)
+ [GetWorkflowRuns 작업(Python: get\$1workflow\$1runs)](#aws-glue-api-workflow-GetWorkflowRuns)
+ [GetWorkflowRunProperties 작업(Python: get\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-GetWorkflowRunProperties)
+ [PutWorkflowRunProperties 작업(Python: put\$1workflow\$1run\$1properties)](#aws-glue-api-workflow-PutWorkflowRunProperties)
+ [CreateBlueprint 작업(Python: create\$1blueprint)](#aws-glue-api-workflow-CreateBlueprint)
+ [UpdateBlueprint 작업(Python: update\$1blueprint)](#aws-glue-api-workflow-UpdateBlueprint)
+ [DeleteBlueprint 작업(Python: delete\$1blueprint)](#aws-glue-api-workflow-DeleteBlueprint)
+ [ListBlueprints 작업(Python: list\$1blueprints)](#aws-glue-api-workflow-ListBlueprints)
+ [BatchGetBlueprints 작업(Python: batch\$1get\$1blueprints)](#aws-glue-api-workflow-BatchGetBlueprints)
+ [StartBlueprintRun 작업(Python: start\$1blueprint\$1run)](#aws-glue-api-workflow-StartBlueprintRun)
+ [GetBlueprintRun 작업(Python: get\$1blueprint\$1run)](#aws-glue-api-workflow-GetBlueprintRun)
+ [GetBlueprintRuns 작업(Python: get\$1blueprint\$1runs)](#aws-glue-api-workflow-GetBlueprintRuns)
+ [StartWorkflowRun 작업(Python: start\$1workflow\$1run)](#aws-glue-api-workflow-StartWorkflowRun)
+ [StopWorkflowRun 작업(Python: stop\$1workflow\$1run)](#aws-glue-api-workflow-StopWorkflowRun)
+ [ResumeWorkflowRun 작업(Python: resume\$1workflow\$1run)](#aws-glue-api-workflow-ResumeWorkflowRun)

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

새 워크플로를 생성합니다.

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

  워크플로에 할당할 이름입니다. 이름은 계정 내에서 고유해야 합니다.
+ `Description` – UTF-8 문자열(120,000바이트 이하).

  워크플로에 대한 설명입니다.
+ `DefaultRunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  워크플로의 각 실행의 일부로 사용할 속성 모음입니다.

  실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 워크플로에 사용할 태그입니다.
+ `MaxConcurrentRuns` - 숫자(정수)입니다.

  이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다.

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

  요청의 일부로 제공된 워크플로의 이름입니다.

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `ConcurrentModificationException`

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

기존 워크플로를 업데이트합니다.

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

  업데이트할 워크플로의 이름입니다.
+ `Description` – UTF-8 문자열(120,000바이트 이하).

  워크플로에 대한 설명입니다.
+ `DefaultRunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  워크플로의 각 실행의 일부로 사용할 속성 모음입니다.

  실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.
+ `MaxConcurrentRuns` - 숫자(정수)입니다.

  이 파라미터를 사용하여 데이터에 대한 원치 않는 다중 업데이트를 방지하거나 비용을 제어하거나 경우에 따라 구성 요소 작업의 최대 동시 실행 수를 초과하는 것을 방지할 수 있습니다. 이 파라미터를 공백으로 두면 동시 워크플로 실행 수에 제한이 없습니다.

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

  입력에서 지정된 워크플로의 이름입니다.

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

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

워크플로를 삭제합니다.

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

  삭제할 워크플로의 이름입니다.

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

  입력에서 지정된 워크플로의 이름입니다.

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

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

워크플로에 대한 리소스 메타데이터를 검색합니다.

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

  검색할 워크플로의 이름입니다.
+ `IncludeGraph` – 부울입니다.

  워크플로 리소스 메타데이터를 반환할 때 그래프를 포함할지 여부를 지정합니다.

**응답**
+ `Workflow` – [워크플로](#aws-glue-api-workflow-Workflow) 객체입니다.

  워크플로에 대한 리소스 메타데이터입니다.

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

## ListWorkflows 작업(Python: list\$1workflows)
<a name="aws-glue-api-workflow-ListWorkflows"></a>

계정에서 생성된 워크플로의 이름을 나열합니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` - 1 이상 25 이하의 숫자(정수)입니다.

  반환할 목록의 최대 크기.

**응답**
+ `Workflows` – 1\$125개 문자열로 구성된 UTF-8 문자열의 배열입니다.

  계정에 있는 워크플로의 이름 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  일부 워크플로 이름이 반환되지 않은 경우의 지속 토큰입니다.

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

## BatchGetWorkflows 작업(Python: batch\$1get\$1workflows)
<a name="aws-glue-api-workflow-BatchGetWorkflows"></a>

제공된 워크플로 이름 목록에 대한 리소스 메타데이터의 목록을 반환합니다. `ListWorkflows` 작업을 호출한 후에는 권한이 부여된 데이터에 액세스하기 위해 이 작업을 호출할 수 있습니다. 이 작업은 태그를 사용하는 권한 조건을 포함해 모든 IAM 권한을 지원합니다.

**요청**
+ `Names` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다.

  `ListWorkflows` 작업에서 반환된 이름일 수 있는 워크플로 이름의 목록입니다.
+ `IncludeGraph` – 부울입니다.

  워크플로 리소스 메타데이터를 반환할 때 그래프를 포함할지 여부를 지정합니다.

**응답**
+ `Workflows` – [워크플로](#aws-glue-api-workflow-Workflow) 객체의 배열이며 구조는 1\$125개입니다.

  워크플로 리소스 메타데이터의 목록입니다.
+ `MissingWorkflows` – 1\$125개 문자열로 구성된 UTF-8 문자열의 배열입니다.

  찾을 수 없는 워크플로의 이름 목록입니다.

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

## GetWorkflowRun 작업(Python: get\$1workflow\$1run)
<a name="aws-glue-api-workflow-GetWorkflowRun"></a>

제공된 워크플로 실행에 대한 메타데이터를 검색합니다. 워크플로 및 작업 실행의 경우 작업 실행 기록을 90일 동안 액세스할 수 있습니다.

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

  실행되고 있는 워크플로의 이름입니다.
+ `RunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  워크플로 실행의 ID입니다.
+ `IncludeGraph` – 부울입니다.

  워크플로 그래프를 응답에 포함할지 여부를 지정합니다.

**응답**
+ `Run` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체입니다.

  요청된 워크플로 실행 메타데이터입니다.

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

## GetWorkflowRuns 작업(Python: get\$1workflow\$1runs)
<a name="aws-glue-api-workflow-GetWorkflowRuns"></a>

제공된 워크플로의 모든 실행에 대한 메타데이터를 검색합니다.

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

  실행 메타데이터를 반환해야 하는 워크플로의 이름입니다.
+ `IncludeGraph` – 부울입니다.

  워크플로 그래프를 응답에 포함할지 여부를 지정합니다.
+ `NextToken` – UTF-8 문자열입니다.

  응답의 최대 크기입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  응답에 포함할 최대 워크플로 실행 수입니다.

**응답**
+ `Runs` – [WorkflowRun](#aws-glue-api-workflow-WorkflowRun) 객체의 배열이며 구조는 1\$11,000개입니다.

  워크플로 실행 메타데이터 객체의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  일부 요청된 워크플로 실행이 반환되지 않은 경우 지속 토큰입니다.

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

## GetWorkflowRunProperties 작업(Python: get\$1workflow\$1run\$1properties)
<a name="aws-glue-api-workflow-GetWorkflowRunProperties"></a>

실행 중에 설정된 워크플로 실행 속성을 검색합니다.

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

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

  실행 속성을 반환해야 하는 워크플로 실행의 ID입니다.

**응답**
+ `RunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  지정된 실행 중에 설정된 워크플로 실행 속성입니다.

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

## PutWorkflowRunProperties 작업(Python: put\$1workflow\$1run\$1properties)
<a name="aws-glue-api-workflow-PutWorkflowRunProperties"></a>

제공된 워크플로 실행에 대해 지정된 워크플로 실행 속성을 입력합니다. 지정된 실행에 대한 속성이 이미 있으면 이 속성이 값을 재정의하고 그렇지 않으면 속성을 기존 속성에 추가합니다.

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

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

  실행 속성을 업데이트해야 하는 워크플로 실행의 ID입니다.
+ `RunProperties` – *필수(Required):* 키-값 페어의 맵 배열입니다.

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

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

  지정된 실행에 대해 입력할 속성입니다.

  실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

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

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

## CreateBlueprint 작업(Python: create\$1blueprint)
<a name="aws-glue-api-workflow-CreateBlueprint"></a>

AWS Glue에 블루프린트를 등록합니다.

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

  블루프린트의 이름입니다.
+ `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  블루프린트에 대한 설명입니다.
+ `BlueprintLocation` – *필수(Required):* [Custom string pattern #32](aws-glue-api-common.md#regex_32)과(와) 일치하는 1\$18,192바이트 길이의 UTF-8 문자열입니다.

  블루프린트가 게시되는 Amazon S3의 경로를 지정합니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 블루프린트에 적용할 태그입니다.

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

  등록된 블루프린트의 이름을 반환합니다.

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

## UpdateBlueprint 작업(Python: update\$1blueprint)
<a name="aws-glue-api-workflow-UpdateBlueprint"></a>

등록된 블루프린트를 업데이트합니다.

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

  블루프린트의 이름입니다.
+ `Description` – 1\$1512바이트 길이의 UTF-8 문자열입니다.

  블루프린트에 대한 설명입니다.
+ `BlueprintLocation` – *필수(Required):* [Custom string pattern #32](aws-glue-api-common.md#regex_32)과(와) 일치하는 1\$18,192바이트 길이의 UTF-8 문자열입니다.

  블루프린트가 게시되는 Amazon S3의 경로를 지정합니다.

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

  업데이트된 블루프린트의 이름을 반환합니다.

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

## DeleteBlueprint 작업(Python: delete\$1blueprint)
<a name="aws-glue-api-workflow-DeleteBlueprint"></a>

기존 블루프린트를 삭제합니다.

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

  삭제할 블루프린트의 이름입니다.

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

  삭제된 블루프린트의 이름을 반환합니다.

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

## ListBlueprints 작업(Python: list\$1blueprints)
<a name="aws-glue-api-workflow-ListBlueprints"></a>

계정의 모든 블루프린트 이름을 나열합니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` - 1 이상 25 이하의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  AWS 리소스 태그로 목록을 필터링합니다.

**응답**
+ `Blueprints` – UTF-8 문자열의 배열입니다.

  계정에 있는 블루프린트의 이름 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  모든 블루프린트 이름이 반환하지 않은 경우의 지속 토큰입니다.

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

## BatchGetBlueprints 작업(Python: batch\$1get\$1blueprints)
<a name="aws-glue-api-workflow-BatchGetBlueprints"></a>

블루프린트 목록에 대한 정보를 검색합니다.

**요청**
+ `Names` – *필수(Required):* 1\$125개 문자열의 UTF-8 문자열의 배열입니다.

  블루프린트 이름의 목록입니다.
+ `IncludeBlueprint` – 부울입니다.

  응답에 워크플로를 포함할지 여부를 지정합니다.
+ `IncludeParameterSpec` – 부울입니다.

  응답에 블루프린트에 대한 파라미터를 JSON 문자열로 포함할지 여부를 지정합니다.

**응답**
+ `Blueprints` – [블루프린트](#aws-glue-api-workflow-Blueprint) 객체의 배열입니다.

  블루프린트 목록을 `Blueprints` 객체로 반환합니다.
+ `MissingBlueprints` – UTF-8 문자열의 배열입니다.

  찾을 수 없는 `BlueprintNames` 목록을 반환합니다.

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

## StartBlueprintRun 작업(Python: start\$1blueprint\$1run)
<a name="aws-glue-api-workflow-StartBlueprintRun"></a>

지정된 블루프린트의 새 실행을 시작합니다.

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

  블루프린트의 이름입니다.
+ `Parameters` – 1\$1131,072바이트 길이의 UTF-8 문자열입니다.

  파라미터를 `BlueprintParameters` 객체로 지정합니다.
+ `RoleArn` – *필수(Required):* [Custom string pattern #30](aws-glue-api-common.md#regex_30)과(와) 일치하는 1\$11,024바이트 길이의 UTF-8 문자열입니다.

  워크플로 생성에 사용되는 IAM 역할을 지정합니다.

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

  이 블루프린트 실행의 실행 ID입니다.

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

## GetBlueprintRun 작업(Python: get\$1blueprint\$1run)
<a name="aws-glue-api-workflow-GetBlueprintRun"></a>

블루프린트 실행의 세부 정보를 검색합니다.

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

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

  검색하려는 블루프린트 실행의 실행 ID입니다.

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

  `BlueprintRun` 객체를 반환합니다.

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

## GetBlueprintRuns 작업(Python: get\$1blueprint\$1runs)
<a name="aws-glue-api-workflow-GetBlueprintRuns"></a>

지정된 블루프린트에 대한 블루프린트 실행의 세부 정보를 검색합니다.

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

  블루프린트의 이름입니다.
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.

**응답**
+ `BlueprintRuns` – [BlueprintRun](#aws-glue-api-workflow-BlueprintRun) 객체의 배열입니다.

  `BlueprintRun` 객체 목록을 반환합니다.
+ `NextToken` – UTF-8 문자열입니다.

  모든 블루프린트 실행이 반환하지 않은 경우의 지속 토큰입니다.

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

## StartWorkflowRun 작업(Python: start\$1workflow\$1run)
<a name="aws-glue-api-workflow-StartWorkflowRun"></a>

지정된 워크플로의 새 실행을 시작합니다.

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

  시작할 워크플로의 이름입니다.
+ `RunProperties` – 키-값 페어의 맵 배열입니다.

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

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

  새 워크플로 실행에 대한 워크플로 실행 속성입니다.

  실행 속성이 로깅될 수 있습니다. 일반 텍스트 보안 암호를 속성으로 전달하지 마세요. 워크플로우 실행 내에서 보안 암호를 사용하려는 경우 AWS Glue 연결, AWS Secrets Manager 또는 다른 보안 암호 관리 메커니즘에서 검색합니다.

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

  새 실행의 ID입니다.

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

## StopWorkflowRun 작업(Python: stop\$1workflow\$1run)
<a name="aws-glue-api-workflow-StopWorkflowRun"></a>

지정된 워크플로 실행의 실행을 중지합니다.

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

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

  중지할 워크플로 실행의 ID입니다.

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

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

## ResumeWorkflowRun 작업(Python: resume\$1workflow\$1run)
<a name="aws-glue-api-workflow-ResumeWorkflowRun"></a>

이전에 부분적으로 완료된 워크플로 실행의 선택한 노드를 다시 시작하고 워크플로 실행을 재개합니다. 선택한 노드와 선택한 노드의 다운스트림에 있는 모든 노드가 실행됩니다.

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

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

  재개할 워크플로 실행의 ID입니다.
+ `NodeIds` – *필수(Required):* UTF-8 문자열의 배열입니다.

  다시 시작하려는 노드의 노드 ID 목록입니다. 다시 시작될 노드에는 원래 실행에서 실행 시도가 있어야 합니다.

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

  재개된 워크플로 실행에 할당된 새 ID입니다. 워크플로 실행의 각 재개에는 새 실행 ID가 있습니다.
+ `NodeIds` – UTF-8 문자열의 배열입니다.

  실제로 다시 시작된 노드의 노드 ID 목록입니다.

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

# 사용 프로필
<a name="aws-glue-api-usage-profiles"></a>

사용 프로필 API는 AWS Glue에서의 사용 프로필 생성, 업데이트 또는 확인과 관련된 API 및 데이터 유형에 대해 설명합니다.

## 데이터 타입
<a name="aws-glue-api-usage-profiles-objects"></a>
+ [ProfileConfiguration 구조](#aws-glue-api-usage-profiles-ProfileConfiguration)
+ [ConfigurationObject 구조](#aws-glue-api-usage-profiles-ConfigurationObject)
+ [UsageProfileDefinition 구조](#aws-glue-api-usage-profiles-UsageProfileDefinition)

## ProfileConfiguration 구조
<a name="aws-glue-api-usage-profiles-ProfileConfiguration"></a>

관리자가 AWS Glue 사용 프로필에서 구성하는 작업 및 세션 값을 지정합니다.

**필드**
+ `SessionConfiguration` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject) 객체입니다.

  AWS Glue 세션에 대한 구성 파라미터의 키 값 맵.
+ `JobConfiguration` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [ConfigurationObject](#aws-glue-api-usage-profiles-ConfigurationObject) 객체입니다.

  AWS Glue 작업에 대한 구성 파라미터의 키 값 맵.

## ConfigurationObject 구조
<a name="aws-glue-api-usage-profiles-ConfigurationObject"></a>

관리자가 AWS Glue 사용 프로필에 구성된 각 작업 또는 세션 파라미터에 대해 설정하는 값을 지정합니다.

**필드**
+ `DefaultValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터의 기본값.
+ `AllowedValues` – UTF-8 문자열의 배열입니다.

  파라미터에 허용되는 값 목록.
+ `MinValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터에 허용되는 최솟값.
+ `MaxValue` – [Custom string pattern #35](aws-glue-api-common.md#regex_35)과(와) 일치하는 1\$1128바이트 길이의 UTF-8 문자열입니다.

  파라미터에 허용되는 최댓값.

## UsageProfileDefinition 구조
<a name="aws-glue-api-usage-profiles-UsageProfileDefinition"></a>

AWS Glue 사용 프로필을 설명합니다.

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

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

  사용 프로필에 대한 설명.
+ `CreatedOn` – 타임스탬프입니다.

  사용 프로필을 생성한 날짜와 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  사용 프로필을 마지막으로 수정한 날짜 및 시간.

## 운영
<a name="aws-glue-api-usage-profiles-actions"></a>
+ [CreateUsageProfile 작업(Python: create\$1usage\$1profile)](#aws-glue-api-usage-profiles-CreateUsageProfile)
+ [GetUsageProfile 작업(Python: get\$1usage\$1profile)](#aws-glue-api-usage-profiles-GetUsageProfile)
+ [UpdateUsageProfile 작업(Python: update\$1usage\$1profile)](#aws-glue-api-usage-profiles-UpdateUsageProfile)
+ [DeleteUsageProfile 작업(Python: delete\$1usage\$1profile)](#aws-glue-api-usage-profiles-DeleteUsageProfile)
+ [ListUsageProfiles 작업(Python: list\$1usage\$1profiles)](#aws-glue-api-usage-profiles-ListUsageProfiles)

## CreateUsageProfile 작업(Python: create\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-CreateUsageProfile"></a>

AWS Glue 사용 프로필을 생성합니다.

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

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

  사용 프로필에 대한 설명.
+ `Configuration` – **필수(Required): [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  사용 프로필에 적용된 태그 목록.

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

  생성한 사용 프로필의 이름.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`
+ `AlreadyExistsException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `OperationNotSupportedException`

## GetUsageProfile 작업(Python: get\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-GetUsageProfile"></a>

지정된 AWS Glue 사용 프로필에 대한 정보를 검색합니다.

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

  검색할 사용 프로필의 이름.

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

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

  사용 프로필에 대한 설명.
+ `Configuration` – [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.
+ `CreatedOn` – 타임스탬프입니다.

  사용 프로필을 생성한 날짜와 시간.
+ `LastModifiedOn` – 타임스탬프입니다.

  사용 프로필을 마지막으로 수정한 날짜 및 시간.

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

## UpdateUsageProfile 작업(Python: update\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-UpdateUsageProfile"></a>

AWS Glue 사용 프로필을 업데이트합니다.

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

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

  사용 프로필에 대한 설명.
+ `Configuration` – **필수(Required): [ProfileConfiguration](#aws-glue-api-usage-profiles-ProfileConfiguration) 객체입니다.

  프로필의 작업 및 세션 값을 지정하는 `ProfileConfiguration` 객체.

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

  업데이트한 사용 프로필의 이름.

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

## DeleteUsageProfile 작업(Python: delete\$1usage\$1profile)
<a name="aws-glue-api-usage-profiles-DeleteUsageProfile"></a>

지정된 AWS Glue 사용 프로필을 삭제합니다.

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

  삭제할 사용 프로필의 이름.

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

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

## ListUsageProfiles 작업(Python: list\$1usage\$1profiles)
<a name="aws-glue-api-usage-profiles-ListUsageProfiles"></a>

모든 AWS Glue 사용 프로필을 나열합니다.

**요청**
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

  이것이 지속적으로 호출되면 지속적인 토큰을 포함합니다.
+ `MaxResults` - 1 이상 200 이하의 숫자(정수)입니다.

  한 번의 응답으로 반환할 최대 사용 프로필 수.

**응답**
+ `Profiles` – [UsageProfileDefinition](#aws-glue-api-usage-profiles-UsageProfileDefinition) 객체의 배열입니다.

  사용 프로필(`UsageProfileDefinition`) 객체 목록.
+ `NextToken` – 400,000바이트 이하 길이의 UTF-8 문자열입니다.

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

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

# 기계 학습 API
<a name="aws-glue-api-machine-learning-api"></a>

기계 학습 API는 기계 학습 데이터 형식을 설명하며 변환을 생성, 삭제 또는 업데이트하거나 기계 학습 작업 실행을 시작하기 위한 API를 포함합니다.

## 데이터 타입
<a name="aws-glue-api-machine-learning-api-objects"></a>
+ [TransformParameters 구조](#aws-glue-api-machine-learning-api-TransformParameters)
+ [EvaluationMetrics 구조](#aws-glue-api-machine-learning-api-EvaluationMetrics)
+ [MLTransform 구조](#aws-glue-api-machine-learning-api-MLTransform)
+ [FindMatchesParameters 구조](#aws-glue-api-machine-learning-api-FindMatchesParameters)
+ [FindMatchesMetrics 구조](#aws-glue-api-machine-learning-api-FindMatchesMetrics)
+ [ConfusionMatrix 구조](#aws-glue-api-machine-learning-api-ConfusionMatrix)
+ [GlueTable 구조](#aws-glue-api-machine-learning-api-GlueTable)
+ [TaskRun 구조](#aws-glue-api-machine-learning-api-TaskRun)
+ [TransformFilterCriteria 구조](#aws-glue-api-machine-learning-api-TransformFilterCriteria)
+ [TransformSortCriteria 구조](#aws-glue-api-machine-learning-api-TransformSortCriteria)
+ [TaskRunFilterCriteria 구조](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria)
+ [TaskRunSortCriteria 구조](#aws-glue-api-machine-learning-api-TaskRunSortCriteria)
+ [TaskRunProperties 구조](#aws-glue-api-machine-learning-api-TaskRunProperties)
+ [FindMatchesTaskRunProperties 구조](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties)
+ [ImportLabelsTaskRunProperties 구조](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties)
+ [ExportLabelsTaskRunProperties 구조](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties)
+ [LabelingSetGenerationTaskRunProperties 구조](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties)
+ [SchemaColumn 구조](#aws-glue-api-machine-learning-api-SchemaColumn)
+ [TransformEncryption 구조](#aws-glue-api-machine-learning-api-TransformEncryption)
+ [MLUserDataEncryption 구조](#aws-glue-api-machine-learning-api-MLUserDataEncryption)
+ [ColumnImportance 구조](#aws-glue-api-machine-learning-api-ColumnImportance)

## TransformParameters 구조
<a name="aws-glue-api-machine-learning-api-TransformParameters"></a>

기계 학습 변환과 연결된 알고리즘별 파라미터입니다.

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

  기계 학습 변환의 유형입니다.

  기계 학습 변환 유형에 대한 자세한 내용은 [기계 학습 변환 생성](https://docs.aws.amazon.com/glue/latest/dg/add-job-machine-learning-transform.html)을 참조하십시오.
+ `FindMatchesParameters` – [FindMatchesParameters](#aws-glue-api-machine-learning-api-FindMatchesParameters) 객체입니다.

  일치 항목 찾기 알고리즘에 대한 파라미터입니다.

## EvaluationMetrics 구조
<a name="aws-glue-api-machine-learning-api-EvaluationMetrics"></a>

평가 지표는 기계 학습 변환의 예상 품질을 제공합니다.

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

  기계 학습 변환의 유형입니다.
+ `FindMatchesMetrics` – [FindMatchesMetrics](#aws-glue-api-machine-learning-api-FindMatchesMetrics) 객체입니다.

  일치 항목 찾기 알고리즘에 대한 평가 지표입니다.

## MLTransform 구조
<a name="aws-glue-api-machine-learning-api-MLTransform"></a>

기계 학습 변환의 구조입니다.

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

  기계 학습 변환에 대해 생성된 고유 변환 ID입니다. ID는 고유한 것으로 보장되며 변경되지 않습니다.
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  기계 학습 변환의 사용자 정의 이름입니다. 이름은 고유한 것으로 보장되지 않으며 언제든지 변경할 수 있습니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  기계 학습 변환에 대한 사용자 정의된 긴 형식의 설명 텍스트입니다. 설명은 고유한 것으로 보장되지 않으며 언제든지 변경할 수 있습니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `NOT_READY` \$1 `READY` \$1 `DELETING`).

  기계 학습 변환의 현재 상태입니다.
+ `CreatedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 기계 학습 변환이 생성된 시간과 날짜입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 기계 학습 변환이 수정된 마지막 시점입니다.
+ `InputRecordTables` – [GlueTable](#aws-glue-api-machine-learning-api-GlueTable) 객체의 배열이며 구조는 10개 이하입니다.

  변환에 사용된 AWS Glue 테이블 정의의 목록입니다.
+ `Parameters` – [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters) 객체입니다.

  `TransformParameters` 객체입니다. 파라미터를 통해 기계 학습 변환이 학습하는 데이터 및 다양한 트레이드오프(예: 재현율 대비 귀중함 또는 비용 대비 정확도)에 대한 기본 설정을 지정하여 기계 학습 변환의 동작을 튜닝(사용자 지정)할 수 있습니다.
+ `EvaluationMetrics` – [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics) 객체입니다.

  `EvaluationMetrics` 객체입니다. 평가 지표는 기계 학습 변환의 예상 품질을 제공합니다.
+ `LabelCount` - 숫자(정수)입니다.

  이 변환에 대해 AWS Glue에서 생성된 레이블 지정 파일에 대한 카운트 식별자입니다. 더 좋은 변환을 만들면 레이블 지정 파일을 반복적으로 다운로드하고 레이블 지정하고 업로드할 수 있습니다.
+ `Schema` – [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn) 객체의 배열이며 구조는 100개 이하입니다.

  이 변환이 실행할 수 있는 열과 데이터 형식을 나타내는 키-값 페어의 맵입니다. 100열의 상한이 있습니다.
+ `Role` – UTF-8 문자열입니다.

  필수 권한이 있는 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다. 필요한 권한에는 AWS Glue 리소스에 대한 AWS Glue 서비스 역할 권한과 변환에서 요구하는 Amazon S3 권한 모두가 포함됩니다.
  + 이 역할에는 AWS Glue의 리소스에 대한 액세스 허용을 위한 AWS Glue 서비스 역할 권한이 필요합니다. [AWS Glue에 액세스하는 IAM 사용자에게 정책 연결](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html)을 참조하세요.
  + 이 역할에는 작업 실행에서 이 변환에 사용되는 Amazon Simple Storage Service(Amazon S3) 소스, 대상, 임시 디렉터리, 스크립트 및 모든 라이브러리에 대한 권한이 필요합니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  이 값은 이러한 기계 학습 변환과 호환되는 AWS Glue의 버전을 결정합니다. Glue 1.0은 대부분의 고객에게 권장됩니다. 값이 설정되지 않은 경우 Glue 호환성은 Glue 0.9로 기본 설정됩니다. 자세한 내용은 개발자 안내서의 [AWS Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions)을 참조하세요.
+ `MaxCapacity` - 숫자(double)입니다.

  이 변환의 태스크 실행에 할당된 AWS Glue 데이터 처리 장치(DPU)의 수입니다. 2\$1100DPU를 할당할 수 있으며, 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  `MaxCapacity`는 `NumberOfWorkers` 및 `WorkerType`과 함께 사용할 수 없는 옵션입니다.
  + `NumberOfWorkers`나 `WorkerType` 중 하나가 설정되면 `MaxCapacity`를 설정할 수 없습니다.
  + `MaxCapacity`가 설정되면 `NumberOfWorkers`와 `WorkerType` 모두 설정할 수 없습니다.
  + `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
  + `MaxCapacity`와 `NumberOfWorkers`는 1 이상이어야 합니다.

  `WorkerType` 필드를 `Standard` 이외의 다른 값으로 설정하면 `MaxCapacity` 필드가 자동으로 설정되고 읽기 전용이 됩니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  이 변환의 작업이 실행될 때 할당되는 미리 정의된 작업자의 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 64GB 디스크와, 작업자당 실행기 1개를 제공합니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 8vCPU, 32GB 메모리 및 128GB 디스크와, 작업자당 실행기 1개를 제공합니다.

  `MaxCapacity`는 `NumberOfWorkers` 및 `WorkerType`과 함께 사용할 수 없는 옵션입니다.
  + `NumberOfWorkers`나 `WorkerType` 중 하나가 설정되면 `MaxCapacity`를 설정할 수 없습니다.
  + `MaxCapacity`가 설정되면 `NumberOfWorkers`와 `WorkerType` 모두 설정할 수 없습니다.
  + `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
  + `MaxCapacity`와 `NumberOfWorkers`는 1 이상이어야 합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  변환의 작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.

  `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  기계 학습 변환의 시간 초과(분)입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  기계 학습 변환의 `MLTaskRun`이 실패한 후 최대 재시도 횟수입니다.
+ `TransformEncryption` – [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption) 객체입니다.

  사용자 데이터 액세스에 적용되는 변환의 유휴 시 암호화 설정입니다. 기계 학습 변환에서는 KMS를 사용하여 Amazon S3의 암호화된 사용자 데이터에 액세스할 수 있습니다.

## FindMatchesParameters 구조
<a name="aws-glue-api-machine-learning-api-FindMatchesParameters"></a>

일치 항목 찾기 변환을 구성하기 위한 파라미터입니다.

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

  소스 테이블에서 행을 고유하게 식별하는 열의 이름입니다. 일치하는 레코드를 식별하기 위해 사용됩니다.
+ `PrecisionRecallTradeoff` – 1.0 이하의 숫자(실수)입니다.

  정밀도와 재현율 간의 균형을 위해 변환을 튜닝할 때 선택하는 값입니다. 값 0.5는 기본 설정 없음, 값 1.0은 순전히 정밀도에 대한 바이어스, 값 0.0은 재현율에 대한 바이어스를 의미합니다. 이 값은 트레이드오프이기 때문에 1.0에 가까운 값을 선택하면 매우 낮은 재현율을 의미하고 0.0에 가까운 값을 선택하면 매우 낮은 정밀도를 나타냅니다.

  정밀도 지표는 모델이 일치를 정확하게 예측하는 빈도를 나타냅니다.

  재현율 지표는 실제 일치에 대해 모델이 일치를 예측하는 빈도를 나타냅니다.
+ `AccuracyCostTradeoff` – 1.0 이하의 숫자(실수)입니다.

  정확도와 비용 간의 균형을 위해 변환을 튜닝할 때 선택하는 값입니다. 값 0.5는 시스템이 정확도 및 비용 문제의 균형을 유지하고 있음을 의미합니다. 값 1.0은 순전히 정확도에 대한 바이어스를 의미하며 일반적으로 더 높은 비용, 때로는 상당히 더 높은 비용을 나타냅니다. 값 0.0은 순전히 비용에 대한 바이어스를 의미하며 비교적 정확하지 않은 `FindMatches` 변환, 때로는 용인할 수 없는 수준의 정확도를 나타냅니다.

  정확도는 변환이 참 긍정과 참 부정을 얼마나 잘 찾는지 측정합니다. 정확도를 증가시키려면 더 많은 기계 리소스와 비용이 필요합니다. 하지만 이렇게 하면 재현율도 증가합니다.

  비용은 변환을 실행하는 데 얼마나 많은 컴퓨팅 리소스(따라서 비용)가 사용되는지를 측정합니다.
+ `EnforceProvidedLabels` – 부울입니다.

  사용자가 제공한 레이블과 일치하는 강제 출력을 켜거나 끄는 값입니다. 값이 `True`이면 `find matches` 변환은 제공된 레이블과 일치하도록 출력을 강제합니다. 결과는 일반 융합 결과를 재정의합니다. 값이 `False`이면 `find matches` 변환은 제공된 모든 레이블이 존중될 것을 보장하지 않으며 결과는 교육된 모델에 따라 다릅니다.

  이 값을 true로 설정하면 융합 실행 시간이 증가합니다.

## FindMatchesMetrics 구조
<a name="aws-glue-api-machine-learning-api-FindMatchesMetrics"></a>

일치 항목 찾기 알고리즘에 대한 평가 지표입니다. 기계 학습 변환의 품질은 변환을 가져와서 몇 가지 일치를 예측하고 동일한 데이터세트의 알려진 일치 항목과 결과를 비교하여 측정됩니다. 품질 지표는 데이터의 하위 세트를 기반으로 하므로 정밀하지 않습니다.

**Fields**
+ `AreaUnderPRCurve` – 1.0 이하의 숫자(실수)입니다.

  정밀도/재현율 곡선(AUPRC) 아래 면적은 변환의 전체 품질을 측정하는 단일 숫자이며, 이 숫자는 재현율 대비 정밀도에 대해 수행한 선택과 무관합니다. 값이 높을수록 더 매력적인 재현율 대비 정밀도 트레이드오프가 있음을 나타냅니다.

  자세한 내용은 Wikipedia의 [정밀도 및 재현율](https://en.wikipedia.org/wiki/Precision_and_recall)을 참조하십시오.
+ `Precision` – 1.0 이하의 숫자(실수)입니다.

  정밀도 지표는 변환이 일치를 정확하게 예측하는 빈도를 나타냅니다. 특히 정밀도는 변환이 총 참 긍정에서 참 긍정을 얼마나 잘 찾는지를 측정합니다.

  자세한 내용은 Wikipedia의 [정밀도 및 재현율](https://en.wikipedia.org/wiki/Precision_and_recall)을 참조하십시오.
+ `Recall` – 1.0 이하의 숫자(실수)입니다.

  재현율 지표는 실제 일치에 대해 변환이 일치를 예측하는 빈도를 나타냅니다. 특히 재현율은 변환이 소스 데이터의 총 레코드에서 참 긍정을 얼마나 잘 찾는지를 측정합니다.

  자세한 내용은 Wikipedia의 [정밀도 및 재현율](https://en.wikipedia.org/wiki/Precision_and_recall)을 참조하십시오.
+ `F1` – 1.0 이하의 숫자(실수)입니다.

  최대 F1 지표는 0\$11 범위에서 변환의 정확도를 나타냅니다. 여기서 1은 최상의 정확도입니다.

  자세한 내용은 Wikipedia의 [F1 점수](https://en.wikipedia.org/wiki/F1_score)를 참조하십시오.
+ `ConfusionMatrix` – [ConfusionMatrix](#aws-glue-api-machine-learning-api-ConfusionMatrix) 객체입니다.

  혼동 행렬은 변환이 무엇을 정확하게 예측하고 있으며 어떤 유형의 오류가 발생하고 있는지를 보여 줍니다.

  자세한 내용은 Wikipedia의 [혼동 행렬](https://en.wikipedia.org/wiki/Confusion_matrix)을 참조하십시오.
+ `ColumnImportances` – [ColumnImportance](#aws-glue-api-machine-learning-api-ColumnImportance) 객체의 배열이며 구조는 100개 이하입니다.

  중요도 내림차순으로 정렬된 열 중요도 지표를 포함하는 `ColumnImportance` 구조 목록입니다.

## ConfusionMatrix 구조
<a name="aws-glue-api-machine-learning-api-ConfusionMatrix"></a>

혼동 행렬은 변환이 무엇을 정확하게 예측하고 있으며 어떤 유형의 오류가 발생하고 있는지를 보여 줍니다.

자세한 내용은 Wikipedia의 [혼동 행렬](https://en.wikipedia.org/wiki/Confusion_matrix)을 참조하십시오.

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

  변환에 대한 혼동 행렬에서 변환이 올바르게 찾은 데이터의 일치 항목 수입니다.
+ `NumFalsePositives` - 숫자(정수)입니다.

  변환에 대한 혼동 행렬에서 변환이 일치 항목으로 잘못 분류한 데이터의 불일치 항목 수입니다.
+ `NumTrueNegatives` - 숫자(정수)입니다.

  변환에 대한 혼동 행렬에서 변환이 올바르게 거부한 데이터의 일치 항목 수입니다.
+ `NumFalseNegatives` - 숫자(정수)입니다.

  변환에 대한 혼동 행렬에서 변환이 찾지 못한 데이터의 일치 항목 수입니다.

## GlueTable 구조
<a name="aws-glue-api-machine-learning-api-GlueTable"></a>

입력 또는 출력 데이터에 사용되는 AWS Glue Data Catalog의 데이터베이스와 테이블입니다.

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

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

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

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

  AWS Glue Data Catalog에 대한 연결 이름입니다.
+ `AdditionalOptions` – 1\$110개 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 설명 문자열(2,048바이트 이하)입니다.

  테이블에 대한 추가 옵션입니다. 현재 지원되는 키는 두 가지입니다.
  + `pushDownPredicate`: 데이터 세트 내 모든 파일을 나열하거나 읽지 않아도 파티션에 필터링합니다.
  + `catalogPartitionPredicate`: AWS Glue Data Catalog에서 파티션 인덱스를 사용하여 서버측 파티션 프루닝을 사용합니다.

## TaskRun 구조
<a name="aws-glue-api-machine-learning-api-TaskRun"></a>

기계 학습 변환과 연결된 샘플링 파라미터입니다.

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

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

  이 작업 실행의 고유 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  요청된 작업 실행의 현재 상태입니다.
+ `LogGroupName` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 보안 로깅을 위한 로그 그룹의 이름입니다.
+ `Properties` – [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties) 객체입니다.

  이 작업 실행과 연결된 구성 속성을 지정합니다.
+ `ErrorString` – UTF-8 문자열입니다.

  이 작업 실행과 연결된 오류 문자열의 목록입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 작업 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  요청된 작업 실행이 업데이트된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  요청된 작업 실행이 완료된 마지막 시점입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 작업 실행이 리소스를 사용한 시간(초).입니다.

## TransformFilterCriteria 구조
<a name="aws-glue-api-machine-learning-api-TransformFilterCriteria"></a>

기계 학습 변환을 핕터링하는 데 사용되는 기준입니다.

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

  기계 학습 변환을 필터링하는 데 사용되는 고유의 변환 이름입니다.
+ `TransformType` – UTF-8 문자열입니다(유효한 값: `FIND_MATCHES`).

  기계 학습 변환을 필터링하는 데 사용되는 기계 학습 변환의 유형입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `NOT_READY` \$1 `READY` \$1 `DELETING`).

  마지막으로 알려진 변환 상태를 기준으로 기계 학습 변환 목록을 필터링합니다(변환을 사용할 수 있는지 여부를 나타냄). "NOT\$1READY", "READY" 또는 "DELETING" 중 하나입니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  이 값은 이러한 기계 학습 변환과 호환되는 AWS Glue의 버전을 결정합니다. Glue 1.0은 대부분의 고객에게 권장됩니다. 값이 설정되지 않은 경우 Glue 호환성은 Glue 0.9로 기본 설정됩니다. 자세한 내용은 개발자 안내서의 [AWS Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions)을 참조하세요.
+ `CreatedBefore` – 타임스탬프입니다.

  그 이전에 변환이 생성된 시간과 날짜입니다.
+ `CreatedAfter` – 타임스탬프입니다.

  그 이후에 변환이 생성된 시간과 날짜입니다.
+ `LastModifiedBefore` – 타임스탬프입니다.

  이 날짜 이전에 마지막으로 수정된 변환에서 필터링합니다.
+ `LastModifiedAfter` – 타임스탬프입니다.

  이 날짜 이후에 마지막으로 수정된 변환에서 필터링합니다.
+ `Schema` – [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn) 객체의 배열이며 구조는 100개 이하입니다.

  특정 스키마를 사용하여 데이터세트에서 필터링합니다. `Map<Column, Type>` 객체는 이 변환이 허용하는 스키마를 나타내는 키-값 페어의 배열입니다. 여기서 `Column`은 열의 이름이고 `Type`은 정수 또는 문자열과 같은 데이터 형식입니다. 100열의 상한이 있습니다.

## TransformSortCriteria 구조
<a name="aws-glue-api-machine-learning-api-TransformSortCriteria"></a>

기계 학습 변환과 연결된 정렬 기준입니다.

**Fields**
+ `Column` – *필수:* UTF-8 문자열입니다(유효한 값: `NAME` \$1 `TRANSFORM_TYPE` \$1 `STATUS` \$1 `CREATED` \$1 `LAST_MODIFIED`).

  기계 학습 변환과 연결된 정렬 기준에 사용할 열입니다.
+ `SortDirection` – *필수:* UTF-8 문자열입니다(유효한 값: `DESCENDING` \$1 `ASCENDING`).

  기계 학습 변환과 연결된 정렬 기준에 사용할 정렬 방향입니다.

## TaskRunFilterCriteria 구조
<a name="aws-glue-api-machine-learning-api-TaskRunFilterCriteria"></a>

기계 학습 변환에 대한 작업 실행을 필터링하는 데 사용되는 기준입니다.

**Fields**
+ `TaskRunType` – UTF-8 문자열입니다(유효한 값: `EVALUATION` \$1 `LABELING_SET_GENERATION` \$1 `IMPORT_LABELS` \$1 `EXPORT_LABELS` \$1 `FIND_MATCHES`).

  작업 실행의 유형입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  작업 실행의 현재 상태입니다.
+ `StartedBefore` – 타임스탬프입니다.

  이 날짜 이전에 시작된 작업 실행에서 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  이 날짜 이후에 시작된 작업 실행에서 필터링합니다.

## TaskRunSortCriteria 구조
<a name="aws-glue-api-machine-learning-api-TaskRunSortCriteria"></a>

기계 학습 변환에 대한 작업 실행 목록을 정렬하는 데 사용되는 정렬 기준입니다.

**Fields**
+ `Column` – *필수:* UTF-8 문자열입니다(유효한 값: `TASK_RUN_TYPE` \$1 `STATUS` \$1 `STARTED`).

  기계 학습 변환에 대한 작업 실행 목록을 정렬하는 데 사용할 열입니다.
+ `SortDirection` – *필수:* UTF-8 문자열입니다(유효한 값: `DESCENDING` \$1 `ASCENDING`).

  기계 학습 변환에 대한 작업 실행 목록을 정렬하는 데 사용할 정렬 방향입니다.

## TaskRunProperties 구조
<a name="aws-glue-api-machine-learning-api-TaskRunProperties"></a>

작업 실행에 대한 구성 속성입니다.

**Fields**
+ `TaskType` – UTF-8 문자열입니다(유효한 값: `EVALUATION` \$1 `LABELING_SET_GENERATION` \$1 `IMPORT_LABELS` \$1 `EXPORT_LABELS` \$1 `FIND_MATCHES`).

  작업 실행의 유형입니다.
+ `ImportLabelsTaskRunProperties` – [ImportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties) 객체입니다.

  가져오기 레이블 작업 실행에 대한 구성 속성입니다.
+ `ExportLabelsTaskRunProperties` – [ExportLabelsTaskRunProperties](#aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties) 객체입니다.

  내보내기 레이블 작업 실행에 대한 구성 속성입니다.
+ `LabelingSetGenerationTaskRunProperties` – [LabelingSetGenerationTaskRunProperties](#aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties) 객체입니다.

  레이블 지정 세트 생성 작업 실행에 대한 구성 속성입니다.
+ `FindMatchesTaskRunProperties` – [FindMatchesTaskRunProperties](#aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties) 객체입니다.

  일치 항목 찾기 작업 실행에 대한 구성 속성입니다.

## FindMatchesTaskRunProperties 구조
<a name="aws-glue-api-machine-learning-api-FindMatchesTaskRunProperties"></a>

일치 항목 찾기 작업 실행에 대한 구성 속성을 지정합니다.

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

  일치 항목 찾기 작업 실행의 작업 ID입니다.
+ `JobName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  일치 항목 찾기 작업 실행에 대한 작업에 할당된 이름입니다
+ `JobRunId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  일치 항목 찾기 작업 실행의 작업 실행 ID입니다.

## ImportLabelsTaskRunProperties 구조
<a name="aws-glue-api-machine-learning-api-ImportLabelsTaskRunProperties"></a>

가져오기 레이블 작업 실행에 대한 구성 속성을 지정합니다.

**Fields**
+ `InputS3Path` – UTF-8 문자열입니다.

  레이블을 가져올 Amazon Simple Storage Service(Amazon S3) 경로입니다.
+ `Replace` – 부울입니다.

  기존 레이블을 덮어쓸지 여부를 표시합니다.

## ExportLabelsTaskRunProperties 구조
<a name="aws-glue-api-machine-learning-api-ExportLabelsTaskRunProperties"></a>

내보내기 레이블 작업 실행에 대한 구성 속성을 지정합니다.

**Fields**
+ `OutputS3Path` – UTF-8 문자열입니다.

  레이블을 내보낼 Amazon Simple Storage Service(Amazon S3) 경로입니다.

## LabelingSetGenerationTaskRunProperties 구조
<a name="aws-glue-api-machine-learning-api-LabelingSetGenerationTaskRunProperties"></a>

레이블 지정 세트 생성 작업 실행에 대한 구성 속성을 지정합니다.

**Fields**
+ `OutputS3Path` – UTF-8 문자열입니다.

  레이블 지정 세트를 생성할 Amazon Simple Storage Service(Amazon S3) 경로입니다.

## SchemaColumn 구조
<a name="aws-glue-api-machine-learning-api-SchemaColumn"></a>

이 변환이 실행할 수 있는 열과 데이터 형식을 나타내는 키-값 페어입니다. `Schema`의 `MLTransform` 파라미터에는 이러한 구조가 최대 100개까지 포함될 수 있습니다.

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

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

  열에 있는 데이터의 형식입니다.

## TransformEncryption 구조
<a name="aws-glue-api-machine-learning-api-TransformEncryption"></a>

사용자 데이터 액세스에 적용되는 변환의 유휴 시 암호화 설정입니다. 기계 학습 변환에서는 KMS를 사용하여 Amazon S3의 암호화된 사용자 데이터에 액세스할 수 있습니다.

또한 가져온 레이블 및 교육된 변환은 이제 고객이 제공한 KMS 키를 사용하여 암호화할 수 있습니다.

**Fields**
+ `MlUserDataEncryption` – [MLUserDataEncryption](#aws-glue-api-machine-learning-api-MLUserDataEncryption) 객체입니다.

  `MLUserDataEncryption` 객체는 암호화 모드 및 고객 제공 KMS 키 ID를 포함합니다.
+ `TaskRunSecurityConfigurationName` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  보안 구성의 이름입니다.

## MLUserDataEncryption 구조
<a name="aws-glue-api-machine-learning-api-MLUserDataEncryption"></a>

사용자 데이터 액세스에 적용되는 변환의 유휴 시 암호화 설정입니다.

**Fields**
+ `MlUserDataEncryptionMode` – *필수:* UTF-8 문자열입니다(유효한 값: `DISABLED` \$1 `SSE-KMS="SSEKMS"`).

  사용자 데이터에 적용되는 암호화 모드입니다. 유효한 값은 다음과 같습니다.
  + DISABLED: 암호화가 비활성화됨
  + SSEKMS: Amazon S3에 저장된 사용자 데이터에 대해 AWS Key Management Service(SSE-KMS) 와 서버 측 암호화를 사용합니다.
+ `KmsKeyId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  고객이 제공한 KMS 키의 ID입니다.

## ColumnImportance 구조
<a name="aws-glue-api-machine-learning-api-ColumnImportance"></a>

열에 대한 열 이름 및 열 중요도 점수를 포함하는 구조입니다.

열 중요도는 레코드에서 다른 열보다 더 중요한 열을 식별하여 열이 모델에 어떻게 기여하는지 이해하는 데 도움이 됩니다.

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

  열의 이름입니다.
+ `Importance` – 1.0 이하의 숫자(실수)입니다.

  열에 대한 열 중요도 점수(10진수)입니다.

## 작업
<a name="aws-glue-api-machine-learning-api-actions"></a>
+ [CreateMLTransform 작업(Python: create\$1ml\$1transform)](#aws-glue-api-machine-learning-api-CreateMLTransform)
+ [UpdateMLTransform 작업(Python: update\$1ml\$1transform)](#aws-glue-api-machine-learning-api-UpdateMLTransform)
+ [DeleteMLTransform 작업(Python: delete\$1ml\$1transform)](#aws-glue-api-machine-learning-api-DeleteMLTransform)
+ [GetMLTransform 작업(Python: get\$1ml\$1transform)](#aws-glue-api-machine-learning-api-GetMLTransform)
+ [GetMLTransforms 작업(Python: get\$1ml\$1transforms)](#aws-glue-api-machine-learning-api-GetMLTransforms)
+ [ListMLTransforms 작업(Python: list\$1ml\$1transforms)](#aws-glue-api-machine-learning-api-ListMLTransforms)
+ [StartMLEvaluationTaskRun 작업(Python: start\$1ml\$1evaluation\$1task\$1run)](#aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun)
+ [StartMLLabelingSetGenerationTaskRun 작업(Python: start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)](#aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun)
+ [GetMLTaskRun 작업(Python: get\$1ml\$1task\$1run)](#aws-glue-api-machine-learning-api-GetMLTaskRun)
+ [GetMLTaskRuns 작업(Python: get\$1ml\$1task\$1runs)](#aws-glue-api-machine-learning-api-GetMLTaskRuns)
+ [CancelMLTaskRun 작업(Python: cancel\$1ml\$1task\$1run)](#aws-glue-api-machine-learning-api-CancelMLTaskRun)
+ [StartExportLabelsTaskRun 작업(Python: start\$1export\$1labels\$1task\$1run)](#aws-glue-api-machine-learning-api-StartExportLabelsTaskRun)
+ [StartImportLabelsTaskRun 작업(Python: start\$1import\$1labels\$1task\$1run)](#aws-glue-api-machine-learning-api-StartImportLabelsTaskRun)

## CreateMLTransform 작업(Python: create\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-CreateMLTransform"></a>

AWS Glue 기계 학습 변환을 생성합니다. 이 작업은 변환과 변환을 교육하는 데 필요한 모든 파라미터를 생성합니다.

데이터 중복 제거에 기계 학습 변환(예: `FindMatches` 변환)을 사용하는 프로세스의 첫 번째 단계로 이 작업을 호출합니다. 알고리즘에 사용할 파라미터 외에도 선택 사항인 `Description`을 제공할 수 있습니다.

데이터에서 학습하고 고품질 기계 학습 변환을 생성하는 과정의 일부로 AWS Glue가 자동으로 실행하는 태스크에 대한 특정 파라미터도 지정해야 합니다. 이러한 파라미터에는 `Role`과 선택 사항으로 `AllocatedCapacity`, `Timeout` 및 `MaxRetries`가 포함됩니다. 자세한 내용은 [작업](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-jobs-job.html)을 참조하십시오.

**요청**
+ `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)

  정의하고 있는 기계 학습 변환에 대한 설명입니다. 기본값은 빈 문자열입니다.
+ `InputRecordTables` – *필수(Required):* [GlueTable](#aws-glue-api-machine-learning-api-GlueTable) 객체의 배열이며 구조는 10개 이하입니다.

  변환에 사용된 AWS Glue 테이블 정의의 목록입니다.
+ `Parameters` – *필수(Required):* [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters) 객체입니다.

  사용된 변환 유형에 특정한 알고리즘 파라미터입니다. 조건부로 변환 유형에 따라 다릅니다.
+ `Role` – *필수(Required):* UTF-8 문자열입니다.

  필수 권한이 있는 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다. 필요한 권한에는 AWS Glue 리소스에 대한 AWS Glue 서비스 역할 권한과 변환에서 요구하는 Amazon S3 권한 모두가 포함됩니다.
  + 이 역할에는 AWS Glue의 리소스에 대한 액세스 허용을 위한 AWS Glue 서비스 역할 권한이 필요합니다. [AWS Glue에 액세스하는 IAM 사용자에게 정책 연결](https://docs.aws.amazon.com/glue/latest/dg/attach-policy-iam-user.html)을 참조하세요.
  + 이 역할에는 작업 실행에서 이 변환에 사용되는 Amazon Simple Storage Service(Amazon S3) 소스, 대상, 임시 디렉터리, 스크립트 및 모든 라이브러리에 대한 권한이 필요합니다.
+ `GlueVersion` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  이 값은 이러한 기계 학습 변환과 호환되는 AWS Glue의 버전을 결정합니다. Glue 1.0은 대부분의 고객에게 권장됩니다. 값이 설정되지 않은 경우 Glue 호환성은 Glue 0.9로 기본 설정됩니다. 자세한 내용은 개발자 안내서의 [AWS Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions)을 참조하세요.
+ `MaxCapacity` - 숫자(double)입니다.

  이 변환의 태스크 실행에 할당된 AWS Glue 데이터 처리 장치(DPU)의 수입니다. 2\$1100DPU를 할당할 수 있으며, 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  `MaxCapacity`는 `NumberOfWorkers` 및 `WorkerType`과 함께 사용할 수 없는 옵션입니다.
  + `NumberOfWorkers`나 `WorkerType` 중 하나가 설정되면 `MaxCapacity`를 설정할 수 없습니다.
  + `MaxCapacity`가 설정되면 `NumberOfWorkers`와 `WorkerType` 모두 설정할 수 없습니다.
  + `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
  + `MaxCapacity`와 `NumberOfWorkers`는 1 이상이어야 합니다.

  `WorkerType` 필드를 `Standard` 이외의 다른 값으로 설정하면 `MaxCapacity` 필드가 자동으로 설정되고 읽기 전용이 됩니다.

  `WorkerType` 필드를 `Standard` 이외의 다른 값으로 설정하면 `MaxCapacity` 필드가 자동으로 설정되고 읽기 전용이 됩니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  이 작업이 실행될 때 할당되는 미리 정의된 작업자의 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 64GB 디스크와, 작업자당 실행기 1개를 제공합니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 8vCPU, 32GB 메모리 및 128GB 디스크와, 작업자당 실행기 1개를 제공합니다.

  `MaxCapacity`는 `NumberOfWorkers` 및 `WorkerType`과 함께 사용할 수 없는 옵션입니다.
  + `NumberOfWorkers`나 `WorkerType` 중 하나가 설정되면 `MaxCapacity`를 설정할 수 없습니다.
  + `MaxCapacity`가 설정되면 `NumberOfWorkers`와 `WorkerType` 모두 설정할 수 없습니다.
  + `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
  + `MaxCapacity`와 `NumberOfWorkers`는 1 이상이어야 합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  이 작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.

  `WorkerType`이 설정되면 `NumberOfWorkers`가 필요합니다(반대의 경우도 마찬가지).
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  이 변환에 대한 작업 실행의 제한 시간(분)입니다. 이 값은 이 변환에 대한 작업 실행이 종료되고 `TIMEOUT` 상태로 전환되기 전에 리소스를 사용할 수 있는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  작업 실행이 실패한 후 이 변환에 대한 작업을 재시도할 최대 횟수입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이러한 기계 학습 변환에서 사용할 태그입니다. 태그를 사용하여 기계 학습 변환에 대한 액세스를 제한할 수 있습니다. AWS Glue의 태그에 대한 자세한 내용은 개발자 안내서의 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.
+ `TransformEncryption` – [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption) 객체입니다.

  사용자 데이터 액세스에 적용되는 변환의 유휴 시 암호화 설정입니다. 기계 학습 변환에서는 KMS를 사용하여 Amazon S3의 암호화된 사용자 데이터에 액세스할 수 있습니다.

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

  변환에 대해 생성되는 고유 식별자입니다.

**오류**
+ `AlreadyExistsException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `InternalServiceException`
+ `AccessDeniedException`
+ `ResourceNumberLimitExceededException`
+ `IdempotentParameterMismatchException`

## UpdateMLTransform 작업(Python: update\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-UpdateMLTransform"></a>

기존 기계 학습 변환을 업데이트합니다. 더 좋은 결과를 달성하도록 알고리즘 파라미터를 튜닝하려면 이 작업을 호출합니다.

이 작업을 호출한 후, `StartMLEvaluationTaskRun` 작업을 호출하여 새로운 파라미터가 목표를 얼마나 잘 달성했는지에 액세스할 수 있습니다(예: 기계 학습 변환의 품질 개선 또는 비용 효과 향상).

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

  변환을 생성할 때 생성된 고유 식별자입니다.
+ `Name` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  생성할 때 변환에 부여한 고유 이름입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  변환에 대한 설명입니다. 기본값은 빈 문자열입니다.
+ `Parameters` – [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters) 객체입니다.

  사용된 변환 유형(알고리즘)에 특정한 구성 파라미터입니다. 조건부로 변환 유형에 따라 다릅니다.
+ `Role` – UTF-8 문자열입니다.

  필수 권한이 있는 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `GlueVersion` – 과 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  이 값은 이러한 기계 학습 변환과 호환되는 AWS Glue의 버전을 결정합니다. Glue 1.0은 대부분의 고객에게 권장됩니다. 값이 설정되지 않은 경우 Glue 호환성은 Glue 0.9로 기본 설정됩니다. 자세한 내용은 개발자 안내서의 [AWS Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions)을 참조하세요.
+ `MaxCapacity` - 숫자(double)입니다.

  이 변환의 태스크 실행에 할당된 AWS Glue 데이터 처리 장치(DPU)의 수입니다. 2\$1100DPU를 할당할 수 있으며, 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  `WorkerType` 필드를 `Standard` 이외의 다른 값으로 설정하면 `MaxCapacity` 필드가 자동으로 설정되고 읽기 전용이 됩니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  이 작업이 실행될 때 할당되는 미리 정의된 작업자의 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 64GB 디스크와, 작업자당 실행기 1개를 제공합니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 8vCPU, 32GB 메모리 및 128GB 디스크와, 작업자당 실행기 1개를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  이 작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  이 변환에 대한 작업 실행의 제한 시간(분)입니다. 이 값은 이 변환에 대한 작업 실행이 종료되고 `TIMEOUT` 상태로 전환되기 전에 리소스를 사용할 수 있는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  작업 실행이 실패한 후 이 변환에 대한 작업을 재시도할 최대 횟수입니다.

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

  업데이트된 변환의 고유 식별자입니다.

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

## DeleteMLTransform 작업(Python: delete\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-DeleteMLTransform"></a>

AWS Glue 기계 학습 변환을 삭제합니다. 기계 학습 변환은 기계 학습을 통해 사람이 제공한 사례에서 학습하여 수행할 변환에 대한 세부 정보를 학습하는 특수한 유형의 변환입니다. 그런 다음 이러한 변환은 AWS Glue에 의해 저장됩니다. 변환이 더 이상 필요하지 않으면 `DeleteMLTransforms`를 호출하여 변환을 삭제할 수 있습니다. 하지만 삭제된 변환을 여전히 참조하는 AWS Glue 작업은 더 이상 성공하지 못합니다.

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

  삭제할 변환의 고유 식별자입니다.

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

  삭제된 변환의 고유 식별자입니다.

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

## GetMLTransform 작업(Python: get\$1ml\$1transform)
<a name="aws-glue-api-machine-learning-api-GetMLTransform"></a>

AWS Glue 기계 학습 변환 아티팩트와 모든 해당 메타데이터를 가져옵니다. 기계 학습 변환은 기계 학습을 통해 사람이 제공한 사례에서 학습하여 수행할 변환에 대한 세부 정보를 학습하는 특수한 유형의 변환입니다. 그런 다음 이러한 변환은 AWS Glue에 의해 저장됩니다. `GetMLTransform`을 호출하여 해당 메타데이터를 검색할 수 있습니다.

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

  변환을 생성할 때 생성된 변환의 고유 식별자입니다.

**응답**
+ `TransformId` – 과(와) 일치하는 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)

  변환을 생성할 때 변환에 지정된 고유 이름입니다.
+ `Description` – 과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다..[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)

  변환에 대한 설명입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `NOT_READY` \$1 `READY` \$1 `DELETING`).

  변환의 마지막 알려진 상태입니다(변환을 사용할 수 있는지 여부를 나타냄). "NOT\$1READY", "READY" 또는 "DELETING" 중 하나입니다.
+ `CreatedOn` – 타임스탬프입니다.

  변환이 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  변환이 수정된 날짜와 시간입니다.
+ `InputRecordTables` – [GlueTable](#aws-glue-api-machine-learning-api-GlueTable) 객체의 배열이며 구조는 10개 이하입니다.

  변환에 사용된 AWS Glue 테이블 정의의 목록입니다.
+ `Parameters` – [TransformParameters](#aws-glue-api-machine-learning-api-TransformParameters) 객체입니다.

  사용된 알고리즘에 특정한 구성 파라미터입니다.
+ `EvaluationMetrics` – [EvaluationMetrics](#aws-glue-api-machine-learning-api-EvaluationMetrics) 객체입니다.

  최신 평가 지표입니다.
+ `LabelCount` - 숫자(정수)입니다.

  이 변환에 사용 가능한 레이블 수입니다.
+ `Schema` – [SchemaColumn](#aws-glue-api-machine-learning-api-SchemaColumn) 객체의 배열이며 구조는 100개 이하입니다.

  이 변환이 허용하는 스키마를 나타내는 `Map<Column, Type>` 객체입니다. 100열의 상한이 있습니다.
+ `Role` – UTF-8 문자열입니다.

  필수 권한이 있는 IAM 역할의 이름 또는 Amazon 리소스 이름(ARN)입니다.
+ `GlueVersion` – 과 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Custom string pattern #48](aws-glue-api-common.md#regex_48)

  이 값은 이러한 기계 학습 변환과 호환되는 AWS Glue의 버전을 결정합니다. Glue 1.0은 대부분의 고객에게 권장됩니다. 값이 설정되지 않은 경우 Glue 호환성은 Glue 0.9로 기본 설정됩니다. 자세한 내용은 개발자 안내서의 [AWS Glue 버전](https://docs.aws.amazon.com/glue/latest/dg/release-notes.html#release-notes-versions)을 참조하세요.
+ `MaxCapacity` - 숫자(double)입니다.

  이 변환의 태스크 실행에 할당된 AWS Glue 데이터 처리 장치(DPU)의 수입니다. 2\$1100DPU를 할당할 수 있으며, 기본값은 10입니다. DPU는 4 vCPU의 컴퓨팅 파워와 16GB 메모리로 구성된 프로세싱 파워의 상대적 측정값입니다. 자세한 내용은 [AWS Glue 요금](https://aws.amazon.com/glue/pricing/) 페이지를 참조하세요.

  `WorkerType` 필드를 `Standard` 이외의 다른 값으로 설정하면 `MaxCapacity` 필드가 자동으로 설정되고 읽기 전용이 됩니다.
+ `WorkerType` – UTF-8 문자열입니다(유효한 값: `Standard=""` \$1 `G.1X=""` \$1 `G.2X=""` \$1 `G.025X=""` \$1 `G.4X=""` \$1 `G.8X=""` \$1 `Z.2X=""`).

  이 작업이 실행될 때 할당되는 미리 정의된 작업자의 유형입니다. Standard, G.1X 또는 G.2X 값을 허용합니다.
  + `Standard` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 50GB 디스크와, 작업자당 실행기 2개를 제공합니다.
  + `G.1X` 작업자 유형의 경우, 각 작업자가 4vCPU, 16GB 메모리 및 64GB 디스크와, 작업자당 실행기 1개를 제공합니다.
  + `G.2X` 작업자 유형의 경우, 각 작업자가 8vCPU, 32GB 메모리 및 128GB 디스크와, 작업자당 실행기 1개를 제공합니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  이 작업이 실행될 때 할당되는 정의된 `workerType`의 작업자 수입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  이 변환에 대한 작업 실행의 제한 시간(분)입니다. 이 값은 이 변환에 대한 작업 실행이 종료되고 `TIMEOUT` 상태로 전환되기 전에 리소스를 사용할 수 있는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `MaxRetries` - 숫자(정수)입니다.

  작업 실행이 실패한 후 이 변환에 대한 작업을 재시도할 최대 횟수입니다.
+ `TransformEncryption` – [TransformEncryption](#aws-glue-api-machine-learning-api-TransformEncryption) 객체입니다.

  사용자 데이터 액세스에 적용되는 변환의 유휴 시 암호화 설정입니다. 기계 학습 변환에서는 KMS를 사용하여 Amazon S3의 암호화된 사용자 데이터에 액세스할 수 있습니다.

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

## GetMLTransforms 작업(Python: get\$1ml\$1transforms)
<a name="aws-glue-api-machine-learning-api-GetMLTransforms"></a>

기존 AWS Glue 기계 학습 변환의 정렬 가능하고 필터링 가능한 목록을 가져옵니다. 기계 학습 변환은 기계 학습을 통해 사람이 제공한 사례에서 학습하여 수행할 변환에 대한 세부 정보를 학습하는 특수한 유형의 변환입니다. 그런 다음 이러한 변환은 AWS Glue에 의해 저장되며, `GetMLTransforms`를 호출하여 해당 메타데이터를 검색할 수 있습니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `Filter` – [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria) 객체입니다.

  변환 필터링 기준입니다.
+ `Sort` – [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria) 객체입니다.

  정렬 기준입니다.

**응답**
+ `Transforms` – **필수(Required): [MLTransform](#aws-glue-api-machine-learning-api-MLTransform) 객체의 배열입니다.

  기계 학습 변환의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## ListMLTransforms 작업(Python: list\$1ml\$1transforms)
<a name="aws-glue-api-machine-learning-api-ListMLTransforms"></a>

 이 AWS 계정에 있는 기존의 AWS Glue 기계 학습 변환이나 지정된 태그가 있는 리소스에 대한 정렬 및 필터링 가능한 목록을 검색합니다. 이 작업을 수행하면 응답의 필터로 사용할 수 있는 `Tags` 필드 옵션이 검색되기 때문에 태그가 지정된 리소스를 하나의 그룹으로 검색할 수 있습니다. 태그 필터링을 사용하기로 선택하면 태그가 포함된 리소스만 검색됩니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  이것이 지속적인 요청이라면 지속적인 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 목록의 최대 크기.
+ `Filter` – [TransformFilterCriteria](#aws-glue-api-machine-learning-api-TransformFilterCriteria) 객체입니다.

  기계 학습 변환을 핕터링하는 데 사용되는 `TransformFilterCriteria`입니다.
+ `Sort` – [TransformSortCriteria](#aws-glue-api-machine-learning-api-TransformSortCriteria) 객체입니다.

  기계 학습 변환을 정렬하는 데 사용되는 `TransformSortCriteria`입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이렇게 태그가 지정된 리소스만 반환하도록 지정합니다.

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

  계정의 모든 기계 학습 변환이나 태그가 지정된 기계 학습의 식별자입니다.
+ `NextToken` – UTF-8 문자열입니다.

  반환된 목록이 사용가능한 마지막 지표를 포함하지 경우의 연속 토큰입니다.

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

## StartMLEvaluationTaskRun 작업(Python: start\$1ml\$1evaluation\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartMLEvaluationTaskRun"></a>

변환 품질을 예상하기 위한 작업을 시작합니다.

레이블 집합을 truth의 사례로 제공하면 AWS Glue 기계 학습은 이러한 사례 중 일부를 사용하여 해당 사례에서 학습합니다. 나머지 레이블은 품질을 예상하기 위한 테스트로 사용됩니다.

실행의 고유 식별자를 반환합니다. `GetMLTaskRun`을 호출하여 `EvaluationTaskRun` 통계에 대한 자세한 정보를 가져올 수 있습니다.

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

  기계 학습 변환의 고유 식별자입니다.

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

  이 실행과 연결된 고유 식별자입니다.

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

## StartMLLabelingSetGenerationTaskRun 작업(Python: start\$1ml\$1labeling\$1set\$1generation\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartMLLabelingSetGenerationTaskRun"></a>

레이블 세트를 생성하고 레이블을 지정하여 변환의 품질을 개선하기 위해 기계 학습 변환에 대한 활성 학습 워크플로우를 시작합니다.

`StartMLLabelingSetGenerationTaskRun`이 완료되면 AWS Glue는 "레이블 지정 집합" 또는 사람이 답변할 질문 집합을 생성합니다.

`FindMatches` 변환의 경우 이러한 질문은 "일치하는 레코드로 완전히 구성된 그룹으로 이러한 행을 함께 그룹화하는 올바른 방법은 무엇입니까?"와 같은 형식입니다.

레이블 지정 프로세스가 완료된 후에는 `StartImportLabelsTaskRun`을 호출하여 레이블을 업로드할 수 있습니다. `StartImportLabelsTaskRun`이 완료된 후에는 기계 학습 변환의 모든 향후 실행이 새롭고 개선된 레이블을 사용하며 더 높은 품질의 변환을 수행합니다.

참고: 생성된 레이블 지정 세트를 `OutputS3Path`에 쓰는 데 사용되는 역할은 `CreateMLTransform` API에 지정된 기계 학습 변환과 연결된 역할입니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `OutputS3Path` – *필수(Required):* UTF-8 문자열입니다.

  레이블 지정 세트를 생성하는 Amazon Simple Storage Service(Amazon S3) 경로입니다.

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

  이 작업 실행과 연결된 고유의 실행 식별자입니다.

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

## GetMLTaskRun 작업(Python: get\$1ml\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRun"></a>

기계 학습 변환의 특정 작업 실행에 대한 세부 사항을 가져옵니다. 기계 학습 태스크 실행은 다양한 기계 학습 워크플로의 일부로 AWS Glue가 자동으로 실행하는 비동기 태스크입니다. `GetMLTaskRun` 및 해당 상위 변환의 `TaskRunID`와 함께 `TransformID`을 호출하여 모든 작업 실행의 통계를 확인할 수 있습니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `TaskRunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행의 고유 식별자입니다.

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

  작업 실행의 고유 식별자입니다.
+ `TaskRunId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 작업 실행의 상태입니다.
+ `LogGroupName` – UTF-8 문자열입니다.

  작업 실행과 연결된 로그 그룹의 이름입니다.
+ `Properties` – [TaskRunProperties](#aws-glue-api-machine-learning-api-TaskRunProperties) 객체입니다.

  작업 실행과 연결된 속성의 목록입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  작업 실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 작업 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  이 작업 실행이 마지막으로 수정된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 작업 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 작업 실행이 리소스를 사용한 시간(초).입니다.

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

## GetMLTaskRuns 작업(Python: get\$1ml\$1task\$1runs)
<a name="aws-glue-api-machine-learning-api-GetMLTaskRuns"></a>

기계 학습 변환에 대한 실행 목록을 가져옵니다. 기계 학습 태스크 실행은 다양한 기계 학습 워크플로의 일부로 AWS Glue가 자동으로 실행하는 비동기 태스크입니다. 이 단원에 기록된 해당 상위 변환의 `GetMLTaskRuns` 및 기타 선택적 파라미터와 함께 `TransformID`를 호출하여 정렬 가능하고 필터링 가능한 기계 학습 작업 실행 목록을 가져올 수 있습니다.

이 작업은 기록 실행 목록을 반환하며 페이지를 매겨야 합니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과의 페이지 매김에 대한 토큰입니다. 기본값은 비어 있음입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `Filter` – [TaskRunFilterCriteria](#aws-glue-api-machine-learning-api-TaskRunFilterCriteria) 객체입니다.

  작업 실행에 대한 `TaskRunFilterCriteria` 구조의 필터 기준입니다.
+ `Sort` – [TaskRunSortCriteria](#aws-glue-api-machine-learning-api-TaskRunSortCriteria) 객체입니다.

  작업 실행에 대한 `TaskRunSortCriteria` 구조의 정렬 기준입니다.

**응답**
+ `TaskRuns` – [TaskRun](#aws-glue-api-machine-learning-api-TaskRun) 객체의 배열입니다.

  변환과 연결된 작업 실행의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## CancelMLTaskRun 작업(Python: cancel\$1ml\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-CancelMLTaskRun"></a>

작업 실행을 취소(중지)합니다. 기계 학습 태스크 실행은 다양한 기계 학습 워크플로의 일부로 AWS Glue가 자동으로 실행하는 비동기 태스크입니다. 작업 실행의 상위 변환의 `CancelMLTaskRun` 및 작업 실행의 `TransformID`와 함께 `TaskRunId`을 호출하여 언제든지 기계 학습 작업 실행을 취소할 수 있습니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `TaskRunId` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  작업 실행의 고유 식별자입니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `TaskRunId` – 과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다..[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)

  작업 실행의 고유 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.

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

## StartExportLabelsTaskRun 작업(Python: start\$1export\$1labels\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartExportLabelsTaskRun"></a>

특정 변환에 대해 레이블 지정된 모든 데이터를 내보내기 위한 비동기 작업을 시작합니다. 이 작업은 일반적인 활성 학습 워크플로우의 일부가 아닌 유일한 레이블 관련 API 호출입니다. 이전에 truth로 제출한 레이블을 제거하거나 변경하려는 경우와 같이 모든 기존 레이블을 동시에 작업하려는 경우에 일반적으로 `StartExportLabelsTaskRun`을 사용합니다. 이 API 작업은 레이블을 내보내려고 하는 `TransformId` 및 레이블을 내보낼 Amazon Simple Storage Service(Amazon S3) 경로를 허용합니다. 이 작업은 `TaskRunId`를 반환합니다. `GetMLTaskRun` API를 호출하여 작업 실행의 상태를 확인할 수 있습니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `OutputS3Path` – *필수(Required):* UTF-8 문자열입니다.

  레이블을 내보내는 Amazon S3 경로입니다.

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

  작업 실행의 고유 식별자입니다.

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

## StartImportLabelsTaskRun 작업(Python: start\$1import\$1labels\$1task\$1run)
<a name="aws-glue-api-machine-learning-api-StartImportLabelsTaskRun"></a>

기계 학습 변환을 교육하고 품질을 개선하는 데 사용할 추가 레이블(truth의 사례)을 제공할 수 있습니다. 일반적으로 이 API 작업은 `StartMLLabelingSetGenerationTaskRun` 호출로 시작하고 결국 기계 학습 변환의 품질을 개선하는 활성 학습 워크플로우의 일부로 사용됩니다.

`StartMLLabelingSetGenerationTaskRun`이 완료되면 AWS Glue 기계 학습은 사람이 답변할 일련의 질문을 생성합니다. (기계 학습 워크플로우에서는 이러한 질문에 답변하는 것을 흔히 ‘레이블 지정’이라고 합니다). `FindMatches` 변환의 경우 이러한 질문은 "일치하는 레코드로 완전히 구성된 그룹으로 이러한 행을 함께 그룹화하는 올바른 방법은 무엇입니까?"와 같은 형식입니다. 레이블 지정 프로세스가 완료된 후 사용자는 `StartImportLabelsTaskRun`을 호출하여 답변/레이블을 업로드할 수 있습니다. `StartImportLabelsTaskRun`이 완료된 후에는 기계 학습 변환의 모든 향후 실행이 새롭고 개선된 레이블을 사용하며 더 높은 품질의 변환을 수행합니다.

기본적으로 `StartMLLabelingSetGenerationTaskRun`를 true로 설정하지 않는 한 `Replace`은 업로드하는 모든 레이블에서 지속적으로 학습하고 업로드하는 모든 레이블을 결합합니다. `Replace`를 true로 설정하면 `StartImportLabelsTaskRun`은 이전에 업로드한 모든 레이블을 삭제하고 잊어버리며 업로드하는 정확한 세트에서만 학습합니다. 레이블 바꾸기는 잘못된 레이블을 이전에 업로드한 것을 인식하고 해당 레이블이 변환 품질에 부정적인 영향을 미치고 있다고 확신하는 경우에 유용할 수 있습니다.

`GetMLTaskRun` 작업을 호출하여 작업 실행의 상태를 확인할 수 있습니다.

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

  기계 학습 변환의 고유 식별자입니다.
+ `InputS3Path` – *필수(Required):* UTF-8 문자열입니다.

  레이블을 가져올 Amazon Simple Storage Service(Amazon S3) 경로입니다.
+ `ReplaceAllLabels` – 부울입니다.

  기존 레이블을 덮어쓸지 여부를 표시합니다.

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

  작업 실행의 고유 식별자입니다.

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

# 데이터 품질 API
<a name="aws-glue-api-data-quality-api"></a>

데이터 품질 API는 데이터 품질 데이터 유형에 대해 설명하며 데이터 품질 규칙 세트, 실행 및 평가를 생성, 삭제 또는 업데이트하기 위한 API를 포함합니다.

## 데이터 타입
<a name="aws-glue-api-data-quality-api-objects"></a>
+ [DataSource 구조](#aws-glue-api-data-quality-api-DataSource)
+ [DataQualityRulesetListDetails 구조](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails)
+ [DataQualityTargetTable 구조](#aws-glue-api-data-quality-api-DataQualityTargetTable)
+ [DataQualityRulesetEvaluationRunDescription 구조](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription)
+ [DataQualityRulesetEvaluationRunFilter 구조](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter)
+ [DataQualityEvaluationRunAdditionalRunOptions 구조](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions)
+ [DataQualityRuleRecommendationRunDescription 구조](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription)
+ [DataQualityRuleRecommendationRunFilter 구조](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter)
+ [DataQualityResult 구조](#aws-glue-api-data-quality-api-DataQualityResult)
+ [DataQualityAnalyzerResult 구조](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult)
+ [DataQualityObservation 구조](#aws-glue-api-data-quality-api-DataQualityObservation)
+ [MetricBasedObservation 구조](#aws-glue-api-data-quality-api-MetricBasedObservation)
+ [DataQualityMetricValues 구조](#aws-glue-api-data-quality-api-DataQualityMetricValues)
+ [DataQualityRuleResult 구조](#aws-glue-api-data-quality-api-DataQualityRuleResult)
+ [DataQualityResultDescription 구조](#aws-glue-api-data-quality-api-DataQualityResultDescription)
+ [DataQualityResultFilterCriteria 구조](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria)
+ [DataQualityRulesetFilterCriteria 구조](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria)
+ [DataQualityAggregatedMetrics 구조](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics)
+ [StatisticAnnotation 구조](#aws-glue-api-data-quality-api-StatisticAnnotation)
+ [TimestampedInclusionAnnotation 구조](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation)
+ [AnnotationError 구조](#aws-glue-api-data-quality-api-AnnotationError)
+ [DatapointInclusionAnnotation 구조](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation)
+ [StatisticSummaryList 목록](#aws-glue-api-data-quality-api-StatisticSummaryList)
+ [StatisticSummary 구조](#aws-glue-api-data-quality-api-StatisticSummary)
+ [RunIdentifier 구조](#aws-glue-api-data-quality-api-RunIdentifier)
+ [StatisticModelResult 구조](#aws-glue-api-data-quality-api-StatisticModelResult)
+ [DataQualityGlueTable 구조](#aws-glue-api-data-quality-api-DataQualityGlueTable)

## DataSource 구조
<a name="aws-glue-api-data-quality-api-DataSource"></a>

데이터 품질 결과를 얻으려는 데이터 소스(AWS Glue 테이블)입니다.

**필드**
+ `GlueTable` – [GlueTable](aws-glue-api-machine-learning-api.md#aws-glue-api-machine-learning-api-GlueTable) 객체입니다.

  AWS Glue 테이블
+ `DataQualityGlueTable` – [DataQualityGlueTable](#aws-glue-api-data-quality-api-DataQualityGlueTable) 객체입니다.

  Data Quality 작업에 대한 AWS Glue 테이블.

## DataQualityRulesetListDetails 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetListDetails"></a>

`GetDataQualityRuleset`에서 반환되는 데이터 품질 규칙 세트를 설명합니다.

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

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

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `CreatedOn` – 타임스탬프입니다.

  데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  데이터 품질 규칙 세트가 마지막으로 수정된 날짜와 시간입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

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

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `RuleCount` - 숫자(정수)입니다.

  규칙 세트의 규칙 수입니다.

## DataQualityTargetTable 구조
<a name="aws-glue-api-data-quality-api-DataQualityTargetTable"></a>

AWS Glue 테이블을 나타내는 객체입니다.

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

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

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

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

## DataQualityRulesetEvaluationRunDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription"></a>

데이터 품질 규칙 세트 평가 실행 결과를 설명합니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `StartedOn` – 타임스탬프입니다.

  실행이 시작된 날짜와 시간입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.

## DataQualityRulesetEvaluationRunFilter 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter"></a>

필터 기준입니다.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  실행과 연결된 데이터 소스(AWS Glue 테이블)를 기반으로 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  이 시간 이전에 시작된 실행을 기준으로 결과를 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  이 시간 이후에 시작된 실행을 기준으로 결과를 필터링합니다.

## DataQualityEvaluationRunAdditionalRunOptions 구조
<a name="aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions"></a>

평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.

**필드**
+ `CloudWatchMetricsEnabled` – 부울입니다.

  CloudWatch 지표를 활성화할지 여부입니다.
+ `ResultsS3Prefix` – UTF-8 문자열입니다.

  결과를 저장할 Amazon S3의 접두사입니다.
+ `CompositeRuleEvaluationMethod` – UTF-8 문자열입니다(유효한 값: `COLUMN` \$1 `ROW`).

  규칙 세트의 복합 규칙 평가 방법을 ROW/COLUMN으로 설정합니다.

## DataQualityRuleRecommendationRunDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription"></a>

데이터 품질 규칙 권장 실행 결과를 설명합니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  권장 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.

## DataQualityRuleRecommendationRunFilter 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter"></a>

데이터 품질 권장 실행을 나열하기 위한 필터입니다.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  지정된 데이터 원본(AWS Glue 테이블)을 기반으로 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  제공된 시간 이전에 시작된 결과에 대한 시간을 기준으로 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  제공된 시간 이후에 시작된 결과에 대한 시간을 기준으로 필터링합니다.

## DataQualityResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityResult"></a>

데이터 품질 결과를 설명합니다.

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

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 데이터 품질 결과에 대한 규칙 세트 평가의 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

## DataQualityAnalyzerResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityAnalyzerResult"></a>

데이터 품질 분석기의 평가 결과를 설명합니다.

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

  데이터 품질 분석기의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  데이터 품질 분석기에 대한 설명입니다.
+ `EvaluationMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가 메시지입니다.
+ `EvaluatedMetrics` – 키-값 페어의 맵 배열입니다.

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

  각 값은 숫자(double)입니다.

  분석기 평가와 관련된 지표의 맵입니다.

## DataQualityObservation 구조
<a name="aws-glue-api-data-quality-api-DataQualityObservation"></a>

규칙과 분석기를 평가한 후 생성된 관찰을 설명합니다.

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

  데이터 품질 관찰에 대한 설명입니다.
+ `MetricBasedObservation` – [MetricBasedObservation](#aws-glue-api-data-quality-api-MetricBasedObservation) 객체입니다.

  평가된 데이터 품질 지표를 기반으로 하는 관찰을 나타내는 `MetricBasedObservation` 유형의 객체입니다.

## MetricBasedObservation 구조
<a name="aws-glue-api-data-quality-api-MetricBasedObservation"></a>

평가된 데이터 품질 지표를 기반으로 생성된 지표 기반 관찰을 설명합니다.

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

  관찰을 생성하는 데 사용된 데이터 품질 지표의 이름입니다.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `MetricValues` – [DataQualityMetricValues](#aws-glue-api-data-quality-api-DataQualityMetricValues) 객체입니다.

  데이터 품질 지표 값의 분석을 나타내는 유형 `DataQualityMetricValues`의 객체입니다.
+ `NewRules` – UTF-8 문자열의 배열입니다.

  데이터 품질 지표 값을 기반으로 관찰의 일부로 생성된 새 데이터 품질 규칙의 목록입니다.

## DataQualityMetricValues 구조
<a name="aws-glue-api-data-quality-api-DataQualityMetricValues"></a>

과거 데이터 분석에 따른 데이터 품질 지표 값을 설명합니다.

**필드**
+ `ActualValue` - 숫자(double)입니다.

  데이터 품질 지표의 실제 값입니다.
+ `ExpectedValue` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표의 예상 값입니다.
+ `LowerLimit` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표 값의 하한입니다.
+ `UpperLimit` - 숫자(double)입니다.

  과거 데이터 분석에 따른 데이터 품질 지표 값의 상한입니다.

## DataQualityRuleResult 구조
<a name="aws-glue-api-data-quality-api-DataQualityRuleResult"></a>

데이터 품질 규칙 평가 결과를 설명합니다.

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

  데이터 품질 규칙의 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙에 대한 설명입니다.
+ `EvaluationMessage` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가 메시지입니다.
+ `Result` – UTF-8 문자열입니다(유효한 값: `PASS` \$1 `FAIL` \$1 `ERROR`).

  규칙의 통과 또는 실패 상태입니다.
+ `EvaluatedMetrics` – 키-값 페어의 맵 배열입니다.

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

  각 값은 숫자(double)입니다.

  규칙 평가와 관련된 지표 맵입니다.
+ `EvaluatedRule` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 UTF-8 문자열입니다.

  평가된 규칙입니다.
+ `RuleMetrics` – 키-값 페어의 맵 배열입니다.

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

  각 값은 숫자(double)입니다.

  행 수준 결과를 기반으로 규칙 평가와 연결된 지표가 포함된 맵입니다.

## DataQualityResultDescription 구조
<a name="aws-glue-api-data-quality-api-DataQualityResultDescription"></a>

데이터 품질 결과를 설명합니다.

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

  이 데이터 품질 결과의 고유한 결과 ID입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

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

  데이터 품질 결과와 연결된 작업 이름입니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 시간입니다.

## DataQualityResultFilterCriteria 구조
<a name="aws-glue-api-data-quality-api-DataQualityResultFilterCriteria"></a>

데이터 품질 결과를 반환하는 데 사용되는 기준입니다.

**필드**
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  지정된 데이터 소스별로 결과를 필터링합니다. 예를 들어 AWS Glue 테이블의 모든 결과를 검색합니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  지정된 작업 이름을 기준으로 결과를 필터링합니다.
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  지정된 작업 실행 ID를 기준으로 결과를 필터링합니다.
+ `StartedAfter` – 타임스탬프입니다.

  이 시간 이후에 시작된 실행을 기준으로 결과를 필터링합니다.
+ `StartedBefore` – 타임스탬프입니다.

  이 시간 이전에 시작된 실행을 기준으로 결과를 필터링합니다.

## DataQualityRulesetFilterCriteria 구조
<a name="aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria"></a>

데이터 품질 규칙 세트를 필터링하는 데 사용되는 기준입니다.

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

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

  규칙 세트 필터 기준에 대한 설명입니다.
+ `CreatedBefore` – 타임스탬프입니다.

  이 날짜 이전에 생성된 규칙 세트에서 필터링합니다.
+ `CreatedAfter` – 타임스탬프입니다.

  이 날짜 이후에 생성된 규칙 세트에서 필터링합니다.
+ `LastModifiedBefore` – 타임스탬프입니다.

  이 날짜 이전에 마지막으로 수정된 규칙 세트에서 필터링합니다.
+ `LastModifiedAfter` – 타임스탬프입니다.

  이 날짜 이후에 마지막으로 수정된 규칙 세트에서 필터링합니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.

## DataQualityAggregatedMetrics 구조
<a name="aws-glue-api-data-quality-api-DataQualityAggregatedMetrics"></a>

행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 지표 요약입니다.

**필드**
+ `TotalRowsProcessed` - 숫자(double)입니다.

  데이터 품질 평가 중에 처리된 행의 총 개수입니다.
+ `TotalRowsPassed` - 숫자(double)입니다.

  해당하는 모든 데이터 품질 규칙을 통과한 행의 총 개수입니다.
+ `TotalRowsFailed` - 숫자(double)입니다.

  하나 이상의 데이터 품질 규칙에서 실패한 행의 총 개수입니다.
+ `TotalRulesProcessed` - 숫자(double)입니다.

  평가된 데이터 품질 규칙의 총 개수입니다.
+ `TotalRulesPassed` - 숫자(double)입니다.

  평가 기준을 통과한 데이터 품질 규칙의 총 개수입니다.
+ `TotalRulesFailed` - 숫자(double)입니다.

  평가 기준을 충족하지 못한 데이터 품질 규칙의 총 개수입니다.

## StatisticAnnotation 구조
<a name="aws-glue-api-data-quality-api-StatisticAnnotation"></a>

통계 주석.

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

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

  통계 ID입니다.
+ `StatisticRecordedOn` – 타임스탬프입니다.

  주석이 달린 통계가 기록된 시점의 타임스탬프.
+ `InclusionAnnotation` – [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation) 객체입니다.

  통계에 적용된 포함 주석.

## TimestampedInclusionAnnotation 구조
<a name="aws-glue-api-data-quality-api-TimestampedInclusionAnnotation"></a>

타임스탬프가 지정된 포함 주석.

**필드**
+ `Value` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  포함 주석 값.
+ `LastModifiedOn` – 타임스탬프입니다.

  포함 주석이 마지막으로 수정된 시점의 타임스탬프.

## AnnotationError 구조
<a name="aws-glue-api-data-quality-api-AnnotationError"></a>

실패한 주석.

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

  실패한 주석의 프로필 ID.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실패한 주석의 통계 ID.
+ `FailureReason` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  주석이 실패한 이유.

## DatapointInclusionAnnotation 구조
<a name="aws-glue-api-data-quality-api-DatapointInclusionAnnotation"></a>

포함 주석.

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

  통계가 속한 데이터 품질 프로필의 ID.
+ `StatisticId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 ID입니다.
+ `InclusionAnnotation` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  통계에 적용할 포함 주석 값.

## StatisticSummaryList 목록
<a name="aws-glue-api-data-quality-api-StatisticSummaryList"></a>

`StatisticSummary` 목록.

[StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary) 객체 어레이.

`StatisticSummary` 목록.

## StatisticSummary 구조
<a name="aws-glue-api-data-quality-api-StatisticSummary"></a>

통계에 대한 요약 정보.

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

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

  프로필 ID.
+ `RunIdentifier` – [RunIdentifier](#aws-glue-api-data-quality-api-RunIdentifier) 객체입니다.

  실행 식별자
+ `StatisticName` – [Custom string pattern #16](aws-glue-api-common.md#regex_16)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  통계 이름.
+ `DoubleValue` - 숫자(double)입니다.

  통계 값.
+ `EvaluationLevel` – UTF-8 문자열입니다(유효한 값: `Dataset="DATASET"` \$1 `Column="COLUMN"` \$1 `Multicolumn="MULTICOLUMN"`).

  통계의 평가 수준. 가능한 값: `Dataset`, `Column`, `Multicolumn`.
+ `ColumnsReferenced` – UTF-8 문자열의 배열입니다.

  통계에서 참조하는 열 목록.
+ `ReferencedDatasets` – UTF-8 문자열의 배열입니다.

  통계에서 참조하는 데이터세트 목록.
+ `StatisticProperties` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 설명 문자열(2,048바이트 이하)입니다.

  `NameString` 및 `DescriptionString`이 포함된 `StatisticPropertiesMap`
+ `RecordedOn` – 타임스탬프입니다.

  통계가 기록된 시점의 타임스탬프.
+ `InclusionAnnotation` – [TimestampedInclusionAnnotation](#aws-glue-api-data-quality-api-TimestampedInclusionAnnotation) 객체입니다.

  통계의 포함 주석.

## RunIdentifier 구조
<a name="aws-glue-api-data-quality-api-RunIdentifier"></a>

실행 식별자.

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

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

  작업 실행 ID.

## StatisticModelResult 구조
<a name="aws-glue-api-data-quality-api-StatisticModelResult"></a>

통계 모델 결과.

**필드**
+ `LowerBound` - 숫자(double)입니다.

  하한.
+ `UpperBound` - 숫자(double)입니다.

  상한.
+ `PredictedValue` - 숫자(double)입니다.

  예측된 값.
+ `ActualValue` - 숫자(double)입니다.

  실제 값.
+ `Date` – 타임스탬프입니다.

  날짜.
+ `InclusionAnnotation` – UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  포함 주석.

## DataQualityGlueTable 구조
<a name="aws-glue-api-data-quality-api-DataQualityGlueTable"></a>

Data Quality 작업에 대한 입력 또는 출력 데이터에 사용되는 AWS Glue Data Catalog의 데이터베이스 및 테이블.

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

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

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

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

  AWS Glue Data Catalog에 대한 연결 이름입니다.
+ `AdditionalOptions` – 1\$110개 페어로 구성된 키-값 페어의 맵 배열입니다.

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

  각 값은 [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)와 일치하는 설명 문자열(2,048바이트 이하)입니다.

  테이블에 대한 추가 옵션입니다. 현재 지원되는 키는 두 가지입니다.
  + `pushDownPredicate`: 데이터 세트 내 모든 파일을 나열하거나 읽지 않아도 파티션에 필터링합니다.
  + `catalogPartitionPredicate`: AWS Glue Data Catalog에서 파티션 인덱스를 사용하여 서버측 파티션 프루닝을 사용합니다.
+ `PreProcessingQuery` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 51,200바이트 이하 길이의 UTF-8 문자열.

  Data Quality 작업을 실행하기 전에 AWS Glue Data Catalog에서 테이블의 데이터를 사전 처리하는 데 사용할 수 있는 SparkSQL 형식의 SQL 쿼리.

## 운영
<a name="aws-glue-api-data-quality-api-actions"></a>
+ [StartDataQualityRulesetEvaluationRun 작업(Python: start\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun)
+ [CancelDataQualityRulesetEvaluationRun 작업(Python: cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun)
+ [GetDataQualityRulesetEvaluationRun 작업(Python: get\$1data\$1quality\$1ruleset\$1evaluation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun)
+ [ListDataQualityRulesetEvaluationRuns 작업(Python: list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns)
+ [StartDataQualityRuleRecommendationRun 작업(Python: start\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun)
+ [CancelDataQualityRuleRecommendationRun 작업(Python: cancel\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun)
+ [GetDataQualityRuleRecommendationRun 작업(Python: get\$1data\$1quality\$1rule\$1recommendation\$1run)](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun)
+ [ListDataQualityRuleRecommendationRuns 작업(Python: list\$1data\$1quality\$1rule\$1recommendation\$1runs)](#aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns)
+ [GetDataQualityResult 작업(Python: get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-GetDataQualityResult)
+ [BatchGetDataQualityResult 작업(Python: batch\$1get\$1data\$1quality\$1result)](#aws-glue-api-data-quality-api-BatchGetDataQualityResult)
+ [ListDataQualityResults 작업(Python: list\$1data\$1quality\$1results)](#aws-glue-api-data-quality-api-ListDataQualityResults)
+ [CreateDataQualityRuleset 작업(Python: create\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-CreateDataQualityRuleset)
+ [DeleteDataQualityRuleset 작업(Python: delete\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-DeleteDataQualityRuleset)
+ [GetDataQualityRuleset 작업(Python: get\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-GetDataQualityRuleset)
+ [ListDataQualityRulesets 작업(Python: list\$1data\$1quality\$1rulesets)](#aws-glue-api-data-quality-api-ListDataQualityRulesets)
+ [UpdateDataQualityRuleset 작업(Python: update\$1data\$1quality\$1ruleset)](#aws-glue-api-data-quality-api-UpdateDataQualityRuleset)
+ [ListDataQualityStatistics 작업(Python: list\$1data\$1quality\$1statistics)](#aws-glue-api-data-quality-api-ListDataQualityStatistics)
+ [TimestampFilter 구조](#aws-glue-api-data-quality-api-TimestampFilter)
+ [CreateDataQualityRulesetRequest 구조](#aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest)
+ [GetDataQualityRulesetResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityRulesetResponse)
+ [GetDataQualityResultResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityResultResponse)
+ [StartDataQualityRuleRecommendationRunRequest 구조](#aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest)
+ [GetDataQualityRuleRecommendationRunResponse 구조](#aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse)
+ [BatchPutDataQualityStatisticAnnotation 작업(Python: batch\$1put\$1data\$1quality\$1statistic\$1annotation)](#aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation)
+ [GetDataQualityModel 작업(Python: get\$1data\$1quality\$1model)](#aws-glue-api-data-quality-api-GetDataQualityModel)
+ [GetDataQualityModelResult 작업(Python: get\$1data\$1quality\$1model\$1result)](#aws-glue-api-data-quality-api-GetDataQualityModelResult)
+ [ListDataQualityStatisticAnnotations 작업(Python: list\$1data\$1quality\$1statistic\$1annotations)](#aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations)
+ [PutDataQualityProfileAnnotation 작업(Python: put\$1data\$1quality\$1profile\$1annotation)](#aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation)

## StartDataQualityRulesetEvaluationRun 작업(Python: start\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRulesetEvaluationRun"></a>

규칙 세트 정의(권장 또는 사용자 고유)가 있는 경우 이 작업을 호출하여 데이터 소스(AWS Glue 테이블)를 기준으로 규칙 세트를 평가합니다. 평가 시 `GetDataQualityResult` API로 검색할 수 있는 결과가 계산됩니다.

**요청**
+ `DataSource` – **필수(Required): [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.
+ `AdditionalRunOptions` – [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.
+ `RulesetNames` – *필수:* 1\$110개 문자열의 UTF-8 문자열 배열입니다.

  규칙 세트 이름의 목록입니다.
+ `AdditionalDataSources` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 데이터 소스에 대한 참조 문자열의 맵입니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

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

## CancelDataQualityRulesetEvaluationRun 작업(Python: cancel\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRulesetEvaluationRun"></a>

데이터 소스에 대해 규칙 세트를 평가 중인 실행을 취소합니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

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

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

## GetDataQualityRulesetEvaluationRun 작업(Python: get\$1data\$1quality\$1ruleset\$1evaluation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetEvaluationRun"></a>

데이터 소스에 대해 규칙 세트를 평가하는 특정 실행을 검색합니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 평가 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `AdditionalRunOptions` – [DataQualityEvaluationRunAdditionalRunOptions](#aws-glue-api-data-quality-api-DataQualityEvaluationRunAdditionalRunOptions) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 실행 옵션입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RulesetNames` – UTF-8 문자열의 배열입니다(1\$110개 문자열).

  실행에 대한 규칙 세트 이름 목록입니다. 현재 이 파라미터는 하나의 규칙 집합 이름만 사용합니다.
+ `ResultIds` – UTF-8 문자열의 배열입니다(1\$110개 문자열).

  실행의 데이터 품질 결과에 대한 결과 ID 목록입니다.
+ `AdditionalDataSources` – 키-값 페어의 맵 배열입니다.

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

  각 값은 [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  평가 실행에 대해 지정할 수 있는 추가 데이터 소스에 대한 참조 문자열의 맵입니다.

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

## ListDataQualityRulesetEvaluationRuns 작업(Python: list\$1data\$1quality\$1ruleset\$1evaluation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesetEvaluationRuns"></a>

규칙 세트가 데이터 소스에 대해 평가되는 필터 조건을 충족하는 모든 실행을 나열합니다.

**요청**
+ `Filter` – [DataQualityRulesetEvaluationRunFilter](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunFilter) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Runs` – [DataQualityRulesetEvaluationRunDescription](#aws-glue-api-data-quality-api-DataQualityRulesetEvaluationRunDescription) 객체의 배열입니다.

  데이터 품질 규칙 세트 실행을 나타내는 `DataQualityRulesetEvaluationRunDescription` 객체 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## StartDataQualityRuleRecommendationRun 작업(Python: start\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRun"></a>

어떤 규칙을 작성해야 할지 모를 때 규칙을 생성하는 데 사용되는 권장 실행을 시작합니다. AWS Glue 데이터 품질은 데이터를 분석하고 잠재적 규칙 세트에 대한 권장 사항을 제시합니다. 그런 다음 규칙 세트를 분류하고 생성된 규칙 세트를 원하는 대로 수정할 수 있습니다.

권장 사항 실행은 90일 후에 자동으로 삭제됩니다.

**요청**

데이터 품질 규칙 권장 사항 요청.
+ `DataSource` – **필수(Required): [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

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

## CancelDataQualityRuleRecommendationRun 작업(Python: cancel\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-CancelDataQualityRuleRecommendationRun"></a>

규칙을 생성하는 데 사용된 지정된 권장 실행을 취소합니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

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

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

## GetDataQualityRuleRecommendationRun 작업(Python: get\$1data\$1quality\$1rule\$1recommendation\$1run)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRun"></a>

규칙을 생성하는 데 사용된 지정된 권장 실행을 가져옵니다.

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

  이 실행과 연결된 고유의 실행 식별자입니다.

**응답**

데이터 품질 규칙 권장 사항 실행에 대한 응답.
+ `RunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RecommendedRuleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  시작 규칙 권장 실행이 완료되면 권장 규칙 세트(규칙 세트)가 생성됩니다. 이 멤버는 DQDL(데이터 품질 정의 언어) 형식 규칙을 포함합니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행에서 생성된 규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

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

## ListDataQualityRuleRecommendationRuns 작업(Python: list\$1data\$1quality\$1rule\$1recommendation\$1runs)
<a name="aws-glue-api-data-quality-api-ListDataQualityRuleRecommendationRuns"></a>

필터 기준에 맞는 권장 실행을 나열합니다.

**요청**
+ `Filter` – [DataQualityRuleRecommendationRunFilter](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunFilter) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Runs` – [DataQualityRuleRecommendationRunDescription](#aws-glue-api-data-quality-api-DataQualityRuleRecommendationRunDescription) 객체의 배열입니다.

  `DataQualityRuleRecommendationRunDescription` 객체의 목록.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## GetDataQualityResult 작업(Python: get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityResult"></a>

데이터 품질 규칙 평가 결과를 검색합니다.

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

  데이터 품질 결과의 고유한 결과 ID입니다.

**응답**

데이터 품질 결과에 대한 응답.
+ `ResultId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트 평가와 연결된 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

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

## BatchGetDataQualityResult 작업(Python: batch\$1get\$1data\$1quality\$1result)
<a name="aws-glue-api-data-quality-api-BatchGetDataQualityResult"></a>

지정된 결과 ID에 대한 데이터 품질 결과 목록을 검색합니다.

**요청**
+ `ResultIds` – **필수: 1\$1100개 문자열의 UTF-8 문자열 배열입니다.

  데이터 품질 결과에 대한 고유한 결과 ID 목록입니다.

**응답**
+ `Results` – **필수(Required): [DataQualityResult](#aws-glue-api-data-quality-api-DataQualityResult) 객체의 배열입니다.

  데이터 품질 결과를 나타내는 `DataQualityResult` 객체 목록입니다.
+ `ResultsNotFound` – UTF-8 문자열의 배열입니다(1\$1100개 문자열).

  결과를 찾을 수 없는 결과 ID 목록입니다.

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

## ListDataQualityResults 작업(Python: list\$1data\$1quality\$1results)
<a name="aws-glue-api-data-quality-api-ListDataQualityResults"></a>

계정의 모든 데이터 품질 실행 결과를 반환합니다.

**요청**
+ `Filter` – [DataQualityResultFilterCriteria](#aws-glue-api-data-quality-api-DataQualityResultFilterCriteria) 객체입니다.

  필터 기준입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

**응답**
+ `Results` – **필수(Required): [DataQualityResultDescription](#aws-glue-api-data-quality-api-DataQualityResultDescription) 객체의 배열입니다.

  `DataQualityResultDescription` 객체의 목록.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## CreateDataQualityRuleset 작업(Python: create\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-CreateDataQualityRuleset"></a>

지정된 AWS Glue 테이블에 적용된 DQDL 규칙을 사용하여 데이터 품질 규칙 세트를 생성합니다.

DQDL(데이터 품질 정의 언어)을 사용하여 규칙 세트를 생성합니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

**요청**

데이터 품질 규칙 세트를 생성하려는 요청.
+ `Name` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 규칙 세트의 고유한 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `Ruleset` – **필수: 2\$165536바이트 길이의 UTF-8 문자열입니다.

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  데이터 품질 규칙 세트에 적용된 태그 목록입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  데이터 품질 규칙 세트와 연결된 대상 테이블입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행의 고유한 실행 ID입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

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

  데이터 품질 규칙 세트의 고유한 이름입니다.

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

## DeleteDataQualityRuleset 작업(Python: delete\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-DeleteDataQualityRuleset"></a>

데이터 품질 규칙 세트를 삭제합니다.

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

  데이터 품질 규칙 세트의 이름입니다.

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

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

## GetDataQualityRuleset 작업(Python: get\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleset"></a>

식별자 또는 이름을 기준으로 기존 규칙 세트를 반환합니다.

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

  규칙 세트의 이름입니다.

**응답**

데이터 품질 규칙 세트 응답을 반환합니다.
+ `Name` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.
+ `CreatedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

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

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

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

## ListDataQualityRulesets 작업(Python: list\$1data\$1quality\$1rulesets)
<a name="aws-glue-api-data-quality-api-ListDataQualityRulesets"></a>

지정된 AWS Glue 테이블 목록에 대한 페이지 매김 규칙 세트 목록을 반환합니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `Filter` – [DataQualityRulesetFilterCriteria](#aws-glue-api-data-quality-api-DataQualityRulesetFilterCriteria) 객체입니다.

  필터 기준입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  키-값 페어 태그의 목록입니다.

**응답**
+ `Rulesets` – [DataQualityRulesetListDetails](#aws-glue-api-data-quality-api-DataQualityRulesetListDetails) 객체의 배열입니다.

  지정된 AWS Glue 테이블 목록에 대한 페이지 매김 규칙 세트 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

## UpdateDataQualityRuleset 작업(Python: update\$1data\$1quality\$1ruleset)
<a name="aws-glue-api-data-quality-api-UpdateDataQualityRuleset"></a>

지정된 데이터 품질 규칙 세트를 업데이트합니다.

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

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

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

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

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

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.

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

## ListDataQualityStatistics 작업(Python: list\$1data\$1quality\$1statistics)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatistics"></a>

데이터 품질 통계 목록을 검색합니다.

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

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

  프로필 ID.
+ `TimestampFilter` – [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter) 객체입니다.

  타임스탬프 필터.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  이 요청에서 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  결과의 다음 페이지를 요청하기 위한 페이지 매김 토큰.

**응답**
+ `Statistics` – [StatisticSummary](#aws-glue-api-data-quality-api-StatisticSummary) 객체의 배열입니다.

  `StatisticSummaryList`.
+ `NextToken` – UTF-8 문자열입니다.

  결과의 다음 페이지를 요청하기 위한 페이지 매김 토큰.

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

## TimestampFilter 구조
<a name="aws-glue-api-data-quality-api-TimestampFilter"></a>

타임스탬프 필터.

**필드**
+ `RecordedBefore` – 타임스탬프입니다.

  특정 시간 이전의 통계를 결과에 포함해야 하는 경우 해당 타임스탬프.
+ `RecordedAfter` – 타임스탬프입니다.

  특정 시간 이후의 통계를 결과에 포함해야 하는 경우 해당 타임스탬프.

## CreateDataQualityRulesetRequest 구조
<a name="aws-glue-api-data-quality-api-CreateDataQualityRulesetRequest"></a>

데이터 품질 규칙 세트를 생성하려는 요청.

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

  데이터 품질 규칙 세트의 고유한 이름입니다.
+ `Description` – [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri)과(와) 일치하는 2,048바이트 이하 길이의 설명 문자열입니다.

  데이터 품질 규칙 세트에 대한 설명입니다.
+ `Ruleset` – **필수: 2\$165536바이트 길이의 UTF-8 문자열입니다.

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  데이터 품질 규칙 세트에 적용된 태그 목록입니다.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  데이터 품질 규칙 세트와 연결된 대상 테이블입니다.
+ `RecommendationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  권장 실행의 고유한 실행 ID입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

## GetDataQualityRulesetResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityRulesetResponse"></a>

데이터 품질 규칙 세트 응답을 반환합니다.

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

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

  규칙 세트에 대한 설명입니다.
+ `Ruleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  DQDL(데이터 품질 정의 언어) 규칙 세트입니다. 자세한 내용은 AWS Glue 개발자 안내서를 참조하세요.
+ `TargetTable` – [DataQualityTargetTable](#aws-glue-api-data-quality-api-DataQualityTargetTable) 객체입니다.

  대상 테이블의 이름 및 데이터베이스 이름입니다.
+ `CreatedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 세트가 생성된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

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

  권장 실행에서 규칙 세트가 생성되면 이 실행 ID가 생성되어 두 규칙을 서로 연결합니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

## GetDataQualityResultResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityResultResponse"></a>

데이터 품질 결과에 대한 응답.

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

  데이터 품질 결과의 고유한 결과 ID입니다.
+ `ProfileId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과의 프로필 ID입니다.
+ `Score` – 1.0 이하의 숫자(실수)입니다.

  집계된 데이터 품질 점수입니다. 총 규칙 수에 전달된 규칙의 비율을 나타냅니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  데이터 품질 결과와 연결된 테이블입니다(있는 경우).
+ `RulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 규칙 세트의 이름입니다.
+ `EvaluationContext` – UTF-8 문자열입니다.

  AWS Glue Studio의 작업 컨텍스트에서 캔버스의 각 노드에는 일반적으로 일종의 이름이 할당되며 데이터 품질 노드에는 이름이 지정됩니다. 여러 노드의 경우 `evaluationContext`에서 노드를 구분할 수 있습니다.
+ `StartedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 시작된 날짜와 시간입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 데이터 품질 결과에 대한 실행이 완료된 날짜와 시간입니다.
+ `JobName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 이름입니다(있는 경우).
+ `JobRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 결과와 연결된 작업 실행 ID입니다(있는 경우).
+ `RulesetEvaluationRunId` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  규칙 세트 평가와 연결된 고유한 실행 ID입니다.
+ `RuleResults` – [DataQualityRuleResult](#aws-glue-api-data-quality-api-DataQualityRuleResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 규칙의 결과를 나타내는 `DataQualityRuleResult` 객체 목록입니다.
+ `AnalyzerResults` – [DataQualityAnalyzerResult](#aws-glue-api-data-quality-api-DataQualityAnalyzerResult) 객체의 배열이며 구조는 2,000개 이하입니다.

  각 분석기의 결과를 나타내는 `DataQualityAnalyzerResult` 객체의 목록입니다.
+ `Observations` – [DataQualityObservation](#aws-glue-api-data-quality-api-DataQualityObservation) 객체의 배열이며 구조는 50개 이하입니다.

  규칙과 분석기를 평가한 후 생성된 관찰을 나타내는 `DataQualityObservation` 객체의 목록입니다.
+ `AggregatedMetrics` – [DataQualityAggregatedMetrics](#aws-glue-api-data-quality-api-DataQualityAggregatedMetrics) 객체입니다.

   행 수준 결과를 기반으로 하는 통과/실패 통계를 포함하여 처리된 행 및 규칙의 총 개수를 보여주는 `DataQualityAggregatedMetrics` 객체 요약입니다.

## StartDataQualityRuleRecommendationRunRequest 구조
<a name="aws-glue-api-data-quality-api-StartDataQualityRuleRecommendationRunRequest"></a>

데이터 품질 규칙 권장 사항 요청.

**필드**
+ `DataSource` – *필수:* [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – *필수:* UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

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

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  멱등성에 사용되며 동일한 리소스의 여러 인스턴스를 생성하거나 시작하지 않으려면 임의의 ID(예: UUID)로 설정하는 것이 좋습니다.

## GetDataQualityRuleRecommendationRunResponse 구조
<a name="aws-glue-api-data-quality-api-GetDataQualityRuleRecommendationRunResponse"></a>

데이터 품질 규칙 권장 사항 실행에 대한 응답.

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

  이 실행과 연결된 고유의 실행 식별자입니다.
+ `DataSource` – [DataSource](#aws-glue-api-data-quality-api-DataSource) 객체입니다.

  이 실행과 연결된 데이터 소스(AWS Glue 테이블)입니다.
+ `Role` – UTF-8 문자열입니다.

  실행 결과를 암호화하기 위해 제공되는 IAM 역할입니다.
+ `NumberOfWorkers` - 숫자(정수)입니다.

  실행에 사용할 `G.1X` 작업자 수입니다. 기본값은 5입니다.
+ `Timeout` – 1 이상의 숫자(정수)입니다.

  실행 제한 시간(분)입니다. 실행에서 리소스를 소비하여 중지되기 전에 `TIMEOUT` 상태로 들어가는 최대 시간입니다. 기본값은 2,880 분(48 시간)입니다.
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `FINISHED` \$1 `FAILED` \$1 `PENDING_EXECUTION` \$1 `TIMED_OUT` \$1 `CANCELING` \$1 `CANCELED` \$1 `RECEIVED_BY_TASKRUNNER`).

  이 실행의 상태입니다.
+ `ErrorString` – UTF-8 문자열입니다.

  실행과 연결된 오류 문자열입니다.
+ `StartedOn` – 타임스탬프입니다.

  이 실행이 시작된 날짜와 시간입니다.
+ `LastModifiedOn` – 타임스탬프입니다.

  타임스탬프입니다. 이 데이터 품질 규칙 권장 실행이 수정된 마지막 시점입니다.
+ `CompletedOn` – 타임스탬프입니다.

  이 실행이 완료된 날짜와 시간입니다.
+ `ExecutionTime` - 숫자(정수)입니다.

  이 실행이 리소스를 사용한 시간(초)입니다.
+ `RecommendedRuleset` – UTF-8 문자열입니다(1\$165536바이트 이하)

  시작 규칙 권장 실행이 완료되면 권장 규칙 세트(규칙 세트)가 생성됩니다. 이 멤버는 DQDL(데이터 품질 정의 언어) 형식 규칙을 포함합니다.
+ `CreatedRulesetName` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  실행에서 생성된 규칙 세트의 이름입니다.
+ `DataQualitySecurityConfiguration` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  데이터 품질 암호화 옵션을 사용하여 생성된 보안 구성의 이름입니다.

## BatchPutDataQualityStatisticAnnotation 작업(Python: batch\$1put\$1data\$1quality\$1statistic\$1annotation)
<a name="aws-glue-api-data-quality-api-BatchPutDataQualityStatisticAnnotation"></a>

특정 데이터 품질 통계에 대해 시간 경과에 따른 데이터 포인트에 주석을 지정합니다. API에는 InclusionAnnotation 입력의 일부로 profileID 및 statisticID가 모두 필요합니다. API는 여러 프로파일에 걸쳐 단일 statisticId에 대해서만 작동합니다.

**요청**
+ `InclusionAnnotations` – **필수(Required): [DatapointInclusionAnnotation](#aws-glue-api-data-quality-api-DatapointInclusionAnnotation) 객체의 배열입니다.

  `DatapointInclusionAnnotation`의 목록. InclusionAnnotation에는 profileId 및 statisticId가 포함되어야 합니다. InclusionAnnotation이 여러 개인 경우 목록은 여러 profileId에 걸쳐 단일 statisticId를 참조해야 합니다.
+ `ClientToken` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  클라이언트 토큰.

**응답**
+ `FailedInclusionAnnotations` – [AnnotationError](#aws-glue-api-data-quality-api-AnnotationError) 객체의 배열입니다.

  `AnnotationError`의 목록.

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

## GetDataQualityModel 작업(Python: get\$1data\$1quality\$1model)
<a name="aws-glue-api-data-quality-api-GetDataQualityModel"></a>

자세한 정보(CompletedOn, StartedOn, FailureReason)와 함께 모델의 훈련 상태를 검색합니다.

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

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

  프로필 ID.

**응답**
+ `Status` – UTF-8 문자열입니다(유효한 값: `RUNNING` \$1 `SUCCEEDED` \$1 `FAILED`).

  데이터 품질 모델의 훈련 상태.
+ `StartedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 시작된 시점의 타임스탬프.
+ `CompletedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 완료된 시점의 타임스탬프.
+ `FailureReason` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  훈련 실패 이유.

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

## GetDataQualityModelResult 작업(Python: get\$1data\$1quality\$1model\$1result)
<a name="aws-glue-api-data-quality-api-GetDataQualityModelResult"></a>

지정된 프로필 ID에 대한 통계의 예측을 검색합니다.

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

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

  프로필 ID.

**응답**
+ `CompletedOn` – 타임스탬프입니다.

  데이터 품질 모델 훈련이 완료된 시점의 타임스탬프.
+ `Model` – [StatisticModelResult](#aws-glue-api-data-quality-api-StatisticModelResult) 객체의 배열입니다.

  `StatisticModelResult` 목록

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

## ListDataQualityStatisticAnnotations 작업(Python: list\$1data\$1quality\$1statistic\$1annotations)
<a name="aws-glue-api-data-quality-api-ListDataQualityStatisticAnnotations"></a>

데이터 품질 통계에 대한 주석을 검색합니다.

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

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

  프로필 ID.
+ `TimestampFilter` – [TimestampFilter](#aws-glue-api-data-quality-api-TimestampFilter) 객체입니다.

  타임스탬프 필터.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  이 요청에서 반환할 최대 결과 수입니다.
+ `NextToken` – UTF-8 문자열입니다.

  다음 결과 세트를 검색하기 위한 페이지 매김 토큰.

**응답**
+ `Annotations` – [StatisticAnnotation](#aws-glue-api-data-quality-api-StatisticAnnotation) 객체의 배열입니다.

  통계에 적용된 `StatisticAnnotation`의 목록
+ `NextToken` – UTF-8 문자열입니다.

  다음 결과 세트를 검색하기 위한 페이지 매김 토큰.

**오류**
+ `InvalidInputException`
+ `InternalServiceException`

## PutDataQualityProfileAnnotation 작업(Python: put\$1data\$1quality\$1profile\$1annotation)
<a name="aws-glue-api-data-quality-api-PutDataQualityProfileAnnotation"></a>

프로필의 모든 데이터 포인트에 주석을 작성합니다.

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

  주석을 달 데이터 품질 모니터링 프로필의 ID.
+ `InclusionAnnotation` – *필수:* UTF-8 문자열입니다(유효한 값: `INCLUDE` \$1 `EXCLUDE`).

  프로필에 적용할 포함 주석 값.

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

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

# 민감한 데이터 감지 API
<a name="aws-glue-api-sensitive-data-api"></a>

민감한 데이터 탐지 API는 정형 데이터의 열과 행에서 민감한 데이터를 탐지하는 데 사용되는 API를 설명합니다.

## 데이터 타입
<a name="aws-glue-api-sensitive-data-api-objects"></a>
+ [CustomEntityType 구조](#aws-glue-api-sensitive-data-api-CustomEntityType)

## CustomEntityType 구조
<a name="aws-glue-api-sensitive-data-api-CustomEntityType"></a>

정형 데이터의 열과 행에서 민감한 데이터를 감지하기 위한 사용자 정의 패턴을 나타내는 객체입니다.

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

  나중에 검색하거나 삭제할 수 있는 사용자 정의 패턴의 이름입니다. 이 이름은 AWS 계정별로 고유해야 합니다.
+ `RegexString` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.
+ `ContextWords` – UTF-8 문자열의 배열입니다(1\$120개 문자열).

  컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

  컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.

## 운영
<a name="aws-glue-api-sensitive-data-api-actions"></a>
+ [CreateCustomEntityType 작업(Python: create\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-CreateCustomEntityType)
+ [DeleteCustomEntityType 작업(Python: delete\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-DeleteCustomEntityType)
+ [GetCustomEntityType 작업(Python: get\$1custom\$1entity\$1type)](#aws-glue-api-sensitive-data-api-GetCustomEntityType)
+ [BatchGetCustomEntityTypes 작업(Python: batch\$1get\$1custom\$1entity\$1types)](#aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes)
+ [ListCustomEntityTypes 작업(Python: list\$1custom\$1entity\$1types)](#aws-glue-api-sensitive-data-api-ListCustomEntityTypes)

## CreateCustomEntityType 작업(Python: create\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-CreateCustomEntityType"></a>

정형 데이터의 열과 행에서 민감한 데이터를 감지하는 데 사용되는 사용자 정의 패턴을 생성합니다.

생성하는 각 사용자 정의 패턴은 정규식과 컨텍스트 단어의 선택적 목록을 지정합니다. 컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.

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

  나중에 검색하거나 삭제할 수 있는 사용자 정의 패턴의 이름입니다. 이 이름은 AWS 계정별로 고유해야 합니다.
+ `RegexString` – *필수(Required):* [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.
+ `ContextWords` – UTF-8 문자열의 배열입니다(1\$120개 문자열).

  컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

  컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  사용자 지정 엔터티 유형에 적용되는 태그 목록입니다.

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

  생성한 사용자 정의 패턴의 이름입니다.

**오류**
+ `AccessDeniedException`
+ `AlreadyExistsException`
+ `IdempotentParameterMismatchException`
+ `InternalServiceException`
+ `InvalidInputException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`

## DeleteCustomEntityType 작업(Python: delete\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-DeleteCustomEntityType"></a>

이름을 지정하여 사용자 정의 패턴을 삭제합니다.

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

  삭제할 사용자 정의 패턴의 이름입니다.

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

  삭제한 사용자 정의 패턴의 이름입니다.

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

## GetCustomEntityType 작업(Python: get\$1custom\$1entity\$1type)
<a name="aws-glue-api-sensitive-data-api-GetCustomEntityType"></a>

이름을 지정하여 사용자 패턴의 세부 정보를 검색합니다.

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

  검색할 사용자 정의 패턴의 이름입니다.

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

  검색한 사용자 정의 패턴의 이름입니다.
+ `RegexString` – [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)과(와) 일치하는 1\$1255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.
+ `ContextWords` – UTF-8 문자열의 배열입니다(1\$120개 문자열).

  사용자 정의 패턴을 생성할 때 지정된 경우 컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

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

## BatchGetCustomEntityTypes 작업(Python: batch\$1get\$1custom\$1entity\$1types)
<a name="aws-glue-api-sensitive-data-api-BatchGetCustomEntityTypes"></a>

이름 목록으로 지정된 사용자 정의 패턴에 대한 세부 정보를 검색합니다.

**요청**
+ `Names` – *필수(Required):* 1\$150개 문자열의 UTF-8 문자열의 배열입니다.

  검색할 사용자 정의 패턴의 이름 목록입니다.

**응답**
+ `CustomEntityTypes` – [CustomEntityType](#aws-glue-api-sensitive-data-api-CustomEntityType) 객체의 배열입니다.

  생성된 사용자 정의 패턴을 나타내는 `CustomEntityType` 객체의 목록입니다.
+ `CustomEntityTypesNotFound` – UTF-8 문자열의 배열입니다(1\$150개 문자열).

  찾을 수 없는 사용자 정의 패턴의 이름 목록입니다.

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

## ListCustomEntityTypes 작업(Python: list\$1custom\$1entity\$1types)
<a name="aws-glue-api-sensitive-data-api-ListCustomEntityTypes"></a>

생성된 모든 사용자 정의 패턴을 나열합니다.

**요청**
+ `NextToken` – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.
+ `MaxResults` – 1\$11,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  키-값 페어 태그의 목록입니다.

**응답**
+ `CustomEntityTypes` – [CustomEntityType](#aws-glue-api-sensitive-data-api-CustomEntityType) 객체의 배열입니다.

  사용자 정의 패턴을 나타내는 `CustomEntityType` 객체의 목록입니다.
+ `NextToken` – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

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

# AWS Glue에서 API 태그 지정
<a name="aws-glue-api-tags"></a>

## 데이터 타입
<a name="aws-glue-api-tags-objects"></a>
+ [태그 구조](#aws-glue-api-tags-Tag)

## 태그 구조
<a name="aws-glue-api-tags-Tag"></a>

`Tag` 객체는 AWS 리소스에 할당할 수 있는 레이블을 나타냅니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

AWS Glue의 태그 및 리소스 액세스 제어에 대한 자세한 내용은 개발자 가이드에서 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) 및 [AWS Glue 리소스 ARN 지정](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)을 참조하세요.

**Fields**
+ `key` – 1\$1128바이트 길이의 UTF-8 문자열입니다.

  태그 키 객체에서 태그를 생성할 때 이 키는 필수입니다. 이 키는 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.
+ `value` – 256바이트 이하 길이의 UTF-8 문자열입니다.

  태그 값 이 값은 객체에서 태그를 생성할 때 선택 사항입니다. 이 값은 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.

## 작업
<a name="aws-glue-api-tags-actions"></a>
+ [TagResource 작업(Python: tag\$1resource)](#aws-glue-api-tags-TagResource)
+ [UntagResource 작업(Python: untag\$1resource)](#aws-glue-api-tags-UntagResource)
+ [GetTags 작업(Python: get\$1tags)](#aws-glue-api-tags-GetTags)

## TagResource 작업(Python: tag\$1resource)
<a name="aws-glue-api-tags-TagResource"></a>

태그를 리소스에 추가합니다. 태그는 AWS 리소스에 할당할 수 있는 레이블입니다. AWS Glue에서는 특정 리소스만 태그 지정을 할 수 있습니다. 태그 지정이 가능한 리소스에 대한 자세한 내용은 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)를 참조하세요.

태그 관련 API를 직접 호출하기 위한 태그 지정 권한 외에도 연결에서 태그 지정 API를 직접 호출할 수 있는 `glue:GetConnection` 권한과 데이터베이스에서 태그 지정 API를 직접 호출할 수 있는 `glue:GetDatabase` 권한도 필요합니다.

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

  태그를 추가할 AWS Glue 리소스의 ARN입니다. AWS Glue 리소스 ARN에 대한 자세한 내용은 [AWS Glue ARN 문자열 패턴](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-common.html#aws-glue-api-regex-aws-glue-arn-id)을 참조하세요.
+ `TagsToAdd` – *필수(Required):* 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  이 리소스에 추가할 태그입니다.

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

**오류**
+ `ResourceNotFoundException`

## UntagResource 작업(Python: untag\$1resource)
<a name="aws-glue-api-tags-UntagResource"></a>

통합 리소스에서 지정된 태그를 제거합니다.

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

  통합 리소스의 Amazon 리소스 이름(ARN)입니다.
+ `TagsToRemove` – *필수(Required):* 50개 이하의 문자열로 구성된 UTF-8 문자열의 배열입니다.

  리소스에서 제거할 메타데이터 태그의 목록입니다.

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

**오류**
+ `ResourceNotFoundException`

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

리소스와 연결된 태그의 목록을 검색합니다.

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

  태그를 검색할 리소스의 Amazon 리소스 이름(ARN)입니다.

**응답**
+ `Tags` – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

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

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

  요청된 태그입니다.

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

# 공통 데이터 형식
<a name="aws-glue-api-common"></a>

일반적인 데이터 유형은 AWS Glue의 기타 일반적인 데이터 유형에 대해 설명합니다.

## 태그 구조
<a name="aws-glue-api-common-Tag"></a>

`Tag` 객체는 AWS 리소스에 할당할 수 있는 레이블을 나타냅니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

AWS Glue의 태그 및 리소스 액세스 제어에 대한 자세한 내용은 개발자 가이드에서 [AWS Glue의 AWS 태그](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) 및 [AWS Glue 리소스 ARN 지정](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)을 참조하세요.

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

  태그 키 객체에서 태그를 생성할 때 이 키는 필수입니다. 이 키는 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.
+ `value` – 256바이트 이하 길이의 UTF-8 문자열입니다.

  태그 값 이 값은 객체에서 태그를 생성할 때 선택 사항입니다. 이 값은 대/소문자를 구분하며 접두사 aws를 포함해서는 안 됩니다.

## DecimalNumber 구조
<a name="aws-glue-api-common-DecimalNumber"></a>

십진수 형식의 숫자 값을 포함합니다.

**필드**
+ `UnscaledValue` – **필수(Required): Blob입니다.

  범위가 정해지지 않은 숫자 값.
+ `Scale` – **필수(Required): 숫자(정수)입니다.

  범위가 정해지지 않은 값 어디에 십진수가 오는지 결정하는 범위입니다.

## ErrorDetail 구조
<a name="aws-glue-api-common-ErrorDetail"></a>

오류의 세부 정보를 포함합니다.

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

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

  메시지에서 오류를 설명합니다.

## PropertyPredicate 구조
<a name="aws-glue-api-common-PropertyPredicate"></a>

속성 조건자를 정의합니다.

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

  속성 키입니다.
+ `Value` – 값 문자열입니다(1\$11,024바이트).

  속성 값입니다.
+ `Comparator` – UTF-8 문자열입니다(유효 값: `EQUALS` \$1 `GREATER_THAN` \$1 `LESS_THAN` \$1 `GREATER_THAN_EQUALS` \$1 `LESS_THAN_EQUALS`).

  비교자는 이 속성을 다른 속성과 비교합니다.

## ResourceUri 구조
<a name="aws-glue-api-common-ResourceUri"></a>

함수 리소스의 URI입니다.

**필드**
+ `ResourceType` – UTF-8 문자열입니다(유효한 값: `JAR` \$1 `FILE` \$1 `ARCHIVE`).

  리소스의 유형.
+ `Uri` – [URI address multi-line string pattern](#aws-glue-api-regex-uri)과(와) 일치하는 1\$11,024바이트 길이의 URI(Uniform Resource Identifier)입니다.

  리소스에 액세스하는 URI입니다.

## ColumnStatistics 구조
<a name="aws-glue-api-common-ColumnStatistics"></a>

테이블 또는 파티션에 대해 생성된 열 수준 통계를 나타냅니다.

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

  통계가 속한 열의 이름입니다.
+ `ColumnType` – **필수(Required): [Single-line string pattern](#aws-glue-api-regex-oneLine)과(와) 일치하는 길이 20,000바이트 이하의 유형 이름입니다.

  열의 데이터 형식.
+ `AnalyzedTime` – **필수(Required): 타임스탬프입니다.

  열 통계가 생성된 시간의 타임스탬프입니다.
+ `StatisticsData` – **필수(Required): [ColumnStatisticsData](#aws-glue-api-common-ColumnStatisticsData) 객체입니다.

  통계 데이터 값을 포함하는 `ColumnStatisticData` 객체입니다.

## ColumnStatisticsError 구조
<a name="aws-glue-api-common-ColumnStatisticsError"></a>

실패한 `ColumnStatistics` 객체와 실패 이유를 캡슐화합니다.

**필드**
+ `ColumnStatistics` – [ColumnStatistics](#aws-glue-api-common-ColumnStatistics) 객체입니다.

  열의 `ColumnStatistics`입니다.
+ `Error` – [ErrorDetail](#aws-glue-api-common-ErrorDetail) 객체입니다.

  작업 실패 이유가 포함된 오류 메시지입니다.

## ColumnError 구조
<a name="aws-glue-api-common-ColumnError"></a>

실패한 열 이름과 실패 이유를 캡슐화합니다.

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

  실패한 열의 이름입니다.
+ `Error` – [ErrorDetail](#aws-glue-api-common-ErrorDetail) 객체입니다.

  작업 실패 이유가 포함된 오류 메시지입니다.

## ColumnStatisticsData 구조
<a name="aws-glue-api-common-ColumnStatisticsData"></a>

열 통계 데이터의 개별 유형을 포함합니다. 하나의 데이터 객체만 설정하고 `Type` 속성으로 표시해야 합니다.

**필드**
+ `Type` – **필수: UTF-8 문자열입니다(유효한 값: `BOOLEAN` \$1 `DATE` \$1 `DECIMAL` \$1 `DOUBLE` \$1 `LONG` \$1 `STRING` \$1 `BINARY`).

  열 통계 데이터의 유형입니다.
+ `BooleanColumnStatisticsData` – [BooleanColumnStatisticsData](#aws-glue-api-common-BooleanColumnStatisticsData) 객체입니다.

  부울 열 통계 데이터입니다.
+ `DateColumnStatisticsData` – [DateColumnStatisticsData](#aws-glue-api-common-DateColumnStatisticsData) 객체입니다.

  날짜 열 통계 데이터입니다.
+ `DecimalColumnStatisticsData` – [DecimalColumnStatisticsData](#aws-glue-api-common-DecimalColumnStatisticsData) 객체입니다.

   10진수 열 통계 데이터입니다. 내부의 UnscaledValues는 빅 엔디안을 저장하는 Base64로 인코딩된 바이너리 객체로, 이 두 가지는 십진수의 스케일링되지 않은 값을 보완하는 표현입니다.
+ `DoubleColumnStatisticsData` – [DoubleColumnStatisticsData](#aws-glue-api-common-DoubleColumnStatisticsData) 객체입니다.

  실수(Double) 열 통계 데이터입니다.
+ `LongColumnStatisticsData` – [LongColumnStatisticsData](#aws-glue-api-common-LongColumnStatisticsData) 객체입니다.

  정수(Long) 열 통계 데이터입니다.
+ `StringColumnStatisticsData` – [StringColumnStatisticsData](#aws-glue-api-common-StringColumnStatisticsData) 객체입니다.

  문자열 열 통계 데이터입니다.
+ `BinaryColumnStatisticsData` – [BinaryColumnStatisticsData](#aws-glue-api-common-BinaryColumnStatisticsData) 객체입니다.

  이진수 열 통계 데이터입니다.

## BooleanColumnStatisticsData 구조
<a name="aws-glue-api-common-BooleanColumnStatisticsData"></a>

부울 데이터 열에 대해 지원되는 열 통계를 정의합니다.

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

  열의 true 값 수입니다.
+ `NumberOfFalses` – **필수(Required): None 이하의 숫자(정수)입니다.

  열의 false 값 수입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.

## DateColumnStatisticsData 구조
<a name="aws-glue-api-common-DateColumnStatisticsData"></a>

타임스탬프 데이터 열에 대해 지원되는 열 통계를 정의합니다.

**필드**
+ `MinimumValue` – 타임스탬프입니다.

  열에서 최저 값입니다.
+ `MaximumValue` – 타임스탬프입니다.

  열에서 최고 값입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.
+ `NumberOfDistinctValues` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 고유 값 수입니다.

## DecimalColumnStatisticsData 구조
<a name="aws-glue-api-common-DecimalColumnStatisticsData"></a>

고정 소수점 데이터 열에 대해 지원되는 열 통계를 정의합니다.

**필드**
+ `MinimumValue` – [DecimalNumber](#aws-glue-api-common-DecimalNumber) 객체입니다.

  열에서 최저 값입니다.
+ `MaximumValue` – [DecimalNumber](#aws-glue-api-common-DecimalNumber) 객체입니다.

  열에서 최고 값입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.
+ `NumberOfDistinctValues` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 고유 값 수입니다.

## DoubleColumnStatisticsData 구조
<a name="aws-glue-api-common-DoubleColumnStatisticsData"></a>

부동 소수점 데이터 열에 대해 지원되는 열 통계를 정의합니다.

**필드**
+ `MinimumValue` - 숫자(double)입니다.

  열에서 최저 값입니다.
+ `MaximumValue` - 숫자(double)입니다.

  열에서 최고 값입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.
+ `NumberOfDistinctValues` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 고유 값 수입니다.

## LongColumnStatisticsData 구조
<a name="aws-glue-api-common-LongColumnStatisticsData"></a>

정수 데이터 열에 대해 지원되는 열 통계를 정의합니다.

**필드**
+ `MinimumValue` - 숫자(정수)입니다.

  열에서 최저 값입니다.
+ `MaximumValue` - 숫자(정수)입니다.

  열에서 최고 값입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.
+ `NumberOfDistinctValues` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 고유 값 수입니다.

## StringColumnStatisticsData 구조
<a name="aws-glue-api-common-StringColumnStatisticsData"></a>

문자 시퀀스 데이터 값에 대해 지원되는 열 통계를 정의합니다.

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

  열에서 가장 긴 문자열의 크기입니다.
+ `AverageLength` – *필수(Required):* None 이하의 숫자(double)입니다.

  열의 평균 문자열 길이입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.
+ `NumberOfDistinctValues` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 고유 값 수입니다.

## BinaryColumnStatisticsData 구조
<a name="aws-glue-api-common-BinaryColumnStatisticsData"></a>

비트 시퀀스 데이터 값에 대해 지원되는 열 통계를 정의합니다.

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

  열에서 가장 긴 비트 시퀀스의 크기입니다.
+ `AverageLength` – *필수(Required):* None 이하의 숫자(double)입니다.

  열의 평균 비트 시퀀스 길이입니다.
+ `NumberOfNulls` – *필수(Required):* None 이하의 숫자(정수)입니다.

  열의 null 값 수입니다.

## 문자열 패턴
<a name="aws-glue-api-common-_string-patterns"></a>

API는 다음 정규식을 사용하여 다양한 문자열 파라미터 및 멤버의 유효한 값이 무엇인지 정의합니다.
+ 한 줄 문자열 패턴 – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*`"
+ URI 주소 여러 줄 문자열 패턴 – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`"
+ Logstash Grok 문자열 패턴 – "`[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\t]*`"
+ 식별자 문자열 패턴 – "`[A-Za-z_][A-Za-z0-9_]*`"
+ AWS IAM ARN 문자열 패턴 – "`arn:aws:iam::\d{12}:role/.*`"
+ 버전 문자열 패턴 – "`^[a-zA-Z0-9-_]+$`"
+ 로그 그룹 문자열 패턴 – "`[\.\-_/#A-Za-z0-9]+`"
+ 로그 스트림 문자열 패턴 – "`[^:*]*`"
+ 사용자 정의 문자열 패턴 \$110 – "`[a-zA-Z0-9-_]+`"
+ 사용자 정의 문자열 패턴 \$111 – "`[-a-zA-Z0-9+=/:_]*`"
+ 사용자 정의 문자열 패턴 \$112 – "`[\S\s]*`"
+ 사용자 정의 문자열 패턴 \$113 – "`.*\S.*`"
+ 사용자 정의 문자열 패턴 \$114 – "`[a-zA-Z0-9-=._/@]+`"
+ 사용자 정의 문자열 패턴 \$115 – "`[1-9][0-9]*|[1-9][0-9]*-[1-9][0-9]*`"
+ 사용자 정의 문자열 패턴 \$116 – "`[A-Z][A-Za-z\.]+`"
+ 사용자 정의 문자열 패턴 \$117 – "`[\S]*`"
+ 사용자 정의 문자열 패턴 \$118 – "`[\w]*`"
+ 사용자 정의 문자열 패턴 \$119 – "`arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`"
+ 사용자 정의 문자열 패턴 \$120 – "`subnet-[a-z0-9]+`"
+ 사용자 정의 문자열 패턴 \$121 – "`\d{12}`"
+ 사용자 정의 문자열 패턴 \$122 – "`([a-z]+)-([a-z]+-)?([a-z]+)-[0-9]+[a-z]+`"
+ 사용자 지정 문자열 패턴 \$123 – '`[a-zA-Z0-9.-]*`'
+ 사용자 정의 문자열 패턴 \$124 – "`arn:aws[a-z0-9\-]*:lambda:[a-z0-9\-]+:\d{12}:function:([\w\-]{1,64})`"
+ 사용자 정의 문자열 패턴 \$125 – "`^(?!(.*[.\/\\]|aws:)).*$`"
+ 사용자 정의 문자열 패턴 \$126 – "`[^\r\n]`"
+ 사용자 정의 문자열 패턴 \$127 – "`^\w+\.\w+\.\w+$`"
+ 사용자 정의 문자열 패턴 \$128 – "`^\w+\.\w+$`"
+ 사용자 정의 문자열 패턴 \$129 – "`^$|arn:aws[a-z0-9-]*:kms:.*`"
+ 사용자 정의 문자열 패턴 \$130 – "`arn:aws[^:]*:iam::[0-9]*:role/.+`"
+ 사용자 정의 문자열 패턴 \$131 – "`[\.\-_A-Za-z0-9]+`"
+ 사용자 정의 문자열 패턴 \$132 – "`^s3://([^/]+)/([^/]+/)*([^/]+)$`"
+ 사용자 정의 문자열 패턴 \$133 – "`.*`"
+ 사용자 지정 문자열 패턴 \$134 – "`^(Sun|Mon|Tue|Wed|Thu|Fri|Sat):([01]?[0-9]|2[0-3])$`"
+ 사용자 지정 문자열 패턴 \$135 – '`[a-zA-Z0-9_.-]+`'
+ 사용자 지정 문자열 패턴 \$136 - "`^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:secretsmanager:.*$`"
+ 사용자 지정 문자열 패턴 \$137 - "`\S+`"
+ 사용자 지정 문자열 패턴 \$138 – "`^[\x20-\x7E]*$`"
+ 사용자 지정 문자열 패턴 \$139 – "`^([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_=]+)\.([a-zA-Z0-9_\-\+\/=]*)`"
+ 사용자 지정 문자열 패턴 \$140 – "`^(https?)://[-a-zA-Z0-9+&@#/%?=~_|!:,.;]*[-a-zA-Z0-9+&@#/%=~_|]`"
+ 사용자 지정 문자열 패턴 \$141 – "`^(https?):\/\/[^\s/$.?#].[^\s]*$`"
+ 사용자 지정 문자열 패턴 \$142 – "`arn:aws:kms:.*`"
+ 사용자 지정 문자열 패턴 \$143 – '`^subnet-[a-z0-9]+$`'
+ 사용자 지정 문자열 패턴 \$144 – '`[\p{L}\p{N}\p{P}]*`'
+ 사용자 지정 문자열 패턴 \$145 – '`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`'
+ 사용자 지정 문자열 패턴 \$146 – '`[a-zA-Z0-9-_$#.]+`'
+ 사용자 지정 문자열 패턴 \$147 – '`^\d{12}$`'
+ 사용자 지정 문자열 패턴 \$148 – '`^(\w+\.)+\w+$`'
+ 사용자 지정 문자열 패턴 \$149 – '`^([2-3]|3[.]9)$`'
+ 사용자 지정 문자열 패턴 \$150 – '`arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:glue:.*`'
+ 사용자 지정 문자열 패턴 \$151 – '`[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}`'
+ 사용자 지정 문자열 패턴 \$152 – '`(^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::\w{12}:root)`'
+ 사용자 지정 문자열 패턴 \$153 – '`^arn:aws(-(cn|us-gov|eusc|iso(-[bef])?))?:iam::[0-9]{12}:role/.+`'
+ 사용자 지정 문자열 패턴 \$154 – '`[\s\S]*`'
+ 사용자 지정 문자열 패턴 \$155 – '`([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF]|[^\S\r\n"'= ;])*`'
+ 사용자 지정 문자열 패턴 \$156 – '`^[A-Z\_]+$`'
+ 사용자 지정 문자열 패턴 \$157 – '`^[A-Za-z0-9]+$`'
+ 사용자 지정 문자열 패턴 \$158 – '`[*A-Za-z0-9_-]*`'
+ 사용자 지정 문자열 패턴 \$159 – '`([\u0020-\u007E\r\s\n])*`'
+ 사용자 지정 문자열 패턴 \$160 – '`[A-Za-z0-9_-]*`'
+ 사용자 지정 문자열 패턴 \$161 – '`([\u0009\u000B\u000C\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF])*`'
+ 사용자 지정 문자열 패턴 \$162 – '`([\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\s])*`'
+ 사용자 지정 문자열 패턴 \$163 – '`([^\r\n])*`'

# 예외
<a name="aws-glue-api-exceptions"></a>

이 섹션에서는 문제의 원인을 찾고 해결하는 데 사용할 수 있는 AWS Glue 예외사항에 대해 설명합니다. 기계 학습과 관련된 예외에 관한 HTTP 오류 코드 및 문자열에 대한 자세한 내용은 [AWS Glue 기계 학습 예외 사항](exceptions-machine-learning.md) 단원을 참조하십시오.

## AccessDeniedException 구조
<a name="aws-glue-api-exceptions-AccessDeniedException"></a>

리소스 액세스가 거부됩니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## AlreadyExistsException 구조
<a name="aws-glue-api-exceptions-AlreadyExistsException"></a>

생성되는 또는 추가되는 리소스가 이미 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ConcurrentModificationException 구조
<a name="aws-glue-api-exceptions-ConcurrentModificationException"></a>

두 절차로 동시에 리소스를 수정하고자 합니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ConcurrentRunsExceededException 구조
<a name="aws-glue-api-exceptions-ConcurrentRunsExceededException"></a>

다양한 작업이 동시에 실행됩니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## CrawlerNotRunningException 구조
<a name="aws-glue-api-exceptions-CrawlerNotRunningException"></a>

지정한 크롤러가 실행되고 있지 않습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## CrawlerRunningException 구조
<a name="aws-glue-api-exceptions-CrawlerRunningException"></a>

크롤러가 이미 수행되고 있기 때문에 작업을 수행할 수 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## CrawlerStoppingException 구조
<a name="aws-glue-api-exceptions-CrawlerStoppingException"></a>

지정한 크롤러가 중지되고 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## EntityNotFoundException 구조
<a name="aws-glue-api-exceptions-EntityNotFoundException"></a>

지정한 개체가 존재하지 않습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지
+ `FromFederationSource` – 부울입니다.

  예외가 페더레이션된 소스와 관련이 있는지 여부를 나타냅니다.

## FederationSourceException 구조
<a name="aws-glue-api-exceptions-FederationSourceException"></a>

페더레이션 소스에 실패했습니다.

**필드**
+ `FederationSourceErrorCode` – UTF-8 문자열입니다(유효한 값: `AccessDeniedException` \$1 `EntityNotFoundException` \$1 `InvalidCredentialsException` \$1 `InvalidInputException` \$1 `InvalidResponseException` \$1 `OperationTimeoutException` \$1 `OperationNotSupportedException` \$1 `InternalServiceException` \$1 `PartialFailureException` \$1 `ThrottlingException`).

  문제의 오류 코드입니다.
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지입니다.

## FederationSourceRetryableException 구조
<a name="aws-glue-api-exceptions-FederationSourceRetryableException"></a>

페더레이션 소스에 실패했지만 작업이 재시도될 수 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## GlueEncryptionException 구조
<a name="aws-glue-api-exceptions-GlueEncryptionException"></a>

암호화 연산에 실패했습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지입니다.

## IdempotentParameterMismatchException 구조
<a name="aws-glue-api-exceptions-IdempotentParameterMismatchException"></a>

두 가지 다른 기록과 연결된 동일한 고유 식별자입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## IllegalWorkflowStateException 구조
<a name="aws-glue-api-exceptions-IllegalWorkflowStateException"></a>

워크플로가 요청된 작업을 수행할 수 있는 잘못된 상태입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InternalServiceException 구조
<a name="aws-glue-api-exceptions-InternalServiceException"></a>

내부 서비스 오류가 발생했습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InvalidExecutionEngineException 구조
<a name="aws-glue-api-exceptions-InvalidExecutionEngineException"></a>

알려지지 않거나 무효한 엔진이 지정되었습니다.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InvalidInputException 구조
<a name="aws-glue-api-exceptions-InvalidInputException"></a>

제공한 입력이 유효하지 않았습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지
+ `FromFederationSource` – 부울입니다.

  예외가 페더레이션된 소스와 관련이 있는지 여부를 나타냅니다.

## InvalidStateException 구조
<a name="aws-glue-api-exceptions-InvalidStateException"></a>

데이터 상태가 잘못되었음을 나타내는 오류입니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## InvalidTaskStatusTransitionException 구조
<a name="aws-glue-api-exceptions-InvalidTaskStatusTransitionException"></a>

하나의 작업이 다음 실패한 작업으로의 적절한 전환.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## JobDefinitionErrorException 구조
<a name="aws-glue-api-exceptions-JobDefinitionErrorException"></a>

작업 정의가 유효하지 않습니다.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## JobRunInTerminalStateException 구조
<a name="aws-glue-api-exceptions-JobRunInTerminalStateException"></a>

작업 실행의 터미널 상태는 실패를 암시합니다.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## JobRunInvalidStateTransitionException 구조
<a name="aws-glue-api-exceptions-JobRunInvalidStateTransitionException"></a>

작업 실행으로 원본 상태에서 대상 상태로의 무효한 전환이 발생했습니다.

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

  문제의 작업 실행 ID입니다.
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지
+ `sourceState` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  소스 데이터
+ `targetState` – UTF-8 문자열입니다(유효한 값: `STARTING` \$1 `RUNNING` \$1 `STOPPING` \$1 `STOPPED` \$1 `SUCCEEDED` \$1 `FAILED` \$1 `TIMEOUT` \$1 `ERROR` \$1 `WAITING` \$1 `EXPIRED`).

  대상 상태

## JobRunNotInTerminalStateException 구조
<a name="aws-glue-api-exceptions-JobRunNotInTerminalStateException"></a>

터미널 상태에서 작업이 실행되지 않습니다.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## LateRunnerException 구조
<a name="aws-glue-api-exceptions-LateRunnerException"></a>

작업 실행이 늦습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## NoScheduleException 구조
<a name="aws-glue-api-exceptions-NoScheduleException"></a>

적용 가능한 일정이 없습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## OperationTimeoutException 구조
<a name="aws-glue-api-exceptions-OperationTimeoutException"></a>

작업 시간이 초과되었습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ResourceNotReadyException 구조
<a name="aws-glue-api-exceptions-ResourceNotReadyException"></a>

리소스가 트랜잭션에 대해 준비되지 않았습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ResourceNumberLimitExceededException 구조
<a name="aws-glue-api-exceptions-ResourceNumberLimitExceededException"></a>

리소스의 숫자 제한을 초과했습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## SchedulerNotRunningException 구조
<a name="aws-glue-api-exceptions-SchedulerNotRunningException"></a>

지정한 스케줄러가 실행되고 있지 않습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## SchedulerRunningException 구조
<a name="aws-glue-api-exceptions-SchedulerRunningException"></a>

지정한 스케줄러가 이미 실행되고 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## SchedulerTransitioningException 구조
<a name="aws-glue-api-exceptions-SchedulerTransitioningException"></a>

지정한 스케줄러가 변환되고 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## UnrecognizedRunnerException 구조
<a name="aws-glue-api-exceptions-UnrecognizedRunnerException"></a>

작업 실행이 인식되지 않습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## ValidationException 구조
<a name="aws-glue-api-exceptions-ValidationException"></a>

값이 유효하지 않을 수 있습니다.

**필드**
+ `Message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지

## VersionMismatchException 구조
<a name="aws-glue-api-exceptions-VersionMismatchException"></a>

버전 충돌이 있었습니다.

**필드**
+ `message` – UTF-8 문자열입니다.

  문제를 설명하는 메시지