機械翻訳について

Pythonおよびpython-oracledbドライバのインストール

PythonアプリケーションからAutonomous Databaseに接続するには、Pythonおよびpython-oracledbドライバをインストールします。

  1. Python 3がインストールされていない場合はインストールします。

    使用するPythonのバージョンは、クライアント側のOSおよびハードウェアによって異なります。 たとえば、Windows、Linux、macOSなどです。

    ノート:

    Oracleでは、Pythonおよびpython-oracledbドライバ・リリースを最新の状態に保つことをお薦めします。
  2. python-oracledbドライバをPyPIからインストールします。

    python-oracledbドライバは、PythonプログラムでOracle Databaseに接続できる「Pythonプログラミング言語」拡張モジュールです。 python-oracledbドライバは、一般的なcx_Oracleドライバの名前が変更された新しいメジャー・リリースです。

    サポートされているpython-oracledbドライバのバージョン: python-oracledb 1.0 (以降)

    次のコマンドを実行して、pythonをアップグレードします:

    python -m pip install oracledb --upgrade

    次のような出力が表示されます。

    Collecting oracledb
  Downloading oracledb-1.0.3-cp310-cp310-win_amd64.whl (1.0 MB)
     ---------------------------------------- 1.0/1.0 MB 1.8 MB/s eta 0:00:00
Collecting cryptography>=3.4
  Downloading cryptography-37.0.4-cp36-abi3-win_amd64.whl (2.4 MB)
     ---------------------------------------- 2.4/2.4 MB 3.5 MB/s eta 0:00:00
Collecting cffi>=1.12
  Downloading cffi-1.15.1-cp310-cp310-win_amd64.whl (179 kB)
     ---------------------------------------- 179.1/179.1 kB 5.4 MB/s eta 0:00:00
Collecting pycparser
  Downloading pycparser-2.21-py2.py3-none-any.whl (118 kB)
     ---------------------------------------- 118.7/118.7 kB 7.2 MB/s eta 0:00:00
Installing collected packages: pycparser, cffi, cryptography, oracledb
Successfully installed cffi-1.15.1 cryptography-37.0.4 oracledb-1.0.3 pycparser-2.21

    python-oracledbのインストールに関するノート:

    • プロキシの背後にいる場合は、--proxyオプションを使用して、コマンドにプロキシ・サーバーを追加します。 たとえば: 

      python -m pip install oracledb --upgrade --proxy=http://proxy.example.com:80

    • システム・ディレクトリへの書き込み権限がない場合は、--userオプションを含めます。 たとえば: 

      python -m pip install oracledb --upgrade --user

    • 使用しているプラットフォームでバイナリ・パッケージを使用できない場合、pipを実行すると、かわりにソース・パッケージがダウンロードされます。 ソースがコンパイルされ、結果のバイナリがインストールされます。

    その他のオプションおよびヒントについては、「python-oracledbのインストール」を参照してください。

  3. python-oracledbドライバをThickモードで使用する場合は、Oracle Clientソフトウェアをインストールします。

    デフォルトでは、python-oracledbは、Oracle Databaseに直接接続するシン・モードで実行されます。 シン・モードでは、Oracle Clientライブラリは必要ありません。 ただし、python-oracledbがThickモードで実行されている場合、いくつかの追加機能を使用できます。

    ノート:

    python-oracledb ThinおよびThickモードでサポートされている機能の詳細は、「Oracle Database python-oracledbでサポートされる機能」を参照してください。 このリンクに示されているすべての機能がAutonomous Databaseで使用できるわけではありません。

    Python-oracledbでは、Oracle Instantクライアント・ライブラリまたはOracle Databaseクライアント・ライブラリのいずれかを使用し、Pythonコードでoracledb.init_oracle_client()をコールすると、Thickモードが使用されます。

    Oracle Clientソフトウェアをインストールする場合、mTLSおよびTLS接続に必要な最小バージョンが次のように異なります:

    • 相互TLS (mTLS)接続:

      • データベースがリモート・コンピュータにある場合は、オペレーティング・システム・アーキテクチャ用の無料のOracle Instant Client "Basic"または"Basic Light"パッケージをダウンロードします。 サポートされているバージョンを使用: Oracle Instant Client: 18.19(以降)、19.2 (以降)、または21 (ベース・リリース以降)。

      • または、フルOracle Databaseクライアント・ライブラリがシステムで使用可能な場合(フルOracle Databaseクライアントを含む)も使用できます: Oracle Databaseクライアント: 18.19(以降)、19.2 (以降)、または21 (ベース・リリース以降)。

    • TLS接続 : 次のクライアント・バージョンを使用している場合、Oracle Call Interface (OCI)クライアントはTLS認証財布なしをサポートします:

      • Oracle Instant Client/Oracle Database Client 19.14 (以降)および21.5 (以降) - Linux x64およびWindowsでのみ

      • または、フルOracle Databaseクライアント・ライブラリ(フルOracle Databaseクライアント19.14 (以降)および21.5 (以降)を含む)がシステムで使用可能な場合は、フルOracle Databaseクライアント・ライブラリを使用できます。

親トピック: Autonomous DatabaseへのPythonアプリケーションの接続