GraphDB-SE Entity Pool

compared with
Current by evgeni.milev
on Jun 04, 2015 15:59.

This line was removed.
This word was removed. This word was added.
This line was added.

Changes (10)

View Page History
The entity pool is a key component of the GraphDB storage layer. It converts the entities (URIs, Blank nodes and Literals) to internal IDs (32\- or 40-bit integers). From version 6.2 this component supports transactional behavior, which improves space usage and cluster behavior.

h1. Configuration Implementations

The transactional property of the entity pool fixes many issues related to creating IDs. However, entities still need to be pre-processed and all other commit operations should be performed (storing, inference, plugin handling, consistency checking, statement retraction on remove operations), including adding the entities to the permanent store. All these operations are time-consuming, so the new transactional entity pool cannot be faster than the classic one.

There are two implementations - a fully transactional and classic.

* the default implementation
* appropriate recommended for large transactions and bulk loads
* avoids the overhead of temporarily storing of the entities and the remapping from temporary to permanent IDs (which is performed in the transactional implementation)
* when adding statements, the entities are directly added and cannot be rolled back
h5. transactional-simple

* all new entities are kept in memory - not recommended for large transactions (> 100M statements) to prevent {{{*}OutOfMemoryErrors{*}}}
* good for large number of small transactions
* mandatory in recommended for cluster environment - ensures entity IDs consistency between worker nodes
* should be used with [Solr|Solr GraphDB Connector#Prerequisites] and [Elascticsearch|Elasticsearch GraphDB Connector#Prerequisites] connectors.

h1. Configuration

The entity pool implementation can be selected by the {{{*}entity-pool-implementation{*}}} config parameter or the {{*\-D{*}}} command line parameter with the same name.

|| Parameter || Value || Description Note ||
| entity-pool-implementation | transactional-simple | all entities are kept in memory |
| | classic (default) | for bulk loads (in cluster should be run only on a single worker node)\\ |
| {{entity-pool-implementation}} | {{classic}} | default |
| | {{transactional-simple}} |
| | {{transactional}} | The recommended transactional implementation in the current version of GraphDB. \\
For 6.2 it is {{{*}transactional-simple{*}}}. May change in future versions |