All Resources

Introducing DynamoQuery: Python AWS DynamoDB ORM

Blog | Amir Kavousian, September 29th, 2020

DynamoDB is a great fit for serverless architectures: it is scalable and fast, it supports role-based permissions, and most importantly, is itself serverless. 

However, a common barrier for engineering teams to use DynamoDB is the lack of a widespread, generic, and flexible Object-Relational-Mapper (ORM) for interacting with it. This is especially striking in the Python ecosystem, where there are great ORM tools for working with relational databases. 

At Altitude Networks, we adopted a serverless architecture, and have been using DynamoDB from day one. To address the gap of a Pythonic ORM for DynamoDB, our team at Altitude Networks developed our own library for it. The result was the DynamoQuery project. We have been using DynamoQuery in our application for more than a year now, and have consistently improved it. We are now excited to make it an open-source project to allow the larger community to use it and contribute to it. 

Key Features

How to use and contribute

DynamoQuery is published on pip, so you can install it by running the command:

python -m pip install dynamoquery

The package README file has information on how to use and contribute to the project:

Here is a simple example of how to use DynamoQuery to define and interact with a Dynamo table.

Usage examples for `DynamoTable` class.
from typing import Optional

import boto3
from mypy_boto3_dynamodb.service_resource import DynamoDBServiceResource, Table

from dynamo_query.dictclasses.dynamo_dictclass import DynamoDictClass
from dynamo_query.dynamo_table import DynamoTable
from dynamo_query.dynamo_table_index import DynamoTableIndex

class UserRecord(DynamoDictClass):
    pk: str
    project_id: str
    company: str
    email: str
    name: Optional[str] = None
    age: Optional[int] = None
    dt_created: Optional[str] = None
    dt_modified: Optional[str] = None

    def get_pk(self) -> str:
        return self.project_id

    def get_sk(self) -> str:

class UserDynamoTable(DynamoTable[UserRecord]):
    gsi_name_age = DynamoTableIndex("gsi_name_age", "name", "age", sort_key_type="N")
    global_secondary_indexes = [gsi_name_age]
    record_class = UserRecord

    read_capacity_units = 50
    write_capacity_units = 10

    def table(self) -> Table:
        resource: DynamoDBServiceResource = boto3.resource("dynamodb")
        return resource.Table("test_dq_users_table")  # pylint: disable=no-member

def main() -> None:
    user_dynamo_table = UserDynamoTable()


    print("Get all records:")
    for user_record in user_dynamo_table.scan():

    print("Get John's record:")
            UserRecord({"email": "", "company": "IBM"})

    print("Query by a specific index:")
                index=UserDynamoTable.gsi_name_age, partition_key="Mary", sort_key=34

    print("Using iterators for batch methods:")
    record = UserRecord({"email": "", "company": "IBM"})
    for full_record in user_dynamo_table.batch_get_records((i for i in [record])):

    user_dynamo_table.batch_delete_records((i for i in [record]))

if __name__ == "__main__":


There are a few open-source options for DynamoDB Python interface, but most of them are either no longer maintained, or support only a fraction of DynamoDB features. The only open-source package we are aware of that has full feature support and is actively maintained is the PynamoDB package. It has nice features such as supporting scans and queries, transactions, and polymorphism. PynamoDB requires defining a Model class based on the DynamoDB table data, and introduces methods for the Model class to view or interact with the table data. While this pattern is familiar to developers that have used traditional Model-View-Controller architectures, it limits their ability to use their data store of choice. For instance, if you read data from an external source such as a relational database or JSON blob, you first need to store it as a Model object before you can work with DynamoDB. If you come from a web application, MVC, or Django background, this abstraction may be desirable. However, if you work with data pipelines, large data sets, and application programming, we believe DynamoQuery is more flexible and scales better with your application’s growing needs.

Ready to get your Cloud Security in Check?

Fill in some contact info below or schedule a meeting so we can reach out to provide more details on how Altitude Networks can protect you from data loss in the cloud.

We'll be in touch!

Ready to get your Cloud Security in Check?

Fill in some contact info below or schedule a meeting so we can reach out to provide more details on how Altitude Networks can protect you from data loss in the cloud.

We'll be in touch!