org.aksw.sparqlify.core.algorithms

Class CandidateViewSelectorImplUseTheGenericImplInstead

java.lang.Object

org.aksw.sparqlify.core.algorithms.CandidateViewSelectorImplUseTheGenericImplInstead

All Implemented Interfaces:

CandidateViewSelectorOld

public class CandidateViewSelectorImplUseTheGenericImplInstead
extends Object
implements CandidateViewSelectorOld

Constructor Summary

Constructors

Constructor and Description
CandidateViewSelectorImplUseTheGenericImplInstead(MappingOps mappingOps)

Method Summary

Methods

Modifier and Type	Method and Description
com.hp.hpl.jena.sparql.algebra.Op	_getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op) Given a sparql query in quad form, this method replaces (sub sets of) quad patterns with view instances (view patterns) The method also passes the filter conditions that an op must satisfy.
com.hp.hpl.jena.sparql.algebra.Op	_getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op, RestrictionManagerImpl restrictions)
void	addView(ViewDefinition viewDef)
static StartsWithConstraint	deriveConstraint(com.hp.hpl.jena.sparql.expr.E_StrConcat expr)
static StartsWithConstraint	deriveConstraint(E_StrConcatPermissive expr)
static Constraint	deriveConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)
static VariableConstraint	deriveIsPrefixOfConstraint(com.hp.hpl.jena.sparql.expr.Expr a, com.hp.hpl.jena.sparql.expr.Expr b) If a variable equals a (uri or string) constant, it means that the view must provide a prefix for that value.
static VariableConstraint	deriveViewLookupConstraint(com.hp.hpl.jena.sparql.expr.Expr expr) Returns IsPrefixOf Constraints for equality expressions between variables and constants.
static RestrictionManagerImpl	filterRestrictionsBound(RestrictionManagerImpl restrictions) Create a new retrictions manager, where "bound" retrictions are removed
Set<ViewQuad>	findCandidates(com.hp.hpl.jena.sparql.core.Quad quad, RestrictionManagerImpl restrictions) TODO: This method is far from optimal performance right now: We need to consider prefix-set-restrictions of the variables during the lookup in order to rule out returning to many view-quad candidates.
org.aksw.commons.util.Pair<NavigableMap<Integer,Set<com.hp.hpl.jena.sparql.core.Quad>>,Map<com.hp.hpl.jena.sparql.core.Quad,Set<ViewQuad>>>	findQuadWithFewestViewCandidates(com.hp.hpl.jena.sparql.core.QuadPattern queryQuads, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpAssign op, RestrictionManagerImpl _restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpConditional op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpDistinct op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpExtend op, RestrictionManagerImpl _restrictions) Extend defines now variables and is therefore similar to a VarDefinition.
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpFilter op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpGroup op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpJoin op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpOrder op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpProject op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSequence op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSlice op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpUnion op, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	getApplicableViews(com.hp.hpl.jena.query.Query query)
List<ViewInstanceJoin>	getApplicableViewsBase(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op, RestrictionManagerImpl restrictions) Order the quads of the quadPattern by selectivity.
void	getApplicableViewsRec2(int index, List<com.hp.hpl.jena.sparql.core.Quad> quadOrder, Set<ViewQuad> viewQuads, Map<com.hp.hpl.jena.sparql.core.Quad,Set<ViewQuad>> candidates, RestrictionManagerImpl restrictions, NestedStack<ViewInstance> instances, List<ViewInstanceJoin> result, Mapping baseMapping)
static List<String>	getCandidateNames(NestedStack<ViewInstance> instances)
static List<RestrictionManagerImpl>	getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op)
static void	getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op, Collection<RestrictionManagerImpl> result) Returns a disjunction (list) of restrictions that apply for a given node
static RestrictionManagerImpl	getRestrictions2(com.hp.hpl.jena.sparql.algebra.Op op)
static RdfTermType	getType(com.hp.hpl.jena.graph.Node node, RestrictionManagerImpl restrictions)
Collection<ViewDefinition>	getViews()
static boolean	isSatisfiable(List<ViewInstance> list) TODO FIX THIS
com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin	processLeftJoin(com.hp.hpl.jena.sparql.algebra.Op left, com.hp.hpl.jena.sparql.algebra.Op right, Iterable<com.hp.hpl.jena.sparql.expr.Expr> exprs, RestrictionManagerImpl restrictions)
com.hp.hpl.jena.sparql.algebra.Op	processOpExtend(com.hp.hpl.jena.sparql.algebra.Op subOp, com.hp.hpl.jena.sparql.core.VarExprList varExprs, RestrictionManagerImpl _restrictions)

