Skip to content
gStore - a graph based RDF triple store.
C++ JavaScript HTML Java Shell PHP Other
Branch: master
Clone or download
Latest commit 7a6b4dc Nov 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.debug add insertion and deletion;move new version here Sep 16, 2016
.objs add insertion and deletion;move new version here Sep 16, 2016
.tmp style: add .tmp/web Jul 31, 2017
COVERAGE fix bugs in gclient Feb 8, 2017
Database Add gexport and update gmonitor, gshow, ginit. Jul 27, 2019
KVstore Add files via upload Feb 22, 2019
Main Add backup and restore feature Sep 20, 2019
Parser merge 'master' branch Nov 4, 2018
Query fix bug of ask sparql Nov 5, 2019
Server fix bug in showUser May 23, 2019
Signature merge 'master' branch Nov 4, 2018
StringIndex Add files via upload Feb 22, 2019
Trie use a different way to apply Trie Feb 22, 2019
Util Add backup and restore feature Sep 20, 2019
VSTree merge 'master' branch Nov 4, 2018
api Update export API Aug 19, 2019
backups docs: remove some nonsense files Oct 14, 2018
bin add insertion and deletion;move new version here Sep 16, 2016
data Add getCoreVersion and getAPIVersion interface May 28, 2019
docs Update ESSAY.md Sep 9, 2019
garbage merge 'master' branch Nov 4, 2018
lib add insertion and deletion;move new version here Sep 16, 2016
logs docs: add README in logs/endpoint; Jul 25, 2017
scripts Add gexport and update gmonitor, gshow, ginit. Jul 27, 2019
tools fix: use rapidjson Nov 18, 2018
.gitattributes docs: forbid git attributes Nov 4, 2018
.gitignore docs: add ignore files Nov 19, 2018
Dockerfile Fix a small bug of Dockerfile Mar 29, 2019
LICENSE
NOTES.md refactor: release 0.5.0 Aug 7, 2017
README.md change mail May 9, 2019
init.conf refactor: fix ghttp and add function Jul 29, 2017
makefile Add gexport and update gmonitor, gshow, ginit. Jul 27, 2019
package.json refactor: move id_tuples to disk in build Mar 29, 2017

README.md

Gstore System

Gstore System(also called gStore) is a graph database engine for managing large graph-structured data, which is open-source and targets at Linux operation systems. The whole project is written in C++, with the help of some libraries such as readline, antlr, and so on. Only source tarballs are provided currently, which means you have to compile the source code if you want to use our system.

The formal help document is in English(EN) and 中文(ZH).

The formal experiment result is in Experiment.

We have built an IRC channel named #gStore on freenode, and you can visit the homepage of gStore.

Getting Started

Compile from Source

This system is really user-friendly and you can pick it up in several minutes. Remember to check your platform where you want to run this system by viewing System Requirements. After all are verified, please get this project's source code. There are several ways to do this:

  • (suggested)type git clone https://github.com/pkumod/gStore.git in your terminal or use git GUI to acquire it

  • download the zip from this repository and extract it

  • fork this repository in your github account

Then you need to compile the project, for the first time you need to type make pre to prepare the ANTLR library and some Lexer/Parser programs. Later you do not need to type this command again, just use the make command in the home directory of gStore, then all executables will be generated. (For faster compiling speed, use make -j4 instead, using how many threads is up to your machine) To check the correctness of the program, please type make test command.

The first strategy is suggested to get the source code because you can easily acquire the updates of the code by typing git pull in the home directory of gStore repository. In addition, you can directly check the version of the code by typing git log to see the commit logs. If you want to use code from other branches instead of master branch, like 'dev' branch, then:

  • clone the master branch and type git checkout dev in your terminal

  • clone the dev branch directly by typing git clone -b dev

Deploy via Docker

You can easily deploy gStore via Docker. We provide both of Dockerfile and docker image. Please see our Docker Deployment Doc(EN) or Docker部署文档(中文) for details.

Run

To run gStore, please type bin/gbuild database_name dataset_path to build a database named by yourself. And you can use bin/gquery database_name command to query an existing database. What is more, bin/ghttp is a wonderful tool designed for you, as a database server which can be accessed via HTTP protocol. Notice that all commands should be typed in the root directory of gStore, and your database name should not end with ".db".


Advanced Help

If you want to understand the details of the gStore system, or you want to try some advanced operations(for example, using the API, server/client), please see the chapters below.


Other Business

Bugs are recorded in BUG REPORT. You are welcomed to submit the bugs you discover if they do not exist in this file.

We have written a series of short essays addressing recurring challenges in using gStore to realize applications, which are placed in Recipe Book.

You are welcome to report any advice or errors in the github Issues part of this repository, if not requiring in-time reply. However, if you want to urgent on us to deal with your reports, please email to gjsjdbgroup@pku.edu.cn to submit your suggestions and report bugs. A full list of our whole team is in Mailing List.

There are some restrictions when you use the current gStore project, you can see them on Limit Description.

Sometimes you may find some strange phenomena(but not wrong case), or something hard to understand/solve(don't know how to do next), then do not hesitate to visit the Frequently Asked Questions page.

Graph database engine is a new area and we are still trying to go further. Things we plan to do next is in Future Plan chapter, and we hope more and more people will support or even join us. You can support in many ways:

  • watch/star our project

  • fork this repository and submit pull requests to us

  • download and use this system, report bugs or suggestions

  • ...

People who inspire us or contribute to this project will be listed in the Thanks List chapter.

You can’t perform that action at this time.