Announcing GQLAlchemy 1.1

Mislav Vuletic
Announcing GQLAlchemy 1.1

GQLAlchemy has some pretty cool new features to show. Similar to its counterpart SQLAlchemy, GQLAlchemy aims to be an Object Graph Mapper (OGM). It’s a Python library that abstracts graph objects found in graph databases into Python objects. Through this update, we’ve added automatic schema validation, serialization and deserialization, on-disk storage and a few more useful features. You can now store Python objects such as User, Molecule and Junction straight into a graph database, without having to write a single line of Cypher.

Don’t feel like reading? You can also watch a short demo where we went over the most important features found in this update.


Automatic schema validation, serialization and deserialization

from gqlalchemy import Field, Memgraph, Node, Relationship
from datetime import datetime

db = Memgraph()

class User(Node):
    id: str = Field(index=True, unique=True, exists=True, db=db)
class FriendsWith(Relationship, type="FRIENDS_WITH"):
    last_seen: datetime = Field()
john = User(id=1).save(db)
boris = User(id=2).save(db)
friends = FriendsWith(

Save Python classes straight into a graph database and let query results be converted into Python objects automatically as well. Use the power of creating a schema to generate uniqueness and existence constraints as well as indexes for you. Using a graph database with Python has never been easier.

Store large properties with on-disk storage (SQL or a Key-Value store)

Since Memgraph is a graph database that stores data in memory (RAM), it’s great that GQLAlchemy provides an on-disk storage solution for large properties not used in graph algorithms.

from gqlalchemy import Memgraph, SQLitePropertyDatabase, Node, Field
from typing import Optional

graphdb = Memgraph()
SQLitePropertyDatabase('path-to-my-db.db', graphdb)

class User(Node):
    id: int = Field(unique=True, exists=True, index=True, db=graphdb)
    huge_string: Optional[str] = Field(on_disk=True)
my_secret = "I LOVE DUCKS" * 1000
john = User(id=5, huge_string=my_secret).save(db)
john2 = User(id=5).load(db)
print(john2.huge_string)  # prints I LOVE DUCKS, a 1000 times

An on-disk property database can be used to:

  • store large properties (strings, parquet files, etc.)
  • create code without having to handle properties that are stored in different solutions separately.

Saving properties is fully abstracted, so you won’t have to worry about where stuff is saved.

Integrate your code with streaming support and triggers

From now on, you won’t have to create and manage data streams and database triggers directly with Cypher queries. You can instead use GQLAlchemy to accomplish these tasks programmatically in Python.

from gqlalchemy import Memgraph, MemgraphKafkaStream, MemgraphTrigger

db = Memgraph()

stream = MemgraphKafkaStream(name="ratings_stream", topics=["ratings"], transform="movielens.rating", bootstrap_servers="localhost:9092")

trigger = MemgraphTrigger(
    statement="UNWIND createdVertices AS node SET node.created_at = LocalDateTime()",

What’s next

In the following weeks, we aim to develop support for running Python functions inside a graph database. This will enable you to set up custom triggers and modules in Python. Stay tuned and in the meantime, why not try out and install GQLAlchemy by executing pip3 install gqlalchemy. Happy coding!

Table of Contents

Get a personalized Memgraph demo
and get your questions answered.

Continue Reading

New Memgraph Platform for Another Year of High Performance Graph Analysis

Start next year with a whole new range of features and graph algorithms to gain insights that will make it a happy year indeed! Developed features include improved security, benchmark tests, projected graph visualization, better code suggestion support, C++ API, node classification and link prediction, to name just a few.

Marko Budiselic
December 13, 2022
Machine Learning
Memgraph MAGE
Run Link Prediction or Node Classification Algorithms and Write Custom Procedures in C++ With Mage 1.4

The new version of Memgraph’s open-source graph extension library, MAGE, now supports node classification and link prediction algorithms. Install the new version of MAGE if you would like to write custom algorithms faster by using the C++ API, need the igraph algorithms or k-means clustering.

Antonio Filipovic
December 6, 2022
Graph Databases and PHP & Vaccine Distribution With Graphs

Join a number of graph enthusiasts on the last Graph Data Zagreb meetup in 2022.!

Petra Marusic
November 24, 2022