Package io.debezium.connector.oracle.logminer.parser

Class LogMinerDmlParser

java.lang.Object

io.debezium.connector.oracle.logminer.parser.LogMinerDmlParser

All Implemented Interfaces:

DmlParser

public class LogMinerDmlParser
extends Object
implements DmlParser

A simple DML parser implementation specifically for Oracle LogMiner. The syntax of each DML operation is restricted to the format generated by Oracle LogMiner. The following are examples of each expected syntax:

     insert into "schema"."table"("C1","C2") values ('v1','v2');
     update "schema"."table" set "C1" = 'v1a', "C2" = 'v2a' where "C1" = 'v1' and "C2" = 'v2';
     delete from "schema"."table" where "C1" = 'v1' AND "C2" = 'v2';
 

Certain data types are not emitted as string literals, such as DATE and TIMESTAMP. For these data types, they're emitted as function calls. The parser can detect this use case and will emit the values for such columns as the explicit function call. Lets take the following UPDATE statement:

     update "schema"."table"
        set "C1" = TO_TIMESTAMP('2020-02-02 00:00:00', 'YYYY-MM-DD HH24:MI:SS')
      where "C1" = TO_TIMESTAMP('2020-02-01 00:00:00', 'YYYY-MM-DD HH24:MI:SS');
 

The new value for C1 would be TO_TIMESTAMP('2020-02-02 00:00:00', 'YYYY-MM-DD HH24:MI:SS'). The old value for C1 would be TO_TIMESTAMP('2020-02-01 00:00:00', 'YYYY-MM-DD HH24:MI:SS').

Author:

Chris Cranford

Field Summary

Fields

Modifier and Type	Field	Description
private static String	AND
private static String	DELETE_FROM
private static int	DELETE_FROM_LENGTH
private static String	INSERT_INTO
private static int	INSERT_INTO_LENGTH
private static String	IS_NULL
private static String	NULL
private static String	NULL_SENTINEL
private static String	OR
private static String	SET
private static int	SET_LENGTH
private static String	UNSUPPORTED
private static String	UNSUPPORTED_TYPE
private static String	UPDATE
private static int	UPDATE_LENGTH
private static String	VALUES
private static int	VALUES_LENGTH
private static String	WHERE
private static int	WHERE_LENGTH

Constructor Summary

Constructors

Constructor	Description
LogMinerDmlParser()

Method Summary

Modifier and Type	Method	Description
private Object	getColumnUnavailableValue(Object value, Column column)
LogMinerDmlEntry	parse(String sql, Table table)	Parse a DML SQL string from the LogMiner event stream.
private int	parseColumnListClause(String sql, int start, String[] columnNames)	Parse an INSERT statement's column-list clause.
private int	parseColumnValuesClause(String sql, int start, String[] columnNames, Object[] values, Table table)	Parse an INSERT statement's column-values clause.
private LogMinerDmlEntry	parseDelete(String sql, Table table)	Parses a SQL DELETE statement.
private LogMinerDmlEntry	parseInsert(String sql, Table table)	Parse an INSERT SQL statement.
private int	parseSetClause(String sql, int start, Object[] newValues, Table table)	Parse an UPDATE statement's SET clause.
private int	parseTableName(String sql, int index)	Parses a table-name in the SQL clause
private LogMinerDmlEntry	parseUpdate(String sql, Table table)	Parse an UPDATE SQL statement.
private int	parseWhereClause(String sql, int start, Object[] values, Table table)	Parses a WHERE clause populates the provided column names and values arrays.

Methods inherited from class java.lang.Object

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

Field Detail

NULL_SENTINEL

private static final String NULL_SENTINEL

See Also:

Constant Field Values

NULL

private static final String NULL

See Also:

Constant Field Values

INSERT_INTO

private static final String INSERT_INTO

See Also:

Constant Field Values

UPDATE

private static final String UPDATE

See Also:

Constant Field Values

DELETE_FROM

private static final String DELETE_FROM

See Also:

Constant Field Values

AND

private static final String AND

See Also:

