Entendendo o Oracle Net Services e o arquivo TNSNAMES

Olá pessoal,

     Estou escrevendo este artigo sobre Oracle Net Services e o arquivo tnsnames.ora porque já recebi e-mails de vários leitores do meu blog pedindo ajuda sobre este assunto e recentemente vi gente com a mesma dificuldade nos fóruns do GPO e Gluke.net. 

     O assunto é básico, mas profissionais que estão iniciando seus trabalhos com Bancos de Dados Oracle, tem dificuldade de configurar, encontrar ou utilizar o arquivo  tnsnames.ora  para que as suas aplicações acessem o Banco de Dados (BD) Oracle. 

      Primeiramente, antes de comentar exclusivamente sobre o arquivo  tnsnames.ora, vamos entender o que é o Oracle Net Services e sua relação com o arquivo citado. Oracle Net Services é um serviço da Oracle utilizado para estabelecer e manter conexões entre um cliente (máquina do usuário ou servidor de aplicação) e o servidor de BD Oracle. No servidor de BD, Oracle Net usa um processo ativo chamado listener para gerenciar conexões entre as aplicações e o servidor de Banco de Dados. As aplicações (remotas) não podem se conectar ao servidor de BD sem um listener. Um único listener pode servir múltiplas instâncias de BD e milhares de conexões clientes, porém ele poderá atender bem seus clientes, se  ele receber no máximo 200 conexões simultâneas. Se o BD tiver mais que 200 conexões simultâneas, crie mais de um listener para que ele não seja um ponto de gargalo para conexões com o BD.

    Resumidamente, o listener é utilizado para habilitar conexões de entrada no BD e seu papel principal é o de intermediador entre conexões de usuário não locais e uma instância de BD Oracle. Sua configuração pode ser realizada através do arquivo listener.ora, que por sua vez, pode ser editado através de qualquer editor de texto ou através de outros softwares e utilitários, como por exemplo o Enterprise Manager e o Net Manager. Este arquivo  pode conter as seguintes informações:
          - Nome da instância do BD (ou serviço);

          - Informações sobre o endereço ou o host do listener;

          - Protocolos suportados pelo listener;

          - Porta monitorada pelo listener.
 
     Segue abaixo um exemplo de conteúdo do arquivo de configuração do listener, chamado listener.ora:

# listener.ora Network Configuration File: 
LISTENER =
  (DESCRIPTION_LIST = 
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
    ) 

    Oracle Net suporta 4 métodos de resolução de nomes, que possibilitam a conexão com o BD:
     
        1- Easy connect:
         - Conexão estabelecida através de "string de conexão", composta pelo nome do host do BD, número da porta do listener e nome do serviço (pode ser a instance name). Se não for especificado a porta, utiliza-se a porta padrão 1521. Se não for fornecido nome de serviço, Oracle Net assume que o nome do serviço é igual ao nome do host;
         - Esse tipo de conexão é muito utilizada por aplicações desenvolvidas em Java que se conectam ao BD via JDBC;
         - Este método é habilitado por padrão e não exige configuração nos clientes;

         - Não suporta SSL e trabalha somente com TCP/IP;

         - Opções de conexão avançadas, tais como: roteamento, connect time failover e balanceamento não são suportadas.

         - Exemplo de conexão utilizando easy connect via SQLPlus:
                  CONNECT user/senha@host:1521/service
     
        2- Nomeação local:
            Usuário fornece um álias para a conexão com o Oracle Net Service. Oracle Net tenta encontrar o álias com os serviços definidos localmente, em um arquivo de resolução de nomes, chamado tnsnames.ora. Se encontrar, resolve o alias no protocolo, host, porta e serviços especificados no arquivo.
            Este método suporta todos os protocolos do Oracle Net e suporta opções de conexão avançadas, tais como: roteamento, connect time failover e balanceamento (muito úteis para ambientes com RAC e DataGuard).
            Ideal para organizações que não mudam frequentemente as configurações de serviços Oracle Net.          
         
        3- Nomeação de diretório:
            Similar ao método de nomeamento local onde a aplicação fornece um alias para conexão. O alias é mantido em um serviço externo que pode ser pesquisado por meio do protocolo LDAP, que acessa o Oracle Internet Directory (OID) ou Microsoft Active Directory.
            Assim como o método de nomeamento local, este método suporta todos os protocolos do Oracle Net e opções de conexão avançadas.

            Ideal para organizações que podem mudar com mais frequência as configurações de serviços Oracle Net.

           
        4- Nomeação externa:

            Similar ao método de nomeamento de diretório, com a diferença de que este método suporta serviços de nomeamento de terceiros, tais como Cell Directory Services (CDS), Distributed Computing Enviroment (DCE) e Network Information Services (NIS).

     Dentre os métodos citados acima, o mais conhecido e comumente utilizado, é o nomeamento local, que utiliza o arquivo tnsnames.ora, na máquina cliente. Segue abaixo um exemplo de conteúdo deste arquivo:


ORCL =
  (DESCRIPTION =
    (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
    (CONNECT_DATA =
      (SERVICE_NAME = orcl)
    )
  )

 

     Uma máquina cliente windows, por exemplo, pode ter vários diretórios de softwares Oracle. Ela pode ter, por exemplo, um cliente do Oracle 10g e outro do 11G. Os diretórios em que estes softwares estão instalado são chamados de Oracle Home. Neste caso, temos 2 Oracle Homes na mesma máquina e cada Oracle Home possui sua estrutura de pastas que definem os seus serviços de rede Oracle (através dos arquivos tnsnames.ora e sqlnet.ora). A subpasta do Oracle Home que contém os arquivos Oracle Net Services chama-se network/admin.

     Se temos mais de um Oracle Home, como saber qual deles é o Oracle Home que o seu programa deve estar usando para ler o tnsnames.ora? Você pode verificar isso abrindo um prompt do DOS e executando o comando tnsping + apelido do BD contido no arquivo tnsnames.ora (Ex.: tnsping orcl) . Ao executar este comando irá aparecer o caminho completo do arquivo sqlnet.ora. Este arquivo tem como função principal definir os métodos de conexão que o cliente poderá utilizar para acessar um ou mais BDs via Oracle Net Services. Na mesma pasta do sqlnet.ora, está o arquivo tnsnames.ora que o seu programa está utilizando. Se você não conseguir executar o comando acima ou se o sistema não funcionar do jeito que você esperava, configure uma variável de ambiente com o nome TNS_ADMIN (ver exemplo da Imagem 01) e valor contendo o caminho completo da pasta onde está o arquivo tnsnames.ora que você deseja utilizar, como no exemplo da imagem abaixo:

Imagem 01 - Configurando a variável de ambiente TNS_ADMIN

     Para simplificar um pouco mais o que expliquei nos parágrafos acima, o Oracle Net Services pode ser composto por 3 arquivos principais:

           - listener.ora: Localizado na máquina servidora

           - sqlnet.ora: Localizado na máquina cliente (que também pode ser uma máquina servidora)

           - tnsnames.ora: Localizado na máquina cliente (que também pode ser uma máquina servidora)

     Para que você consiga efetuar uma conexão em um ambiente de BD Oracle, é necessário apenas que você saiba configurar estes arquivos. Para quem quiser mais informações e sugestões de solução para problemas comumente encontrados em Oracle Net Services, tais como os erros TNS-03505, TNS-12541 e ORA-12154, sugiro a leitura do artigo Evitando os erros de TNS – Parte I.

Por hoje é só!

[]s
 
Referência:
    Treinamento oficial Oracle: Workshop Administration II