Methods inherited from class java.lang.Object

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

Constructor Detail

CandidateViewSelectorImplUseTheGenericImplInstead

public CandidateViewSelectorImplUseTheGenericImplInstead(MappingOps mappingOps)

Parameters:

opMappingRewriter - May be null. If given, we can do rewrites during the SQL generation to prune empty result mappings early.

Method Detail

addView

public void addView(ViewDefinition viewDef)

Specified by:

addView in interface CandidateViewSelectorOld

deriveConstraint

public static Constraint deriveConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)

deriveConstraint

public static StartsWithConstraint deriveConstraint(com.hp.hpl.jena.sparql.expr.E_StrConcat expr)

deriveConstraint

public static StartsWithConstraint deriveConstraint(E_StrConcatPermissive expr)

getType

public static RdfTermType getType(com.hp.hpl.jena.graph.Node node,
                  RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.query.Query query)

Specified by:

getApplicableViews in interface CandidateViewSelectorOld

deriveIsPrefixOfConstraint

public static VariableConstraint deriveIsPrefixOfConstraint(com.hp.hpl.jena.sparql.expr.Expr a,
                                            com.hp.hpl.jena.sparql.expr.Expr b)

If a variable equals a (uri or string) constant, it means that the view must provide a prefix for that value.

Parameters:

a -

b -

Returns:

deriveViewLookupConstraint

public static VariableConstraint deriveViewLookupConstraint(com.hp.hpl.jena.sparql.expr.Expr expr)

Returns IsPrefixOf Constraints for equality expressions between variables and constants. Used for looking up view candidates. Not used for satisfiability checks.

Parameters:

expr -

Returns:

getApplicableViewsBase

public List<ViewInstanceJoin> getApplicableViewsBase(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op,
                                            RestrictionManagerImpl restrictions)

Order the quads of the quadPattern by selectivity. Iterate the quads in order, and for each quad, do a lookup of the views that may yield answers to it. So for each quad we get a set of candidate bindings to the views. Binding is a mapping from query-var to a set of view variables/constant The view varibale may have constraints on it, which carry over to the query variable. So given Create View x ... {?x a Class . } With ?x.value prefix "foo" a query Select {?s ?p ?o } and a binding(?s = ?x), then we can infer the constraint on ?x.value prefix "foo" So if there is a second pattern { ?x a Class. ?x label ?z } Then we can use this constraint on the lookup at the second pattern. Note that the selectivity of query quad pattern change with the bindings, so we should be able to quickly update the selectivity of the quads in the presence of bindings. Another note: Maybe we could treat constants as specially delimited prefixes, such as 'aaaa' = prefix 'aaaaa$' = constant

findCandidates

public Set<ViewQuad> findCandidates(com.hp.hpl.jena.sparql.core.Quad quad,
                           RestrictionManagerImpl restrictions)

TODO: This method is far from optimal performance right now: We need to consider prefix-set-restrictions of the variables during the lookup in order to rule out returning to many view-quad candidates.

Parameters:

quad -

restrictions -

Returns:

findQuadWithFewestViewCandidates

public org.aksw.commons.util.Pair<NavigableMap<Integer,Set<com.hp.hpl.jena.sparql.core.Quad>>,Map<com.hp.hpl.jena.sparql.core.Quad,Set<ViewQuad>>> findQuadWithFewestViewCandidates(com.hp.hpl.jena.sparql.core.QuadPattern queryQuads,
                                                                                                                                                                           RestrictionManagerImpl restrictions)

