Criar um Aplicativo Ruby

Para criar um aplicativo Ruby 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 para oferecer suporte ao acesso ao banco de dados, você codifica as conexões do banco de dados e as instruções SQL em seu aplicativo para aproveitar esses recursos.

Tópicos Relacionados

Configurar o seu Sistema de Desenvolvimento Ruby

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

  1. Faça download do Ruby e instale-o.
  2. Faça download do Oracle Instant Client e instale-o.
  3. Faça download do ruby-oci8 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 Ruby

Para fazer download e instalar o Ruby, vá para a página Installing Ruby em ruby-lang.org e siga as instruções para o sistema operacional e a arquitetura do seu sistema.

Fazer Download e Instalar o Oracle Instant Client

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 ruby-oci8

Para fazer download e instalar a interface do ruby-oci8 no Oracle Database, siga as instruções na página Install for Oracle Instant Client.

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 Ruby 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:

require 'oci8'
OCI8.properties[:events_mode] = true
cpool = OCI8::ConnectionPool.new(1, 5, 2, username, password, 'tp_tls')
conn1 = OCI8.new(username, password, cpool)

Este exemplo ativa o FAN definindo a propriedade events_mode como true, cria um pool para conexões com o serviço de banco de dados tp_tls e adquire uma conexão do pool.

Recursos Adicionais

Para obter informações detalhadas sobre o ruby-oci8, vá para a página Ruby-oci8.