DynamoDB PartiQL - The Ultimate Guide (with Examples)

Written by Rafal Wilinski

Published on 2020-11-29

AWS recently announced that DynamoDB will now support PartiQL - an SQL-like language for querying, modifying, and inserting data. This is huge because of few reasons:

  • It makes the learning curve a little less steep - You can use well-known language to start using DynamoDB and transition to the native DSL later on.
  • It makes migrations a bit easier - no need to learn and implement DynamoDB query language from the very beginning.
  • Choice - it gives you two options/languages to interact with DynamoDB. You don't like ExpressionAttributeValues and FilterExpressions? Fine, use PartiQL.

How to use PartiQL in DynamoDB:

  • Using Dynobase
  • The DynamoDB console
  • The AWS Command Line Interface (AWS CLI)
  • The DynamoDB APIs

Querying the data



Keep in mind that even if DynamoDB supports this SQL-like language, it is still paradoxically a NoSQL database, and it is not changing the core principles of how it works. Data is still shared across partitions, GSIs and LSIs are still needed, scans and queries are not going anywhere. Your SELECT statements are going to be converted into Scan or Query operations depending on the WHERE clause. If you add a condition on an indexed field, the PartiQL query will be translated to a Query. In other cases, if you will execute something like SELECT * from my-ddb-table;, it will be translated to a Scan.

While PartiQL might make DynamoDB more approachable, it is also more likely that you'll make a silly mistake like scanning a whole table. In PartiQL, a Scan and Query are both disguised as a SELECT statement while in DynamoDB's native language you have to explicilty state to use Scan(...). However, there's a way to guard yourself from that behavior, more on that in the IAM section.

Inserting data



Updating data


Deleting data


Similar to updates, deleting records in big bulks is not possible. You can only delete one record in one operation. If you need to remove multiple records or truncate the whole table, consider using Dynobase's Terminal or Truncate Table option.

However, If you'd like to delete or update items in batches of 25, you can do so using the batchExecuteStatement API. It is also nice that it supports conditions, unlike regular DynamoDB's API.


Just like with traditional DynamoDB query syntax, making transactions using PartiQL is possible. Keep in mind that inside one transactions block, you can only contain either read or write type. Mixing these two in one block is not possible.

Executing transactions is possible via SDK or CLI by passing an array of objects with Statements and Parameters:

Save this JSON as a file and reference using command:


PartiQL DynamoDB update adds four new IAM permissions:

  • dynamodb:PartiQLSelect - needed to perform read operations on the table
  • dynamodb:PartiQLInsert - needed to perform put operations on the table
  • dynamodb:PartiQLUpdate - needed to perform update operations on the table
  • dynamodb:PartiQLDelete - needed to perform delete operations on the table

If you want to allow all operations on your DynamoDB table, attach the following policy to your role:

Deny Full Table Scans

As I have mentioned previously, SELECT statements in PartiQL can convert into unwanted Scans. Luckily, IAM allows us from prohibiting that behavior, you can create a Deny statement with a condition dynamodb:FullTableScan = true and include it in your policy:


  • Not suited for analytics, e.g. SELECT COUNT or complex operations. If you need it, use Athena or write your own aggregation functions based on DynamoDB Streams.
  • Amazon DynamoDB supports only a subset of the PartiQL language.
  • You cannot use it for UPDATE X WHERE Y logic. If you need to conditionally update multiple items at once, head to our guide on how to conditionally update collections in DynamoDB
  • Is DynamoDB with SQL support still a NoSQL database? 🙃
  • If you want to use a true relational and SQL database, consider Aurora and read our comparison here

Tired of switching accounts and regions? Use Dynobase.

First 7 days are on us. No strings attached.

Product Features

© 2021 Dynobase

Tired of AWS Console?
Try Dynobase to accelerate your DynamoDB workflow. Start your 7-day free trial today.