Workbench User Interface

The Workbench is the web-based administration interface to GraphDB. It lets you administer GraphDB, as well as load, transform, explore, manage, query and export data.

The Workbench layout consists of two main areas. The navigation area is on the left-hand side of the screen and it contains dropdown menus to all functionalities - Import, Explore, SPARQL, Export/Context, Monitor, Setup, and Help. The work area shows the tasks associated with the selected functionality. On the home page, it provides easy access to some of the actions in the workbench such as set a license, attach location, create a repository, find a resource, query your data, etc. On the bottom of the page, you can see the license details, and in the footer - the versions of the various GraphDB components.

_images/ee-workbench-landing-page.png

Workbench Functionalities Descriptions

Navigation Tab Functionality Description
Import
  • RDF => Import data from local files, from files on the server where the workbench is located, from a remote URL (with a format extension or by specifying the data format), or by pasting the RDF data in the Text area tab. Each import method supports different serialisation formats.
  • Tabular (OntoRefine) => Convert tabular data into RDF and import it into a GraphDB repository using simple SPARQL queries and a virtual endpoint. The supported formats are TSV, CSV, *SV, Excel (.xls and. xlsx), JSON, XML, RDF as XML, and Google sheet.
Explore
  • Class hierarchy => Explore the hierarchy of RDF classes by number of instances. The biggest circles are the parent classes and the nested ones are their children. Hover over a given class to see its subclasses or zoom in a nested circle (RDF class) for further exploration.
  • Class relationships => Explore the relationships between RDF classes, where a relationship is represented by links between the individual instances of two classes. Each link is an RDF statement where the subject is an instance of one class, the object is an instance of another class, and the link is the predicate. Depending on the number of links between the instances of two classes, the bundle can be thicker or thinner and it gets the colour of the class with more incoming links. The links can be in both directions.
  • View resource => View and edit all RDF data related to a resource.
SPARQL
  • SPARQL => Query and update your data. Use any type of SPARQL query and click Run to execute it.
Export/Context
  • Export => Export an entire repository or one or more graphs (contexts). Multiple formats are supported.
  • Context => Filter and manage the contexts (graphs) in a repository - inspect its triples, downloaded, or delete it.
Monitor
  • Resources => Monitor the usage of various system resources, such as memory and CPU, for the currently active location.
  • Queries => Monitor all running queries in GraphDB. Any query can be killed by pressing the Abort query button.
Setup
  • Repositories => Manage repositories and connect to remote locations. A location represents a local or remote instance of GraphDB. Only a single location can be active at a given time.
  • Users and Access => Manage the users and their access to the GraphDB repositories. You can also enable or disable the security of the entire Workbench. When disabled, everyone has full access to the repositories and the admin functionality.
  • Connectors => Create, view and delete GraphDB Connector instances with a handy form-based editor for Connector configurations.
  • Cluster => Manage a GraphDB cluster - create or modify a cluster by dragging and dropping the nodes or use it to monitor the state of a running cluster in near real time. The view shows repositories from the active location and all remote locations.
  • Namespaces => View and manipulate the RDF namespaces for the active repository. You need a write permission to add or delete namespaces.
  • Autocomplete => Enable/disable the autocomplete index and check its status. It is used for automatic completion of URIs in the SPARQL editor.
Help
  • REST API => REST API documentation of all available public RESTful endpoints together with an interactive interface for executing requests.
  • Documentation => a link to the GraphDB public documentation.
  • Developer Hub => a link to the GraphDB dev hub - a hands-on compendium to the GraphDB Documentation that gives practical advice and tips on accomplishing real-world tasks.
  • Support => a link to the GraphDB support page.
  • System information => See the configuration values of the JVM running the GraphDB workbench: Application Info, JVM Arguments and Workbench Configuration properties.

Workbench configuration properties

In addition to the standard GraphDB command line parameters, the GraphDB Workbench can be controlled with the following parameters (they should be of the form -Dparam=value):

Parameter Description
graphdb.workbench.cors.enable

Enables cross-origin resource sharing.

Default: false

graphdb.workbench.cors.origin

Sets the allowed Origin value for cross-origin resource sharing.

This can be a comma-delimited list or a single value. The value “*” means “allow all origins” and it works with authentication too.

Default: *

graphdb.workbench.maxConnections

Sets the maximum number of concurrent connections to a remote GraphDB instance.

Default: 200

graphdb.workbench.datadir

Sets the directory where the workbench persistence data will be stored.

Default: ${user.home}/.graphdb-workbench/

graphdb.workbench.importDirectory

Changes the location of the file import folder.

Default: ${user.home}/graphdb-import/

graphdb.workbench.maxUploadSize

Sets the maximum upload size for importing local files. The value must be in bytes.

Default: 200 MB