Criar um Aplicativo Ruby

Para criar um aplicativo Ruby que se beneficia de um Autonomous AI Database, você começa configurando seu sistema de desenvolvimento para oferecer suporte ao acesso a bancos de Dados que podem aproveitar a disponibilidade contínua e recursos de alto desempenho do Autonomous AI 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.

Configurar o seu Sistema de Desenvolvimento Ruby

Para configurar seu sistema de desenvolvimento para que a sua aplicação Ruby possa se beneficiar da disponibilidade contínua e dos recursos de alto desempenho de um Autonomous AI Database, você realiza 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:

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.)

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 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.

    1. Em seu Web browser, acesse o Oracle Cloud e navegue até a página Detalhes do Autonomous AI Database.

    2. Clique em Conexão do BD.

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

    4. 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.

    5. Clique em Fazer 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

Após configurar seu sistema de desenvolvimento para oferecer suporte à conectividade do aplicativo Ruby 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:

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.

Conteúdo Relacionado