Criar um Aplicativo Node.js

Para criar um aplicativo Node.js 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, 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 opção de "testar" para ler os tópicos a seguir, você pode conferir o Lab 3: Build and Deploy Node.js Application no Oracle Autonomous Database Dedicated for Developers and Database Users Workshop.

Tópicos Relacionados

Noções Básicas da Criação de um Aplicativo

Configurar o seu Sistema de Desenvolvimento Node.js

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

Faça download do Node.js e instale o.
Faça download do Oracle Instant Client e instale-o.
Faça download do node-oracledb 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 de rede ao Autonomous 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.

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:

Oracle Linux:

Execute estes comandos para fazer download e instalar a versão mais recente do Node.js:
```
sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y nodejs 
```
Outras OSes e arquiteturas:

Vá para a página Downloads do Node.js, selecione a versão mais recente do LTS (Suporte de Longo Prazo) para o sistema operacional e a arquitetura do sistema e instale-a.

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

Oracle Linux:

Execute estes comandos para fazer download e instalar a versão mais recente do node-oracledb:
```
sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
sudo yum install -y node-oracledb-node10
```
Outras OSes e arquiteturas:

Vá para a página Installing node-oracledb , escolha as instruções "Meu banco de dados está em outra máquina" para o seu sistema operacional e arquitetura e siga as instruções Instalar o complemento.

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 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.
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 Node.js com um Autonomous Database, siga estas etapas para garantir o desempenho ideal do uso do banco de dados pelo seu aplicativo:

Adicione a dependência no complemento node-oracledb ao arquivo package.json do seu aplicativo.
Codifique conexões para alto desempenho e disponibilidade contínua.

Adicione a Dependência node-oracledb ao arquivo package.json

Edite o objeto dependencies no arquivo package.json do seu aplicativo, adicionando o pacote e a versão do oracledb. (Use o comando npm init para gerar o arquivo 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:

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

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.

Recursos Adicionais

Para obter informações detalhadas sobre o node-oracledb, vá para a página Documentação do node-oracledb, que inclui uma Referência de API e um Guia do Usuário.

Para ver exemplos de código que demonstram uma grande variedade de recursos node-oracledb, vá para a pasta exemplos de node-oracledb.

Título e Informações de Copyright

Oracle e/ou suas empresas afiliadas.