Graphdb SE Documentation Release 6.6
Total Page：16
File Type：pdf, Size：1020Kb
GraphDB SE Documentation Release 6.6 Ontotext Dec 14, 2017 CONTENTS 1 General 1 1.1 About GraphDB...........................................2 1.2 Architecture & Components.....................................2 1.2.1 Architecture.........................................2 1.2.1.1 Sesame.......................................3 1.2.1.2 The SAIL API...................................4 1.2.2 GraphDB components...................................4 1.2.2.1 Engine.......................................4 1.2.2.2 Connectors.....................................5 1.2.2.3 Workbench.....................................5 1.3 GraphDB SE.............................................5 1.3.1 Comparison of GraphDB Free and GraphDB SE......................6 1.4 GraphDB SE in the Cloud......................................6 1.4.1 Overview..........................................6 1.4.2 Amazon Web Services...................................6 1.4.3 Pricing details........................................7 1.4.4 Setup and usage.......................................7 1.5 Connectors..............................................7 1.6 Workbench..............................................8 1.6.1 Requirements........................................8 1.6.2 How to use it........................................9 2 Quick Start Guide 11 2.1 Starting the database......................................... 11 2.2 Creating locations and repositories................................. 12 2.3 Loading data............................................. 13 2.3.1 Supported file formats................................... 13 2.3.2 Loading data through the GraphDB Workbench...................... 13 2.3.2.1 To load a local file:................................ 13 2.3.2.2 To load a database server file:........................... 14 2.3.2.3 Other ways of loading data:............................ 15 2.3.3 Loading data through SPARQL or Sesame API...................... 15 2.3.4 Loading data through the GraphDB LoadRDF tool.................... 16 2.4 Querying data............................................ 16 2.4.1 Querying data through the GraphDB Workbench..................... 16 2.4.2 Querying data programmatically.............................. 17 2.4.2.1 Execute the example query with a HTTP GET request:.............. 17 2.4.2.2 Execute the example query with a POST operation:................ 17 2.4.3 Supported export/download formats............................ 17 2.5 Additional resources......................................... 17 3 Installation 19 3.1 Distribution Package......................................... 19 3.2 Requirements............................................. 20 i 3.2.1 Minimum requirements................................... 20 3.2.2 Production environment.................................. 20 3.2.2.1 Hardware..................................... 20 3.2.2.2 Software...................................... 20 3.2.2.3 Control & management.............................. 21 3.2.3 Licensing.......................................... 21 3.3 Installing GraphDB SE........................................ 21 3.3.1 Install GraphDB on a laptop/desktop computer...................... 21 3.3.2 Installing GraphDB on a server............................... 21 3.4 Upgrading GraphDB SE....................................... 21 3.4.1 Procedure.......................................... 21 3.4.2 Upgrade scenarios..................................... 22 3.4.2.1 The storage/ folder format is not different (for minor versions)........ 22 3.4.2.2 The storage/ folder format is different but GraphDB can auto-upgrade it (for minor changes in the format)........................... 22 3.4.2.3 The storage/ folder format is different but the changes cannot be auto- upgraded (for major versions)........................... 23 3.4.3 Upgrade from/to specific versions............................. 23 3.4.3.1 Upgrade from 6.2................................. 23 3.4.3.2 Upgrade from 6.1................................. 23 3.4.3.3 Upgrade from 5.4 to 6.2+............................. 24 3.4.3.4 Upgrade from 5.x................................. 24 4 Administration 27 4.1 Administration Tasks......................................... 27 4.2 Administration Tools......................................... 27 4.2.1 Through the Workbench.................................. 27 4.2.2 Through the JMX interface................................. 28 4.2.3 GraphDB configurator (spreadsheet)............................ 28 4.3 Creating a Repository........................................ 28 4.3.1 Creating locations and repositories............................. 28 4.4 Configuring a Repository...................................... 29 4.4.1 Steps............................................ 29 4.4.2 A repository configuration template - how it works.................... 30 4.4.3 Sample configuration.................................... 31 4.4.4 Configuration parameters.................................. 31 4.4.4.1 Debugging options................................. 34 4.4.5 Configuring memory.................................... 35 4.4.5.1 Configuring the JVM, the application and the GraphDB workspace memory.. 36 4.4.5.2 Configuring the memory for storing entities................... 37 4.4.5.3 Configuring the Cache memory.......................... 37 4.5 Sizing Guidelines........................................... 38 4.5.1 Entry-level deployment................................... 38 4.5.2 Mid-range deployment................................... 38 4.5.3 Enterprise deployment................................... 38 4.6 Disk Space Requirements...................................... 39 4.6.1 GraphDB disk space requirements for loading a dataset.................. 39 4.6.2 GraphDB disk space requirements per statement...................... 39 4.7 Configuring the Entity Pool..................................... 40 4.8 Setting up Licenses.......................................... 40 4.9 Starting & Shutting down GraphDB................................. 41 4.9.1 Starting GraphDB in the embedded Tomcat........................ 41 4.9.2 Shutting down GraphDB in the embedded Tomcat..................... 41 4.9.3 How to start/stop via non-embedded Tomcat (or other application server)........ 41 4.9.4 Shutting down a repository instance from the JMX interface............... 42 4.10 Managing Repositories........................................ 42 4.10.1 Changing repository parameters.............................. 42 4.10.2 Renaming a repository................................... 43 ii 4.11 Access Rights and Security..................................... 44 4.11.1 Using the GraphDB Workbench.............................. 44 4.11.2 Using an HTTP authentication and the Sesame server’s deployment descriptor...... 45 4.11.2.1 Operations..................................... 45 4.11.2.2 Security constraints and roles........................... 46 4.11.2.3 User accounts................................... 47 4.11.3 Programmatic authentication................................ 48 4.12 Backing up and Recovering a Repository.............................. 48 4.12.1 Backing up a repository................................... 48 4.12.2 Restoring a repository.................................... 50 4.13 Query and Transaction Monitoring................................. 51 4.13.1 Query monitoring and termination............................. 51 4.13.1.1 Preventing long running queries.......................... 52 4.13.2 Terminating a transaction.................................. 52 4.14 Diagnosing and Reporting Critical Errors.............................. 52 4.14.1 Logs............................................. 52 4.14.2 Report script........................................ 53 4.14.2.1 Requirements................................... 54 4.14.2.2 Example...................................... 54 5 Usage 57 5.1 Workbench User Guide....................................... 57 5.1.1 Installation, start-up and shut down............................. 57 5.1.2 Checking your setup.................................... 58 5.1.3 Using the Workbench.................................... 58 5.1.3.1 Managing locations................................ 58 5.1.3.2 Managing repositories............................... 59 5.1.4 Loading data into a repository............................... 62 5.1.4.1 Import settings................................... 62 5.1.4.2 Four ways to import data............................. 63 5.1.5 Executing queries...................................... 65 5.1.6 Exporting data....................................... 67 5.1.7 Viewing and editing resources............................... 69 5.1.8 Namespace management.................................. 71 5.1.9 Context view........................................ 72 5.1.10 Connector management................................... 73 5.1.11 Users and access management............................... 74 5.1.11.1 Free access..................................... 76 5.1.12 REST API.......................................... 76 5.1.13 Configuration properties.................................. 78 5.2 Using GraphDB with the Sesame API................................ 79 5.2.1 Sesame Application Programming Interface (API)..................... 79 5.2.1.1 Using the Sesame API to access a local GraphDB repository.......... 79 5.2.1.2 Using the Sesame API to access a remote GraphDB repository......... 80 5.2.2 Managing repositories with the Sesame Workbench.................... 81 5.2.3 SPARQL endpoint..................................... 81 5.2.4 Graph Store