github.hscsec.cn/dgraph-io/dgraph@v1.1.0/README.md (about)

     1  ![](/logo.png)
     2  
     3  **Fast, Transactional, Distributed Graph Database.**
     4  
     5  [![Wiki](https://img.shields.io/badge/res-wiki-blue.svg)](https://docs.dgraph.io)
     6  [![Build Status](https://teamcity.dgraph.io/guestAuth/app/rest/builds/buildType:(id:Dgraph_Ci)/statusIcon.svg)](https://teamcity.dgraph.io/viewLog.html?buildTypeId=Dgraph_Ci&buildId=lastFinished&guest=1)
     7  [![Coverage Status](https://coveralls.io/repos/github/dgraph-io/dgraph/badge.svg?branch=master)](https://coveralls.io/github/dgraph-io/dgraph?branch=master)
     8  [![Go Report Card](https://goreportcard.com/badge/github.com/dgraph-io/dgraph)](https://goreportcard.com/report/github.com/dgraph-io/dgraph)
     9  
    10  Dgraph is a horizontally scalable and distributed graph database, providing ACID transactions, consistent replication and linearizable reads. It's built from ground up to perform for
    11  a rich set of queries. Being a native graph database, it tightly controls how the
    12  data is arranged on disk to optimize for query performance and throughput,
    13  reducing disk seeks and network calls in a cluster.
    14  
    15  
    16  Dgraph's goal is to provide [Google](https://www.google.com) production level scale and throughput,
    17  with low enough latency to be serving real time user queries, over terabytes of structured data.
    18  Dgraph supports [GraphQL-like query syntax](https://docs.dgraph.io/master/query-language/), and responds in [JSON](http://www.json.org/) and [Protocol Buffers](https://developers.google.com/protocol-buffers/) over [GRPC](http://www.grpc.io/) and HTTP.
    19  
    20  ## Status
    21  
    22  Dgraph is [at version 1.0.x][rel] and is production ready. Apart from the vast open source community, it is being used in
    23  production at multiple Fortune 500 companies, and by
    24  [Intuit Katlas](https://github.com/intuit/katlas) and [VMware Purser](https://github.com/vmware/purser).
    25  
    26  [rel]: https://github.com/dgraph-io/dgraph/releases
    27  
    28  ## Quick Install
    29  
    30  The quickest way to install Dgraph is to run this command on Linux or Mac.
    31  
    32  ```bash
    33  curl https://get.dgraph.io -sSf | bash
    34  ```
    35  
    36  ## Install with Docker
    37  
    38  If you're using Docker, you can use the [official Dgraph image](https://hub.docker.com/r/dgraph/dgraph/).
    39  
    40  ```bash
    41  docker pull dgraph/dgraph:latest
    42  ```
    43  
    44  ## Install from Source
    45  
    46  If you want to install from source, you can use `go get` to install to `$GOPATH/bin`.
    47  
    48  ```bash
    49  go get -v github.com/dgraph-io/dgraph/dgraph
    50  ```
    51  
    52  ## Get Started
    53  **To get started with Dgraph, follow:**
    54  
    55  - Installation to queries in 3 steps via [docs.dgraph.io](https://docs.dgraph.io/get-started/).
    56  - A longer interactive tutorial via [tour.dgraph.io](https://tour.dgraph.io).
    57  - Tutorial and
    58  presentation videos on [YouTube channel](https://www.youtube.com/channel/UCghE41LR8nkKFlR3IFTRO4w/featured).
    59  
    60  ## Is Dgraph the right choice for me?
    61  
    62  - Do you have more than 10 SQL tables, connected to each other via foreign keys?
    63  - Do you have sparse data, which doesn't elegantly fit into SQL tables?
    64  - Do you want a simple and flexible schema, which is readable and maintainable
    65    over time?
    66  - Do you care about speed and performance at scale?
    67  
    68  If the answers to the above are YES, then Dgraph would be a great fit for your
    69  application. Dgraph provides NoSQL like scalability while providing SQL like
    70  transactions and ability to select, filter and aggregate data points. It
    71  combines that with distributed joins, traversals and graph operations, which
    72  makes it easy to build applications with it.
    73  
    74  ## Dgraph compared to other graph DBs
    75  
    76  | Features | Dgraph | Neo4j | Janus Graph |
    77  | -------- | ------ | ----- | ----------- |
    78  | Architecture | Sharded and Distributed | Single server (+ replicas in enterprise) | Layer on top of other distributed DBs |
    79  | Replication | Consistent | None in community edition (only available in enterprise) | Via underlying DB |
    80  | Data movement for shard rebalancing | Automatic | Not applicable (all data lies on each server) | Via underlying DB |
    81  | Language | GraphQL inspired | Cypher, Gremlin | Gremlin |
    82  | Protocols | Grpc / HTTP + JSON / RDF | Bolt + Cypher | Websocket / HTTP |
    83  | Transactions | Distributed ACID transactions | Single server ACID transactions | Not typically ACID
    84  | Full Text Search | Native support | Native support | Via External Indexing System |
    85  | Regular Expressions | Native support | Native support | Via External Indexing System |
    86  | Geo Search | Native support | External support only | Via External Indexing System |
    87  | License | Apache 2.0 | GPL v3 | Apache 2.0 |
    88  
    89  ## Users
    90  - **Dgraph official documentation is present at [docs.dgraph.io](https://docs.dgraph.io).**
    91  - For feature requests or questions, visit
    92    [https://discuss.dgraph.io](https://discuss.dgraph.io).
    93  - Check out [the demo at dgraph.io](http://dgraph.io) and [the visualization at
    94    play.dgraph.io](http://play.dgraph.io/).
    95  - Please see [releases tab](https://github.com/dgraph-io/dgraph/releases) to
    96    find the latest release and corresponding release notes.
    97  - [See the Roadmap](https://github.com/dgraph-io/dgraph/issues/1) for list of
    98    working and planned features.
    99  - Read about the latest updates from Dgraph team [on our
   100    blog](https://open.dgraph.io/).
   101  - Watch tech talks on our [YouTube
   102    channel](https://www.youtube.com/channel/UCghE41LR8nkKFlR3IFTRO4w/featured).
   103  
   104  ## Developers
   105  - See a list of issues [that we need help with](https://github.com/dgraph-io/dgraph/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22).
   106  - Please see [Contributing to Dgraph](https://github.com/dgraph-io/dgraph/blob/master/CONTRIBUTING.md) for guidelines on contributions.
   107  
   108  ## Client Libraries
   109  The Dgraph team maintain a number of [officially supported client libraries](https://docs.dgraph.io/clients/). There are also libraries contributed by the community [unofficial client libraries](https://docs.dgraph.io/clients#unofficial-dgraph-clients).
   110  
   111  ## Contact
   112  - Please use [discuss.dgraph.io](https://discuss.dgraph.io) for documentation, questions, feature requests and discussions.
   113  - Please use [Github issue tracker](https://github.com/dgraph-io/dgraph/issues) for filing bugs or feature requests.
   114  - Join [![Slack Status](http://slack.dgraph.io/badge.svg)](http://slack.dgraph.io).
   115  - Follow us on Twitter [@dgraphlabs](https://twitter.com/dgraphlabs).