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

1. Python 3がまだ使用できない場合は、それをインストールします。

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

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

   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に直接接続されるThinモードで実行されます。Thinモードでは、Oracle Clientライブラリは必要ありません。ただし、python-oracledbがThickモードで実行されている場合、いくつかの追加機能を使用できます。

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

   Python-oracledbでは、Oracle Instantクライアント・ライブラリまたはOracle Database Clientライブラリのいずれかを使用し、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 Clientを含む: Oracle Database Client: 18.19 (以上)、19.2 (以上)、または21 (ベース・リリース以上)。

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

     • Oracle Instant Client/Oracle Database Client 19.14 (以上)および21.5 (以上) - すべてのプラットフォーム

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

クライアント・セキュリティ資格証明を取得して、Autonomous Databaseインスタンスに接続します。

1. Autonomous Databaseインスタンスからウォレット・ファイルをダウンロードして、Autonomous Databaseインスタンスへのアクセスに必要なクライアント・セキュリティ資格証明およびネットワーク構成設定が含まれるzipファイルを取得します。

   クライアント・セキュリティ資格証明(wallet.zipファイル):

   • ADMINユーザー: Oracle Cloud Infrastructureコンソールで、「データベース接続」をクリックします。クライアント資格証明(ウォレット)のダウンロードを参照してください。

   • 他のユーザー(非管理者): Autonomous Databaseインスタンスの管理者からOracle Walletを取得します。

   ノート
   
   不正なデータベース・アクセスを防ぐために、wallet.zipファイルとそのコンテンツを保護してください。
2. クライアント資格証明ファイル(wallet.zip)を解凍します。

デフォルトでは、python-oracledbはThinモードを使用してAutonomous Databaseインスタンスに直接接続します。

1. tnsnames.oraおよびewallet.pemファイルをシステム上の場所に移動します。
   • Linux
   • Windows

   たとえば、Linuxでは次のようにします。

   /opt/OracleCloud/MYDB

   たとえば、Windowsでは次のように指定します。

   C:\opt\OracleCloud\MYDB

2. Pythonアプリケーションで、Autonomous Databaseインスタンスに接続するために次の接続パラメータを設定します:
   • config_dir: tnsnames.oraを含むディレクトリを指定します。
   • dsn: tnsnames.oraファイルから目的のネットワーク別名を指定するために使用します。
   • password: データベース・ユーザー・パスワードを指定します。
   • user: データベース・ユーザーを指定します。
   • wallet_location: PEMファイル(ewallet.PEM)を含むディレクトリを指定します。
   • wallet_password: PEMファイル(ewallet.PEM)のパスワードを指定します。このパスワードは、wallet.zipファイルのダウンロード時に設定します。
   • Linux
   • Windows

   たとえば、Linuxでは、db2024_lowネットワーク・サービス名でoracledb.connectを使用してADMINユーザーとして接続します(サービス名はtnsnames.oraにあります)。

   connection=oracledb.connect(
        config_dir="/opt/OracleCloud/MYDB",
        user="admin",
        password=password,
        dsn="db2024_low",
        wallet_location="/opt/OracleCloud/MYDB",
        wallet_password=wallet_pw)

   たとえば、Windowsでは、db2024_lowネットワーク・サービス名でoracledb.connectを使用してADMINユーザーとして接続します(サービス名はtnsnames.oraにあります)。

   connection=oracledb.connect(
        config_dir=r"C:\opt\OracleCloud\MYDB",
        user="admin",
        password=password,
        dsn="db2024_low",
        wallet_location=r"C:\opt\OracleCloud\MYDB",
        wallet_password=wallet_pw)

   'raw'文字列r"..."を使用すると、バックスラッシュはディレクトリ・セパレータとして扱われます。

   この例に示すように、wallet_locationとconfig_dirは同じディレクトリに設定されます(ディレクトリにはtnsnames.oraとewallet.pemが含まれます)。これらのファイルに同じディレクトリを指定することは必須ではありません。

connection=oracledb.connect(
     config_dir="/opt/OracleCloud/MYDB",
     user="admin",
     password=password,
     dsn="db2024_low",
     wallet_location="/opt/OracleCloud/MYDB",
     wallet_password=wallet_pw,
     https_proxy='myproxy.example.com',
     https_proxy_port=80)

