Add support for Oracle databases & dialect in PyDough

.github/workflows/oracle_testing.yml

@@ -0,0 +1,69 @@
+name: Run Oracle Tests
+
+on:
+  workflow_call:
+    inputs:
+      python-versions:
+        description: "JSON string of Python versions"
+        type: string
+        required: true
+    secrets:
+      ORACLE_PASSWORD:
+        required: true
+
+jobs:
+  oracle-tests:
+    name: Oracle Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ${{ fromJSON(inputs.python-versions) }}
+
+    # Define services here to run Docker containers alongside your job
+    services:
+      oracle:
+        image: bodoai1/pydough-oracle-tpch:latest
+        env:
+          # Set environment variables for Oracle container
+          ORACLE_PWD: ${{ secrets.ORACLE_PASSWORD }}
+        ports:
+          - 1521:1521
+    env:
+      ORACLE_PASSWORD: ${{ secrets.ORACLE_PASSWORD }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        id: setup-python
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "0.4.23"
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install dependencies
+        run: uv pip install -e ".[oracle]"
+
+      - name: Wait for TPCH data to load
+        run: |
+          for i in {1..600}; do
+            if docker logs ${{ job.services.oracle.id }} 2>&1 | grep -q "02_tpch_data.sh"; then
+              echo "TPCH data loaded"
+              break
+            fi
+            echo "Waiting for TPCH load... ($i/600)"
+            sleep 5
+          done
+
+      - name: Confirm Oracle connector is installed
+        run: uv run python -c "import oracledb; print('Oracle connector installed')"
+
+      - name: Run Oracle Tests
+        run: uv run pytest -m oracle tests/ -rs

.github/workflows/pr_testing.yml

@@ -49,6 +49,11 @@ on:
         description: "Run Postgres Tests"
         type: boolean
         required: false
+        default: false   
+      run-oracle:
+        description: "Run Oracle Tests"
+        type: boolean
+        required: false
         default: false        
       run-sf_masked:
         description: "Run Snowflake Masked Tests"
@@ -168,7 +173,7 @@ jobs:
         run: uv run ruff check .
 
       - name: Run Tests
-        run: uv run pytest tests/ -m "not (snowflake or mysql or postgres or sf_masked or s3 or bodosql)" -rs
+        run: uv run pytest tests/ -m "not (snowflake or mysql or postgres or sf_masked or s3 or bodosql or oracle)" -rs
 
   run-defog-daily-update:
     name: Run DEFOG Daily Update
@@ -286,3 +291,19 @@ jobs:
       python-versions: ${{ github.event_name == 'workflow_dispatch'
                       && needs.get-py-ver-matrix.outputs.matrix
                       || '["3.10", "3.11", "3.12", "3.13"]' }}
+
+  run-oracle-tests:
+    name: Oracle Tests
+    needs: [get-msg, get-py-ver-matrix]
+    if: |
+      (github.event_name == 'pull_request' && contains(needs.get-msg.outputs.commitMsg, '[run all]')) ||
+      (github.event_name == 'pull_request' && contains(needs.get-msg.outputs.commitMsg, '[run dialects]')) ||
+      (github.event_name == 'pull_request' && contains(needs.get-msg.outputs.commitMsg, '[run oracle]')) ||
+      (github.event_name == 'workflow_dispatch' && (inputs.run-all || inputs.run-dialects || inputs.run-oracle))
+    uses: ./.github/workflows/oracle_testing.yml
+    secrets:
+      ORACLE_PASSWORD: ${{ secrets.ORACLE_PASSWORD }}
+    with:
+      python-versions: ${{ github.event_name == 'workflow_dispatch'
+                      && needs.get-py-ver-matrix.outputs.matrix
+                      || '["3.10", "3.11", "3.12", "3.13"]' }}

demos/README.md

@@ -27,4 +27,5 @@ Once the introduction notebook is complete, you can explore the other notebooks:
 - [SF_TPCH_q1.ipynb](notebooks/SF_TPCH_q1.ipynb) demonstrates how to connect a Snowflake database with PyDough.
 - [MySQL_TPCH.ipynb](notebooks/MySQL_TPCH.ipynb) demonstrates how to connect a MySQL database with PyDough.
 - [PG_TPCH.ipynb](notebooks/PG_TPCH.ipynb) demonstrates how to connect a Postgres database with PyDough.
+- [Oracle_TPCH.ipynb](notebooks/Oracle_TPCH.ipynb) demonstrates how to connect an Oracle database with PyDough.