DynamoDB

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy

Reads items from an Amazon DynamoDB table.

Configuration

source:
  kind: dynamodb
  table_name: my-table
  region: us-east-1

Field	Default	Description
table_name	(required)	DynamoDB table name
region		AWS region
endpoint_url		Custom endpoint (e.g. LocalStack)

Namespace: dynamodb.{table_name}

CLI

skippr connect source dynamodb \
  --table-name my-table \
  --region us-east-1

Flag	Description
--table-name	DynamoDB table name
--region	AWS region
--endpoint-url	Optional custom endpoint URL

Authentication

Authentication uses the AWS default credential chain.

• AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY
• IAM roles, instance profiles, or task roles
• AWS SSO or shared config profiles

Permissions or Network Requirements

For batch reads, the AWS principal needs dynamodb:DescribeTable and dynamodb:Scan. For CDC, it also needs DynamoDB Streams permissions as described in CDC Sources -- DynamoDB.

Troubleshooting

Symptom	Fix
AccessDenied or UnrecognizedClient	Verify the AWS credential chain and that the caller has access to the table and region.
no items returned	Check table_name, region, and any custom endpoint settings such as LocalStack.

CDC Support

DynamoDB supports real-time Change Data Capture via DynamoDB Streams. When paired with a supported warehouse destination, Skippr reconciles those mutations to exactly-once final state. Add cdc_enabled: true to the source config and configure a pipeline cdc: block.

See CDC Sources -- DynamoDB for prerequisites, configuration, and resume behavior.

Next steps

• Pair this source with a destination from Destination Connectors.
• For CDC setup and restart behavior, see CDC Sources and CDC Operations.

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy