// Referência de erro do Oracle

ORA-12154: TNS: não foi possível resolver o identificador de conexão

O cliente Oracle não conseguiu transformar o nome com o qual você se conectou em um endereço de banco de dados: o alias não está no tnsnames.ora, ou o cliente está lendo um arquivo diferente.

Código de erro
ORA-12154
Categoria
Conexão e login
Mensagem de erro
TNS:could not resolve the connect identifier specified

O que significa

Quando você se conecta com um nome de serviço de rede como SALES, o cliente Oracle o procura usando seus métodos de nomenclatura, geralmente tnsnames.ora. ORA-12154 significa que ele não encontrou esse nome. O banco de dados nunca é contatado, então o servidor não é o problema.

Versões mais recentes dizem assim Cannot connect to database. Cannot find alias alias_value in repository_loc., que também indica onde o cliente procurou.

Causas comuns

  • O alias não está definido no tnsnames.ora o cliente realmente lê, ou está escrito incorretamente.
  • TNS_ADMIN aponta para outro diretório, ou várias homes do Oracle cada uma com seu próprio tnsnames.ora.
  • Um erro de sintaxe em tnsnames.ora, como parênteses não fechados, que tornam a entrada ilegível.
  • sqlnet.ora restringe métodos de nomeação (NAMES.DIRECTORY_PATH) de modo que tnsnames.ora não seja consultado.
  • Um domínio é adicionado ao nome de NAMES.DEFAULT_DOMAIN e a entrada não o possui.

Como corrigir

  1. Ignore o alias e conecte-se com Easy Connect, que não precisa de tnsnames.ora: sqlplus app_user@//db-host:1521/salespdb.

  2. Verifique qual arquivo o cliente usa: execute tnsping SALES, que imprime o arquivo de parâmetros que leu e como resolveu o nome.

  3. Adicione ou corrija a entrada nesse arquivo.

    SALES =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = db-host)(PORT = 1521))
        (CONNECT_DATA = (SERVICE_NAME = salespdb)))
  4. Definir TNS_ADMIN para o diretório que contém o correto tnsnames.ora e sqlnet.ora.

Erros relacionados

Mais erros de conexão e login

O código e o texto da mensagem são de Ajuda de erros do Oracle Database. Veja toda a Lista de erros do Oracle ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com Oracle no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o Oracle e os outros bancos de dados que você usa.