Support parsing Oracle RMAN CHANGE SQL

* Add CHANGE BACKUPSET / DATAFILECOPY / COPY OF ARCHIVELOG SEQUENCE BETWEEN /
  BACKUP OF SPFILE TAG statements with AVAILABLE / UNAVAILABLE / NOKEEP
  qualifiers to the Oracle DAL grammar
* Define BACKUPSET, DATAFILECOPY, AVAILABLE, UNAVAILABLE and TAG lexer tokens
  and register them in unreservedWord to keep identifier compatibility
* Add OracleChangeStatement, visitor mapping and CHANGE visitor rule
* Add 8 CHANGE parser IT cases and a BINARY_FLOAT / BINARY_DOUBLE create-table case

Fixes #27016

Author: terrymanu

parser/sql/engine/core/src/main/java/org/apache/shardingsphere/sql/parser/engine/core/database/visitor/SQLVisitorRule.java

@@ -885,6 +885,8 @@ public enum SQLVisitorRule {
 
     REPORT("Report", SQLStatementType.DAL),
 
+    CHANGE("Change", SQLStatementType.DAL),
+    
     START_REPLICA("StartReplica", SQLStatementType.DAL),
 
     REFRESH("Refresh", SQLStatementType.DAL),

parser/sql/engine/dialect/oracle/src/main/antlr4/imports/oracle/BaseRule.g4

@@ -203,3 +203,16 @@ list
 report
     : REPORT SCHEMA forDbUniqueName?
     ;
+
+change
+    : CHANGE BACKUPSET numberLiterals changeOption?
+    | CHANGE DATAFILECOPY (stringLiterals | numberLiterals) changeOption?
+    | CHANGE COPY OF ARCHIVELOG SEQUENCE BETWEEN numberLiterals AND numberLiterals changeOption?
+    | CHANGE BACKUP OF SPFILE TAG (stringLiterals | DOUBLE_QUOTED_TEXT) changeOption?
+    ;
+
+changeOption
+    : AVAILABLE
+    | UNAVAILABLE
+    | NOKEEP
+    ;

parser/sql/engine/dialect/oracle/src/main/antlr4/imports/oracle/DALStatement.g4

@@ -1599,6 +1599,14 @@ DATAFILE
     : D A T A F I L E
     ;
 
+DATAFILECOPY
+    : D A T A F I L E C O P Y
+    ;
+
+BACKUPSET
+    : B A C K U P S E T
+    ;
+
 MANAGED
     : M A N A G E D
     ;
@@ -1679,6 +1687,18 @@ AVAILABILITY
     : A V A I L A B I L I T Y
     ;
 
+AVAILABLE
+    : A V A I L A B L E
+    ;
+
+UNAVAILABLE
+    : U N A V A I L A B L E
+    ;
+
+TAG
+    : T A G
+    ;
+
 PERFORMANCE
     : P E R F O R M A N C E
     ;

parser/sql/engine/dialect/oracle/src/main/antlr4/imports/oracle/OracleKeyword.g4

@@ -166,6 +166,7 @@ execute
     | set
     | list
     | report
+    | change
     | createOperator
     | createIndexType
     | createSchema

parser/sql/engine/dialect/oracle/src/main/antlr4/org/apache/shardingsphere/sql/parser/autogen/OracleStatement.g4

@@ -21,6 +21,7 @@
 import org.apache.shardingsphere.sql.parser.api.ASTNode;
 import org.apache.shardingsphere.sql.parser.api.visitor.statement.type.DALStatementVisitor;
 import org.apache.shardingsphere.sql.parser.autogen.OracleStatementParser.AlterResourceCostContext;
+import org.apache.shardingsphere.sql.parser.autogen.OracleStatementParser.ChangeContext;
 import org.apache.shardingsphere.sql.parser.autogen.OracleStatementParser.ExecuteContext;
 import org.apache.shardingsphere.sql.parser.autogen.OracleStatementParser.ExplainContext;
 import org.apache.shardingsphere.sql.parser.autogen.OracleStatementParser.ListContext;
@@ -37,6 +38,7 @@
 import org.apache.shardingsphere.sql.parser.statement.core.statement.type.dal.SetStatement;
 import org.apache.shardingsphere.sql.parser.statement.core.statement.type.dal.ShowStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleAlterResourceCostStatement;
+import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleChangeStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleListStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleReportStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleSpoolStatement;
@@ -118,4 +120,9 @@ public ASTNode visitList(final ListContext ctx) {
     public ASTNode visitReport(final ReportContext ctx) {
         return new OracleReportStatement(getDatabaseType(), null == ctx.forDbUniqueName() ? null : ctx.forDbUniqueName().identifier().getText());
     }
+    
+    @Override
+    public ASTNode visitChange(final ChangeContext ctx) {
+        return new OracleChangeStatement(getDatabaseType());
+    }
 }

parser/sql/engine/dialect/oracle/src/main/java/org/apache/shardingsphere/sql/parser/engine/oracle/visitor/statement/type/OracleDALStatementVisitor.java

@@ -0,0 +1,31 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shardingsphere.sql.parser.statement.oracle.dal;
+
+import org.apache.shardingsphere.database.connector.core.type.DatabaseType;
+import org.apache.shardingsphere.sql.parser.statement.core.statement.type.dal.DALStatement;
+
+/**
+ * Change statement for Oracle.
+ */
+public final class OracleChangeStatement extends DALStatement {
+    
+    public OracleChangeStatement(final DatabaseType databaseType) {
+        super(databaseType);
+    }
+}

parser/sql/statement/dialect/oracle/src/main/java/org/apache/shardingsphere/sql/parser/statement/oracle/dal/OracleChangeStatement.java

@@ -20,14 +20,17 @@
 import lombok.AccessLevel;
 import lombok.NoArgsConstructor;
 import org.apache.shardingsphere.sql.parser.statement.core.statement.type.dal.DALStatement;
+import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleChangeStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleListStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleReportStatement;
 import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleSpoolStatement;
 import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.SQLCaseAssertContext;
+import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.statement.dal.dialect.oracle.type.OracleChangeStatementAssert;
 import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.statement.dal.dialect.oracle.type.OracleListStatementAssert;
 import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.statement.dal.dialect.oracle.type.OracleReportStatementAssert;
 import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.statement.dal.dialect.oracle.type.OracleSpoolStatementAssert;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.SQLParserTestCase;
+import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleChangeStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleListStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleReportStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleSpoolStatementTestCase;
@@ -55,5 +58,8 @@ public static void assertIs(final SQLCaseAssertContext assertContext, final DALS
         if (actual instanceof OracleReportStatement) {
             OracleReportStatementAssert.assertIs(assertContext, (OracleReportStatement) actual, (OracleReportStatementTestCase) expected);
         }
+        if (actual instanceof OracleChangeStatement) {
+            OracleChangeStatementAssert.assertIs(assertContext, (OracleChangeStatement) actual, (OracleChangeStatementTestCase) expected);
+        }
     }
 }

