PutDynamoDB

文档中心 › 组件索引 › PutDynamoDB

PutDynamoDB Processor

类型全限定名：cn.org.acal.lynxus.processors.aws.dynamodb.PutDynamoDB

所属 Bundle：cn.org.acal.lynxus:lynxus-aws-nar:2.11.8

描述

基于哈希键和范围键将文档放入 DynamoDB。表可以具有哈希键和范围键

标签

AmazonDynamoDBAWSPutInsert

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称默认值可选值描述
Table NameDynamoDB 表名称
支持表达式语言：是（仅使用环境/系统变量求值）
Regionus-west-2
  • Africa (Cape Town) — AWS Region Code : af-south-1
  • Asia Pacific (Hong Kong) — AWS Region Code : ap-east-1
  • Asia Pacific (Hyderabad) — AWS Region Code : ap-south-2
  • Asia Pacific (Jakarta) — AWS Region Code : ap-southeast-3
  • Asia Pacific (Malaysia) — AWS Region Code : ap-southeast-5
  • Asia Pacific (Melbourne) — AWS Region Code : ap-southeast-4
  • Asia Pacific (Mumbai) — AWS Region Code : ap-south-1
  • Asia Pacific (New Zealand) — AWS Region Code : ap-southeast-6
  • Asia Pacific (Osaka) — AWS Region Code : ap-northeast-3
  • Asia Pacific (Seoul) — AWS Region Code : ap-northeast-2
  • Asia Pacific (Singapore) — AWS Region Code : ap-southeast-1
  • Asia Pacific (Sydney) — AWS Region Code : ap-southeast-2
  • Asia Pacific (Taipei) — AWS Region Code : ap-east-2
  • Asia Pacific (Thailand) — AWS Region Code : ap-southeast-7
  • Asia Pacific (Tokyo) — AWS Region Code : ap-northeast-1
  • AWS European Sovereign Cloud (Germany) — AWS Region Code : eusc-de-east-1
  • aws global region — AWS Region Code : aws-global
  • AWS GovCloud (US-East) — AWS Region Code : us-gov-east-1
  • AWS GovCloud (US-West) — AWS Region Code : us-gov-west-1
  • aws-cn global region — AWS Region Code : aws-cn-global
  • aws-iso global region — AWS Region Code : aws-iso-global
  • aws-iso-b global region — AWS Region Code : aws-iso-b-global
  • aws-iso-e global region — AWS Region Code : aws-iso-e-global
  • aws-iso-f global region — AWS Region Code : aws-iso-f-global
  • aws-us-gov global region — AWS Region Code : aws-us-gov-global
  • Canada (Central) — AWS Region Code : ca-central-1
  • Canada West (Calgary) — AWS Region Code : ca-west-1
  • China (Beijing) — AWS Region Code : cn-north-1
  • China (Ningxia) — AWS Region Code : cn-northwest-1
  • EU ISOE West — AWS Region Code : eu-isoe-west-1
  • Europe (Frankfurt) — AWS Region Code : eu-central-1
  • Europe (Ireland) — AWS Region Code : eu-west-1
  • Europe (London) — AWS Region Code : eu-west-2
  • Europe (Milan) — AWS Region Code : eu-south-1
  • Europe (Paris) — AWS Region Code : eu-west-3
  • Europe (Spain) — AWS Region Code : eu-south-2
  • Europe (Stockholm) — AWS Region Code : eu-north-1
  • Europe (Zurich) — AWS Region Code : eu-central-2
  • Israel (Tel Aviv) — AWS Region Code : il-central-1
  • Mexico (Central) — AWS Region Code : mx-central-1
  • Middle East (Bahrain) — AWS Region Code : me-south-1
  • Middle East (UAE) — AWS Region Code : me-central-1
  • South America (Sao Paulo) — AWS Region Code : sa-east-1
  • US East (N. Virginia) — AWS Region Code : us-east-1
  • US East (Ohio) — AWS Region Code : us-east-2
  • US ISO East — AWS Region Code : us-iso-east-1
  • US ISO WEST — AWS Region Code : us-iso-west-1
  • US ISOB East (Ohio) — AWS Region Code : us-isob-east-1
  • US ISOB West — AWS Region Code : us-isob-west-1
  • US ISOF EAST — AWS Region Code : us-isof-east-1
  • US ISOF SOUTH — AWS Region Code : us-isof-south-1
  • US West (N. California) — AWS Region Code : us-west-1
  • US West (Oregon) — AWS Region Code : us-west-2
  • Use Custom Region — 用户定义的区域，可以是非 AWS 区域，和/或来自表达式语言（Expression Language）
