Package sqltriples :: Module Store :: Class TripleStore
[show private | hide private]
[frames | no frames]

Class TripleStore


A triple store whose contents are stored in an SQL-accessible database
table.

Method Summary
  __init__(self, adapter, context, table_name, sequence_name, debug)
Initialise access to the store via the given 'adapter' and employing the given, optional 'context' URI, using a table with the given, optional 'table_name' ("triples" by default) and a sequence (for BNode generation) with the optional 'sequence_name' ("bnode" by default).
  add(self, pattern)
Add a triple using the information found in the given 'pattern'.
  and_objects(self, queries)
  and_predicates(self, queries)
  and_subjects(self, queries)
  and_triples(self, queries)
  and_tuples(self, queries, pattern)
  close(self)
Close the connection to the database system.
  commit(self)
Commit the changes made to the triple store.
  contexts(self)
Return a list of contexts found in this store.
  count(self, pattern, expression)
Return a count of the triples conforming to the given 'pattern'.
  delete(self)
Drop the store's table and sequence.
  delete_index(self)
Drop the index from certain columns.
  delete_sequence(self)
Drop the BNode sequence.
  delete_table(self)
Drop the triple store's table.
  get_context(self, context)
Return a copy of this store which uses the given 'context' to constrain operations on the stored triples.
  has_triple(self, pattern)
  init(self)
Initialise the database by creating a table and a sequence.
  init_index(self)
Initialise an index for certain columns.
  init_sequence(self)
Initialise the BNode sequence.
  init_table(self)
Initialise the triple store's table.
  intersect_objects(self, queries)
  intersect_predicates(self, queries)
  intersect_subjects(self, queries)
  intersect_triples(self, queries)
  intersect_tuples(self, queries, pattern)
  not_objects(self, result)
  not_predicates(self, result)
  not_subjects(self, result)
  not_triples(self, result)
  not_tuples(self, result, pattern)
  objects(self, subject, predicate, pattern, expression, functions, ordering, order_by, limit)
Return objects for the given 'subject' and/or 'predicate' identifiers.
  or_objects(self, queries)
  or_predicates(self, queries)
  or_subjects(self, queries)
  or_triples(self, queries)
  or_tuples(self, queries, pattern)
  predicates(self, subject, object, pattern, expression, ordering, order_by, limit)
Return predicates for the given 'subject' and/or 'object' identifiers.
  remove(self, pattern)
Remove all triples conforming to the given 'pattern'.
  remove_context(self, context)
Removes the specified 'context' from the database.
  rollback(self)
Roll back (undo) the changes made to the triple store.
  subject(self, subject)
Return a Subject for the given 'subject' identifier.
  subjects(self, predicate, object, pattern, expression, ordering, order_by, limit)
Return subjects for the given 'predicate' and/or 'object' identifiers.
  triples(self, pattern, expression, functions, ordering, order_by, limit)
Return triples conforming to the given 'pattern'.
  tuples(self, pattern, expression, functions, ordering, order_by, limit, partial)

