建置 Python 應用程式

若要建置可存取 Autonomous Database 的 Python 應用程式,請先設定開發系統來支援資料庫存取,以利用 Autonomous Database 的持續可用性和高效能功能。

設定開發系統之後,您可以對應用程式中的資料庫連線和 SQL 敘述句編寫程式碼,以利用這些功能。

秘訣:

如需閱讀下列主題的「試用」替代方案,請前往《 Oracle Autonomous Database Dedicated for Developers and Database Users Workshop 》中的 Lab 4:Build Python Application Stacks

配置您的 Python 開發系統

若要設定您的開發系統,讓您的 Python 應用程式能夠充分利用 Autonomous Database 的持續可用性和高效能功能,請執行下列步驟。

  1. 下載並安裝 Python。
  2. 下載並安裝 Oracle Instant Client。
  3. 下載並安裝 cx_Oracle。
  4. 下載資料庫的用戶端憑證,並將其提供給 Oracle Instant Client 使用。

Before You Begin - 開始之前

您的開發系統必須符合特定條件才能順利設定。

  • 它必須能夠存取網際網路。

  • 它必須具備 Autonomous Database 的網路存取權。

    請參閱設定開發系統以存取資料庫,瞭解如何確保您的開發系統符合此需求。

下載並安裝 Python

  • Oracle Linux:

    Oracle Linux 7 包含 Python 2。7,因此您只要執行此命令即可:

    sudo yum -y install oracle-release-el7
  • 其他 OSes 與架構:

    請前往 python.org 下載頁面,下載並安裝最新的 Python 2。7 或 Python 3。5 (或更新版本) 版本供您的作業系統和架構使用。

下載並安裝 Oracle Instant Client

您需要 Oracle Instant Client 程式庫版本 19.6 或更新版本。

下載並安裝適用於系統作業系統與架構的 Oracle Instant Client 基本套裝軟體:

  • Oracle Linux:

    執行下列指令以下載和安裝 Oracle Instant Client 基本套裝軟體:

    sudo yum -y install oracle-release-el7
    sudo yum -y install oracle-instantclient19.3-basic

    (如果您要查看所有 Instant Client 套裝軟體的清單,請前往 http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html。)

  • 其他 OSes 與架構:

    1. 請前往 Oracle Instant Client 下載項目頁面,選取您系統作業系統與架構的下載項目。

    2. 在下載頁面上,接受 Oracle Technology Network License Agreement,下載最新版本的基本套件,然後依照下載頁面底部的指示進行安裝。

下載並安裝 cx_Oracle

使用 Python 的 pip 套裝軟體從 PyPI (Python 套裝軟體索引) 安裝 cx_Oracle

  • Oracle Linux:

    執行下列命令以下載 pip 套裝程式,然後用來安裝 cx_Oracle

    sudo yum -y install oracle-release-el7
    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
    sudo python get-pip.py
    python -m pip install cx_Oracle --upgrade
  • 其他 OSes 與架構:

    執行此命令:

    python -m pip install cx_Oracle --upgrade

下載並安裝資料庫的從屬端證明資料

  1. 將包含您資料庫之從屬端證明資料的壓縮檔下載至您電腦上的安全目錄。

    您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有允許您存取此頁面的 Oracle Cloud 使用者帳戶,請下載下列證明資料。如果您沒有此帳戶,則必須從資料庫管理員取得 zip 檔案,以及用來保護 zip 檔案的密碼。

    1. 在 Web 瀏覽器中,登入 Oracle Cloud 並瀏覽至 Autonomous Database 的「詳細資訊」頁面。

    2. 按一下資料庫連線

    3. 資料庫連線頁面上,按一下下載

    4. 下載公事包對話方塊的密碼欄位中輸入公事包密碼,然後在確認密碼欄位中確認密碼。

      密碼的長度至少要有 8 個字元,而且至少必須包含 1 個字元、1 個數字字元或 1 個特殊字元。

    5. 按一下下載,將用戶端憑證 zip 檔案儲存至安全目錄。

  2. 下載壓縮檔之後,請依照下列步驟進行:

    1. 解壓縮從屬端證明資料壓縮檔。

    2. 編輯從屬端證明資料中提供的 sqlnet.ora 檔案,以您解壓縮從屬端證明資料之目錄的完整路徑取代 "?/network/admin";例如,變更:

      (DIRECTORY="?/network/admin")

      到:

      (DIRECTORY="/users/jdoe/adbcredentials")
    3. 建立 TNS_ADMIN 環境變數,將其值設為您解壓縮從屬端證明資料的目錄完整路徑。

程式碼資料庫連線和 SQL 敘述句

設定您的開發系統以支援與 Autonomous Database 的 Python 應用程式連線之後,請遵循下列準則,以實現應用程式與資料庫連線的高效能和持續可用性:

舉例而言:

pool = cx_Oracle.SessionPool("appuser",
                             SampleEnv.GetMainPassword(),
                             "tp_tls",
                             events=True,
                             threaded=True)

此範例會為連線至 tp_tls 資料庫服務的連線建立集區,並透過將 events 參數設為 True 來啟用 FAN。

其他資源

如需有關 cx_Oracle 的詳細資訊,請移至 cx_Oracle 文件頁面。

如需示範各種 cx_Oracle 功能的程式碼範例,請移至 python-cx_Oracle samples 資料夾。