Criar um Aplicativo Python
Para criar um aplicativo Python que tenha acesso a um Autonomous AI Database, você começa configurando seu sistema de desenvolvimento para oferecer suporte ao acesso a bancos de Dados que pode aproveitar a disponibilidade contínua e recursos de alto desempenho do Autonomous AI 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 alternativa de "teste" de ler os seguintes tópicos, você pode passar pelo Lab 4: Build Python Application Stacks no Oracle Autonomous AI 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 se beneficiar da disponibilidade contínua e dos recursos de alto desempenho de um Banco de Dados de IA Autônomo, você realiza estas etapas.
-
Faça download do Python e instale-o.
-
Faça download do Oracle Instant Client e instale-o.
-
Faça download do cx_Oracle e instale-o.
-
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.
-
Deve ter acesso à Internet.
-
Ele deve ter acesso à rede para o Autonomous AI Database.
Consulte Configurar um Sistema de Desenvolvimento para Acessar o Banco de Dados para saber como garantir que seu sistema de desenvolvimento atenda a esse requisito.
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 -
Outros SOs 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, vá para
http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html.) -
Outros SOs e arquiteturas:
-
Vá para a página Downloads do Oracle Instant Client e selecione o download para o sistema operacional e a arquitetura do seu sistema.
-
Na página do download, aceite o Acordo de Licença da Oracle Technology Network, faça download da versão mais recente do Pacote Básica e instale-o seguindo as instruções na parte inferior da página do 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
pipe depois use-o para instalar ocx_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 -
Outros SOs e arquiteturas:
Execute este comando:
python -m pip install cx_Oracle --upgrade
Fazer Download e Instalar Credenciais do Cliente para o Banco de Dados
-
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 do usuário Oracle Cloud que lhe permita acessar esta página, faça download das credenciais da seguinte forma. Se você não tiver uma conta desse tipo, precisará obter o arquivo zip do administrador do banco de dados, juntamente com a senha que foi usada para proteger o arquivo zip.
-
No seu Web browser, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous AI Database.
-
Clique em Conexão do BD.
-
Na página Conexão de Banco de Dados, clique em Fazer Download.
-
No diálogo Fazer Download da Wallet, informe uma senha da wallet no campoSenha e confirme a senha no campoConfirmar Senha.
A senha deve ter pelo menos 8 caracteres e deve incluir pelo menos 1 letra e 1 número ou 1 caractere especial.
-
Clique em Fazer Download para salvar o arquivo zip de credenciais do cliente em um diretório seguro.
-
-
Depois de fazer download do arquivo zip, siga estas etapas:
-
Descompacte o arquivo zip de credenciais do cliente.
-
Edite o arquivo
sqlnet.orafornecido 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") -
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
Após configurar seu sistema de desenvolvimento para oferecer suporte à conectividade de aplicativo Python com um Autonomous AI Database, siga estas diretrizes para obter alto desempenho e disponibilidade contínua das conexões do seu aplicativo com o banco De Dados:
-
Use pools de conexão.
-
Ative a FAN (Fast Application Notification).
-
Use o serviço de banco de dados predefinido que melhor corresponda às operações que você executará. Para obter informações sobre os serviços de banco de dados predefinidos, consulte Nomes de Serviço de Banco de dados Predefinidos para o Autonomous AI Database.
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.
Conteúdo Relacionado
-
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.