# 공통 데이터 형식
<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])*`'