Instalación de Python y el controlador python-oracledb

Para conectarse a Autonomous Database desde la aplicación Python, instalación de Python y el controlador python-oracledb.

Instale Python 3 si aún no está disponible.

La versión de Python que utilice depende del sistema operativo y el hardware del cliente. Por ejemplo, Windows, Linux, macOS y otros.

Nota

Oracle recomienda mantenerse actualizado con las versiones de controlador Python y python-oracledb.
Instale el controlador python-oracledb desde PyPI.

El controlador python-oracledb es un módulo de extensión de lenguaje de programación Python que permite a los programas Python conectarse a Oracle Database. El controlador python-oracledb es la nueva versión principal con nombre cambiado del controlador cx_Oracle.

Versiones de controlador de python-oracledb admitidas: python-oracledb 1.0 (o posterior)
Ejecute el siguiente comando para actualizar python:
```
python -m pip install oracledb --upgrade
```
Aparecerá una pantalla similar a la siguiente:
```
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
```
Notas sobre la instalación de python-oracledb:
- Si está protegido por un proxy, utilice la opción --proxy para agregar un servidor proxy al comando. Por ejemplo:
```
python -m pip install oracledb --upgrade --proxy=http://proxy.example.com:80
```
- En caso de que no tenga permiso para escribir en los directorios del sistema, incluya la opción --user. Por ejemplo:
```
python -m pip install oracledb --upgrade --user
```
- Si no hay un paquete binario disponible para la plataforma, al ejecutar pip se descargará el paquete de origen en su lugar. Se compilará el origen y se instalará el binario resultante.
Consulte Instalación de python-oracledb para obtener más opciones y consejos.
Si desea utilizar el controlador python-oracledb en modo Grueso, instale el software de Oracle Client.

Por defecto, python-oracledb se ejecuta en modo Grueso, que se conecta directamente a Oracle Database. En el modo Grueso no se necesitan bibliotecas de Oracle Client. Sin embargo, hay algunas funciones adicionales disponibles cuando python-oracledb se ejecuta en modo grueso.

Nota

Consulte Funciones de Oracle Database soportadas por python-oracledb para obtener información sobre las funciones soportadas en los modos Fino y Grueso de python-oracledb. No están disponibles todas las funciones que se muestran en este enlace con Autonomous Database.

Python-oracledb utiliza el modo Thick cuando utiliza las bibliotecas de Oracle Instant Client o las bibliotecas de Oracle Database Client y llama a oracledb.init_oracle_client() en el código Python.

Al instalar el software de Oracle Client, existen diferencias en las versiones mínimas requeridas para las conexiones mTLS y TLS, de la siguiente manera:
- Conexiones TLS mutuas:
  - Si la base de datos está en una computadora remota, descargue el paquete gratuito Oracle Instant Client "Basic" o "Basic Light" para la arquitectura del sistema operativo. Utilice una versión soportada: Oracle Instant Client: 18.19 (o posterior), 19.2 (o posterior) o 21 (versión base o posterior).
  - También puede utilizar las bibliotecas de cliente de Full Oracle Database cuando estén disponibles en el sistema (incluido Full Oracle Database Client: Oracle Database Client: 18.19 (o posterior), 19.2 (o posterior) o 21 (versión base o posterior).
- Conexiones TLS: los clientes de Oracle Call Interface (OCI) soportan la autenticación TLS sin una cartera si utiliza las siguientes versiones de cliente:
  - Oracle Instant Client/Oracle Database Client 19.14 (o posterior) y 21.5 (o posterior): solo en Linux x64 y Windows
  - También puede utilizar las bibliotecas de cliente de Full Oracle Database cuando estén disponibles en el sistema, incluidos Full Oracle Database Client 19.14 (or later) y Full 21.5 (or later).

Tema principal: Conexión de aplicaciones Python a Autonomous Database

Documentación de Oracle Cloud Infrastructure