PutDynamoDB

Description:

Puts a document from DynamoDB based on hash and range key. The table can have either hash and range or hash key alone. Currently the keys supported are string and number and value can be json document. In case of hash and range keys both key are required for the operation. The FlowFile content must be JSON. FlowFile content is mapped to the specified Json Document attribute in the DynamoDB item.

Tags:

Amazon, DynamoDB, AWS, Put, Insert

Properties:

In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.

Display NameAPI NameDefault ValueAllowable ValuesDescription
Table NameTable NameThe DynamoDB table name
Supports Expression Language: true (will be evaluated using Environment variables only)
RegionRegionUS West (Oregon)
  • AWS GovCloud (US-East) AWS Region Code : us-gov-east-1
  • AWS GovCloud (US-West) AWS Region Code : us-gov-west-1
  • 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 (Melbourne) AWS Region Code : ap-southeast-4
  • Asia Pacific (Mumbai) AWS Region Code : ap-south-1
  • 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 (Tokyo) AWS Region Code : ap-northeast-1
  • 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
  • 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
  • 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 West (N. California) AWS Region Code : us-west-1
  • US West (Oregon) AWS Region Code : us-west-2
  • aws-cn-global AWS Region Code : aws-cn-global
  • aws-global AWS Region Code : aws-global
  • aws-iso-b-global AWS Region Code : aws-iso-b-global
  • aws-iso-global AWS Region Code : aws-iso-global
  • aws-us-gov-global AWS Region Code : aws-us-gov-global
No description provided.
AWS Credentials Provider ServiceAWS Credentials Provider serviceController Service API:
AWSCredentialsProviderService
Implementations: AWSCredentialsProviderControllerService
AWSIDBrokerCloudCredentialsProviderControllerService		The Controller Service that is used to obtain AWS credentials provider
Json Document attributeJson Document attributeThe Json document to be retrieved from the dynamodb item ('s' type in the schema)
Supports Expression Language: true (will be evaluated using Environment variables only)
Hash Key NameHash Key NameThe hash key name of the item
Supports Expression Language: true (will be evaluated using Environment variables only)
Range Key NameRange Key NameThe range key name of the item
Supports Expression Language: true (will be evaluated using Environment variables only)
Hash Key ValueHash Key Value${dynamodb.item.hash.key.value}The hash key value of the item
Supports Expression Language: true (will be evaluated using flow file attributes and Environment variables)
Range Key ValueRange Key Value${dynamodb.item.range.key.value}No description provided.
Supports Expression Language: true (will be evaluated using flow file attributes and Environment variables)
Hash Key Value TypeHash Key Value Typestring
  • string
  • number
The hash key value type of the item
Range Key Value TypeRange Key Value Typestring
  • string
  • number
The range key value type of the item
Character set of documentCharacter set of documentUTF-8Character set of data in the document
Supports Expression Language: true (will be evaluated using Environment variables only)
Batch items for each request (between 1 and 50)Batch items for each request (between 1 and 50)1The items to be retrieved in one batch
Supports Expression Language: true (will be evaluated using Environment variables only)
Communications TimeoutCommunications Timeout30 secsNo description provided.
Endpoint Override URLEndpoint Override URLEndpoint URL to use instead of the AWS default including scheme, host, port, and path. The AWS libraries select an endpoint URL based on the AWS region, but this property overrides the selected endpoint URL, allowing use with other S3-compatible endpoints.
Supports Expression Language: true (will be evaluated using Environment variables only)
SSL Context ServiceSSL Context ServiceController Service API:
SSLContextService
Implementations: StandardRestrictedSSLContextService
StandardSSLContextService		Specifies an optional SSL Context Service that, if provided, will be used to create connections
Proxy Configuration Serviceproxy-configuration-serviceController Service API:
ProxyConfigurationService
Implementation: StandardProxyConfigurationService		Specifies the Proxy Configuration Controller Service to proxy network requests.

Relationships:

NameDescription
unprocessedFlowFiles are routed to unprocessed relationship when DynamoDB is not able to process all the items in the request. Typical reasons are insufficient table throughput capacity and exceeding the maximum bytes per request. Unprocessed FlowFiles can be retried with a new request.
successFlowFiles are routed to success relationship
failureFlowFiles are routed to failure relationship

Reads Attributes:

NameDescription
dynamodb.item.hash.key.valueItems hash key value
dynamodb.item.range.key.valueItems range key value

Writes Attributes:

NameDescription
dynamodb.key.error.unprocessedDynamoDB unprocessed keys
dynmodb.range.key.value.errorDynamoDB range key error
dynamodb.key.error.not.foundDynamoDB key not found
dynamodb.error.exception.messageDynamoDB exception message
dynamodb.error.codeDynamoDB error code
dynamodb.error.messageDynamoDB error message
dynamodb.error.serviceDynamoDB error service
dynamodb.error.retryableDynamoDB error is retryable
dynamodb.error.request.idDynamoDB error request id
dynamodb.error.status.codeDynamoDB error status code
dynamodb.item.io.errorIO exception message on creating item

State management:

This component does not store state.

Restricted:

This component is not restricted.

Input requirement:

This component requires an incoming relationship.

System Resource Considerations:

ResourceDescription
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.

See Also:

DeleteDynamoDB, GetDynamoDB, PutDynamoDBRecord