构建 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。

使用须知

您的开发系统必须满足某些标准才能成功配置。

它必须有互联网接入。
它必须具有对自治 AI 数据库的网络访问权限。

请参见 Configure a Development System to Access the Database ，了解如何确保开发系统满足此要求。

下载并安装 Python

Oracle Linux：

Oracle Linux 7 包含 Python 2。7，因此您只需运行以下命令：
```
sudo yum -y install oracle-release-el7
```
其他 OS 和体系结构：

转到 python.org Downloads（下载）页面，下载并安装适用于您的 OS 和体系结构的最新 Python 2。7 或 Python 3。5（或更高版本）。

下载和安装 Oracle Instant Client

您需要 Oracle Instant Client 库版本 19.6 或更高版本。

下载并安装适用于系统 OS 和体系结构的 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 。）
其他 OS 和体系结构：
1. 转到 Oracle Instant Client 下载页面，然后选择系统的操作系统和体系结构的下载。
2. 在下载页面上，接受 Oracle Technology Network 许可协议，下载最新版本的 Basic Package ，然后按照下载页面底部的说明进行安装。

下载并安装 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

其他 OS 和体系结构：

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

下载并安装数据库的客户端身份证明

将包含数据库客户端身份证明的 zip 文件下载到计算机上的安全目录。

可以从 Oracle Cloud 控制台中数据库的“详细信息”页下载此 zip 文件。如果您具有允许您访问此页的 Oracle Cloud 用户账户，请按如下方式下载身份证明。如果您没有这样的帐户，则需要从数据库的管理员那里获取 zip 文件，以及用于保护 zip 文件的密码。
1. 在 Web 浏览器中，登录到 Oracle Cloud 并导航到自治 AI 数据库的“详细信息”页面。
2. 单击 DB Connection（数据库连接）。
3. 在数据库连接页上，单击下载。
4. 在 Download Wallet（下载 Wallet）对话框中，在 Password（口令）字段中输入 wallet 密码，然后在 Confirm Password（确认口令）字段中输入该口令。
  
  密码长度必须至少为 8 个字符，并且必须至少包含 1 个字母和 1 个数字字符或 1 个特殊字符。
5. 单击 Download（下载）以将客户端凭据 zip 文件保存到安全目录。
下载 zip 文件后，请执行以下步骤：
1. 解压缩客户端身份证明 zip 文件。
2. 编辑客户端身份证明中提供的 sqlnet.ora 文件，将 "?/network/admin" 替换为您解压缩客户端身份证明的目录的完整路径；例如，更改：
```
 (DIRECTORY="?/network/admin")
```
  to
```
 (DIRECTORY="/users/jdoe/adbcredentials")
```
3. 创建 TNS_ADMIN 环境变量，将其值设置为解压缩客户机凭证的目录的完整路径。

代码数据库连接和 SQL 语句

将您的开发系统配置为支持与自治 AI 数据库的 Python 应用程序连接后，请遵循以下准则，以实现应用程序与数据库的连接的高性能和持续可用性：

使用连接池
启用 FAN（快速应用程序通知）。
使用与要执行的操作最匹配的预定义数据库服务。有关预定义数据库服务的信息，请参见 Predefined Database Service Names for Autonomous AI Database 。

例如：

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

此示例为与 tp_tls 数据库服务的连接创建池，并通过将 events 参数设置为 True 来启用 FAN。