Constant Field Values

OR

private static final String OR

See Also:

Constant Field Values

SET

private static final String SET

See Also:

Constant Field Values

WHERE

private static final String WHERE

See Also:

Constant Field Values

VALUES

private static final String VALUES

See Also:

Constant Field Values

IS_NULL

private static final String IS_NULL

See Also:

Constant Field Values

UNSUPPORTED

private static final String UNSUPPORTED

See Also:

Constant Field Values

UNSUPPORTED_TYPE

private static final String UNSUPPORTED_TYPE

See Also:

Constant Field Values

INSERT_INTO_LENGTH

private static final int INSERT_INTO_LENGTH

UPDATE_LENGTH

private static final int UPDATE_LENGTH

DELETE_FROM_LENGTH

private static final int DELETE_FROM_LENGTH

VALUES_LENGTH

private static final int VALUES_LENGTH

SET_LENGTH

private static final int SET_LENGTH

WHERE_LENGTH

private static final int WHERE_LENGTH

Constructor Detail

LogMinerDmlParser

public LogMinerDmlParser()

Method Detail

parse

public LogMinerDmlEntry parse(String sql,
                              Table table)

Description copied from interface: DmlParser

Parse a DML SQL string from the LogMiner event stream.

Specified by:

parse in interface DmlParser

Parameters:

sql - the sql statement

table - the table the sql statement is for

Returns:

the parsed sql as a DML entry or null if the SQL couldn't be parsed.

parseInsert

private LogMinerDmlEntry parseInsert(String sql,
                                     Table table)

Parse an INSERT SQL statement.

Parameters:

sql - the sql statement

table - the table

Returns:

the parsed DML entry record or null if the SQL was not parsed

parseUpdate

private LogMinerDmlEntry parseUpdate(String sql,
                                     Table table)

Parse an UPDATE SQL statement.

Parameters:

sql - the sql statement

table - the table

Returns:

the parsed DML entry record or null if the SQL was not parsed

parseDelete

private LogMinerDmlEntry parseDelete(String sql,
                                     Table table)

Parses a SQL DELETE statement.

Parameters:

sql - the sql statement

table - the table

Returns:

the parsed DML entry record or null if the SQL was not parsed

parseTableName

private int parseTableName(String sql,
                           int index)

Parses a table-name in the SQL clause

Parameters:

sql - the sql statement

index - the index into the sql statement to begin parsing

Returns:

the index into the sql string where the table name ended

parseColumnListClause

private int parseColumnListClause(String sql,
                                  int start,
                                  String[] columnNames)

Parse an INSERT statement's column-list clause.

Parameters:

sql - the sql statement

start - the index into the sql statement to begin parsing

columnNames - the list that will be populated with the column names

Returns:

the index into the sql string where the column-list clause ended

parseColumnValuesClause

private int parseColumnValuesClause(String sql,
                                    int start,
                                    String[] columnNames,
                                    Object[] values,
                                    Table table)

Parse an INSERT statement's column-values clause.

Parameters:

sql - the sql statement

start - the index into the sql statement to begin parsing

columnNames - the column names array, already indexed based on relational table column order

values - the values array that will be populated with column values

table - the relational table

Returns:

the index into the sql string where the column-values clause ended

parseSetClause

private int parseSetClause(String sql,
                           int start,
                           Object[] newValues,
                           Table table)

Parse an UPDATE statement's SET clause.

Parameters:

sql - the sql statement

start - the index into the sql statement to begin parsing

newValues - the new values array to be populated

table - the relational table

Returns:

the index into the sql string where the set-clause ended

parseWhereClause

private int parseWhereClause(String sql,
                             int start,
                             Object[] values,
                             Table table)

Parses a WHERE clause populates the provided column names and values arrays.

Parameters:

sql - the sql statement

start - the index into the sql statement to begin parsing

values - the column values to be parsed from the where clause

table - the relational table

Returns:

the index into the sql string to continue parsing

getColumnUnavailableValue

private Object getColumnUnavailableValue(Object value,
                                         Column column)