A graph-relational database with declarative schema, built-in migration system, and a next-generation query language
Go to file
Aljaž Mur Eržen f755cb985a
Formatting of stack tracebacks in tests (#6756)
2024-02-03 15:42:07 +01:00
.github Fix some postgres submodule check issues (#6717) 2024-01-20 12:15:06 -08:00
dev-notes Add a checklist for adding new types to EdgeDB (#4373) 2022-09-16 18:07:32 -07:00
docs Docs: Cloud app deployment guides (#6769) 2024-02-01 14:18:28 -05:00
edb Formatting of stack tracebacks in tests (#6756) 2024-02-03 15:42:07 +01:00
postgres@c372fbbd8e Revert accidental postgres downgrade (#6440) 2023-11-07 11:12:18 -08:00
tests Add a test for #6767 (#6771) 2024-02-01 13:31:40 -08:00
.editorconfig Run test workflow in shards (#2217) 2021-02-12 15:42:00 -06:00
.flake8 Increase the line length limit from 79 to 80 (#5422) 2023-05-04 13:46:02 -07:00
.gitignore Docs reorg (#3039) 2021-11-10 17:27:39 -05:00
.gitmodules Parse SQL with libpg_query and translate to our pgsql.ast (#4480) 2022-10-13 20:57:53 +02:00
.mailmap Add mailmap 2019-08-22 15:54:08 -04:00
CODE_OF_CONDUCT.md Add CoC. 2019-05-13 13:05:33 -04:00
CONTRIBUTING.rst Add documentation contributing guidelines (#4761) 2022-12-05 12:11:35 -08:00
Cargo.lock Build and serialize parser spec during build process (#6302) 2023-10-18 22:23:05 +02:00
Cargo.toml Refactor Rust libraries (#5654) 2023-06-14 18:39:50 +02:00
LICENSE Put EdgeDB under the Apache License v2.0 2018-05-09 22:11:25 -04:00
MANIFEST.in Include auth_ext static assets in the package build (#6377) 2023-10-27 16:42:44 -07:00
Makefile Build and serialize parser spec during build process (#6302) 2023-10-18 22:23:05 +02:00
NOTICE Add the NOTICE file 2019-10-17 17:04:11 -04:00
README.md Update the README 2023-11-01 20:22:37 -07:00
build_backend.py Adapt setup.py/pyproject.toml to setuptools 54 (#4261) 2022-08-19 15:10:25 -07:00
logo.svg Add README 2018-05-10 12:33:56 -04:00
pyproject.toml Bump setuptools-rust (#6765) 2024-02-01 12:13:39 -05:00
setup.py Move script entrypoints from `setup.py` to `pyproject.toml` (#6366) 2023-10-26 10:35:44 -07:00

README.md

EdgeDB

Stars license discord

Quickstart   •   Website   •   Docs   •   Playground   •   Blog   •   Discord   •   Twitter



What is EdgeDB?

EdgeDB is a new kind of database
that takes the best parts of
relational databases, graph
databases, and ORMs. We call it
a graph-relational database.



🧩 Types, not tables 🧩


Schema is the foundation of your application. It should be something you can read, write, and understand.

Forget foreign keys; tabular data modeling is a relic of an older age, and it isn't compatible with modern languages. Instead, EdgeDB thinks about schema the same way you do: as object types containing properties connected by links.

type Person {
  required name: str;
}

type Movie {
  required title: str;
  multi actors: Person;
}

This example is intentionally simple, but EdgeDB supports everything you'd expect from your database: a strict type system, indexes, constraints, computed properties, stored procedures...the list goes on. Plus it gives you some shiny new features too: link properties, schema mixins, and best-in-class JSON support. Read the schema docs for details.


🌳 Objects, not rows 🌳


EdgeDB's super-powered query language EdgeQL is designed as a ground-up redesign of SQL. EdgeQL queries produce rich, structured objects, not flat lists of rows. Deeply fetching related objects is painless...bye, bye, JOINs.

select Movie {
  title,
  actors: {
    name
  }
}
filter .title = "The Matrix"

EdgeQL queries are also composable; you can use one EdgeQL query as an expression inside another. This property makes things like subqueries and nested mutations a breeze.

insert Movie {
  title := "The Matrix Resurrections",
  actors := (
    select Person
    filter .name in {
      'Keanu Reeves',
      'Carrie-Anne Moss',
      'Laurence Fishburne'
    }
  )
}

There's a lot more to EdgeQL: a comprehensive standard library, computed properties, polymorphic queries, with blocks, transactions, and much more. Read the EdgeQL docs for the full picture.


🦋 More than a mapper 🦋


While EdgeDB solves the same problems as ORM libraries, it's so much more. It's a full-fledged database with a powerful and elegant query language, a migrations system, a suite of client libraries in different languages, a command line tool, and—coming soon—a cloud hosting platform. The goal is to rethink every aspect of how developers model, migrate, manage, and query their database.

Here's a taste-test of EdgeDB's next-level developer experience: you can install our CLI, spin up an instance, and open an interactive EdgeQL shell with just three commands.

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.edgedb.com | sh
$ edgedb project init
$ edgedb
edgedb> select "Hello world!"

Windows users: use this Powershell command to install the CLI.

PS> iwr https://ps1.edgedb.com -useb | iex

Get started

To start learning about EdgeDB, check out the following resources:

  • The quickstart. If you're just starting out, the 10-minute quickstart guide is the fastest way to get up and running.
  • EdgeDB Cloud 🌤️. The best most effortless way to host your EdgeDB database in the cloud.
  • The interactive tutorial. For a structured deep-dive into the EdgeQL query language, try the web-based tutorial— no need to install anything.
  • The e-book. For the most comprehensive walkthrough of EdgeDB concepts, check out our illustrated e-book Easy EdgeDB. It's designed to walk a total beginner through EdgeDB in its entirety, from the basics through advanced concepts.
  • The docs. Jump straight into the docs for schema modeling or EdgeQL!

Contributing

PRs are always welcome! To get started, follow this guide to build EdgeDB from source on your local machine.

File an issue 👉
Start a Discussion 👉
Join the discord 👉


License

The code in this repository is developed and distributed under the Apache 2.0 license. See LICENSE for details.