oracle.pg.rdbms.pgql

Class PgqlTranslator

java.lang.Object

oracle.pg.rdbms.pgql.PgqlTranslator

public class PgqlTranslator
extends java.lang.Object

This class is the main driver for PGQL-to-SQL translation

Method Summary

Modifier and Type	Method and Description
static PgqlTranslator	getPgqlTranslator(QueryContext ctx) factory method for generating a PgqlTranslator instance
static PgqlTranslator	getPgqlTranslator(QueryContext ctx, TraversalStruct parentTStruct, java.util.Map<java.lang.String,oracle.pgql.lang.ir.QueryExpression> parentExprAliasMap) factory method for generating a PgqlTranslator instance
PgqlSqlTrans	translatePgql(java.lang.String pgqlStr, oracle.pgql.lang.ir.Statement stmt, BindValueInfo bvInfo) Translates the given PGQL into a class containing SQL queries that can be used to perform query, insert/update/delete, create/drop on PG vertex and edge tables.
PgqlSqlTrans	translatePgql(java.lang.String pgqlStr, oracle.pgql.lang.ir.Statement stmt, BindValueInfo bvInfo, boolean forExecute) Translates the given PGQL into a class containing SQL queries that can be used to perform query, insert/update/delete, create/drop on PG vertex and edge tables.
PgqlSqlQueryTrans	translateQuery(java.lang.String pgqlStr) main query translation method
PgqlSqlQueryTrans	translateQuery(java.lang.String pgqlStr, BindValueInfo bvInfo) main query translation method

Methods inherited from class java.lang.Object

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

Method Detail

getPgqlTranslator

public static PgqlTranslator getPgqlTranslator(QueryContext ctx)

factory method for generating a PgqlTranslator instance

Parameters:

ctx - the QueryContext for this overall query

Returns:

a new PgqlTranslator object

getPgqlTranslator

public static PgqlTranslator getPgqlTranslator(QueryContext ctx,
                                               TraversalStruct parentTStruct,
                                               java.util.Map<java.lang.String,oracle.pgql.lang.ir.QueryExpression> parentExprAliasMap)

factory method for generating a PgqlTranslator instance

Parameters:

ctx - the QueryContext for this overall query

parentTStruct - the traversal structures for this query block's parent

parentExprAliasMap - alias to expression mapping for this query block's parent

Returns:

a new PgqlTranslator object

translatePgql

public PgqlSqlTrans translatePgql(java.lang.String pgqlStr,
                                  oracle.pgql.lang.ir.Statement stmt,
                                  BindValueInfo bvInfo)
                           throws oracle.pgql.lang.PgqlException,
                                  PgqlToSqlException

Translates the given PGQL into a class containing SQL queries that can be used to perform query, insert/update/delete, create/drop on PG vertex and edge tables. Only one of pgqlStr or stmt should be non-null.

Parameters:

pgqlStr - the PGQL string to translate

stmt - Statement IR object for a DML or DDL

bvInfo - bind variable information for this overall PGQL

Returns:

the SQL translation of the input PGQL for the PG schema

Throws:

oracle.pgql.lang.PgqlException - when an error occurs in the translation

PgqlToSqlException - when receiving an unexpected statement

translatePgql

public PgqlSqlTrans translatePgql(java.lang.String pgqlStr,
                                  oracle.pgql.lang.ir.Statement stmt,
                                  BindValueInfo bvInfo,
                                  boolean forExecute)
                           throws oracle.pgql.lang.PgqlException,
                                  PgqlToSqlException

Translates the given PGQL into a class containing SQL queries that can be used to perform query, insert/update/delete, create/drop on PG vertex and edge tables. Only one of pgqlStr or stmt should be non-null.

Parameters:

pgqlStr - the PGQL string to translate

stmt - Statement IR object for a DML or DDL

bvInfo - bind variable information for this overall PGQL

forExecute - true if this translation is called from execute()

Returns:

the SQL translation of the input PGQL for the PG schema

Throws:

oracle.pgql.lang.PgqlException - when an error occurs in the translation

PgqlToSqlException - when receiving an unexpected statement

translateQuery

public PgqlSqlQueryTrans translateQuery(java.lang.String pgqlStr)
                                 throws oracle.pgql.lang.PgqlException,
                                        PgqlToSqlException

main query translation method

Parameters:

pgqlStr - the PGQL query string to translate

Returns:

the SQL translation of the input PGQL for the DAL schema

Throws:

oracle.pgql.lang.PgqlException - when an error occurs in the translation

PgqlToSqlException - when an error occurs in the translation

translateQuery

public PgqlSqlQueryTrans translateQuery(java.lang.String pgqlStr,
                                        BindValueInfo bvInfo)
                                 throws oracle.pgql.lang.PgqlException,
                                        PgqlToSqlException

main query translation method

Parameters:

pgqlStr - the PGQL query string to translate

bvInfo - bind variable information for this overall query

Returns:

the SQL translation of the input PGQL for the DAL schema

Throws:

oracle.pgql.lang.PgqlException - when an error occurs in the translation

PgqlToSqlException - when an error occurs in the translation