Instalar o Python e o Driver python-oracledb

Para estabelecer conexão com o Autonomous Database pelo seu aplicativo Python, instale o 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 seu sistema operacional e hardware do lado 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 versão principal do popular driver cx_Oracle.

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

   Execute o seguinte comando para atualizar python:

   python -m pip install oracledb --upgrade

   Você deverá ver a 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 sobre a instalação do python-oracledb:

   • Se estiver atrás de 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 de você não ter permissão para gravar em 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 a sua plataforma, a execução de pip fará download do pacote de origem. A origem é compilada e o binário resultante é instalado.

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

3. Se 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 fino não requer bibliotecas do Oracle Client. No entanto, algumas funcionalidades adicionais estão disponíveis quando o python-oracledb é executado no modo Thick.

   Observação
   
   Consulte Recursos do Oracle Database Suportados pelo python-oracledb para obter informações sobre recursos suportados nos modos python-oracledb Thin e Thick. Nem todos os recursos mostrados neste 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.

   Quando você instala o Oracle Client Software, há diferenças nas versões mínimas necessárias para conexões mTLS e TLS, desta forma:

   • Conexões MUTUAL TLS (mTLS):

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

     • Como alternativa, você pode usar as bibliotecas de cliente Full Oracle Database quando elas estiverem disponíveis no seu sistema (incluindo Full Oracle Database Client: Oracle Database Client: 18.19 (ou posterior), 19.2 (ou posterior) ou 21 (versão base ou posterior).

   • Conexões TLS: Os clientes do OCI (Oracle Call Interface) suportam 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 posterior), 21.5 (ou posterior) ou 23.1 (ou posterior)

     • Como alternativa, você pode usar as bibliotecas do cliente Full Oracle Database quando elas estiverem disponíveis no seu sistema, incluindo Full Oracle Database Client 19.14 (ou posterior) e 21.5 (ou posterior).