test/it/parser/src/main/java/org/apache/shardingsphere/test/it/sql/parser/internal/asserts/statement/dal/dialect/oracle/OracleDALStatementAssert.java

@@ -0,0 +1,41 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.shardingsphere.test.it.sql.parser.internal.asserts.statement.dal.dialect.oracle.type;
+
+import lombok.AccessLevel;
+import lombok.NoArgsConstructor;
+import org.apache.shardingsphere.sql.parser.statement.oracle.dal.OracleChangeStatement;
+import org.apache.shardingsphere.test.it.sql.parser.internal.asserts.SQLCaseAssertContext;
+import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleChangeStatementTestCase;
+
+/**
+ * Oracle change statement assert for Oracle.
+ */
+@NoArgsConstructor(access = AccessLevel.PRIVATE)
+public final class OracleChangeStatementAssert {
+    
+    /**
+     * Assert change statement is correct with expected parser result.
+     *
+     * @param assertContext assert context
+     * @param actual actual change statement
+     * @param expected expected change statement test case
+     */
+    public static void assertIs(final SQLCaseAssertContext assertContext, final OracleChangeStatement actual, final OracleChangeStatementTestCase expected) {
+    }
+}

test/it/parser/src/main/java/org/apache/shardingsphere/test/it/sql/parser/internal/asserts/statement/dal/dialect/oracle/type/OracleChangeStatementAssert.java

@@ -123,6 +123,7 @@
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.mysql.table.MySQLChecksumTableStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.mysql.table.MySQLOptimizeTableStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.mysql.table.MySQLRepairTableStatementTestCase;
+import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleChangeStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleListStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleReportStatementTestCase;
 import org.apache.shardingsphere.test.it.sql.parser.internal.cases.parser.jaxb.statement.dal.dialect.oracle.OracleSpoolStatementTestCase;
@@ -2120,6 +2121,9 @@ public final class RootSQLParserTestCases {
     @XmlElement(name = "report")
     private final List<OracleReportStatementTestCase> oracleReportStatementTestCases = new LinkedList<>();
 
+    @XmlElement(name = "change")
+    private final List<OracleChangeStatementTestCase> oracleChangeStatementTestCases = new LinkedList<>();
+    
     @XmlElement(name = "create-loadable-function")
     private final List<MySQLCreateLoadableFunctionTestCase> createLoadableFunctionTestCases = new LinkedList<>();