Skip to content

Migrate oracle provider to oracle-oracledb #71325

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eladkal wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Migrate oracle provider to oracle-oracledb #71325

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 15 additions & 12 deletions providers/oracle/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,20 +23,23 @@

Package ``apache-airflow-providers-oracle``

Release: ``4.6.2``
Release: ``4.6.3``


`Oracle <https://www.oracle.com/database/technologies/>`__

**Deprecated.** All functionality has moved, unchanged, to
``apache-airflow-providers-oracle-oracledb``. See the changelog below for the migration guide.

Provider package
----------------

This is a provider package for ``oracle`` provider. All classes for this provider package
are in ``airflow.providers.oracle`` python package.
are in ``airflow.providers.oracle`` python package, and now re-export the equivalent
classes from ``airflow.providers.oracle.oracledb``.

You can find package information and changelog for the provider
in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-oracle/4.6.2/>`_.
in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-oracle/4.6.3/>`_.

Installation
------------
Expand All @@ -50,14 +53,14 @@ The package supports the following python versions: 3.10,3.11,3.12,3.13,3.14
Requirements
------------

========================================== ==================
PIP package Version required
========================================== ==================
``apache-airflow`` ``>=2.11.0``
``apache-airflow-providers-common-compat`` ``>=1.8.0``
``apache-airflow-providers-common-sql`` ``>=1.32.0``
``oracledb`` ``>=2.3.0``
========================================== ==================
=========================================== ==================
PIP package Version required
=========================================== ==================
``apache-airflow`` ``>=2.11.0``

@eladkal eladkal Aug 8, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we may want to limit the apache-airflow version here also to <3.4.0
That way we are making sure that users of new Airflow versions will not still use the old provider.

``apache-airflow-providers-common-compat`` ``>=1.8.0``
``apache-airflow-providers-common-sql`` ``>=1.32.0``
``apache-airflow-providers-oracle-oracledb`` ``>=4.6.3``
=========================================== ==================

Optional cross provider package dependencies
--------------------------------------------
Expand Down Expand Up @@ -89,4 +92,4 @@ Extra Dependencies
=============== ============================================================================================================================================================================================================================================

The changelog for the provider package can be found in the
`changelog <https://airflow.apache.org/docs/apache-airflow-providers-oracle/4.6.2/changelog.html>`_.
`changelog <https://airflow.apache.org/docs/apache-airflow-providers-oracle/4.6.3/changelog.html>`_.
33 changes: 33 additions & 0 deletions providers/oracle/docs/changelog.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,39 @@
Changelog
---------

4.6.3
.....

``apache-airflow-providers-oracle`` is now **deprecated**. All functionality has moved,
unchanged, to the new ``apache-airflow-providers-oracle-oracledb`` provider. Installing
``apache-airflow-providers-oracle`` now pulls in ``apache-airflow-providers-oracle-oracledb``
as a dependency, and the old import paths keep re-exporting the same classes so existing
Dags keep working, but every import now raises a ``DeprecatedImportWarning``.

To migrate:

* Add ``apache-airflow-providers-oracle-oracledb`` to your dependencies (you can drop
``apache-airflow-providers-oracle`` once you finish migrating).
* Update your imports:

============================================================================== ============================================================================
Old import (deprecated) New import
============================================================================== ============================================================================
``airflow.providers.oracle.hooks.oracle.OracleHook`` ``airflow.providers.oracle.oracledb.hooks.oracle.OracleHook``
``airflow.providers.oracle.hooks.handlers`` ``airflow.providers.oracle.oracledb.hooks.handlers``
``airflow.providers.oracle.operators.oracle.OracleStoredProcedureOperator`` ``airflow.providers.oracle.oracledb.operators.oracle.OracleStoredProcedureOperator``
``airflow.providers.oracle.transfers.oracle_to_oracle.OracleToOracleOperator`` ``airflow.providers.oracle.oracledb.transfers.oracle_to_oracle.OracleToOracleOperator``
``airflow.providers.oracle.assets.oracle`` ``airflow.providers.oracle.oracledb.assets.oracle``
============================================================================== ============================================================================

Connection type (``oracle``), connection ids, and behavior are unchanged — only the
python import path moves.

Misc
~~~~

