DynamoDB: Query KeyConditionExpression (Guide w/ Code Examples)

Provided by Rafal Wilinski
The KeyConditionExpression parameter is used to specify the key condition for query operations. It should be a string that follows the syntax of a condition expression, and it should be specified using the attribute name and value placeholders (Attribute_name = :value).
The ExpressionAttributeValues parameter is used to provide the values for the placeholders in the KeyConditionExpression. The values should be passed in an object where the keys are the placeholder names.
Here's an example of how you might use the query method to retrieve items from a DynamoDB table where the partition key is userId and the sort key is timestamp:
const AWS = require('aws-sdk'); const dynamodb = new AWS.DynamoDB.DocumentClient(); const params = { TableName: 'myTable', KeyConditionExpression: 'userId = :userId and timestamp >= :startTimestamp', ExpressionAttributeValues: { ':userId': '123', ':startTimestamp': 1560934400 } }; dynamodb.query(params, (err, data) => { if (err) { console.log(err); } else { console.log(data); } });
Similar Code Examples
- DynamoDB: Delete Table
- DynamoDB: Not Begins With
- DynamoDB: Attribute Not Null
- DynamoDB: GetItem
- DynamoDB: Increment Counter
- DynamoDB: Get By ID
- DynamoDB: Query Group By
- DynamoDB: Create if Not Exists
- DynamoDB: Delete All Items With Partition Key
- DynamoDB Get in Typescript
- DynamoDB: Query Global Secondary Index in Nodejs
- DynamoDB: Like
- DynamoDB: Batch Get
- DynamoDB: Query Date Range
- DynamoDB: Get Multiple Items
Better DynamoDB experience.
First 7 days are on us. No strings attached.
Product Features
DynamoDB Tools
DynamoDB Info
© 2025 Dynobase