README
¶
Fast, Transactional, Distributed Graph Database.
Dgraph is an open source, horizontally scalable and distributed graph database, providing ACID transactions, consistent replication and linearizable reads. It's built from ground up to perform for a rich set of queries. Being a native graph database, it tightly controls how the data is arranged on disk to optimize for query performance and throughput, reducing disk seeks and network calls in a cluster.
Dgraph's goal is to provide Google production level scale and throughput, with low enough latency to be serving real time user queries, over terabytes of structured data. Dgraph supports GraphQL-like query syntax, and responds in JSON and Protocol Buffers over GRPC and HTTP.
Status
Dgraph is at version 0.9.x. We're aiming to convert this into v1.0 release before Christmas. We recommend using it in your projects and in production environment.
Quick Install
The quickest way to install Dgraph is to run this command on Linux or Mac.
curl https://get.dgraph.io -sSf | bash
Get Started
To get started with Dgraph, follow:
- Installation to queries in 3 steps via docs.dgraph.io.
- A longer interactive tutorial via tour.dgraph.io.
- Tutorial and presentation videos on YouTube channel.
Is Dgraph the right choice for me?
- Do you have more than 10 SQL tables, connected to each other via foreign ids?
- Do you have sparse data, which doesn't correctly fit into SQL tables?
- Do you want a simple and flexible schema, which is readable and maintainable over time?
- Do you care about speed and performance at scale?
If the answers to the above are YES, then Dgraph would be a great fit for your application. Dgraph provides NoSQL like scalability while providing SQL like transactions and ability to select, filter and aggregate data points. It combines that with distributed joins, traversals and graph operations, which makes it easy to build applications with it.
Dgraph compared to other graph DBs
| Features | Dgraph | Neo4j | Janus Graph |
|---|---|---|---|
| Architecture | Distributed | Single server | Layer on top of other distributed DBs |
| Replication | Consistent | None (only available in Enterprise) | Via underlying DB |
| Data movement for shard rebalancing | Automatic | Not applicable (all data lies on each server) | Via underlying DB |
| Language | GraphQL inspired | Cypher, Gremlin | Gremlin |
| Protocols | Grpc / HTTP + JSON / RDF | Bolt + Cypher | Websocket / HTTP |
| Transactions | Distributed ACID transactions | Single server ACID transactions | Not typically ACID |
| Full Text Search | Native support | Native support | Via External Indexing System |
| Regular Expressions | Native support | Native support | Via External Indexing System |
| Geo Search | Native support | External support only | Via External Indexing System |
| License | AGPL v3 for server + Apache 2.0 for client | GPL v3 | Apache 2.0 |
Users
- Dgraph official documentation is present at docs.dgraph.io.
- For feature requests or questions, visit https://discuss.dgraph.io.
- Check out the demo at dgraph.io and the visualization at play.dgraph.io.
- Please see releases tab to find the latest release and corresponding release notes.
- See the Roadmap for list of working and planned features.
- Read about the latest updates from Dgraph team on our blog.
- Watch tech talks on our YouTube channel.
Developers
- See a list of issues that we need help with.
- Please see contributing to Dgraph for guidelines on contributions.
Contact
- Please use discuss.dgraph.io for documentation, questions, feature requests and discussions.
- Please use Github issue tracker for filing bugs or feature requests.
- Join .
- Follow us on Twitter @dgraphlabs.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package algo contains algorithms such as merging, intersecting sorted lists.
|
Package algo contains algorithms such as merging, intersecting sorted lists. |
|
Package bp128 implements SIMD-BP128 integer encoding and decoding.
|
Package bp128 implements SIMD-BP128 integer encoding and decoding. |
|
benchmark
command
|
|
|
Package client is used to interact with a Dgraph server.
|
Package client is used to interact with a Dgraph server. |
|
contrib
|
|
|
integration/acctupsert
command
|
|
|
integration/bank
command
|
|
|
integration/mutates
command
|
|
|
integration/swap
command
|
|
|
stopwords
command
|
|
|
cmd/dgraph-converter
command
|
|
|
* Copyright (C) 2017 Dgraph Labs, Inc.
|
* Copyright (C) 2017 Dgraph Labs, Inc. |
|
Package gql is responsible for lexing and parsing a GraphQL query/mutation.
|
Package gql is responsible for lexing and parsing a GraphQL query/mutation. |
|
* Copyright (C) 2017 Dgraph Labs, Inc.
|
* Copyright (C) 2017 Dgraph Labs, Inc. |
|
protos
|
|
|
api
Package api is a generated protocol buffer package.
|
Package api is a generated protocol buffer package. |
|
intern
Package intern is a generated protocol buffer package.
|
Package intern is a generated protocol buffer package. |
|
Package rdf package parses N-Quad statements based on http://www.w3.org/TR/n-quads/
|
Package rdf package parses N-Quad statements based on http://www.w3.org/TR/n-quads/ |
|
systest
|
|
|
customtok/anagram
command
|
|
|
customtok/cidr
command
|
|
|
customtok/factor
command
|
|
|
customtok/rune
command
|
|
|
wiki
|
|
|
* Copyright (C) 2017 Dgraph Labs, Inc.
|
* Copyright (C) 2017 Dgraph Labs, Inc. |
|
* Copyright (C) 2017 Dgraph Labs, Inc.
|
* Copyright (C) 2017 Dgraph Labs, Inc. |
|
Package y contains the code shared by the Go client and Dgraph server.
|
Package y contains the code shared by the Go client and Dgraph server. |