Apache Derby 10.4

Package org.apache.derby.vti

Support for Table Functions.

See:
          Description

Interface Summary
VTICosting VTICosting is the interface that the query optimizer uses to cost Table Functions.
VTIEnvironment VTIEnvironment is the state variable created by the optimizer to help it place a Table Function in the join order.
 

Package org.apache.derby.vti Description

Support for Table Functions.

Derby lets you declare functions which return ResultSets. You can then use these function results as tables in your queries. This, in turn, lets you do the following:

Here is an example of how to declare and invoke a Table Function:


CREATE FUNCTION externalEmployees
()
RETURNS TABLE
(
  employeeId    INT,
  lastName       VARCHAR( 50 ),
  firstName      VARCHAR( 50 ),
  birthday         DATE
)
LANGUAGE JAVA
PARAMETER STYLE DERBY_JDBC_RESULT_SET
NO SQL
EXTERNAL NAME 'com.acme.hrSchema.EmployeesTable.read'
;

INSERT INTO employees
  SELECT s.*
    FROM TABLE (externalEmployees() ) s;

The Derby optimizer makes some assumptions about these Table Functions:

Based on these assumptions, the optimizer decides where to place the Table Function in the join order. Using the interfaces in this package, you may override the optimizer's guesses and force the optimizer to choose a better join order.


Built on Tue 2008-08-26 06:30:01-0700, from revision 689064

Apache Derby 10.4 API Documentation - Copyright © 2004,2008 The Apache Software Foundation. All Rights Reserved.