feat(ingestion/oracle): add support for materialized view, stored procs and usage

metadata-ingestion/docs/sources/oracle/oracle.md

@@ -1 +1,12 @@
-As a SQL-based service, the Oracle integration is also supported by our SQL profiler. See here for more details on configuration.
+The Oracle source extracts metadata from Oracle databases, including:
+
+- **Tables and Views**: Standard relational tables and views with column information, constraints, and comments
+- **Stored Procedures**: Functions, procedures, and packages with source code, arguments, and dependency tracking
+- **Materialized Views**: Materialized views with proper lineage and refresh information
+- **Lineage**: Automatic lineage generation from stored procedure definitions and materialized view queries via SQL parsing
+- **Usage Statistics**: Query execution statistics and table access patterns (when audit data is available)
+- **Operations**: Data modification events (CREATE, INSERT, UPDATE, DELETE) from audit trail data
+
+The Oracle integration supports both thin mode (default, no Oracle client required) and thick mode (requires Oracle client installation) connections using the modern `python-oracledb` driver.
+
+As a SQL-based service, the Oracle integration is also supported by our SQL profiler for table and column statistics.

metadata-ingestion/docs/sources/oracle/oracle_pre.md

@@ -17,6 +17,11 @@ The following table contains a brief description of what each data dictionary vi
 | `ALL_CONSTRAINTS` or `DBA_CONSTRAINTS`             | Get constraint definitions on tables                  |
 | `ALL_CONS_COLUMNS` or `DBA_CONS_COLUMNS`           | Get list of columns that are specified in constraints |
 | `ALL_USERS` or `DBA_USERS`                         | Get all schema names                                  |
+| `ALL_OBJECTS` or `DBA_OBJECTS`                     | Get stored procedures, functions, and packages        |
+| `ALL_SOURCE` or `DBA_SOURCE`                       | Get source code for stored procedures and functions   |
+| `ALL_ARGUMENTS` or `DBA_ARGUMENTS`                 | Get arguments for stored procedures and functions     |
+| `ALL_DEPENDENCIES` or `DBA_DEPENDENCIES`           | Get dependency information for database objects       |
+| `ALL_MVIEWS` or `DBA_MVIEWS`                       | Get materialized views and their definitions          |
 
 #### Data Dictionary Views accessible information and required privileges
 

metadata-ingestion/docs/sources/oracle/oracle_recipe.yml

@@ -2,7 +2,7 @@ source:
   type: oracle
   config:
     # Coordinates
-    host_port: localhost:5432
+    host_port: localhost:1521
     database: dbname
 
     # Credentials
@@ -11,6 +11,28 @@ source:
 
     # Options
     service_name: svc # omit database if using this option
+
+    # Data Dictionary Mode
+    data_dictionary_mode: "ALL" # or "DBA" for full database access
+
+    # Stored Procedures
+    include_stored_procedures: true
+    procedure_pattern:
+      allow:
+        - "SCHEMA.*" # Include all procedures from SCHEMA
+      deny:
+        - "SYS.*"    # Exclude system procedures
+
+    # Materialized Views
+    include_materialized_views: true
+
+    # Usage and Operations (requires audit data or query logs)
+    include_usage_stats: true
+    include_operational_stats: true
+
+    # Oracle Client Configuration (optional)
+    enable_thick_mode: false # Set to true to use Oracle thick client
+    # thick_mode_lib_dir: "/path/to/oracle/client" # Required on Mac/Windows if thick mode enabled
 
 sink:
   # sink configs

metadata-ingestion/src/datahub/ingestion/autogenerated/capability_summary.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2025-10-23T14:26:01.879155+00:00",
+  "generated_at": "2025-10-27T17:35:54.648985+00:00",
   "generated_by": "metadata-ingestion/scripts/capability_summary.py",
   "plugin_details": {
     "abs": {
@@ -2130,12 +2130,19 @@
         },
         {
           "capability": "LINEAGE_FINE",
-          "description": "Enabled by default to get lineage for views via `include_view_column_lineage`",
+          "description": "Enabled by default to get lineage for stored procedures via `include_lineage` and for views via `include_view_column_lineage`",
           "subtype_modifier": [
+            "Stored Procedure",
             "View"
           ],
           "supported": true
         },
+        {
+          "capability": "USAGE_STATS",
+          "description": "Enabled by default via SQL aggregator when processing observed queries",
+          "subtype_modifier": null,
+          "supported": true
+        },
         {
           "capability": "DESCRIPTIONS",
           "description": "Enabled by default",
@@ -2162,8 +2169,9 @@
         },
         {
           "capability": "LINEAGE_COARSE",
-          "description": "Enabled by default to get lineage for views via `include_view_lineage`",
+          "description": "Enabled by default to get lineage for stored procedures via `include_lineage` and for views via `include_view_lineage`",
           "subtype_modifier": [
+            "Stored Procedure",
             "View"
           ],
           "supported": true