Graphdb SE Documentation Release 7.2
Total Page:16
File Type:pdf, Size:1020Kb
GraphDB SE Documentation Release 7.2 Ontotext Oct 28, 2016 CONTENTS 1 General 1 1.1 About GraphDB...........................................2 1.2 Architecture & components.....................................2 1.2.1 Architecture.........................................2 Sesame............................................3 The SAIL API........................................4 1.2.2 Components.........................................4 Engine............................................4 Connectors..........................................5 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..............................................7 1.6.1 How to use it........................................8 2 Quick start guide 9 2.1 Start the database...........................................9 2.1.1 Run GraphDB as a stand-alone server...........................9 Running GraphDB......................................9 Configuring GraphDB....................................9 Stopping the database.................................... 10 2.2 Set up your license.......................................... 10 2.3 Create a repository.......................................... 12 2.4 Load your data............................................ 12 2.4.1 Load data through the GraphDB Workbench........................ 12 2.4.2 Load data through SPARQL or Sesame API........................ 14 2.4.3 Load data through the GraphDB LoadRDF tool...................... 14 2.5 Explore your data and class relationships.............................. 15 2.5.1 Class hierarchy....................................... 15 2.5.2 Domain-Range graph.................................... 17 2.5.3 Class relationships..................................... 19 2.6 Query your data........................................... 21 2.6.1 Query data through the GraphDB Workbench....................... 21 2.6.2 Query data programmatically................................ 25 2.7 Additional resources......................................... 25 3 Installation 27 3.1 Requirements............................................. 27 3.1.1 Minimum.......................................... 27 i 3.1.2 Recommended....................................... 27 3.1.3 Licensing.......................................... 27 3.2 Deployment scenarios........................................ 27 3.3 Running GraphDB.......................................... 28 3.3.1 Run GraphDB as a stand-alone server........................... 28 Running GraphDB...................................... 28 Configuring GraphDB.................................... 29 Stopping the database.................................... 29 3.3.2 Run GraphDB as a WAR file deployed in a servlet container............... 29 Configuring GraphDB.................................... 30 Stopping the database.................................... 30 3.4 Configuring GraphDB........................................ 30 3.4.1 Directories......................................... 30 GraphDB Home....................................... 30 Checking the configured directories............................. 31 3.4.2 Configuration........................................ 31 Config properties....................................... 32 Configuring logging..................................... 33 3.4.3 Best practices........................................ 33 Step by step guide...................................... 33 3.5 Distribution package......................................... 33 3.6 Using Maven artifacts........................................ 33 3.6.1 Public Maven repository.................................. 34 3.6.2 Distribution......................................... 34 3.6.3 GraphDB JAR file for embedding the database or plugin development.......... 35 4 Administration 37 4.1 Administration tasks......................................... 37 4.2 Administration tools......................................... 37 4.2.1 Through the Workbench.................................. 37 4.2.2 Through the JMX interface................................. 38 4.3 Setting up licenses.......................................... 38 4.3.1 Setting up licenses through the GraphDB Workbench................... 38 4.3.2 Setting up licenses through a file.............................. 39 Custom file path property.................................. 40 4.3.3 Order of preference..................................... 40 4.3.4 Deprecated methods.................................... 40 4.4 Creating locations and repositories................................. 40 4.5 Configuring a repository....................................... 41 4.5.1 Planning a repository configuration............................. 41 4.5.2 Configuring a repository through the GraphDB Workbench................ 42 4.5.3 Configuring a repository programmatically........................ 43 4.5.4 Configuration parameters.................................. 44 4.5.5 Configuring GraphDB memory............................... 47 Configuring Java heap memory............................... 47 Single global page cache................................... 48 Configuring Entity pool memory............................... 48 Sample memory configuration................................ 48 4.6 Sizing guidelines........................................... 49 4.6.1 Entry-level deployment................................... 49 4.6.2 Mid-range deployment................................... 49 4.6.3 Enterprise deployment................................... 50 4.7 Disk space requirements....................................... 50 4.7.1 GraphDB disk space requirements for loading a dataset.................. 50 4.7.2 GraphDB disk space requirements per statement...................... 51 4.8 Configuring the Entity Pool..................................... 51 4.9 Managing repositories........................................ 52 4.9.1 Changing repository parameters.............................. 52 ii Using the Workbench..................................... 52 In the SYSTEM repository................................... 52 Global overrides....................................... 53 4.9.2 Renaming a repository................................... 53 4.10 Access rights and security...................................... 53 4.10.1 Using the GraphDB Workbench.............................. 53 4.11 Backing up and recovering a repository............................... 54 4.11.1 Backing up a repository................................... 54 4.11.2 Restoring a repository.................................... 56 4.12 Query monitoring and termination.................................. 57 4.12.1 Query monitoring...................................... 57 4.12.2 Terminating a query..................................... 58 Stopping queries using JMX................................. 58 Stopping queries with GraphDB Workbench........................ 58 Automatically prevent long running queries......................... 59 4.12.3 Terminating a transaction.................................. 59 4.13 Database health checks........................................ 59 4.13.1 Possible values for health checks and their meaning.................... 60 4.13.2 Default health checks for the different GraphDB editions................. 60 4.13.3 Running the health checks................................. 60 4.14 System metrics monitoring...................................... 61 4.14.1 Page cache metrics..................................... 61 cache.flush.......................................... 61 cache.hit........................................... 61 cache.load........................................... 61 cache.miss.......................................... 61 4.14.2 Entity pool metrics..................................... 61 epool.read........................................... 61 epool.write.......................................... 62 4.15 Diagnosing and reporting critical errors............................... 62 4.15.1 Logs............................................. 62 Setting up the root logger................................... 62 Logs location......................................... 62 Log files........................................... 63 4.15.2 Report script........................................ 63 Requirements......................................... 64 Example........................................... 64 5 Usage 65 5.1 Workbench user guide........................................ 65 5.1.1 Admin (Administering the Workbench).......................... 66 Managing locations...................................... 66 Managing repositories.................................... 67 Managing users and access.................................. 69 Query monitoring and interruption.............................. 70 Resource monitoring..................................... 71 System information...................................... 71 REST API.......................................... 72 5.1.2 Data (Working with data).................................. 73 Importing data........................................ 73 Exporting data.......................................