Resolvendo o erro de conexão Oracle: ORA-12154

Á

Álvaro Moura

Última atualização em Jul 6, 2026

Resolvendo o erro de conexão Oracle: ORA-12154: TNS:could not resolve the connect identifier specified

Para corrigir esse erro ao conectar ao banco Oracle, siga os passos abaixo:

1. Criar o arquivo tnsnames.ora

Crie um arquivo chamado tnsnames.ora com o seguinte conteúdo:

REALDB =

(DESCRIPTION =

(ADDRESS = (PROTOCOL = TCP)(HOST = SEU_IP_OU_HOST)(PORT = SUA_PORTA))

(CONNECT_DATA =

(SERVER = DEDICATED)

(SERVICE_NAME = SEU_SERVICE_NAME)

)

)

Warning

Substitua SEU_IP_OU_HOSTSUA_PORTA e SEU_SERVICE_NAME com os dados reais da conexão.

2. Salvar no diretório correto

Salve o arquivo no caminho:

C:\instantclient_19_6\network\admin

![Warning](https://static.zohocdn.com/zoho-desk-editor/static/images/caution.png/)Se as pastas network e admin não existirem, crie-as manualmente.

3. Configurar variáveis de ambiente no Windows

Acesse:
Painel de Controle → Sistema → Configurações Avançadas → Variáveis de Ambiente

Adicione ou edite as seguintes variáveis de sistema:

  • TNS_ADMIN
    Nome: TNS_ADMIN
    Valor: C:\instantclient_19_6\network\admin
  • ORACLE_HOME
    Nome: ORACLE_HOME
    Valor: C:\instantclient_19_6

4. Editar o Apache

Abra o arquivo:

C:\Program Files\NetMake\v9-php81\components\apache\conf\httpd.conf

E adicione estas linhas:

FcgidInitialEnv TNS_ADMIN "C:/instantclient_19_6/network/admin"
FcgidInitialEnv ORACLE_HOME "C:/instantclient_19_6"

Essas linhas devem ser inseridas entre as diretivas FcgidMaxRequestLen e Timeout.

5. Configuração do ambiente

- Salve o arquivo httpd.conf após adicionar as variáveis FcgidInitialEnv.
- Reinicie o computador para que as variáveis de ambiente (TNS_ADMIN e ORACLE_HOME) sejam aplicadas corretamente.

​

6. Criação da conexão no Scriptcase

- Abra o Scriptcase  e vá para a tela de criação de conexão com banco de dados.
- Escolha o driver Oracle desejado.
- No campo "Base de dados", informe o nome definido no arquivo tnsnames.ora (por exemplo: REALDB).

​

Se tudo estiver correto, a conexão com o banco Oracle será realizada com sucesso.