getCandidateNames

public static List<String> getCandidateNames(NestedStack<ViewInstance> instances)

getApplicableViewsRec2

public void getApplicableViewsRec2(int index,
                          List<com.hp.hpl.jena.sparql.core.Quad> quadOrder,
                          Set<ViewQuad> viewQuads,
                          Map<com.hp.hpl.jena.sparql.core.Quad,Set<ViewQuad>> candidates,
                          RestrictionManagerImpl restrictions,
                          NestedStack<ViewInstance> instances,
                          List<ViewInstanceJoin> result,
                          Mapping baseMapping)

Parameters:

index -

quadOrder -

viewQuads - The viewQuads provided by the parent invocation - with any restrictions encountered during the rewrite taken into account

candidates - The viewQuads here are the ones from only analyzing the query filter In some cases (small candidate sets) it might be faster filtering this set of view candidates, rather than doing a new lookup.

restrictions -

result -

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpQuadPattern op,
                                                   RestrictionManagerImpl restrictions)

isSatisfiable

public static boolean isSatisfiable(List<ViewInstance> list)

TODO FIX THIS

Parameters:

list -

Returns:

_getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op _getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op)

Given a sparql query in quad form, this method replaces (sub sets of) quad patterns with view instances (view patterns) The method also passes the filter conditions that an op must satisfy.

Parameters:

op -

Returns:

_getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op _getApplicableViews(com.hp.hpl.jena.sparql.algebra.Op op,
                                                    RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSequence op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpProject op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpOrder op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpGroup op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpExtend op,
                                                   RestrictionManagerImpl _restrictions)

Extend defines now variables and is therefore similar to a VarDefinition. Below is outdated. We treat OpExtend as a filter for now TODO This breaks for instance Count(*) as Jena also does renaming with extend: Jena generates Project(?c, Extend(?c, ?x, Group(Count(*) As ?x))) So in this case, extend creates a new alias for a variable

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpAssign op,
                                                   RestrictionManagerImpl _restrictions)

processOpExtend

public com.hp.hpl.jena.sparql.algebra.Op processOpExtend(com.hp.hpl.jena.sparql.algebra.Op subOp,
                                                com.hp.hpl.jena.sparql.core.VarExprList varExprs,
                                                RestrictionManagerImpl _restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpFilter op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpUnion op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpJoin op,
                                                   RestrictionManagerImpl restrictions)

filterRestrictionsBound

public static RestrictionManagerImpl filterRestrictionsBound(RestrictionManagerImpl restrictions)

Create a new retrictions manager, where "bound" retrictions are removed

Parameters:

restrictions -

Returns:

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpConditional op,
                                                   RestrictionManagerImpl restrictions)

processLeftJoin

public com.hp.hpl.jena.sparql.algebra.op.OpLeftJoin processLeftJoin(com.hp.hpl.jena.sparql.algebra.Op left,
                                                           com.hp.hpl.jena.sparql.algebra.Op right,
                                                           Iterable<com.hp.hpl.jena.sparql.expr.Expr> exprs,
                                                           RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpSlice op,
                                                   RestrictionManagerImpl restrictions)

getApplicableViews

public com.hp.hpl.jena.sparql.algebra.Op getApplicableViews(com.hp.hpl.jena.sparql.algebra.op.OpDistinct op,
                                                   RestrictionManagerImpl restrictions)

getRestrictions2

public static RestrictionManagerImpl getRestrictions2(com.hp.hpl.jena.sparql.algebra.Op op)

getRestrictions

public static List<RestrictionManagerImpl> getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op)

getRestrictions

public static void getRestrictions(com.hp.hpl.jena.sparql.algebra.Op op,
                   Collection<RestrictionManagerImpl> result)

Returns a disjunction (list) of restrictions that apply for a given node

getViews

public Collection<ViewDefinition> getViews()

Specified by:

getViews in interface CandidateViewSelectorOld