Light
Dark
System
1.0latest

Introduction

EdgeDB is a next-generation graph-relational database.

It’s designed to be a spiritual successor to the SQL-based relation database and inherits all its core strengths: type safety, performance, reliability, and ACID compliance. Beyond that, EdgeDB brings with it a more intuitive data model based on object types, properties, and links, plus a superpowered query language that solves SQL’s biggest usability problems.

The sidebar is broken up into a number of main sections.

  1. Go through the quickstart. It is the simplest way to set up EdgeDB on your machine, learn the basics of schema, and write a couple queries.

  2. Go through the Schema docs in order, up to Constraints. This will give you a full understanding of EdgeDB’s type system and how to declare your schema. The last few pages (aliases, annotations, functions, etc) are more advanced; you can skip them for now.

  3. Go through the EdgeQL docs in order. This section assumes you have some familiarity with the Schema docs already. Each page is written as an accessible guide. up to Constraints. This will give you a full understanding of how to model data in EdgeDB. The last few pages (aliases, annotations, functions, etc) are more advanced; you can skip them for now.

  4. At this point you’ll have a very strong working knowledge of how to write schemas and queries with EdgeDB. To start building applications, you’ll likely use one of our client libraries for JavaScript, Go, or Python; find your preferred library under Client Libraries. You may instead prefer to use the GraphQL endpoint (documented in the GraphQL section) or execute EdgeQL over HTTP.

  5. As you move forward, more advanced or obscure questions are likely answered in the encylopedic Reference and Standard Library sections. The Reference section contains formal SDL and EdgeQL syntax breakdowns and reference information on our dump format, binary protocol, configuration settings, and more. The Standard Library section documents all types, functions, and operators.

EdgeDB features:

  • strict, strongly typed schema;

  • powerful and clean query language;

  • ability to easily work with complex hierarchical data;

  • built-in support for schema migrations.

EdgeDB is not a graph database: the data is stored and queried using relational database techniques. Unlike most graph databases, EdgeDB maintains a strict schema.

EdgeDB is not a document database, but inserting and querying hierarchical document-like data is trivial.

EdgeDB is not a traditional object database, despite the classification, it is not an implementation of OOP persistence.

Light
Dark
System