Class Variable Summary
classobj BNode = sqltriples.Types.BNode
dict codes_to_names = {'B': 'BNode', 'U': 'URIRef', 'L': 'Lit...
type Literal = sqltriples.Types.Literal
dict names_to_codes = {'Literal': 'L', 'BNode': 'B', 'Namespa...
type Namespace = sqltriples.Types.Namespace
str null_context = 'None'
Namespace TYPE = Namespace: http://www.w3.org/1999/02/22-rdf-synta...
type URIRef = sqltriples.Types.URIRef

Method Details

__init__(self, adapter, context=None, table_name=None, sequence_name=None, debug=0)
(Constructor)

Initialise access to the store via the given 'adapter' and employing
the given, optional 'context' URI, using a table with the given,
optional 'table_name' ("triples" by default) and a sequence (for BNode
generation) with the optional 'sequence_name' ("bnode" by default).

If the optional 'debug' parameter is set to a true value, the SQL
statements issued to the database system will be displayed on standard
output.

add(self, pattern)

Add a triple using the information found in the given 'pattern'.

close(self)

Close the connection to the database system.

commit(self)

Commit the changes made to the triple store.

contexts(self)

Return a list of contexts found in this store.

count(self, pattern=None, expression=None)

Return a count of the triples conforming to the given 'pattern'.

delete(self)

Drop the store's table and sequence.

delete_index(self)

Drop the index from certain columns.

delete_sequence(self)

Drop the BNode sequence.

delete_table(self)

Drop the triple store's table.

get_context(self, context)

Return a copy of this store which uses the given 'context' to constrain
operations on the stored triples.

init(self)

Initialise the database by creating a table and a sequence.

init_index(self)

Initialise an index for certain columns.

init_sequence(self)

Initialise the BNode sequence.

init_table(self)

Initialise the triple store's table.

objects(self, subject=None, predicate=None, pattern=None, expression=None, functions=None, ordering=None, order_by=None, limit=None)

Return objects for the given 'subject' and/or 'predicate' identifiers.

Where the given 'functions' dictionary is specified, a function will be
applied for all columns named as keys in that dictionary. For example,
the following dictionary...

{"object", "substr(_, 1, 4)"}

...results in the following function being applied in the underlying
query:

substr(object, 1, 4)

Where the 'ordering' is specified (as either "asc" or "desc"), a query
is produced which sorts the results according to retrieved objects.

Where the 'order_by' qualifier can be used to choose whether the
"subject" or the "object" will order the results.

Where a 'limit' is specified (as an integer), the number of results will
be limited to the stated amount.

predicates(self, subject=None, object=None, pattern=None, expression=None, ordering=None, order_by=None, limit=None)

Return predicates for the given 'subject' and/or 'object' identifiers.

Where the 'ordering' is specified (as either "asc" or "desc"), a query
is produced which sorts the results according to retrieved objects.

Where the 'order_by' qualifier can be used to choose whether the
"subject" or the "object" will order the results.

Where a 'limit' is specified (as an integer), the number of results will
be limited to the stated amount.

remove(self, pattern)

Remove all triples conforming to the given 'pattern'.

remove_context(self, context)

Removes the specified 'context' from the database.

rollback(self)

Roll back (undo) the changes made to the triple store.

subject(self, subject)

Return a Subject for the given 'subject' identifier.

subjects(self, predicate=None, object=None, pattern=None, expression=None, ordering=None, order_by=None, limit=None)

Return subjects for the given 'predicate' and/or 'object' identifiers.

Where the 'ordering' is specified (as either "asc" or "desc"), a query
is produced which sorts the results according to retrieved objects.

Where the 'order_by' qualifier can be used to choose whether the
"subject" or the "object" will order the results.

Where a 'limit' is specified (as an integer), the number of results will
be limited to the stated amount.

triples(self, pattern=None, expression=None, functions=None, ordering=None, order_by=None, limit=None)

Return triples conforming to the given 'pattern'.

Where the given 'functions' dictionary is specified, a function will be
applied for all columns named as keys in that dictionary. For example,
the following dictionary...

{"object", "substr(_, 1, 4)"}

...results in the following function being applied in the underlying
query:

substr(object, 1, 4)

Where the 'ordering' is specified (as either "asc" or "desc"), a query
is produced which sorts the results according to retrieved objects.

Where the 'order_by' qualifier can be used to choose whether the
"subject" or the "object" will order the results.

Where a 'limit' is specified (as an integer), the number of results will
be limited to the stated amount.

Class Variable Details

codes_to_names

Type:
dict
Value:
{'B': 'BNode', 'U': 'URIRef', 'L': 'Literal'}                          

names_to_codes

Type:
dict
Value:
{'Literal': 'L', 'BNode': 'B', 'Namespace': 'U', 'URIRef': 'U'}        

null_context

Type:
str
Value:
'None'                                                                 

TYPE

Type:
Namespace
Value:
Namespace: http://www.w3.org/1999/02/22-rdf-syntax-ns#type             

Generated by Epydoc 2.1 on Fri Jan 12 00:04:34 2007 http://epydoc.sf.net