Criar um Aplicativo Node.js

Para criar um aplicativo Node.js 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, você codifica conexões de banco de dados e instruções SQL em seu aplicativo para aproveitar a disponibilidade contínua e os recursos de alto desempenho.

Dica: Para ter a alternativa de "experimentar" a leitura dos seguintes tópicos, você pode passar pelo Lab 3: Build and Deploy Node.js Application no Oracle Autonomous AI Database Dedicated for Developers and Database Users Workshop.

Configurar o seu Sistema de Desenvolvimento Node.js

Para configurar seu sistema de desenvolvimento para que o seu aplicativo Node.js 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 Node.js e instale o.

  2. Faça download do Oracle Instant Client e instale-o.

  3. Faça download do node-oracledb 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.

Faça download do Node.js e Instale o.

Faça download do Node.js para o sistema operacional e a arquitetura do seu sistema e instale-o:

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs

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:

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 node-oracledb

Faça download do complemento node-oracledb para Node.js para o sistema operacional e a arquitetura do seu sistema e instale-o:

sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10

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. No 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 Node.js com um Autonomous AI Database, siga estas etapas para garantir a melhor performance do uso do banco de dados por seu aplicativo:

  1. Adicione a dependência no complemento node-oracledb ao arquivo package.json do seu aplicativo.

  2. Codifique conexões para alto desempenho e disponibilidade contínua.

Adicione o node-oracledb Dependency topackage.json

Edite o objeto dependencies no arquivo package.json do seu aplicativo, adicionando o pacote e a versão do oracledb. (Utilize o comando npm init para gerar package.json se ele não existir.) Por exemplo:

. . .
"dependencies": {
  . . .,
 "oracledb": "^4.0",
  . . .
},
. . .

Para obter informações detalhadas sobre o objeto dependencies, consulte a página npm-package.json. Para exibir a versão do oracledb instalada, você pode usar o comando npm list; por exemplo:

npm list -g --depth=0

Codificar conexões para Alto Desempenho e Disponibilidade Contínua

Para obter alto desempenho e disponibilidade contínua, siga estas diretrizes ao fazer conexões com o banco de dados:

Por exemplo:

pool = await oracledb.createPool({
  events: true,
  user: "appuser",
  password: process.env.MY_PASSWORD_ENV_VAR,
  connectString: "tp_tls"
});

Este exemplo cria um pool para conexões com o serviço de banco de dados tp_tls e ativa o FAN definindo a propriedade events como true.

Conteúdo Relacionado