本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
中的整合 APIs AWS Glue
資料類型
整合結構
描述零 ETL 整合。
欄位
-
SourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合來源的 ARN。
-
TargetArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合目標的 ARN。
-
Description– UTF-8 字串,長度不可超過 1000 個位元組,需符合 Custom string pattern #12。整合的說明。
-
IntegrationName– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的唯一名稱。
-
IntegrationArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的 Amazon Resource Name (ARN)。
-
KmsKeyId– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密頻道之 KMS 金鑰的 ARN。
-
AdditionalEncryptionContext– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
一組選用的非秘密金鑰/值對,其中包含用於加密的其他內容資訊。只有在提供
KMSKeyId時,才能提供此功能。 -
Tags– 一個 Tag 物件陣列。指派給 資源的中繼資料,由索引鍵/值對清單組成。
-
Status– 必要:UTF-8 字串 (有效值:CREATING|ACTIVE|MODIFYING|FAILED|DELETING|SYNCING|NEEDS_ATTENTION)。可能的狀態如下:
-
CREATING:正在建立整合。
-
ACTIVE:整合建立成功。
-
修改中:正在修改整合。
-
失敗:整合建立失敗。
-
刪除:整合已刪除。
-
SYNCING:整合正在同步。
-
NEEDS_ATTENTION:整合需要關注,例如同步。
-
-
CreateTime– 必要:時間戳記。以 UTC 建立整合的時間。
-
IntegrationConfig– IntegrationConfig 物件。與整合相關聯的屬性。
-
Errors– 一個 IntegrationError 物件陣列。與整合相關聯的錯誤清單。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
IntegrationConfig 結構
與整合相關聯的屬性。
欄位
-
RefreshInterval– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。指定 CDC (變更資料擷取) 提取或增量載入應該發生的頻率。此參數提供彈性,讓重新整理速率與您的特定資料更新模式、系統負載考量和效能最佳化目標保持一致。時間增量可以設定為 15 分鐘到 8640 分鐘 (六天)。
-
SourceProperties– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
金鑰值對的集合,可指定整合來源的其他屬性。這些屬性提供組態選項,可用於在資料整合操作期間自訂 ODB 來源的行為。
-
ContinuousSync– 布林值。針對從 SaaS 應用程式到 Amazon Redshift 和 等 AWS 資料服務的需求資料擷取,啟用持續同步 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 個位元組,也不可以超過 2048 個位元組。描述錯誤的訊息。
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|ACTIVE|MODIFYING|FAILED|DELETING|SYNCING|NEEDS_ATTENTION)。可能的狀態如下:
-
CREATING:正在建立整合。
-
ACTIVE:整合建立成功。
-
修改中:正在修改整合。
-
失敗:整合建立失敗。
-
刪除:整合已刪除。
-
SYNCING:整合正在同步。
-
NEEDS_ATTENTION:整合需要關注,例如同步。
-
-
CreateTime– 必要:時間戳記。以 UTC 建立整合的時間。
-
IntegrationConfig– IntegrationConfig 物件。與整合相關聯的屬性。
-
Errors– 一個 IntegrationError 物件陣列。與整合相關聯的錯誤清單。
SourceProcessingProperties 結構
與整合來源相關聯的資源屬性。
欄位
-
RoleArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。存取 AWS Glue 連線的 IAM 角色。
TargetProcessingProperties 結構
與整合目標相關聯的資源屬性。
欄位
-
RoleArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。存取 AWS Glue 資料庫的 IAM 角色。
-
KmsArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密之 KMS 金鑰的 ARN。
-
ConnectionName– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。用於設定在客戶 VPC 中執行之 AWS Glue 任務的 AWS Glue 網路連線。
-
EventBusArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。接收整合狀態通知的 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|FULL|NOUNNEST)。指定如何將巢狀物件扁平化為最上層元素。有效值為:「TOPLEVEL」、「FULL」或「NOUNNEST」。
-
PartitionSpec– 一個 IntegrationPartition 物件陣列。決定目標上的檔案配置。
-
TargetTableName– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。目標資料表的選用名稱。
作業
DescribeInboundIntegrations 動作 (Python: describe_inbound_integrations)
CreateIntegrationTableProperties 動作 (Python:create_integration_table_properties)
UpdateIntegrationTableProperties 動作 (Python:update_integration_table_properties)
GetIntegrationTableProperties 動作 (Python:get_integration_table_properties)
DeleteIntegrationTableProperties 動作 (Python:Delete_integration_table_properties)
CreateIntegrationResourceProperty 動作 (Python:create_integration_resource_property)
UpdateIntegrationResourceProperty 動作 (Python:update_integration_resource_property)
GetIntegrationResourceProperty 動作 (Python:get_integration_resource_property)
CreateIntegration 動作 (Python:create_integration)
在具有 Amazon Resource Name (ARNs) 的兩個資源之間,在發起人的帳戶中建立零 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。整合的說明。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
-
KmsKeyId– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密頻道的 KMS 金鑰 ARN。
-
AdditionalEncryptionContext– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
一組選用的非秘密金鑰/值對,其中包含用於加密的其他內容資訊。只有在提供
KMSKeyId時,才能提供此功能。 -
Tags– 一個 Tag 物件陣列。指派給 資源的中繼資料,由索引鍵/值對清單組成。
-
IntegrationConfig– 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。整合的說明。
-
IntegrationArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。已建立整合的 Amazon Resource Name (ARN)。
-
KmsKeyId– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密頻道的 KMS 金鑰 ARN。
-
AdditionalEncryptionContext– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
一組選用的非秘密金鑰/值對,其中包含用於加密的其他內容資訊。
-
Tags– 一個 Tag 物件陣列。指派給 資源的中繼資料,由索引鍵/值對清單組成。
-
Status– 必要:UTF-8 字串 (有效值:CREATING|ACTIVE|MODIFYING|FAILED|DELETING|SYNCING|NEEDS_ATTENTION)。正在建立的整合狀態。
可能的狀態如下:
-
CREATING:正在建立整合。
-
ACTIVE:整合建立成功。
-
修改中:正在修改整合。
-
失敗:整合建立失敗。
-
刪除:整合已刪除。
-
SYNCING:整合正在同步。
-
NEEDS_ATTENTION:整合需要注意,例如同步。
-
-
CreateTime– 必要:時間戳記。建立整合的時間,以 UTC 為單位。
-
Errors– 一個 IntegrationError 物件陣列。與整合建立相關聯的錯誤清單。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
-
IntegrationConfig– IntegrationConfig 物件。組態設定。
錯誤
ValidationExceptionAccessDeniedExceptionResourceNotFoundExceptionInternalServerExceptionIntegrationConflictOperationFaultIntegrationQuotaExceededFaultKMSKeyNotAccessibleFaultEntityNotFoundExceptionInternalServiceExceptionConflictExceptionResourceNumberLimitExceededExceptionInvalidInputException
ModifyIntegration 動作 (Python: modify_integration)
修改發起人帳戶中的零 ETL 整合。
請求
-
IntegrationIdentifier– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的 Amazon Resource Name (ARN)。
-
Description– UTF-8 字串,長度不可超過 1000 個位元組,需符合 Custom string pattern #12。整合的說明。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
-
IntegrationConfig– 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。整合的說明。
-
IntegrationArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的 Amazon Resource Name (ARN)。
-
KmsKeyId– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密頻道的 KMS 金鑰 ARN。
-
AdditionalEncryptionContext– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
一組選用的非秘密金鑰/值對,其中包含用於加密的其他內容資訊。
-
Tags– 一個 Tag 物件陣列。指派給 資源的中繼資料,由索引鍵/值對清單組成。
-
Status– 必要:UTF-8 字串 (有效值:CREATING|ACTIVE|MODIFYING|FAILED|DELETING|SYNCING|NEEDS_ATTENTION)。正在修改的整合狀態。
可能的狀態如下:
-
CREATING:正在建立整合。
-
ACTIVE:整合建立成功。
-
修改中:正在修改整合。
-
失敗:整合建立失敗。
-
刪除:整合已刪除。
-
SYNCING:整合正在同步。
-
NEEDS_ATTENTION:整合需要注意,例如同步。
-
-
CreateTime– 必要:時間戳記。建立整合的時間,以 UTC 為單位。
-
Errors– 一個 IntegrationError 物件陣列。與整合修改相關聯的錯誤清單。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
-
IntegrationConfig– IntegrationConfig 物件。已更新整合的組態設定。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionIntegrationNotFoundFaultIntegrationConflictOperationFaultInvalidIntegrationStateFaultEntityNotFoundExceptionInternalServiceExceptionConflictExceptionInvalidStateExceptionInvalidInputException
DescribeIntegrations 動作 (Python: describe_integrations)
API 用於擷取整合清單。
請求
-
IntegrationIdentifier– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的 Amazon Resource Name (ARN)。
-
Marker– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。指出後續請求中下一組回應記錄起點的值。
-
MaxRecords– 數字 (整數)。要在輸出中傳回的項目總數。
-
Filters– 一個 IntegrationFilter 物件陣列。索引鍵和值的清單,用於篩選結果。支援的金鑰為 "Status"、"IntegrationName" 和 "SourceArn"。IntegrationName 僅限於一個值。
回應
-
Integrations– 一個 整合 物件陣列。零 ETL 整合的清單。
-
Marker– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。指出後續請求中下一組回應記錄起點的值。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionIntegrationNotFoundFaultEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
DeleteIntegration 動作 (Python:Delete_integration)
刪除指定的零 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。整合的說明。
-
IntegrationArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。整合的 Amazon Resource Name (ARN)。
-
KmsKeyId– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。用於加密頻道之 KMS 金鑰的 ARN。
-
AdditionalEncryptionContext– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串。
每個值都是 UTF-8 字串。
一組選用的非秘密金鑰/值對,其中包含用於加密的其他內容資訊。
-
Tags– 一個 Tag 物件陣列。指派給 資源的中繼資料,由索引鍵/值對清單組成。
-
Status– 必要:UTF-8 字串 (有效值:CREATING|ACTIVE|MODIFYING|FAILED|DELETING|SYNCING|NEEDS_ATTENTION)。要刪除的整合狀態。
可能的狀態如下:
-
CREATING:正在建立整合。
-
ACTIVE:整合建立成功。
-
修改中:正在修改整合。
-
失敗:整合建立失敗。
-
刪除:整合已刪除。
-
SYNCING:整合正在同步。
-
NEEDS_ATTENTION:整合需要關注,例如同步。
-
-
CreateTime– 必要:時間戳記。建立整合的時間,以 UTC 為單位。
-
Errors– 一個 IntegrationError 物件陣列。與整合相關聯的錯誤清單。
-
DataFilter– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 2048 個位元組。使用 Maxwell 篩選條件語法選取整合的來源資料表。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionIntegrationNotFoundFaultIntegrationConflictOperationFaultInvalidIntegrationStateFaultEntityNotFoundExceptionInternalServiceExceptionConflictExceptionInvalidStateExceptionInvalidInputException
DescribeInboundIntegrations 動作 (Python: describe_inbound_integrations)
傳回指定整合的傳入整合清單。
請求
-
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 物件陣列。傳入整合的清單。
-
Marker– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。指出後續請求中下一組回應記錄起點的值。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionIntegrationNotFoundFaultTargetResourceNotFoundOperationNotSupportedExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
CreateIntegrationTableProperties 動作 (Python:create_integration_table_properties)
此 API 用於為需要複寫的資料表提供選用覆寫屬性。這些屬性可以包含用於篩選和分割來源和目標資料表的屬性。若要同時設定來源和目標屬性,必須使用與 相同的 AWS Glue 連線 ARNResourceArnSourceTableConfig,以及TargetTableConfig分別與 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 物件。來源資料表組態的結構。請參閱
SourceTableConfig結構以查看支援的來源屬性清單。 -
TargetTableConfig– TargetTableConfig 物件。目標資料表組態的結構。
回應
無回應參數。
錯誤
ValidationExceptionAccessDeniedExceptionResourceNotFoundExceptionInternalServerExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
UpdateIntegrationTableProperties 動作 (Python:update_integration_table_properties)
此 API 用於為需要複寫的資料表提供選用的覆寫屬性。這些屬性可以包含用於篩選和分割來源和目標資料表的屬性。若要同時設定來源和目標屬性,必須使用與 相同的 AWS Glue 連線 ARNResourceArnSourceTableConfig,以及TargetTableConfig分別與 ResourceArn相同的 AWS Glue 資料庫 ARN 來叫用相同的 API。
覆寫將反映在所有使用相同 ResourceArn和來源資料表的整合中。
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
TableName– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。要複寫的資料表名稱。
-
SourceTableConfig– SourceTableConfig 物件。來源資料表組態的結構。
-
TargetTableConfig– TargetTableConfig 物件。目標資料表組態的結構。
回應
無回應參數。
錯誤
ValidationExceptionAccessDeniedExceptionResourceNotFoundExceptionInternalServerExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
GetIntegrationTableProperties 動作 (Python:get_integration_table_properties)
此 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 物件。來源資料表組態的結構。
-
TargetTableConfig– TargetTableConfig 物件。目標資料表組態的結構。
錯誤
ValidationExceptionAccessDeniedExceptionResourceNotFoundExceptionInternalServerExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
DeleteIntegrationTableProperties 動作 (Python:Delete_integration_table_properties)
刪除為需要複寫的資料表建立的資料表屬性。
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
TableName– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。要複寫的資料表名稱。
回應
無回應參數。
錯誤
ValidationExceptionAccessDeniedExceptionResourceNotFoundExceptionInternalServerExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
CreateIntegrationResourceProperty 動作 (Python:create_integration_resource_property)
此 API 可用於設定 AWS Glue 連線ResourceProperty的 (適用於來源) 或 AWS Glue 資料庫 ARN (適用於目標)。這些屬性可以包含 角色來存取連線或資料庫。若要同時設定來源和目標屬性,需要分別使用與 ResourceArn相同的 AWS Glue 連線 ARN SourceProcessingProperties和與 AWS Glue ResourceArn相同的資料庫 ARN 來叫用相同的 APITargetProcessingProperties。
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
SourceProcessingProperties– SourceProcessingProperties 物件。與整合來源相關聯的資源屬性。
-
TargetProcessingProperties– TargetProcessingProperties 物件。與整合目標相關聯的資源屬性。
回應
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
SourceProcessingProperties– SourceProcessingProperties 物件。與整合來源相關聯的資源屬性。
-
TargetProcessingProperties– TargetProcessingProperties 物件。與整合目標相關聯的資源屬性。
錯誤
ValidationExceptionAccessDeniedExceptionConflictExceptionInternalServerExceptionResourceNotFoundExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
UpdateIntegrationResourceProperty 動作 (Python:update_integration_resource_property)
此 API 可用於更新 AWS Glue 連線ResourceProperty的 (適用於來源) 或 AWS Glue 資料庫 ARN (適用於目標)。這些屬性可以包含 角色來存取連線或資料庫。由於相同的資源可用於多個整合,因此更新資源屬性會影響使用它的所有整合。
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
SourceProcessingProperties– SourceProcessingProperties 物件。與整合來源相關聯的資源屬性。
-
TargetProcessingProperties– TargetProcessingProperties 物件。與整合目標相關聯的資源屬性。
回應
-
ResourceArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
SourceProcessingProperties– SourceProcessingProperties 物件。與整合來源相關聯的資源屬性。
-
TargetProcessingProperties– TargetProcessingProperties 物件。與整合目標相關聯的資源屬性。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionResourceNotFoundExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
GetIntegrationResourceProperty 動作 (Python:get_integration_resource_property)
此 API 用於擷取 AWS Glue 連線ResourceProperty的 (適用於來源) 或 AWS Glue 資料庫 ARN (適用於目標)
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
回應
-
ResourceArn– UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 128 個位元組。來源的連線 ARN,或目標的資料庫 ARN。
-
SourceProcessingProperties– SourceProcessingProperties 物件。與整合來源相關聯的資源屬性。
-
TargetProcessingProperties– TargetProcessingProperties 物件。與整合目標相關聯的資源屬性。
錯誤
ValidationExceptionAccessDeniedExceptionInternalServerExceptionResourceNotFoundExceptionEntityNotFoundExceptionInternalServiceExceptionInvalidInputException
UntagResource 動作 (Python: untag_resource)
從整合資源移除指定的標籤。
請求
-
ResourceArn– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 10240 個位元組,且需符合Custom string pattern #49。整合資源的 Amazon Resource Name (ARN)。
-
TagsToRemove– 必要:UTF-8 字串的陣列,不可超過 50 個字串。要從資源中移除的中繼資料標籤清單。
回應
無回應參數。
錯誤
ResourceNotFoundException
ListTagsForResource 動作 (Python:list_tags_for_resource)
列出指派給指定資源的中繼資料標籤。
請求
-
ResourceARN– 必要:UTF-8 字串,長度不可小於 1 個位元組,也不可以超過 10240 個位元組,且需符合Custom string pattern #49。資源的資源 ARN。
回應
-
Tags– 一個 Tag 物件陣列,不可超過 10 個結構。標籤的清單。
錯誤
ResourceNotFoundException
例外狀況
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 字串。說明問題的訊息。