Para estabelecer conexão com o Autonomous Database usando o aplicativo Python, instale o driver Python e o driver python-oracledb.

1. Instale o Python 3, se ele ainda não estiver disponível.

   A versão do Python que você usa depende do sistema operacional e do hardware do cliente. Por exemplo, Windows, Linux, macOS e outros.

   Observação
   
   A Oracle recomenda que você se mantenha atualizado com as releases do driver Python e python-oracledb.
2. Instale o driver python-oracledb em PyPI.

   O driver python-oracledb é um módulo de extensão da linguagem de programação Python que permite que programas Python se conectem ao Oracle Database. O driver python-oracledb é a nova release principal renomeada do driver cx_Oracle popular.

   Versões suportadas do driver python-oracledb: python-oracledb 1.0 (ou mais recente)

   Execute o seguinte comando para fazer upgrade do python:

   python -m pip install oracledb --upgrade

   Você deverá ver uma saída semelhante a esta:

   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

   Observações da instalação do python-oracledb:

   • Se você estiver usando um proxy, utilize a opção --proxy para adicionar um servidor proxy ao comando. Por exemplo:

     python -m pip install oracledb --upgrade --proxy=http://proxy.example.com:80

   • No caso em que você não tiver permissão para gravar nos diretórios do sistema, inclua a opção --user. Por exemplo:

     python -m pip install oracledb --upgrade --user

   • Se um pacote binário não estiver disponível para sua plataforma, a execução de pip fará download do pacote de origem. A origem é compilada e o binário resultante é instalado.

   Consulte Instalando o python-oracledb para obter opções e dicas adicionais.

3. Se você quiser usar o driver python-oracledb no modo Thick, instale o software Oracle Client.

   Por padrão, o python-oracledb é executado no modo Thin que se conecta diretamente ao Oracle Database. O modo Thin não exige bibliotecas do Oracle Client. No entanto, uma funcionalidade adicional está disponível quando o python-oracledb é executado no modo Thick.

   Observação
   
   Consulte Recursos do Oracle Database Suportados pelo python-oracledb para obter informações sobre os recursos suportados nos modos Thin e Thick do python-oracledb. Nem todos os recursos mostrados nesse link estão disponíveis com o Autonomous Database.

   O Python-oracledb usa o modo Thick quando você usa as bibliotecas do cliente Oracle Instant ou as bibliotecas do Oracle Database Client e chama oracledb.init_oracle_client() no código Python.

   Ao instalar o Oracle Client Software, há diferenças nas versões mínimas obrigatórias para conexões mTLS e TLS, conforme a seguir:

   • Conexões mTLS (TLS Mútuo):

     • Se o seu banco de dados estiver em um computador remoto, faça download do pacote "Basic" ou "Basic Light" do Oracle Instant Client gratuito para sua arquitetura de sistema operacional. Use uma versão suportada: Oracle Instant Client: 18.19 (ou mais recente), 19.2 (ou mais recente) ou 21 (versão base ou mais recente).

     • Se preferir, você poderá usar as bibliotecas completas do cliente Oracle Database quando elas estiverem disponíveis no seu sistema (incluindo o Oracle Database Client Completo: Oracle Database Client: 18.19 (ou mais recente), 19.2 (ou mais recente) ou 21 (versão base ou mais recente).

   • Conexões TLS: Os clientes Oracle Call Interface (OCI) suportarão a autenticação TLS sem uma wallet se você estiver usando as seguintes versões do cliente:

     • Oracle Instant Client/Oracle Database Client 19.14 (ou mais recente) e 21.5 (ou mais recente) - somente no Linux x64 e no Windows

     • Se preferir, você poderá usar as bibliotecas do cliente Oracle Database Completo quando elas estiverem disponíveis no seu sistema, incluindo o Oracle Database Client Completo 19.14 (ou mais recente) e 21.5 (ou mais recente).