enapso-graphdb-cli

Enapso Ontotext GraphDB 8.x/9.x Command Line Interface (CLI) for Node.js

Enapso Command Line Interface for GraphDB to easily perform numerous operations on GraphDB repositories and named graphs. This tool will be continously extended by further scriptable convenience operations.

The following demos require a running GraphDB 8.x/9.x instance on localhost at port 7200. The demos as well as the automated tests require a fully working Ontotext GraphDB repository "Test" and a user "Test" with the password "Test" being set up, which has read/write access to the "Test" Repository. For certain operations the user needs to have the Repository Manager or Administrator role in GraphDB. Get the latest version of GraphDB for free at https://www.ontotext.com/products/graphdb/.

This project is actively developed and maintained. To discuss questions and suggestions with the Enapso and GraphDB community, we'll be happy to meet you in our forum at https://www.innotrade.com/forum/.

Commands

export   exports (download) a repository or context from GraphDB to a file
import   imports (upload) a repository or context from a file to a GraphDB repository or named graph

Parameters

--dburl        -d   base url of GraphDB instance, e.g. http://localhost:7200
--repository   -r   repository to use for the command
--context      -c   context to be used for the command, of not passed usually the entire repository is used
--username     -u   the user to be authenticated
--password     -p   the password to be used for authentication
                    (should not be stored in scripts, better use env variables)
--baseiri      -i   base iri of graph e.g. http://ont.enapso.com/
--verbose      -v   log detailed output to the console
--targetfile   -t   file name for exports to file
--sourcefile   -s   file name for import from file
--queryfile    -q   file name for the query file (SPARQL)
--format       -f   please refer to the below format specification
--authorities -a    rights of GraphDB which we are providing to newly created user

Examples

Export (download) a repository or named graph

Download from GraphDB to a file:

enapsogdb export | download \
  -d "http://localhost:7200" \
  -r "Test" \
  -c "http://ont.enapso.com/test" \
  -t "backups/backup.ttl" \
  -u "Test" \
  -p "Test" \
  -f "text/turtle"

Import (upload) a repository or named graph

Upload from a file to GraphDB:

enapsogdb import | upload \
  --dburl "http://localhost:7200" \
  --repository "Test" \
  --context "http://ont.enapso.com/test" \
  --baseiri "http://ont.enapso.com/test#" \
  --sourcefile "imports/test.owl" \
  --username "Test" \
  --password "Test" \
  --format "application/rdf+xml"

Clearing entire repository

Clear entire repository. Caution! Use this command with care! The operation cannot be undone!

enapsogdb clearRepository \
  --dburl "http://localhost:7200" \
  --repository "Test" \
  --username "Test" \
  --password "Test" \

Perform Garbage Collection

Perform the garbage collection of the Ontotext GraphDB.

enapsogdb gc \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \

Create Repository

Create New Repository in the Ontotext GraphDB.

enapsogdb createRepository \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \
  --reponame "MyTestUser"\
    --repotitle "MyTestUser"\

Delete Repository

Delete Repository of Ontotext GraphDB.

enapsogdb deleteRepository \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \
  --reponame "MyTestUser"\

Create User

Create new user in Ontotext GraphDB.

enapsogdb createUser \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \
  --newusername "MyTestUser"\
  --newpassword "MyTestUser"\ 
  -a "ROLE_USER WRITE_REPO_Test READ_REPO_Test READ_REPO_EnapsoDotNetProDemo"\

Update User

Update exisiting user of Ontotext GraphDB.

enapsogdb updateUser \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \
  --newusername "MyTestUser"\
  --newpassword "MyTestUser"\ 
  -a "ROLE_USER READ_REPO_Test READ_REPO_EnapsoDotNetProDemo"\

Delete User

Delete exisiting user of Ontotext GraphDB.

enapsogdb deleteUser \
  --dburl "http://localhost:7200" \
  --username "Test" \
  --password "Test" \
  --newusername "MyTestUser"\

File Types and Data Formats

The following file types are supported:

name: "JSON",
type: "application/rdf+json",
extension: ".json"

name: "JSON-LD",
type: "application/ld+json",
extension: ".jsonld"

name: "RDF-XML",
type: "application/rdf+xml",
extension: ".rdf"

name: "N3",
type: "text/rdf+n3",
extension: ".n3"

name: "N-Triples",
type: "text/plain",
extension: ".nt"

name: "N-Quads",
type: "text/x-nquads",
extension: ".nq"

name: "Turtle",
type: "text/turtle",
extension: ".ttl"

name: "TriX",
type: "application/trix",
extension: ".trix"

name: "TriG",
type: "application/x-trig",
extension: ".trig"

name: "Binary RDF",
type: "application/x-binary-rdf",
extension: ".brf"