com.bigdata.rdf.sail

Class BigdataSailHelper

java.lang.Object

com.bigdata.rdf.sail.BigdataSailHelper

Deprecated.

The workbench provides configuration guidance. This class also provides some support for people who want to modify some properties after a namespace has been created. This is in fact possible for some kinds of properties but not for others, but there is very little documentation about when this is and is not possible. You need to actually understand and reason about whether the property controls the manner in which the data is stored on the disk or whether it simply controls the runtime behavior in a manner that does not impact the disk storage.

public class BigdataSailHelper
extends Object

Class provides guidance on parameter setup a data set and queries.

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
BigdataSailHelper() Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
Properties	getProperties() Deprecated. Return the Properties that will be used to configure a new AbstractTripleStore instance.
Properties	getProperties(BigdataSail sail) Deprecated. Return the properties associated with the AbstractTripleStore backing the BigdataSail.
protected Properties	getProperties(IIndexManager indexManager, String namespace) Deprecated. Return the properties associated with the given namespace.
BigdataSail	getSail(IBigdataFederation<?> fed, String namespace, long timestamp) Deprecated. (Re-)open a SAIL backed by persistent data stored in an IBigdataFederation.
BigdataSail	getSail(String filename, String namespace, long timestamp) Deprecated. (Re-)open a SAIL backed by persistent data stored on a Journal.
static void	main(String[] args) Deprecated. Utility class.
Properties	setProperties(BigdataSail sail, Properties properties) Deprecated. Update properties for the SAIL.
protected Properties	setProperties(IIndexManager indexManager, String namespace, Properties properties) Deprecated.
static void	showLexiconIndexDetails(BigdataSail.BigdataSailConnection cxn) Deprecated. Shows some interesting details about the terms index.
protected static void	showProperties(Properties p) Deprecated.
static void	showSPOIndexDetails(BigdataSail.BigdataSailConnection cxn) Deprecated. Shows some interesting details about the primary index for the SPORelation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BigdataSailHelper

public BigdataSailHelper()

Deprecated.

Method Detail

getSail

public BigdataSail getSail(IBigdataFederation<?> fed,
                  String namespace,
                  long timestamp)

Deprecated.

(Re-)open a SAIL backed by persistent data stored in an IBigdataFederation.

Parameters:

fed - The federation.

namespace - The namespace of the triple store.

timestamp - The timestamp of the view.

Returns:

The SAIL.

getSail

public BigdataSail getSail(String filename,
                  String namespace,
                  long timestamp)

Deprecated.

(Re-)open a SAIL backed by persistent data stored on a Journal.

Parameters:

filename - The name of the backing file for the Journal.

namespace - The namespace of the triple store.

timestamp - The timestamp of the view.

Returns:

The SAIL.

getProperties

public Properties getProperties()

Deprecated.

Return the Properties that will be used to configure a new AbstractTripleStore instance. The AbstractTripleStore will remember the properties with which it was created and use those values each time it is re-opened. The properties are stored in the global row store for the backing IIndexManager.

Note: You need to edit this code to correspond to your application requirements. Currently the code reflects an application using a triple store without inference, without statement level provenance, and with the full text index enabled. Another common configuration is a triple store with RDFS++ inference, which can be realized by changing the AbstractTripleStore.Options#AXIOMS_CLASS property value and possibly enabling BigdataSail.Options.TRUTH_MAINTENANCE depending on whether or not you will be incrementally or bulk loading data.

getProperties

public Properties getProperties(BigdataSail sail)

Deprecated.

Return the properties associated with the AbstractTripleStore backing the BigdataSail.

Parameters:

sail - The sail.

Returns:

The persistent properties.

getProperties

protected Properties getProperties(IIndexManager indexManager,
                       String namespace)

Deprecated.

Return the properties associated with the given namespace.

Parameters:

indexManager - Use BigdataSail#getDatabase() and then AbstractResource.getIndexManager().

namespace - The namespace of a locatable resource such as an AbstractTripleStore, SPORelation or LexiconRelation.

Returns:

The persistent properties.

setProperties

public Properties setProperties(BigdataSail sail,
                       Properties properties)

Deprecated.

Update properties for the SAIL. This will overwrite any properties having the same name with their new values. Properties that are not overwritten will remain visible. A property can be deleted by specifying a null value.

Note: this changes the persistent property values associated with the SAIL. It DOES NOT change the properties associated with the given instance. You MUST re-open the SAIL in order for the new properties to be in effect.

Note: While many property values can be changed dynamically, some may not. In particular, the properties that effect the way in which the keys for the indices are generated as stored within the indices themselves. Among other things this ensures that Unicode configuration options are applied uniformly when an is accessed by any host in a federation.

Parameters:

sail - The SAIL.

properties - The properties.

Returns:

The post-modification properties.

setProperties

protected Properties setProperties(IIndexManager indexManager,
                       String namespace,
                       Properties properties)

Deprecated.

Parameters:

indexManager -

namespace -

properties -

Returns:

The post-modification properties.

showProperties

protected static void showProperties(Properties p)

Deprecated.

showLexiconIndexDetails

public static void showLexiconIndexDetails(BigdataSail.BigdataSailConnection cxn)

Deprecated.

Shows some interesting details about the terms index.

Parameters:

cxn - The connection.

showSPOIndexDetails

public static void showSPOIndexDetails(BigdataSail.BigdataSailConnection cxn)

Deprecated.

Shows some interesting details about the primary index for the SPORelation.

Parameters:

cxn - The connection.

Throws:

org.openrdf.sail.SailException

InterruptedException

main

public static void main(String[] args)
                 throws org.openrdf.sail.SailException,
                        IOException,
                        InterruptedException

Deprecated.

Utility class.

Note: The LTS (local triple store) mode is inferred when the filename is a .properties file. The JiniFederation (JDS) mode is inferred when the filename is a .config file. If neither of those file extensions is used, then you must specify the either LTS or JDS explicitly.

Note: The namespace identifies which triple store you are accessing and defaults to kb.

Note: The timestamp identifies which commit point you are accessing and defaults to the ITx.UNISOLATED view, which can also be specified as ).

Note: The properties is a file containing property overrides to be applied to the kb.

Parameters:

args - filename ((LTS|JDS ((namespace (timestamp)))properties)

Throws:

org.openrdf.sail.SailException

ConfigurationException

IOException

InterruptedException