GraphDB-Workbench

compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (18)

View Page History
The GraphDB Workbench is a our recommended web-based administration tool. The user interface is similar to the Sesame Workbench webapp, but with more functionality. Here are some of the additional features:
* Query monitoring with the possibility to kill a long running query
* Better SPARQL editor based on [http://laurensrietveld.nl/yasgui/]
* Connectors administration(only present in the enterprise edition)

password: *root*
{info}
You are recommended to change the root password as soon as you login for the first time. Go to Admin->Users and choose Edit next to your username. Then change your password. See section [User administration|../../../../../../../../../../#GraphDB-Workbench-Useradministration] in the current document.




!Configure_New_Repository.png|border=1,width=781!
!create-repository.png|border=1,width=772,,height=426!


h2. Selecting a repository

another way(recommended) is to use the dropdown in the top right corner. This will allow you easily change repository while running queries, importing, exporting data in other views.

*//TODO: add a screenshot of the dropdown*
 !repository-select-dropdown.png|border=1,width=776,,height=429!


h1. Loading data into a repository

After creating and connecting to a repository the following steps can be used to load data. Note that loading data is a two stage process: the data files are first uploaded to the workbench and from there loaded in to GraphDB:
We provide two ways of importing files in the currently selected repository. Both can be accessed from *Data->Import* menu item in the workbench

# Pick a repository to work with from the dropdown for selecting a repository
# Use the menu bar *Data->Import* and choose a file (.rdf, .n3, .nt, .trig, and .trix) - as each file is selected it is added to the list in this page. The files you want to load should be stored in a folder, called "owlim-impex" in your computer home directory - HOME/owlim-impex. The Max file size is 50.0 MB.
h3. Basic data load

{warning}
The limitation of this method is that it supports files that are smaller than 50.0 MB.
{warning}

Loading data from the *Upload files* tab is a two stage process: the data files are first uploaded to the workbench and from there loaded in to GraphDB:

# Click on *Select files to upload* and browse a file to upload
# After the files have been selected, click "Start Upload" for individual files or "Upload All" to load all of them
# When the upload is finished a "Load Data" button will appear for each successfully uploaded file. Press this to load files individually or use the "Load All" button for multiple files. After loading a message is displayed with a link to the query page.
# When the upload is finished a "Load Data" button will appear for each successfully uploaded file. Press this to load files individually or use the "Load All" button for multiple files. You will be asked to select a method to load your data:
## SPARQL - import the data in the default context without a base url
## Advanced - provides more options for the import process



!upload.png|border=1,width=781!

!load.png|border=1,width=781!

(/) If you want to load a large amount of data, one solution would be to convert the RDF data into a line-based RDF format (e.g. N-triples) and then split it into many smaller files (e.g. using the unix command 'split'). This would allow each file to be uploaded separately using either the console or the workbench application.
h3. Impex method

The impex method allows you to load files with arbitrary size. It has the limitation that the files must be put(symbolic links are supported) in a specific directory(by default \*${user.home}/owlim-impex*. Look at the *impex.dir* system parameter if you want to tweak the directory location. The directory will be scanned recursively and all files with semantic mime type will be visible in the impex tab.

h1. Executing queries

Access the SPARQL pages using the menu bar *SPARQL->Query*. Above the query editing text area а query template can be accessed and selected. Clicking on it will populate the text-area with a SPARQL query that can be edited in place. The query can be freely edited (with syntax highlighting) and namespaces can be added very easily by accessing the list of known namespaces next to the query template.

A check-box is provided that allows the execution of the query over all RDF statements or just explicit statements. Another check-box controls whether equivalent URIs are expanded. This relates to the use of {{owl:sameAs}} and causes the automatic addition of the pseudo-graph {{FROM <}}{{[http://www.ontotext.com/disable-sameAs]}}{{>}} to the query. This is described in the [special query behaviour section of the OWLIM v54 user guide|OWLIMv54:OWLIM-SE Query Behaviour].