* ``Deprecate apache-airflow-providers-oracle in favor of apache-airflow-providers-oracle-oracledb``

4.6.2
.....

Expand Down
6 changes: 6 additions & 0 deletions providers/oracle/docs/connections/oracle.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,12 @@

.. _howto/connection:oracle:

.. warning::
``apache-airflow-providers-oracle`` is deprecated. Install
``apache-airflow-providers-oracle-oracledb`` instead and see its
`connection documentation <https://airflow.apache.org/docs/apache-airflow-providers-oracle-oracledb/stable/connections/oracle.html>`__.
The ``oracle`` connection type and its configuration are unchanged.

Oracle Connection
=================
The Oracle connection type provides connection to a Oracle database.
Expand Down
31 changes: 19 additions & 12 deletions providers/oracle/docs/index.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@
``apache-airflow-providers-oracle``
===================================

.. warning::
This provider is **deprecated**. All functionality has moved, unchanged, to
``apache-airflow-providers-oracle-oracledb``. See the :doc:`changelog <changelog>`
for the migration guide.

.. toctree::
:hidden:
Expand Down Expand Up @@ -76,14 +80,17 @@ apache-airflow-providers-oracle package

`Oracle <https://www.oracle.com/database/technologies/>`__

This provider is deprecated. All functionality has moved, unchanged, to
``apache-airflow-providers-oracle-oracledb``.

Release: 4.6.2
Release: 4.6.3

Provider package
----------------

This package is for the ``oracle`` provider.
All classes for this package are included in the ``airflow.providers.oracle`` python package.
All classes for this package are included in the ``airflow.providers.oracle`` python package,
and now re-export the equivalent classes from ``airflow.providers.oracle.oracledb``.

Installation
------------
Expand All @@ -97,14 +104,14 @@ Requirements

The minimum Apache Airflow version supported by this provider distribution is ``2.11.0``.

========================================== ==================
PIP package Version required
========================================== ==================
``apache-airflow`` ``>=2.11.0``
``apache-airflow-providers-common-compat`` ``>=1.8.0``
``apache-airflow-providers-common-sql`` ``>=1.32.0``
``oracledb`` ``>=2.3.0``
========================================== ==================
=========================================== ==================
PIP package Version required
=========================================== ==================
``apache-airflow`` ``>=2.11.0``
``apache-airflow-providers-common-compat`` ``>=1.8.0``
``apache-airflow-providers-common-sql`` ``>=1.32.0``
``apache-airflow-providers-oracle-oracledb`` ``>=4.6.3``
=========================================== ==================

Optional cross provider package dependencies
--------------------------------------------
Expand Down Expand Up @@ -149,5 +156,5 @@ Downloading official packages
You can download officially released packages and verify their checksums and signatures from the
`Official Apache Download site <https://downloads.apache.org/airflow/providers/>`_

* `The apache-airflow-providers-oracle 4.6.2 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2.tar.gz.sha512>`__)
* `The apache-airflow-providers-oracle 4.6.2 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.2-py3-none-any.whl.sha512>`__)
* `The apache-airflow-providers-oracle 4.6.3 sdist package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3.tar.gz>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3.tar.gz.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3.tar.gz.sha512>`__)
* `The apache-airflow-providers-oracle 4.6.3 wheel package <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3-py3-none-any.whl>`_ (`asc <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3-py3-none-any.whl.asc>`__, `sha512 <https://downloads.apache.org/airflow/providers/apache_airflow_providers_oracle-4.6.3-py3-none-any.whl.sha512>`__)
7 changes: 7 additions & 0 deletions providers/oracle/docs/operators.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,13 @@

.. _howto/operator:OracleOperator:

.. warning::
``apache-airflow-providers-oracle`` is deprecated. Install
``apache-airflow-providers-oracle-oracledb`` instead and see its
`operators documentation <https://airflow.apache.org/docs/apache-airflow-providers-oracle-oracledb/stable/operators.html>`__.
The classes below keep working from their old import paths for now, but emit a
deprecation warning; see the :doc:`changelog <changelog>` for the full migration guide.

SQLExecuteQueryOperator to connect to Oracle
============================================

Expand Down
1 change: 1 addition & 0 deletions providers/oracle/oracledb/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
*.iml
Loading
Loading