Skip to main content

Oracle

Oracle

Para adicionar uma conexão de banco de dados, clique no ícone de engrenagem no canto superior direito e navegue até Configurações de administrador > Bancos de dados > Adicionar um banco de dados.

Versões suportadas

O Analytics suporta desde a versão mais antiga ainda suportada até a versão estável mais recente. Veja a Agenda de lançamentos das versões atuais do Oracle.

Editar detalhes da conexão

Você pode editar essas configurações a qualquer momento. Apenas lembre-se de salvar as alterações.

Nome de exibição

O nome que será exibido para o banco de dados na interface do Analytics.

Host

O endereço IP do seu banco de dados, ou seu nome de domínio (por exemplo, esc.mydatabase.com).

Porta

A porta do banco de dados. Exemplo: 1521.

Oracle system ID (SID)

Geralmente algo como ORCL ou XE. Opcional se estiver usando service name.

Oracle service name

Alias TNS opcional.

Nome de usuário

O nome de usuário do banco de dados para a conta que você deseja usar para conectar ao seu banco de dados. Você pode configurar múltiplas conexões para o mesmo banco usando contas de usuário diferentes, cada uma com diferentes conjuntos de privilégios.

Senha

A senha do usuário que você utiliza para conectar ao banco de dados.

Usar uma conexão segura (SSL)

Você pode usar autenticação tanto do cliente quanto do servidor (conhecida como autenticação mútua).

Conectando ao Oracle Cloud Autonomous Database

Se seu banco foi configurado para exigir mutual TLS (mTLS), você precisará de uma wallet. Para baixar sua wallet:

  1. Acesse seu Oracle Autonomous Database.
  2. Vá aos detalhes do banco de dados.
  3. Clique em DB connection.
  4. Faça o download da wallet.
  5. Crie uma senha para o arquivo de chave (keyfile).
  6. Copie o arquivo keystore.jks para onde você armazena os dados de configuração do Analytics.
  7. Use as variáveis JAVA_OPTS para informar ao Analytics a localização e a senha do keystore (para mais informações sobre keystores, veja a próxima seção).
  8. Na página de conexão de dados do Analytics, insira seu host, port e service_name. Você pode encontrar esses valores no arquivo tsnnames.ora.

Autenticação do cliente com um keystore

Para configurar o servidor (Oracle) para autenticar a identidade do cliente (Analytics), você precisa configurar um arquivo keystore que inclua a chave privada do cliente.

Você importará a chave privada do cliente no keystore (em vez de importar uma CA raiz em um arquivo truststore). Adicione as seguintes opções JVM para o Analytics:

-Djavax.net.ssl.keyStore=/path/to/keystore.jks
-Djavax.net.ssl.keyStoreType=JKS \
-Djavax.net.ssl.keyStorePassword=<keyStorePassword>

Você pode definir essas opções na variável de ambiente JAVA_OPTS, assim:

JAVA_OPTS="-Djavax.net.ssl.keyStore=/scripts/keystore.jks -Djavax.net.ssl.keyStoreType=JKS -Djavax.net.ssl.keyStorePassword=<keyStorePassword>"

Com isso, o servidor Oracle autenticará o Analytics usando a chave privada quando o Analytics tentar se conectar via SSL.

Autenticação do servidor com um truststore

Para configurar o cliente (Analytics) para autenticar a identidade do servidor (Oracle), talvez seja necessário configurar um arquivo truststore que inclua a CA raiz do servidor, para que a JVM que executa o Analytics confie na cadeia de certificados.

Consulte a documentação Oracle sobre o uso do keytool para gerenciar arquivos keystore e truststore, importação de certificados, etc.

Para mais informações sobre a configuração do truststore para instâncias AWS RDS Oracle, veja as instruções fornecidas pela Amazon.

Se você precisar conectar a outros bancos usando SSL, em vez de criar um truststore novo, provavelmente desejará adicionar a CA do RDS ao seu arquivo truststore existente (geralmente chamado cacerts).

Versões do Oracle Database e do driver Oracle suportadas

  • Versão do driver: a versão mínima do driver Oracle deve ser 19c, independentemente da versão do Java ou do banco de dados Oracle que você utiliza.
  • Versão do banco de dados: a versão mínima do banco de dados deve ser 19c, pois a Oracle não oferece mais suporte para versões anteriores à 19.

Baixando o driver Oracle JDBC JAR

Você pode baixar um driver JDBC na página de downloads do driver JDBC da Oracle.

Recomendamos utilizar o arquivo ojdbc8.jar.

Adicionando o driver Oracle JDBC JAR ao diretório de plugins do Analytics

Na sua pasta do Analytics (onde você mantém e executa o arquivo analytics.jar), crie uma pasta chamada plugins (se ela ainda não existir).

Movimente o JAR que você acabou de baixar (ojdbc8.jar) para o diretório plugins e reinicie o Analytics. O Analytics tornará o driver Oracle disponível automaticamente no próximo início.

Quando executando a partir de um JAR

Por padrão, o diretório plugins está nomeado como plugins e fica no mesmo diretório do arquivo Analytics JAR.

Por exemplo, se você está executando o Analytics em um diretório chamado /app/, você deve mover o driver Oracle JDBC para /app/plugins/:

# exemplo de estrutura de diretórios para executar o Analytics com suporte Oracle
/app/analytics.jar
/app/plugins/ojdbc8.jar

Quando executando via Docker

O processo para adicionar plugins ao rodar via Docker é semelhante, mas será necessário montar o diretório plugins. Consulte as instruções aqui para mais detalhes.

Zona de risco

Veja Zona de risco.

Leituras adicionais

Consulte a documentação para outras versões do Analytics.

Back to top