Criar um Aplicativo Python

Para criar um aplicativo Python que acesse um Autonomous Database, comece configurando seu sistema de desenvolvimento para oferecer suporte ao acesso ao banco de dados que possa aproveitar a disponibilidade contínua e os recursos de alto desempenho do Autonomous Database.

Depois de configurar seu sistema de desenvolvimento, codifique as conexões de banco de dados e as instruções SQL em seu aplicativo para aproveitar esses recursos.

Dica:

Para ter a opção de "testar" para ler os tópicos a seguir, você pode conferir o Lab 4: Build Python Application Stacks no Oracle Autonomous Database Dedicated for Developers and Database Users Workshop.

Configurar o seu Sistema de Desenvolvimento Python

Para configurar seu sistema de desenvolvimento para que seu aplicativo Python possa aproveitar a disponibilidade contínua e os recursos de alto desempenho de um Autonomous Database, execute estas etapas.

  1. Faça download do Python e instale-o.
  2. Faça download do Oracle Instant Client e instale-o.
  3. Faça download do cx_Oracle e instale-o.
  4. Faça download das credenciais do cliente do banco de dados e torne-as disponíveis para o Oracle Instant Client.

Antes de Começar

Seu sistema de desenvolvimento deve atender a determinados critérios para configurá-lo com sucesso.

Fazer Download e Instalar o Python

  • Oracle Linux:

    O Oracle Linux 7 inclui o Python 2.7 e, portanto, você só executa este comando:

    sudo yum -y install oracle-release-el7
  • Outras OSes e arquiteturas:

    Vá para a página Downloads do python.org e faça download e instale a versão mais recente do Python 2.7 ou Python 3.5 (ou mais recente) para o seu sistema operacional e arquitetura.

Fazer Download e Instalar o Oracle Instant Client

Você precisa das bibliotecas do Oracle Instant Client versão 19.6 ou mais recente.

Faça download do pacote básico do Oracle Instant Client para o sistema operacional e a arquitetura do seu sistema e instale-o:

  • Oracle Linux:

    Execute estes comandos para fazer download e instalar o pacote básico do Oracle Instant Client:

    sudo yum -y install oracle-release-el7
    sudo yum -y install oracle-instantclient19.3-basic

    (Se você quiser ver uma lista de todos os pacotes do Instant Client, acesse http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.)

  • Outras OSes e arquiteturas:

    1. Vá para a página Downloads do Oracle Instant Client e selecione o download para o sistema operacional e a arquitetura do seu sistema.

    2. Na página de download, aceite o Contrato de Licença do Oracle Technology Network, faça download da versão mais recente do Pacote Básico e, em seguida, instale-o seguindo as instruções na parte inferior da página de download.

Fazer Download e Instalar o cx_Oracle

Use o pacote pip do Python para instalar o cx_Oracle no PyPI (oPython Package Index).:

  • Oracle Linux:

    Execute estes comandos para fazer download do pacote pip e depois use-o para instalar o 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
  • Outras OSes e arquiteturas:

    Execute este comando:

    python -m pip install cx_Oracle --upgrade

Fazer Download e Instalar Credenciais do Cliente para o Banco de Dados

  1. Faça download do arquivo zip que contém credenciais do cliente do seu banco de dados para um diretório seguro no seu computador.

    Esse arquivo zip está disponível para download da página Detalhes do banco de dados na console do Oracle Cloud. Se você tiver uma conta de usuário do Oracle Cloud que permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver essa conta, precisará obter o arquivo zip do administrador do banco de dados, juntamente com a senha que foi usada para proteger o arquivo zip.

    1. No seu navegador da Web, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous Database.

    2. Clique em Conexão do BD.

    3. Na página Conexão do Banco de Dados clique em Fazer Download.

    4. Na caixa de diálogo Download da Wallet, digite uma senha da wallet no campo Senha e confirme a senha no campo Confirmar Senha.

      A senha deve ter pelo menos 8 caracteres e deve incluir pelo menos 1 letra e 1 número ou 1 caractere especial.

    5. Clique em Download para salvar o arquivo zip de credenciais do cliente em um diretório seguro.

  2. Depois de fazer download do arquivo zip, siga estas etapas:

    1. Descompacte o arquivo zip de credenciais do cliente.

    2. Edite o arquivo sqlnet.ora fornecido nas credenciais do cliente, substituindo "?/network/admin" pelo caminho completo do diretório no qual você descompactou as credenciais do cliente; por exemplo, altere:

      (DIRECTORY="?/network/admin")

      para:

      (DIRECTORY="/users/jdoe/adbcredentials")
    3. Crie a variável de ambiente TNS_ADMIN, definindo seu valor para o caminho completo do diretório no qual você descompactou as credenciais do cliente.

Codificar Conexões do Banco de Dados e Instruções SQL

Depois de configurar seu sistema de desenvolvimento para oferecer suporte à conectividade do aplicativo Python com um Autonomous Database, siga estas diretrizes para obter alto desempenho e disponibilidade contínua das conexões do seu aplicativo com o banco de dados:

Por exemplo:

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

Este exemplo cria um pool para conexões com o serviço de banco de dados tp_tls e ativa o FAN definindo o parâmetro events como True.

Recursos Adicionais

Para obter informações detalhadas sobre o cx_Oracle, vá para a página Documentação do cx_Oracle.

Para obter exemplos de código que demonstram uma grande variedade de recursos cx_Oracle, vá para a pasta python-cx_Oracle samples.