com.bigdata.bop.fed

Class TestFederatedQueryEngine

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.btree.AbstractBTreeTestCase

com.bigdata.service.AbstractEmbeddedFederationTestCase

com.bigdata.bop.fed.TestFederatedQueryEngine

All Implemented Interfaces:

junit.framework.Test

public class TestFederatedQueryEngine
extends AbstractEmbeddedFederationTestCase

Unit tests for FederatedQueryEngine running against an EmbeddedFederation having a single DataService. The data may be partitioned, but the partitions will live on the same DataService.

Note: You can not use multiple DataServices in this test suite with the EmbeddedFederation because the services are not sufficiently distinct based on how they are created. Therefore unit tests against more than one DataService are located in the bigdata-jini module.

Note: Distributed query processing generally means that the order in which the chunks arrive is non-deterministic. Therefore the order of the solutions can not be checked unless a total order is placed on the solutions using a SortOp.

 -Dlog4j.configuration=bigdata/src/resources/logging/log4j.properties
 

Version:

$Id: TestFederatedQueryEngine.java 3508 2010-09-05 17:02:34Z thompsonbry $

Author:

Bryan Thompson

Nested Class Summary

Nested classes/interfaces inherited from class junit.framework.TestCase2

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields inherited from class com.bigdata.service.AbstractEmbeddedFederationTestCase

client, dataService0, dataService1, fed, metadataService

Fields inherited from class com.bigdata.btree.AbstractBTreeTestCase

keyBuilder, log, r

Fields inherited from class junit.framework.TestCase2

_randomType

Constructor Summary

Constructors

Constructor and Description
TestFederatedQueryEngine()
TestFederatedQueryEngine(String name)

Method Summary

Methods

Modifier and Type	Method and Description
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
void	setUp() Data files are placed into a directory named by the test.
void	tearDown()
void	test_query_join_1shard() Test the ability to run a simple join reading on a single shard.
void	test_query_join_2shards_nothingBoundOnAccessPath_withConstraint() Test the ability run a simple join which is mapped across two index partitions.
void	test_query_join_2shards_nothingBoundOnAccessPath() Test the ability run a simple join which is mapped across two index partitions.
void	test_query_join2_optionals() Unit test for optional join.
void	test_query_join2() Test the ability run a query requiring two joins.
void	test_query_startRun() Test the ability to run a query which does nothing and produces no solutions.
void	test_query_startThenSlice_noJoins() Unit test uses a StartOp to copy some binding sets through a SliceOp without involving any joins or access path reads.
void	test_startStop() Starts and stops the QueryEngine, but does not validate the semantics of shutdown() versus shutdownNow() since we need to be evaluating query mixes in order to verify the semantics of those operations.

Methods inherited from class com.bigdata.service.AbstractEmbeddedFederationTestCase

assertEquals, assertEquals, assertEquals, assertIndexRegistered, awaitAsynchronousOverflow, getPartitionCount

Methods inherited from class com.bigdata.btree.AbstractBTreeTestCase

assertChildKeys, assertEntryCounts, assertKeys, assertKeys, assertKeys, assertSameAbstractNodeData, assertSameBTree, assertSameEntryIterator, assertSameEntryIterator, assertSameIterator, assertSameIterator, assertSameLeaf, assertSameLeafData, assertSameNode, assertSameNodeData, assertSameNodeOrLeaf, assertSameRaba, assertValues, assertValues, doEntryIteratorTest, doInsertKeySequenceTest, doInsertLookupRemoveStressTest, doInsertRandomKeySequenceTest, doInsertRandomKeySequenceTest, doInsertRandomSparseKeySequenceTest, doKnownKeySequenceTest, doRandomIndexOfTest, doRandomKeyInsertTest, doRandomLookupTest, doRemoveStructureStressTest, doSplitTest, doSplitWithDecreasingKeySequence, doSplitWithIncreasingKeySequence, doSplitWithRandomDenseKeySequence, getBTree, getBTree, getKeysAndValues, getRandomKeys, getRandomKeyValues, i2k, nextLong, useRawRecords

Methods inherited from class junit.framework.TestCase2

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEqualsWithinUlps, assertSameArray, assertSameArray, assertSameBigDecimal, assertSameBigDecimal, assertSameBigInteger, assertSameBigInteger, assertSameIterator, assertSameIterator, assertSameIteratorAnyOrder, assertSameIteratorAnyOrder, assertSameValue, assertSameValue, assertZeroUlps, assertZeroUlps, fail, getInnerCause, getNormalInt, getProjectBuildPath, getRandomObject, getRandomObject, getRandomOrder, getRandomString, getTestInputStream, getTestResource, getTestResource, getUlps, getUlps, isDEBUG, isDEBUG, isINFO, isINFO, isInnerCause, logProperties

