# AWS Glue 中的集成 API ## 数据类型 + [集成结构](#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 资源名称 (ARN)。 + `KmsKeyId`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 用于加密通道的 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 个字节，不超过 2048 个字节。 使用 Maxwell 筛选条件语法选择用于集成的源表。 ## IntegrationConfig 结构 与集成关联的属性。 **字段** + `RefreshInterval` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。 指定执行 CDC（更改数据捕获）拉取或增量加载的频率。此参数支持灵活地根据特定数据更新模式、系统负载注意事项和性能优化目标调整刷新率。时间增量可以设置为 15 到 8640 分钟（六天）。 + `SourceProperties` – 键值对的映射数组。 每个键是一个 UTF-8 字符串。 每个值是一个 UTF-8 字符串。 为集成源指定其他属性的键值对集合。这些属性提供有配置选项，可用于自定义 ODB 源在数据集成操作期间的行为。 + `ContinuousSync`：布尔值。 支持从以下位置按需提取数据的连续同步：1) SaaS 应用程序到 AWS 数据服务（如 Amazon Redshift 和 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 年 1 月 15 日） + `hour` - 从时间戳值中提取小时数（例如，2023 年 1 月 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` \$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 个字节，不超过 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` \$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 资源名称 (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 个字节，不超过 2048 个字节。 使用 Maxwell 筛选条件语法选择用于集成的源表。 + `KmsKeyId`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 用于加密通道的 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 资源名称 (ARN)。 + `KmsKeyId`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 用于加密通道的 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 个字节，不超过 2048 个字节。 使用 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 资源名称 (ARN)。 + `Description`：UTF-8 字符串，长度不超过 1000 个字节，与 [Custom string pattern #12](aws-glue-api-common.md#regex_12) 匹配。 集成的描述。 + `DataFilter`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 使用 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 资源名称 (ARN)。 + `KmsKeyId`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 用于加密通道的 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 个字节，不超过 2048 个字节。 使用 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 资源名称 (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 资源名称 (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 资源名称 (ARN)。 + `KmsKeyId`：UTF-8 字符串，长度不少于 1 个字节，不超过 2048 个字节。 用于加密通道的 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 个字节，不超过 2048 个字节。 使用 Maxwell 筛选条件语法选择用于集成的源表。 **错误** + `ValidationException` + `AccessDeniedException` + `InternalServerException` + `IntegrationNotFoundFault` + `IntegrationConflictOperationFault` + `InvalidIntegrationStateFault` + `EntityNotFoundException` + `InternalServiceException` + `ConflictException` + `InvalidStateException` + `InvalidInputException` ## DescribeInboundIntegrations 操作（Python：describe\$1inbound\$1integrations） 返回指定集成的入站集成列表。 **请求** + `IntegrationArn` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。 集成的 Amazon 资源名称 (ARN)。 + `Marker` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。 指定从何处开始分页的令牌。这是先前截断的响应中的标记。 + `MaxRecords` – 数字（整数）。 输出中要返回的项总数。 + `TargetArn` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。 集成中目标资源的 Amazon 资源名称 (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 作为 `ResourceArn` 和 `SourceTableConfig` 来调用相同的 API，并使用 AWS Glue 数据库 ARN 作为 `ResourceArn` 和 `TargetTableConfig` 来调用相同的 API。 **请求** + `ResourceArn`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。 要为其创建集成表属性的目标表的 Amazon 资源名称 (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 作为 `ResourceArn` 和 `SourceTableConfig` 来调用相同的 API，并使用 AWS Glue 数据库 ARN 作为 `ResourceArn` 和 `TargetTableConfig` 来调用相同的 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 资源名称 (ARN)。目前，此 API 仅支持为目标表检索属性，并且提供的 ARN 应为 AWS Glue Data Catalog 中目标表的 ARN。尚未实现对源连接（使用连接 ARN）检索集成表属性的支持，将在未来版本中添加。 + `TableName`：*必需：*UTF-8 字符串，长度不少于 1 个字节，不超过 128 个字节。 要复制的表的名称。 **响应** + `ResourceArn` – UTF-8 字符串，长度不少于 1 个字节或超过 128 个字节。 要为其检索集成表属性的目标表的 Amazon 资源名称 (ARN)。目前，此 API 仅支持为目标表检索属性，并且提供的 ARN 应为 AWS Glue Data Catalog 中目标表的 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 连接（对于源）或 AWS Glue 数据库 ARN（对于目标）的 `ResourceProperty`。这些属性可包括访问连接或数据库的角色。要设置源属性和目标属性，需要分别使用 AWS Glue 连接 ARN 作为 `ResourceArn` 和 `SourceProcessingProperties` 来调用相同的 API，并使用 AWS Glue 数据库 ARN 作为 `ResourceArn` 和 `TargetProcessingProperties` 来调用相同的 API。 **请求** + `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 连接（对于源）或 AWS Glue 数据库 ARN（对于目标）的 `ResourceProperty`。这些属性可包括访问连接或数据库的角色。由于相同的资源可以在多个集成中使用，因此更新资源属性将影响所有使用它的集成。 **请求** + `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 连接（对于源）或 AWS Glue 数据库 ARN（对于目标）的 `ResourceProperty` **请求** + `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 资源名称 (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 字符串。 描述问题的消息。