本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 常見資料類型
<a name="aws-glue-api-common"></a>

常見資料類型說明 AWS Glue中的其他常見資料類型。

## Tag 結構
<a name="aws-glue-api-common-Tag"></a>

`Tag` 物件代表您可以指派給 AWS 資源的標籤。每個標籤皆包含由您定義的一個金鑰與一個選用值。

如需 中標籤和控制資源存取的詳細資訊 AWS Glue，請參閱 開發人員指南中的 [AWS 中的標籤 AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html)和[指定 AWS Glue 資源 ARNs](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html)。

**欄位**
+ `key` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。

  標籤金鑰。如果要在物件上建立標籤，您必須擁有金鑰。這份金鑰會區分大小寫，而且前綴不可為 aws。
+ `value` – UTF-8 字串，長度不可超過 256 個位元組。

  標籤值。如果要在物件上建立標籤，這個值為選用性。這個值區分大小寫，而且前綴不可為 aws。

## DecimalNumber 結構
<a name="aws-glue-api-common-DecimalNumber"></a>

包含十進制格式的數值。

**欄位**
+ `UnscaledValue` – *必要：*Blob。

  沒有單位的數值。
+ `Scale` – *必要：*數字 (整數)。

  決定無刻度值內小數點位置的刻度。

## ErrorDetail 結構
<a name="aws-glue-api-common-ErrorDetail"></a>

包含錯誤的詳細資訊。

**欄位**
+ `ErrorCode` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](#aws-glue-api-regex-oneLine)。

  此錯誤相關的程式碼。
+ `ErrorMessage` – 描述字串，長度不可超過 2048 個位元組，需符合[URI address multi-line string pattern](#aws-glue-api-regex-uri)。

  描述錯誤的訊息。

## PropertyPredicate 結構
<a name="aws-glue-api-common-PropertyPredicate"></a>

定義屬性述詞。

**欄位**
+ `Key` – 值字串，長度不可小於 1 個位元組，也不可以超過 1,024 個位元組。

  屬性的金鑰。
+ `Value` – 值字串，長度不可小於 1 個位元組，也不可以超過 1,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)，長度不可小於 1 個位元組，也不可以超過 1024 個位元組，需符合[URI address multi-line string pattern](#aws-glue-api-regex-uri)。

  存取資源的 URI。

## ColumnStatistics 結構
<a name="aws-glue-api-common-ColumnStatistics"></a>

代表資料表或分割區產生的欄層級統計資料。

**欄位**
+ `ColumnName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合[Single-line string pattern](#aws-glue-api-regex-oneLine)。

  統計資料所屬的欄名稱。
+ `ColumnType` – *必要：*輸入名稱，長度不可超過 20000 個位元組，需符合 [Single-line string pattern](#aws-glue-api-regex-oneLine)。

  欄的資料類型。
+ `AnalyzedTime` – *必要：*時間戳記。

  欄統計資料產生時的時間戳記。
+ `StatisticsData` – *必要：*[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` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](#aws-glue-api-regex-oneLine)。

  失敗欄的名稱。
+ `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) 物件。

   十進位欄統計資料。其中的 UnscaledValues 是存放大端序的 Base64 編碼二進位物件，即十進位未縮放值的兩的補數表示。
+ `DoubleColumnStatisticsData` – [DoubleColumnStatisticsData](#aws-glue-api-common-DoubleColumnStatisticsData) 物件。

  雙欄統計資料。
+ `LongColumnStatisticsData` – [LongColumnStatisticsData](#aws-glue-api-common-LongColumnStatisticsData) 物件。

  長欄統計資料。
+ `StringColumnStatisticsData` – [StringColumnStatisticsData](#aws-glue-api-common-StringColumnStatisticsData) 物件。

  字串欄統計資料。
+ `BinaryColumnStatisticsData` – [BinaryColumnStatisticsData](#aws-glue-api-common-BinaryColumnStatisticsData) 物件。

  二進位資料行統計資料。

## BooleanColumnStatisticsData 結構
<a name="aws-glue-api-common-BooleanColumnStatisticsData"></a>

定義布林資料欄支援的欄統計資料。

**欄位**
+ `NumberOfTrues` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 true 值數目。
+ `NumberOfFalses` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 false 值數目。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。

## DateColumnStatisticsData 結構
<a name="aws-glue-api-common-DateColumnStatisticsData"></a>

定義時間戳記資料欄支援的欄統計資料。

**欄位**
+ `MinimumValue` – 時間戳記。

  欄中的最低值。
+ `MaximumValue` – 時間戳記。

  欄中的最高值。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。
+ `NumberOfDistinctValues` – *必要：*數字 (long)，不可大於 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` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。
+ `NumberOfDistinctValues` – *必要：*數字 (long)，不可大於 None (無)。

  欄中相異值的數目。

## DoubleColumnStatisticsData 結構
<a name="aws-glue-api-common-DoubleColumnStatisticsData"></a>

定義浮點數資料欄支援的欄統計資料。

**欄位**
+ `MinimumValue` – 數字 (雙位數)。

  欄中的最低值。
+ `MaximumValue` – 數字 (雙位數)。

  欄中的最高值。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。
+ `NumberOfDistinctValues` – *必要：*數字 (long)，不可大於 None (無)。

  欄中相異值的數目。

## LongColumnStatisticsData 結構
<a name="aws-glue-api-common-LongColumnStatisticsData"></a>

定義整數資料欄支援的欄統計資料。

**欄位**
+ `MinimumValue` – 數字 (long)。

  欄中的最低值。
+ `MaximumValue` – 數字 (long)。

  欄中的最高值。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。
+ `NumberOfDistinctValues` – *必要：*數字 (long)，不可大於 None (無)。

  欄中相異值的數目。

## StringColumnStatisticsData 料結構
<a name="aws-glue-api-common-StringColumnStatisticsData"></a>

定義字元序列資料值支援的欄統計資料。

**欄位**
+ `MaximumLength` – *必要：*數字 (long)，不可大於 None (無)。

  欄中最長字串的大小。
+ `AverageLength` – *必要：*數字 (double)，不可大於 None (無)。

  欄中的平均字串長度。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 None (無)。

  欄中的 null 值數目。
+ `NumberOfDistinctValues` – *必要：*數字 (long)，不可大於 None (無)。

  欄中相異值的數目。

## BinaryColumnStatisticsData 結構
<a name="aws-glue-api-common-BinaryColumnStatisticsData"></a>

定義位元序列資料值支援的欄統計資料。

**欄位**
+ `MaximumLength` – *必要：*數字 (long)，不可大於 None (無)。

  欄中最長位元序列的大小。
+ `AverageLength` – *必要：*數字 (double)，不可大於 None (無)。

  欄中的平均位元序列長度。
+ `NumberOfNulls` – *必要：*數字 (long)，不可大於 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])*`"