本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 中的整合 APIs AWS Glue ## 資料類型 + [整合結構](#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) ## 整合結構 描述零 ETL 整合。 **欄位** + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合來源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合目標的 ARN。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `IntegrationName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的唯一名稱。 + `IntegrationArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 + `KmsKeyId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密頻道的 KMS 金鑰的 ARN。 + `AdditionalEncryptionContext` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 一組選用的非機密金鑰值對，其中包含用於加密的其他內容資訊。只有在提供 `KMSKeyId` 時，才能提供此功能。 + `Tags` – 一個 [Tag](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` – *必要：*時間戳記。 整合建立時間 (UTC)。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 物件。 與整合關聯的屬性。 + `Errors` – 一個 [IntegrationError](#aws-glue-api-integrations-IntegrationError) 物件陣列。 與整合關聯的錯誤清單。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 使用 Maxwell 篩選條件語法選取整合的來源資料表。 ## IntegrationConfig 結構 與整合關聯的屬性。 **欄位** + `RefreshInterval` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指定 CDC (變更資料擷取) 提取或增量載入應發生的頻率。此參數提供彈性，可讓重新整理速率與您的特定資料更新模式、系統負載考量和效能最佳化目標保持一致。時間增量可以設定為 15 分鐘至 8,640 分鐘 (6 天)。 + `SourceProperties` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 金鑰值對的集合，可指定整合來源的其他屬性。這些屬性提供組態選項，可用於在資料整合操作期間自訂 ODB 來源的行為。 + `ContinuousSync` – 布林值。 啟用隨需資料擷取的持續同步：1) SaaS 應用程式到 Amazon Redshift 和 等 AWS 資料服務 Amazon S3，以及 2) DynamoDB 到 Amazon S3。 ## IntegrationPartition 結構 描述如何在目標上分區資料的結構。 **欄位** + `FieldName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 用於分區目標上資料的欄位名稱。避免使用具有每個資料列唯一值的資料欄 (例如，'LastModifiedTimestamp' 和 'SystemModTimeStamp') 作為分區資料欄。這些資料欄不適合分區，因為其會建立大量小型分區，這可能會導致效能問題。 + `FunctionSpec` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指定用於分區目標上資料的函數。此參數的接受值為： + `identity` - 直接使用來源值而不進行轉換 + `year` - 從時間戳記值中擷取年份 (例如 2023) + `month` - 從時間戳記值中擷取月份 (例如 2023 年 1 月) + `day` - 從時間戳記值中擷取日期 (例如 2023-01-15) + `hour` - 從時間戳記值中擷取小時 (例如 2023-01-15-14) + `ConversionSpec` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指定來源資料的時間戳記格式。有效的值如下： + `epoch_sec` - 以秒為單位的 Unix epoch 時間戳記 + `epoch_milli` - 以毫秒為單位的 Unix epoch 時間戳記 + `iso` - ISO 8601 格式的時間戳記 **注意** 僅在使用以時間戳記為基礎的分割區函數 （年、月、日或小時） `ConversionSpec`時指定 。 AWS Glue 零 ETL 使用此參數，在分割之前將來源資料正確轉換為時間戳記格式。 請勿將高基數資料欄與 `identity` 分區函數搭配使用。高基數資料欄包括： 主索引鍵 時間戳記欄位 (例如 `LastModifiedTimestamp`、`CreatedDate`) 系統產生的時間戳記 使用具有身分分區的高基數資料欄會建立許多小型分區，這可能會大幅降低擷取效能。 ## IntegrationError 結構 與零 ETL 整合關聯的錯誤。 **欄位** + `ErrorCode` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 此錯誤相關的程式碼。 + `ErrorMessage` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 描述錯誤的訊息。 ## IntegrationFilter 結構 可在調用 `DescribeIntegrations` 請求時使用的篩選條件。 **欄位** + `Name` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 篩選條件的名稱。 + `Values` – UTF-8 字串陣列。 篩選條件值清單。 ## InboundIntegration 結構 將資料寫入資源的整合的結構。 **欄位** + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的來源資源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的目標資源的 ARN。 + `IntegrationArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 零 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` – *必要：*時間戳記。 整合建立時間 (UTC)。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 物件。 與整合關聯的屬性。 + `Errors` – 一個 [IntegrationError](#aws-glue-api-integrations-IntegrationError) 物件陣列。 與整合關聯的錯誤清單。 ## SourceProcessingProperties 結構 與整合來源關聯的資源屬性。 **欄位** + `RoleArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 存取 AWS Glue 連線的 IAM 角色。 ## TargetProcessingProperties 結構 與整合目標關聯的資源屬性。 **欄位** + `RoleArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 存取 AWS Glue 資料庫的 IAM 角色。 + `KmsArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密的 KMS 金鑰的 ARN。 + `ConnectionName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 用於設定在客戶 VPC 中執行之 AWS Glue 任務的 AWS Glue 網路連線。 + `EventBusArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 接收整合狀態通知的 Eventbridge 事件匯流排的 ARN。 ## SourceTableConfig 結構 來源分支用來處理來源資料的屬性。 **欄位** + `Fields` – UTF-8 字串陣列。 用於資料欄層級篩選的欄位清單。目前不支援。 + `FilterPredicate` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 用於資料列層級篩選的條件子句。目前不支援。 + `PrimaryKey` – UTF-8 字串陣列。 為此資料表提供主索引鍵集。目前根據請求專門支援 SAP `EntityOf` 實體。請聯絡 AWS Support 以使用此功能。 + `RecordUpdateField` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 增量提取以時間戳記為基礎的欄位。目前不支援。 ## TargetTableConfig 結構 目標分支用來分區目標上資料的屬性。 **欄位** + `UnnestSpec` – UTF-8 字串 (有效值：`TOPLEVEL` \$1 `FULL` \$1 `NOUNNEST`)。 指定如何將巢狀物件展平為最上層元素。有效值為： "TOPLEVEL"、"FULL" 或 "NOUNNEST"。 + `PartitionSpec` – 一個 [IntegrationPartition](#aws-glue-api-integrations-IntegrationPartition) 物件陣列。 決定目標上的檔案配置。 + `TargetTableName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 目標資料表的選用名稱。 ## 作業 + [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) 在具有 Amazon Resource Name (ARN) 的兩個資源之間，在發起人的帳戶中建立零 ETL 整合：`SourceArn` 和 `TargetArn`。 **請求** + `IntegrationName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 AWS Glue中整合的唯一名稱。 + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的來源資源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的目標資源的 ARN。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 使用 Maxwell 篩選條件語法選取整合的來源資料表。 + `KmsKeyId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密頻道的 KMS 金鑰的 ARN。 + `AdditionalEncryptionContext` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 一組選用的非機密金鑰值對，其中包含用於加密的其他內容資訊。只有在提供 `KMSKeyId` 時，才能提供此功能。 + `Tags` – 一個 [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) 物件陣列。 指派給由金鑰值對清單組成的資源的中繼資料。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 物件。 組態設定。 **回應** + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的來源資源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的目標資源的 ARN。 + `IntegrationName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 AWS Glue中整合的唯一名稱。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `IntegrationArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 所建立整合的 Amazon Resource Name (ARN)。 + `KmsKeyId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密頻道的 KMS 金鑰的 ARN。 + `AdditionalEncryptionContext` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 一組選用的非機密金鑰值對，其中包含用於加密的其他內容資訊。 + `Tags` – 一個 [Tag](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` – *必要：*時間戳記。 整合建立時間 (UTC)。 + `Errors` – 一個 [IntegrationError](#aws-glue-api-integrations-IntegrationError) 物件陣列。 與整合建立關聯的錯誤清單。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,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) 修改發起人帳戶中的零 ETL 整合。 **請求** + `IntegrationIdentifier` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 使用 Maxwell 篩選條件語法選取整合的來源資料表。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 物件。 整合的組態設定。目前，只能修改 RefreshInterval。 + `IntegrationName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 AWS Glue中整合的唯一名稱。 **回應** + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合來源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合目標的 ARN。 + `IntegrationName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 AWS Glue中整合的唯一名稱。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `IntegrationArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 + `KmsKeyId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密頻道的 KMS 金鑰的 ARN。 + `AdditionalEncryptionContext` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 一組選用的非機密金鑰值對，其中包含用於加密的其他內容資訊。 + `Tags` – 一個 [Tag](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` – *必要：*時間戳記。 整合建立時間 (UTC)。 + `Errors` – 一個 [IntegrationError](#aws-glue-api-integrations-IntegrationError) 物件陣列。 與整合修改關聯的錯誤清單。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 使用 Maxwell 篩選條件語法選取整合的來源資料表。 + `IntegrationConfig` – [IntegrationConfig](#aws-glue-api-integrations-IntegrationConfig) 物件。 已更新整合的組態設定。 **錯誤** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `IntegrationConflictOperationFault` + `InvalidIntegrationStateFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `InvalidStateException` + `InvalidInputException` ## DescribeIntegrations 動作 (Python：describe\$1integrations) API 用於擷取整合清單。 **請求** + `IntegrationIdentifier` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 + `Marker` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指出後續請求中下一組回應記錄起點的值。 + `MaxRecords` – 數字 (整數)。 要在輸出中傳回的項目總數。 + `Filters` – 一個 [IntegrationFilter](#aws-glue-api-integrations-IntegrationFilter) 物件陣列。 金鑰和值的清單，用於篩選結果。支援的金鑰為 "Status"、"IntegrationName" 和 "SourceArn"。IntegrationName 僅限於一個值。 **回應** + `Integrations` – 一個 [整合](#aws-glue-api-integrations-Integration) 物件陣列。 零 ETL 整合的清單。 + `Marker` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指出後續請求中下一組回應記錄起點的值。 **錯誤** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## DeleteIntegration 動作 (Python：delete\$1integration) 刪除指定的零 ETL 整合。 **請求** + `IntegrationIdentifier` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 **回應** + `SourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合來源的 ARN。 + `TargetArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合目標的 ARN。 + `IntegrationName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 AWS Glue中整合的唯一名稱。 + `Description` – UTF-8 字串，長度不可超過 1000 個位元組，需符合 [Custom string pattern #12](aws-glue-api-common.md#regex_12)。 整合的描述。 + `IntegrationArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合的 Amazon Resource Name (ARN)。 + `KmsKeyId` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 用於加密頻道的 KMS 金鑰的 ARN。 + `AdditionalEncryptionContext` – 金鑰值對的映射陣列。 每個金鑰都是 UTF-8 字串。 每個值都是 UTF-8 字串。 一組選用的非機密金鑰值對，其中包含用於加密的其他內容資訊。 + `Tags` – 一個 [Tag](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` – *必要：*時間戳記。 整合建立時間 (UTC)。 + `Errors` – 一個 [IntegrationError](#aws-glue-api-integrations-IntegrationError) 物件陣列。 與整合關聯的錯誤清單。 + `DataFilter` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 2,048 個位元組。 使用 Maxwell 篩選條件語法選取整合的來源資料表。 **錯誤** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `IntegrationConflictOperationFault` + `InvalidIntegrationStateFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `InvalidStateException` + `InvalidInputException` ## DescribeInboundIntegrations 動作 (Python：describe\$1inbound\$1integrations) 傳回所指定整合的傳入整合清單。 **請求** + `IntegrationArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 事件整合的 Amazon Resource Name (ARN)。 + `Marker` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 用以指定分頁開始位置的字符。這是來自先前已截斷回應的標記。 + `MaxRecords` – 數字 (整數)。 要在輸出中傳回的項目總數。 + `TargetArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 整合中目標資源的 Amazon Resource Name (ARN)。 **回應** + `InboundIntegrations` – 一個 [InboundIntegration](#aws-glue-api-integrations-InboundIntegration) 物件陣列。 傳入整合的清單。 + `Marker` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 指出後續請求中下一組回應記錄起點的值。 **錯誤** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `TargetResourceNotFound` + `OperationNotSupportedException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## CreateIntegrationTableProperties 動作 (Python：create\$1integration\$1table\$1properties) 此 API 用於為需要複寫的資料表提供選用的覆寫屬性。這些屬性可以包含用於篩選及分區來源和目標資料表的屬性。若要同時設定來源和目標屬性，必須使用與 相同的 AWS Glue 連線 ARN`SourceTableConfig`，以及`TargetTableConfig`分別與 `ResourceArn` `ResourceArn`相同的 AWS Glue 資料庫 ARN 來叫用相同的 API。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要為其建立整合資料表屬性的目標資料表的 Amazon Resource Name (ARN)。目前，此 API 僅支援為目標資料表建立整合資料表屬性，且提供的 ARN 應為 AWS Glue Data Catalog 中目標資料表的 ARN。尚未實作對為來源連線 (使用連線 ARN) 建立整合資料表屬性的支援，將在未來版本中新增。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要複寫的資料表名稱。 + `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) 此 API 用於為需要複寫的資料表提供選用的覆寫屬性。這些屬性可以包含用於篩選及分區來源和目標資料表的屬性。若要同時設定來源和目標屬性，必須使用與 相同的 AWS Glue 連線 ARN`SourceTableConfig`，以及`TargetTableConfig`分別與 `ResourceArn` `ResourceArn`相同的 AWS Glue 資料庫 ARN 來叫用相同的 API。 覆寫將反映在所有使用相同 `ResourceArn` 和來源資料表的整合中。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 ARN，或目標的資料庫 ARN。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要複寫的資料表名稱。 + `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) 此 API 用於擷取需要複寫的資料表的選用覆寫屬性。這些屬性可以包含用於篩選及分區來源和目標資料表的屬性。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要為其擷取整合資料表屬性的目標資料表的 Amazon Resource Name (ARN)。目前，此 API 僅支援擷取目標資料表的屬性，而提供的 ARN 應該是 AWS Glue 資料目錄中目標資料表的 ARN。尚未實作擷取來源連線 (使用連線 ARN) 整合資料表屬性的支援，將在未來版本中新增。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要複寫的資料表名稱。 **回應** + `ResourceArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要為其擷取整合資料表屬性的目標資料表的 Amazon Resource Name (ARN)。目前，此 API 僅支援擷取目標資料表的屬性，而提供的 ARN 應該是 AWS Glue 資料目錄中目標資料表的 ARN。尚未實作擷取來源連線 (使用連線 ARN) 整合資料表屬性的支援，將在未來版本中新增。 + `TableName` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要複寫的資料表名稱。 + `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) 刪除為需要複寫的資料表建立的資料表屬性。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 ARN，或目標的資料庫 ARN。 + `TableName` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 要複寫的資料表名稱。 **回應** + *無回應參數。* **錯誤** + `ValidationException` + `AccessDeniedException` + `ResourceNotFoundException` + `InternalServerException` + `EntityNotFoundException` + `InternalServiceException` + `InvalidInputException` ## CreateIntegrationResourceProperty 動作 (Python：create\$1integration\$1resource\$1property) 此 API 可用於設定 AWS Glue 連線`ResourceProperty`的 （適用於來源） 或 AWS Glue 資料庫 ARN （適用於目標）。這些屬性可以包含角色來存取連線或資料庫。若要同時設定來源和目標屬性，需要分別使用與 `ResourceArn`相同的 AWS Glue 連線 ARN `SourceProcessingProperties`和與 AWS Glue `ResourceArn`相同的資料庫 ARN 來叫用相同的 API`TargetProcessingProperties`。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 ARN，或目標的資料庫 ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 物件。 與整合來源關聯的資源屬性。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 物件。 與整合目標關聯的資源屬性。 **回應** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 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) 此 API 可用於更新 AWS Glue 連線`ResourceProperty`的 （適用於來源） 或 AWS Glue 資料庫 ARN （適用於目標）。這些屬性可以包含角色來存取連線或資料庫。由於相同的資源可用於多個整合，因此更新資源屬性會影響使用其所有整合。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 ARN，或目標的資料庫 ARN。 + `SourceProcessingProperties` – [SourceProcessingProperties](#aws-glue-api-integrations-SourceProcessingProperties) 物件。 與整合來源關聯的資源屬性。 + `TargetProcessingProperties` – [TargetProcessingProperties](#aws-glue-api-integrations-TargetProcessingProperties) 物件。 與整合目標關聯的資源屬性。 **回應** + `ResourceArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 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) 此 API 用於擷取 AWS Glue 連線`ResourceProperty`的 （適用於來源） 或 AWS Glue 資料庫 ARN （適用於目標） **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 ARN，或目標的資料庫 ARN。 **回應** + `ResourceArn` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。 來源的連線 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) 從整合資源移除指定的標籤。 **請求** + `ResourceArn` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 10240 個位元組，且需符合[Custom string pattern #50](aws-glue-api-common.md#regex_50)。 整合資源的 Amazon Resource Name (ARN)。 + `TagsToRemove` – *必要：*UTF-8 字串的陣列，不可超過 50 個字串。 要從資源移除的中繼資料標籤的清單。 **回應** + *無回應參數。* **錯誤** + `ResourceNotFoundException` ## ListTagsForResource 動作 (Python：list\$1tags\$1for\$1resource) 列出指派給所指定資源的中繼資料標籤。 **請求** + `ResourceARN` – *必要：*UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 10240 個位元組，且需符合[Custom string pattern #50](aws-glue-api-common.md#regex_50)。 資源的資源 ARN。 **回應** + `Tags` – 一個 [Tag](aws-glue-api-common.md#aws-glue-api-common-Tag) 物件陣列，不可超過 10 個結構。 標籤的清單。 **錯誤** + `ResourceNotFoundException` ## 例外狀況 + [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 結構 找不到來源。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## InternalServerException 結構 發生內部伺服器錯誤。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## IntegrationAlreadyExistsFault 結構 指定的整合已存在。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## IntegrationConflictOperationFault 結構 請求的操作與另一個操作衝突。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## IntegrationQuotaExceededFault 結構 透過整合處理的資料超過您的配額。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## KMSKeyNotAccessibleFault 結構 指定的 KMS 金鑰無法存取。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## IntegrationNotFoundFault 結構 找不到指定的整合。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## TargetResourceNotFound 結構 找不到目標來源。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。 ## InvalidIntegrationStateFault 結構 整合處於無效狀態。 **欄位** + `Message` – UTF-8 字串。 說明問題的訊息。