建置 Python 應用程式

若要建置可存取自治式 AI 資料庫的 Python 應用程式，首先要設定開發系統以支援資料庫存取，以利用自治式 AI 資料庫的持續可用性和高效能功能。

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

提示：如需閱讀下列主題的「試試看」替代方案，請瀏覽 Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop 中的 Lab 4：Build Python Application Stacks 。

設定您的 Python 開發系統

若要設定您的開發系統，讓 Python 應用程式充分利用自治式 AI 資料庫的持續可用性和高效能功能，請執行下列步驟。

下載和安裝 Python。
下載並安裝 Oracle Instant Client。
下載與安裝 cx_Oracle。
下載資料庫的從屬端證明資料，並讓它們可供 Oracle Instant Client 使用。

Before You Begin - 開始之前

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

它必須具備網際網路存取權。
它必須具備自治式 AI 資料庫的網路存取權。

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

下載並安裝 Python

Oracle Linux：

Oracle Linux 7 包含 Python 2。7，因此您只要執行此命令即可：
```
sudo yum -y install oracle-release-el7
```
其他作業系統與架構：

請前往 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 。)
其他作業系統與架構：
1. 前往 Oracle Instant Client 下載頁面，並選取您系統作業系統和架構的下載項目。
2. 在下載頁面上，接受 Oracle Technology Network 授權合約、下載最新版本的基本套件，然後依照下載頁面底部的指示進行安裝。

下載並安裝 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

其他作業系統與架構：

執行此命令：
```
python -m pip install cx_Oracle --upgrade
```

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

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

您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有一個允許您存取此頁面的 Oracle Cloud 使用者帳戶，請下載下列證明資料。如果您沒有這樣的帳戶，您必須將 zip 檔案與資料庫管理員取得，以及用來保護 zip 檔案的密碼一起取得。
1. 在 Web 瀏覽器中，登入 Oracle Cloud 並瀏覽至「自治式 AI 資料庫」的「詳細資訊」頁面。
2. 按一下資料庫連線。
3. 在資料庫連線頁面中，按一下下載。
4. 在下載公事包對話方塊中，於密碼欄位中輸入一個公事包密碼，然後在確定密碼欄位中確認該密碼。
  
  密碼長度至少必須包含 8 個字元，且必須包含至少 1 個字母及 1 個數字字元或 1 個特殊字元。
5. 按一下下載，將從屬端證明資料壓縮檔儲存至安全目錄。
下載壓縮檔之後，請遵循下列步驟：
1. 解壓縮從屬端證明資料壓縮檔。
2. 編輯從屬端證明資料中提供的 sqlnet.ora 檔案，將 "?/network/admin" 取代為您解壓縮從屬端證明資料之目錄的完整路徑；例如，變更：
```
 (DIRECTORY="?/network/admin")
```
  to
```
 (DIRECTORY="/users/jdoe/adbcredentials")
```
3. 建立 TNS_ADMIN 環境變數，將其值設為您解壓縮從屬端證明資料之目錄的完整路徑。

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

將開發系統設定為支援與自治式 AI 資料庫的 Python 應用程式連線之後，請遵循下列準則，以實現應用程式與資料庫連線的高效能和持續可用性：

使用連線集區。
啟用 FAN (快速申請通知)。
使用最符合將執行之作業的預先定義資料庫服務。如需預先定義之資料庫服務的相關資訊，請參閱自治式 AI 資料庫的預先定義資料庫服務名稱。

舉例而言：

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

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