Compatibilidade do E3/Power/Water com o banco Oracle.

1. Introdução

Ao integrar o Elipse E3/Power/Water com um banco de dados Oracle, surge a dúvida sobre quais versões são compatíveis. O ponto central é que o E3 não se conecta diretamente ao servidor Oracle: ele usa o cliente Oracle instalado na mesma máquina, e é esse cliente que conversa com o servidor. Por isso, a compatibilidade que importa é entre as versões do cliente e do servidor Oracle, não entre o E3 e o banco. Este artigo cobre a conexão, a compatibilidade de versões e os requisitos de configuração.

2. Como o E3/Power/Water se conecta ao Oracle

A conexão passa sempre pelo cliente Oracle:

Consequências práticas:

• O cliente Oracle precisa estar instalado e acessível na máquina do E3. Os erros mais comuns (OCI.DLL LoadLibrary failed, Provider cannot be found, OraConnection::Open() FAILED) indicam que o E3 não encontrou o cliente Oracle.
• Arquitetura (bits). Até o E3/Power/Water 6.9, a conexão com o Oracle usa sempre o cliente Oracle de 32 bits — mesmo que o Windows, o E3 e o servidor Oracle sejam de 64 bits —, porque o componente que faz a conexão (o E3DBEngine) roda em 32 bits.

3. Compatibilidade entre as versões do cliente e do servidor Oracle

Quem define quais combinações cliente ↔ servidor são suportadas é a própria Oracle, pela matriz de interoperabilidade (Client/Server Interoperability Support Matrix). A tabela abaixo cobre as versões atuais (Oracle 12.1.0 e superiores); para versões mais antigas, consulte a matriz de interoperabilidade nos canais oficiais da Oracle.

Legenda: Yes = suportado · Was = já foi suportado, mas uma das versões saiu de suporte (correções não são mais possíveis) · No = nunca foi suportado.

Recomendação prática: use Oracle 12c ou superior (cliente e servidor). Versões antigas (9, 10 e 11) já saíram do suporte da Oracle. O uso do provedor nativo da Oracle (ver a seguir) requer servidor Oracle 11.2 ou superior.

4. Provedor de conexão: nativo da Oracle × Microsoft

O E3 pode acessar o Oracle por dois provedores OLE DB:

• Provedor nativo da Oracle (OraOLEDB) — recomendado. Habilitado pela opção “Usar provedor OLE DB Oracle” (em versões anteriores, “Usar drivers ADO Oracle”), normalmente junto com “Usar tipo TIMESTAMP”.
• Provedor da Microsoft para Oracle (MSDAORA) — descontinuado pela Microsoft e sem previsão de continuar nas próximas versões do Windows.

Como isso evoluiu nas versões do E3/Power/Water:

• Uma falha antiga fazia as consultas de Storage falharem quando o provedor nativo da Oracle estava habilitado. Isso foi corrigido na versão 6.6 — desde então o provedor nativo funciona também para essas consultas.
• A partir de domínios criados na versão 6.6, os novos DBServers Oracle já vêm com o provedor nativo e o tipo TIMESTAMP marcados por default (configurável nas Compatibilidades do domínio).

5. Requisitos de configuração para a conexão funcionar

Além de instalar o cliente Oracle compatível, atente-se a estes pontos — que explicam por que uma conexão às vezes funciona no teste do Studio mas falha em runtime:

• O caminho do cliente Oracle (onde fica o OCI.dll) deve estar na variável Path do Sistema — não apenas na Path do usuário. O E3 Server roda como serviço (conta SYSTEM), que só enxerga a Path do Sistema; por isso o teste de conexão no Studio pode funcionar e o Domínio em runtime falhar.
• Reinicie a máquina após instalar ou alterar o cliente Oracle. A atualização da Path só passa a valer após um reinício de fato (reiniciar, não apenas desligar e ligar).
• Use um usuário Oracle com privilégios adequados à operação (gravar/consultar). Permissões insuficientes aparecem como ORA-00942: a tabela ou view não existe.
• Evite caracteres especiais no caminho de instalação.

Artigos relacionados

• Conexão do E3 32 bits com Oracle 64 bits
• Elipse E3/Power versão 4.6 x64