Add OracleErrorDetailsProvider

Author: psainics

database-commons/src/main/java/io/cdap/plugin/util/DBUtils.java

@@ -64,6 +64,7 @@ public final class DBUtils {
   public static final String CLOUDSQLMYSQL_SUPPORTED_DOC_URL = "https://cloud.google.com/sql/docs/mysql/error-messages";
   public static final String POSTGRES_SUPPORTED_DOC_URL =
     "https://www.postgresql.org/docs/current/errcodes-appendix.html";
+  public static final String ORACLE_SUPPORTED_DOC_URL = "https://docs.oracle.com/en/error-help/db/ora-index.html";
   public static final String CLOUDSQLPOSTGRES_SUPPORTED_DOC_URL =
     "https://cloud.google.com/sql/docs/postgres/error-messages";
 

oracle-plugin/src/e2e-test/features/source/OracleRunTime.feature

@@ -338,7 +338,9 @@ Feature: Oracle - Verify data transfer from Oracle source to BigQuery sink
     And Save and Deploy Pipeline
     And Run the Pipeline in Runtime
     And Wait till pipeline is in running state
+    And Open and capture logs
     And Verify the pipeline status is "Failed"
+    And Close the pipeline logs
     Then Open Pipeline logs and verify Log entries having below listed Level and Message:
       | Level | Message                                  |
       | ERROR | errorLogsMessageInvalidBoundingQuery     |

oracle-plugin/src/main/java/io/cdap/plugin/oracle/OracleErrorDetailsProvider.java

@@ -0,0 +1,68 @@
+/*
+ * Copyright © 2025 Cask Data, Inc.
+ *
+ * Licensed 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 io.cdap.plugin.oracle;
+
+import com.google.common.base.Strings;
+import io.cdap.cdap.api.exception.ErrorType;
+import io.cdap.plugin.db.DBErrorDetailsProvider;
+import io.cdap.plugin.util.DBUtils;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * A custom ErrorDetailsProvider for Oracle plugin.
+ */
+public class OracleErrorDetailsProvider extends DBErrorDetailsProvider {
+  private static final Map<String, ErrorType> ERROR_CODE_PREFIX_TO_ERROR_TYPE;
+
+  static {
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE = new HashMap<>();
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-00", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-01", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-02", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-03", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-04", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-06", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-07", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-09", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-10", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-11", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-12", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-15", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-16", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-17", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-18", ErrorType.SYSTEM);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-20", ErrorType.USER);
+    ERROR_CODE_PREFIX_TO_ERROR_TYPE.put("ORA-21", ErrorType.USER);
+  }
+
+  @Override
+  protected String getExternalDocumentationLink() {
+    return DBUtils.ORACLE_SUPPORTED_DOC_URL;
+  }
+
+  @Override
+  protected ErrorType getErrorTypeFromErrorCode(int errorCode, String sqlState) {
+    int prefixLength = 6;
+    if (Strings.isNullOrEmpty(sqlState) || sqlState.length() < prefixLength ||
+      !ERROR_CODE_PREFIX_TO_ERROR_TYPE.containsKey(sqlState.substring(0, prefixLength))) {
+      return ErrorType.UNKNOWN;
+    }
+    return ERROR_CODE_PREFIX_TO_ERROR_TYPE.get(sqlState.substring(0, prefixLength));
+  }
+
+}

oracle-plugin/src/main/java/io/cdap/plugin/oracle/OracleSink.java

@@ -82,6 +82,15 @@ protected LineageRecorder getLineageRecorder(BatchSinkContext context) {
     return new LineageRecorder(context, asset);
   }
 
+  @Override
+  protected String getErrorDetailsProviderClassName() {
+    return OracleErrorDetailsProvider.class.getName();
+  }
+
+  @Override
+  protected String getExternalDocumentationLink() {
+    return DBUtils.ORACLE_SUPPORTED_DOC_URL;
+  }
 
   /**
    * Oracle action configuration.

oracle-plugin/src/main/java/io/cdap/plugin/oracle/OracleSource.java

@@ -71,6 +71,16 @@ protected Class<? extends DBWritable> getDBRecordType() {
     return OracleSourceDBRecord.class;
   }
 
+  @Override
+  protected String getExternalDocumentationLink() {
+    return DBUtils.ORACLE_SUPPORTED_DOC_URL;
+  }
+
+  @Override
+  protected String getErrorDetailsProviderClassName() {
+    return OracleErrorDetailsProvider.class.getName();
+  }
+
   @Override
   protected LineageRecorder getLineageRecorder(BatchSourceContext context) {
     String fqn = DBUtils.constructFQN("oracle",