构建 Python 应用程序

要构建可访问自治 AI 数据库的 Python 应用，您需要首先配置开发系统以支持数据库访问，以利用 Autonomous AI Database 的持续可用性和高性能功能。

配置开发系统后，可以在应用程序中对数据库连接和 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。

使用须知

您的开发系统必须符合某些标准才能成功配置它。

它必须有互联网接入。
它必须具有对 Autonomous AI Database 的网络访问权限。

要了解如何确保开发系统满足此要求，请参阅配置开发系统以访问数据库。

下载并安装 Python

Oracle Linux：

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

转到 python.org 下载页面，下载并安装适用于您的 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。）
其他 OSes 和体系结构：
1. 转到 Oracle Instant Client 下载页，然后为您的系统的 OS 和体系结构选择下载。
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

其他 OSes 和体系结构：

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

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

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

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

其他资源

有关 cx_Oracle 的详细信息，请访问 cx_Oracle 文档页面。

有关演示各种 cx_Oracle 功能的代码示例，请转到 python-cx_Oracle 样例文件夹。

标题和版权信息

Oracle 和/或其关联公司。