Skip to main content

DynamoDB Query Language

Project description


Dev Build:build coverage
0.3 Branch:build-0.3 coverage-0.3

A simple, SQL-ish language for DynamoDB

Getting Started

Install with pip:

pip install dql

Here are some basic DQL examples to get you going:

Start the REPL:

$ dql -a <access key> -s <secret key>

Creating a table:

us-west-1> CREATE TABLE forum_threads (name STRING HASH KEY,
         >                             subject STRING RANGE KEY)
         >                             THROUGHPUT (4, 2);

Inserting data:

us-west-1> INSERT INTO forum_threads (name, subject, views, replies)
         > VALUES ('Self Defense', 'Defense from Banana', 67, 4),
         > ('Self Defense', 'Defense from Strawberry', 10, 0),
         > ('Cheese Shop', 'Anyone seen the camembert?', 16, 1);


us-west-1> SCAN forum_threads;
us-west-1> COUNT forum_threads WHERE name = 'Self Defense';
us-west-1> SELECT * FROM forum_threads WHERE name = 'Self Defense';


us-west-1> UPDATE forum_threads SET views += 1 WHERE
         > name = 'Self Defense' AND subject = 'Defense from Banana';
us-west-1> DELETE FROM forum_threads WHERE name = 'Cheese Shop';

Changing tables:

us-west-1> ALTER TABLE forum_threads SET THROUGHPUT (8, 4);
us-west-1> DROP TABLE forum_threads;

And don’t forget to use help!



  • Bug fix: Allow ‘.’ in table names


  • Feature: SELECT and COUNT can have FILTER clause
  • Feature: FILTER clause may OR constraints together


  • Bug fix: Crash when printing ‘COUNT’ queries


  • Feature: Python 3 support


  • First public release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dql, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size dql-0.3.1.tar.gz (21.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page