服务所在的 AWS 区域
Custom Region自定义区域，例如 AWS 兼容服务提供商的区域
支持表达式语言：是（仅使用环境/系统变量求值）
AWS Credentials Provider Service控制器服务 API：
AwsCredentialsProviderService
cn.org.acal.lynxus-lynxus-aws-service-api-nar-2.11.8		用于获取AWS凭证提供者的Controller Service
Json Document要从 dynamodb 项检索的 Json 文档（架构中的“s”类型）
支持表达式语言：是（仅使用环境/系统变量求值）
Hash Key Name项目的哈希键名称
支持表达式语言：是（仅使用环境/系统变量求值）
Range Key Name项目的范围键名称
支持表达式语言：是（仅使用环境/系统变量求值）
Hash Key Value${dynamodb.item.hash.key.value}项目的哈希Key-Value
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Range Key Value${dynamodb.item.range.key.value}
支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Hash Key Value Typestring
  • string
  • number
项目的哈希Key-Value类型
Range Key Value Typestring
  • string
  • number
项目的范围Key-Value类型
Document Character SetUTF-8文档中数据的字符集
支持表达式语言：是（仅使用环境/系统变量求值）
Batch Items Per Request1一批中要检索的项目数量（1 到 50 之间）
支持表达式语言：是（仅使用环境/系统变量求值）
Communications Timeout30 secs
Endpoint Override URL用于替代 AWS 默认端点的端点 URL，包括协议、主机、端口和路径。AWS 库根据 AWS 区域选择端点 URL，但此属性会覆盖所选端点 URL，允许与其他 S3 兼容端点一起使用。
支持表达式语言：是（仅使用环境/系统变量求值）
SSL Context Service控制器服务 API：
SSLContextProvider
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		指定可选的 SSL 上下文服务，如果提供，将用于创建连接
Proxy Configuration Service控制器服务 API：
ProxyConfigurationService
cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8		指定代理配置 Controller Service 来代理网络请求。

关系 (Relationships)

名称描述自动终止
failureFlowFiles被路由到故障关系否
successFlowFiles被路由到成功关系否
unprocessed当 DynamoDB 无法处理请求中的所有项目时，FlowFile 被路由到未处理关系。典型原因是表吞吐量不足和超过每个请求的最大字节数。未处理的 FlowFile 可以通过新请求重试。否

读取的 FlowFile 属性

名称描述
dynamodb.item.hash.key.value项目哈希键值
dynamodb.item.range.key.value项目范围键值

写入的 FlowFile 属性

名称描述
dynamodb.key.error.unprocessedDynamoDB 未处理的密钥
dynmodb.range.key.value.errorDynamoDB 范围键错误
dynamodb.key.error.not.found未找到 DynamoDB 密钥
dynamodb.error.exception.messageDynamoDB 异常消息
dynamodb.error.codeDynamoDB 错误代码
dynamodb.error.messageDynamoDB 错误消息
dynamodb.error.serviceDynamoDB 错误服务
dynamodb.error.retryableDynamoDB 错误可重试
dynamodb.error.request.idDynamoDB 错误请求 ID
dynamodb.error.status.codeDynamoDB 错误状态代码
dynamodb.item.io.error创建项目时的 IO 异常消息

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。

系统资源考量

资源描述
MEMORYAn instance of this component can cause high usage of this system resource. Multiple instances or high concurrency settings may result a degradation of performance.

另请参阅

© 2026 ACAL Organization. Licensed under Apache License 2.0.