Skip to main content

PoolParty's SPARQL Shell

Abstract

PoolParty's SPARQL Shell

Users who have the PoolPartySuperAdmin role assigned can access the PoolParty SPARQL shell when they are logged into PoolParty.

  • The PoolParty SPARQL shell is available via the Admin Scripts menu entry in the Tools menu.

  • This will bring up a page listing available admin scripts where you can access the SPARQL shell clicking the respective link.

  • Select the project you want to query and connect to it clicking Connect.

    • In the top area you can formulate your queries and perform them via the Run Query button.

    • In the bottom area you will see the results of your query or get notified if the query was performed successfully or if any errors occurred.

You can add, delete and update data in your project following the SPARQL 1.1 Update language definition.

  • Using queries you can check the result of your updates.

    • Click the Commit Updates button to apply the changes to the project.

  • Use Rollback Updates to undo all changes made since you connected to the project or committed updates.

  • Disconnect closes the connection to the project.

23901026.png

The following functions are available in the top right-hand corner:

  • The drop down provides a number of often used default queries you can select from here to paste into the shell. To execute one, click Run Query.

    • You can also save your custom queries using this drop down and Save beside it:

      • Select the custom queries entry, enter your query into the shell, click Save and in the subsequent dialogue window enter a name of your choice for the query, confirm with OK.

    • To delete a query, select it from the drop down and click Delete.

  • The arrow up and arrow down buttons let you cycle through the history of queries performed in the current session.

Note

Always create a snapshot or backup your project before you change data via the PoolParty SPARQL shell endpoint.

All changes made wil be lost when you disconnect without committing the updates.

Warning

When you perform SPARQL Update queries in the shell it is important to finalise the session on that repository before working with it in PoolParty. This means you have to

  • commit the updates (write the changes to the repository),

  • perform a rollback (discard the changes), or

  • disconnect from the repository (changes are discarded).

This is especially important when working on system repositories such as the Custom Schema repository that are used by all projects.