Methods inherited from class junit.framework.TestCase

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

TestFederatedQueryEngine

public TestFederatedQueryEngine()

TestFederatedQueryEngine

public TestFederatedQueryEngine(String name)

Method Detail

getProperties

public Properties getProperties()

Description copied from class: TestCase2

Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy. If a property name is not bound at the top-level of the returned Properties object, then the lower levels of the hierarchy are recursively searched.

The hierarchy is constructed from the following properties files in the following order. The first property file in this list corresponds to the top of the property hierarchy. The last property file in this list corresponds to the bottom of the property hierarchy. The property resources are:

1. The System properties specified using the -D argument on the command line.
2. ${user.home}/build.properties. ${user.home} is the value of the Java system environment variable named "user.home" and corresponds to the user home directory. A warning is logged if this properties file does not exist. Note: The JUnit UI can wind up with a different value for this property than when you execute tests without the UI. It is an error if the properties file exists but can not be read.
3. {class}.properties, where {class} is the class name reported by Java reflection, is loaded iff it is found.
4. {class} is repeatedly truncated by dropping the last package name component to generate a package name. If a properties file named "test.properties" exists in that package then those properties are loaded.

Overrides:

getProperties in class AbstractEmbeddedFederationTestCase

Returns:

A Properties object that supplies bindings for property names according to the described hierarchy among property resources. The returned Properties is NOT cached. TODO This does not handle the recursive truncation of the class name to search for "test.properties" yet.

setUp

public void setUp()
           throws Exception

Description copied from class: AbstractEmbeddedFederationTestCase

Data files are placed into a directory named by the test. If the directory exists, then it is removed before the federation is set up.

Overrides:

setUp in class AbstractEmbeddedFederationTestCase

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

Overrides:

tearDown in class AbstractEmbeddedFederationTestCase

Throws:

Exception

test_startStop

public void test_startStop()
                    throws Exception

Starts and stops the QueryEngine, but does not validate the semantics of shutdown() versus shutdownNow() since we need to be evaluating query mixes in order to verify the semantics of those operations.

Throws:

Exception

test_query_startRun

public void test_query_startRun()
                         throws Exception

Test the ability to run a query which does nothing and produces no solutions.

Throws:

Exception

test_query_startThenSlice_noJoins

public void test_query_startThenSlice_noJoins()
                                       throws Exception

Unit test uses a StartOp to copy some binding sets through a SliceOp without involving any joins or access path reads. For this test, the binding sets never leave the query controller.

Throws:

Exception

test_query_join_2shards_nothingBoundOnAccessPath

public void test_query_join_2shards_nothingBoundOnAccessPath()
                                                      throws Exception

Test the ability run a simple join which is mapped across two index partitions. There are three operators. One feeds an empty binding set[] into the join, another is the predicate for the access path on which the join will read (no variables are bound so it will read everything), and the third is the join itself.

Throws:

Exception

test_query_join_2shards_nothingBoundOnAccessPath_withConstraint

public void test_query_join_2shards_nothingBoundOnAccessPath_withConstraint()
                                                                     throws Exception

Test the ability run a simple join which is mapped across two index partitions. The join is constrained to filter for only solutions in which [y==Paul].

Throws:

Exception

test_query_join_1shard

public void test_query_join_1shard()
                            throws Exception

Test the ability to run a simple join reading on a single shard. There are three operators. One feeds an empty binding set[] into the join, another is the predicate for the access path on which the join will read (it probes the index once for "Mary" and binds "Paul" and "John" when it does so), and the third is the join itself (there are two solutions, which are value="Paul" and value="John").

Throws:

Exception

test_query_join2

public void test_query_join2()
                      throws Exception

Test the ability run a query requiring two joins.

Throws:

Exception

test_query_join2_optionals

public void test_query_join2_optionals()
                                throws Exception

Unit test for optional join. Two joins are used and target a SliceOp. The 2nd join is marked as optional. Intermediate results which do not succeed on the optional join are forwarded to the SliceOp which is the target specified by the PipelineOp.Annotations#ALT_SINK_REF.

Throws:

Exception