connection=oracledb.connect(
     config_dir=r"C:\opt\OracleCloud\MYDB",
     user="admin",
     password=password,
     dsn="db2024_low",
     wallet_location=r"C:\opt\OracleCloud\MYDB",
     wallet_password=wallet_pw,
     https_proxy='myproxy.example.com',
     https_proxy_port=80)

1. ファイルtnsnames.ora、sqlnet.oraおよびcwallet.ssoをシステムに配置します。

   次の2つのオプションのいずれかを使用して、これらのファイルをシステムに配置します。

   • インスタント・クライアントを使用している場合は、ファイルをインスタント・クライアント・ディレクトリ下のnetwork/adminサブディレクトリ階層に移動します。たとえば、アーキテクチャやクライアント・システム、およびインスタント・クライアントをインストールした場所に応じて、ファイルを次のようなディレクトリの場所に配置する必要があります:

     /home/myuser/instantclient_19_21/network/admin

     OR

     /usr/lib/oracle/19.21/client64/lib/network/admin

     たとえば、Linuxでは、完全なOracle Clientを使用している場合は、ファイルを$ORACLE_HOME/network/adminに移動します。

   • または、ファイルをアクセス可能なディレクトリに移動します。

     たとえば、Linuxでは、ファイルを/opt/OracleCloud/MYDBディレクトリに移動し、sqlnet.oraを編集して、ウォレットの場所のディレクトリをcwallet.ssoファイルを含むディレクトリに変更します。

     たとえば、Linuxでは、次のようにsqlnet.oraを編集します:

     WALLET_LOCATION = (SOURCE = (METHOD=file) (METHOD_DATA = (DIRECTORY="/opt/OracleCloud/MYDB")))
     SSL_SERVER_DN_MATCH=yes

     構成ファイルがデフォルトの場所に存在しない場合、アプリケーションでは、コールoracledb.init_oracle_client()のconfig_dirパラメータを使用して、またはTNS_ADMIN環境変数を設定して、ファイルが存在する場所を示す必要があります。

     ノート
     
     network/adminディレクトリにすべての構成ファイルを配置する場合、sqlnet.oraはいずれの設定も必要なく、編集する必要はありません。
2. Pythonアプリケーションで、Autonomous Databaseインスタンスに接続するために次の初期化パラメータおよび接続パラメータを設定します:
   • config_dir: 構成ファイルを配置する際の構成ディレクトリを指定します。これは、構成ファイルがインスタント・クライアント構成ディレクトリnetwork/adminの外部のディレクトリに配置されている場合にのみ必要です。
   • dsn: tnsnames.oraファイルから目的のネットワーク別名を指定します。
   • password: データベース・ユーザー・パスワードを指定します。
   • user: データベース・ユーザーを指定します。

   構成ファイルを配置する最初のケースでは、tnsnames.oraから目的のネットワーク別名にdsnパラメータを設定して、データベース資格証明を使用してAutonomous Databaseインスタンスに接続します。

   たとえば、oracledb.init_oracle_clientを使用してADMINユーザーとして接続し、db2024_lowネットワーク・サービス名で接続するには(tnsnames.oraにサービス名があります):

   oracledb.init_oracle_client()
      connection=oracledb.connect(
          user="admin",
          password=password,
          dsn="db2024_low")

   構成ファイルがインスタント・クライアント構成ディレクトリ外のディレクトリにある場合は、oracledb.init_oracle_clientをコールするときにconfig_dirパラメータを設定します。

   • Linux
   • Windows

   たとえば、Linuxでは、db2024_lowネットワーク・サービス名を使用してADMINユーザーとして接続します。

   oracledb.init_oracle_client(config_dir="/opt/OracleCloud/MYDB")
      connection=oracledb.connect(
         user="admin",
         password=password,
         dsn="db2024_low")

   たとえば、Windowsでは、db2024_lowネットワーク・サービス名を使用してADMINユーザーとして接続します。

   oracledb.init_oracle_client(config_dir=r"C:\opt\OracleCloud\MYDB")
      connection=oracledb.connect(
         user="admin",
         password=password,
         dsn="db2024_low")

   'raw'文字列r"..."を使用すると、バックスラッシュはディレクトリ・セパレータとして扱われます。

SQLNET.USE_HTTPS_PROXY=on

mydb_high=(description=
(address=(https_proxy=myproxy.example.com)
(https_proxy_port=80)
(protocol=tcps)(port=1522)(host=...)