Creating and editing repositories

Selecting Repositories from the Workbench Setup menu displays a list of the currently available repositories:

_images/sample-repo-list.png

You can connect to one of the listed repositories by selecting its name from the Choose repository drop-down list in the upper right or by clicking the Connect repository icon connectRepositoryIcon to the left of its name. This will convert the icon to a Connected repository icon connectedRepositoryIcon icon and show the repository’s name in the upper right.

Mousing over the icons to the right of each repository name shows what each icon does. (Their activities are described further below.)

Create a repository

There are two ways to create and manage repositories: through the Workbench interface or by using the RDF4J console.

Using the Workbench

To manage your repositories, go to Setup ‣ Repositories. This opens a list of available repositories like the one shown above; if you have just installed GraphDB, the list may be empty, as shown here:

_images/create-repository.png
  1. Click the Create new repository button or create it from a file by using the configuration template that can be found under /configs/templates in the GraphDB distribution.

    _images/create-repository.png
  2. Select GraphDB repository.

    _images/select-repo-type.png
  1. If you have attached remote locations to your GraphDB instance, there will be an additional field for specifying the Location in which you want to create the repository. The default is Local. See more about creating a repository in a remote location a little further below.

  2. Enter the Repository ID (e.g., my_repo) and leave all other optional configuration settings with their default values.

Tip

For repositories with over several tens of millions of statements, see the configuration parameters.

  1. Click the Create button. Your newly created repository appears in the repository list.

Create a repository in a remote location

You can easily create a repository in any remote location attached to your GraphDB instance.

  1. Connect to the location. For example, you can connect to http://localhost:7202 (substitute localhost and the 7200 port number as appropriate).

  2. Just like with local repositories, go to Setup ‣ Repositories ‣ Create new repository.

  3. In the Location field, the two locations are now visible. Select http://localhost:7202.

    _images/create-remote-repo.png
  4. Fill in the Repository ID and create the repo.

  5. Both repositories are now created.

    _images/local-and-remote-repos.png
  6. Go to http://localhost:7202. You will now see remote_repo created there.

Using the RDF4J console

Note

Use the create command to add new repositories to the location to which the console is connected. This command expects the name of the template that describes the repository’s configuration.

  1. Run the RDF4J console application, which resides in the /bin folder:

    • Windows: console.cmd

    • Unix/Linux: ./console

  2. Connect to the GraphDB server instance with connect http://localhost:7200.

  1. Create a repository using create graphdb.

    We can also create a repository with enabled SHACL validation through the RDF4J console using the command create graphdb-shacl.

  2. Fill in the values of the parameters in the console.

  3. Exit the RDF4J console with quit.

Editing repositories

Connect a repository

Click the connect icon in the repository list.

_images/connect-repo.png

Alternatively, use the dropdown menu in the top right corner. This allows you to easily switch between repositories while running queries or importing and exporting data in other views. Hovering over the respective repository will also display some basic information about it.

_images/switch-between-repos.png

Note

The label in the top right corner of a remote repository indicates whether you are connected to it.

_images/remote-repo-label.png

Make it the default repository

Use the pin to select it as the default repository.

_images/default-repo-pin.png

Restart a repository

There are two ways to restart a repository without having to restart the entire GraphDB instance:

  • Click the restart icon restart-repo-icon next to the repository’s name. A warning will prompt you to confirm the action.

  • Click the edit icon, which will open the repository configuration. At its bottom, tick the restart box, save, and confirm.

_images/restart-repo.png

Warning

Restarting the repository will shut it down immediately, and all running queries and updates will be cancelled.