Conectando-se a um Banco de Dados a partir do Linux e do Sistemas UNIX Usando os Drivers DataDirect

Para permitir que um broker se conecte a um banco de dados, defina o DSN (Data Source Name) ODBC para o banco de dados.

As informações a seguir destinam-se apenas aos bancos de dados DB2, Informix, Oracle, Sybase e SQLServer. Para todos os outros bancos de dados suportados, consulte Conectando-se a um Banco de Dados a Partir dos Sistemas Linux e UNIX Utilizando o WebSphere Message Broker ODBC Database Extender (IE02).

Antes de começar:
  1. Copie o arquivo de amostra odbc.ini que é fornecido no diretório install_dir/ODBC/V6.0 para um local de sua escolha. Por exemplo, copie o arquivo para /var/mqsi, que é o diretório do usuário do WebSphere Message Broker, e o local preferencial desse arquivo copiado. Cada ID do usuário do serviço do broker no sistema pode, portanto, utilizar suas próprias definições de DSN.

    Consulte o conteúdo do arquivo de amostra em Arquivo odbc.ini de DataDirect de Amostra.

  2. Certifique-se de que o arquivo odbc.ini tenha a propriedade de arquivo mqm:mqbrkrs e as mesmas permissões do arquivo de amostra fornecido.
  3. Configure a variável de ambiente ODBCINI para apontar para seu arquivo odbc.ini, especificando um caminho e nome de arquivo completos. Certifique-se de apontar para a cópia e de não apontar para o arquivo odbc.ini nos diretórios de instalação.
  4. Se você estiver se conectando aos bancos de dados DB2 ou Informix, configure a variável de ambiente do caminho da procura da biblioteca para mostrar o local das bibliotecas para o gerenciador de banco de dados que você está usando.

    Para obter informações adicionais sobre o caminho da procura da biblioteca, consulte o administrador de banco de dados (DBA) ou consulte a documentação do gerenciador do banco de dados.

    A variável de ambiente de caminho da procura da biblioteca depende de sua plataforma:
    • Linux platformSolaris platform No Linux e Solaris, configure LD_LIBRARY_PATH.
    • HP-UX platform No HP-UX, configure SHLIB_PATH.
    • AIX platform No AIX, configure LIBPATH.

    As atualizações no caminho da procura da biblioteca não são necessárias para outros bancos de dados suportados.

  5. Se você estiver utilizando uma instância de banco de dados DB2 que está instalada no AIX, um único processo poderá fazer, no máximo, 10 conexões, utilizando a memória compartilhada para um banco de dados DB2. Utilize o modo TCP/IP para se conectar à instância de banco de dados; consulte A Mensagem de Erro SQL1224N do DB2 é Emitida Quando Você Conecta-se ao DB2.
  6. Edite a sub-rotina final no arquivo odbc.ini, a sub-rotina [ODBC], para especificar o local do Gerenciador de Driver ODBC e para controlar o rastreio. Os detalhes exatos na sub-rotina dependem da plataforma.
    Para assegurar que você editou o arquivo odbc.ini correto, é possível abrir o arquivo no editor de texto vi usando o seguinte comando:
    vi $ODBCINI
    1. No InstallDir, inclua o local da instalação do WebSphere Message Broker para concluir o caminho completo para o diretório ODBC. Se você não especificar este valor corretamente, a definição do ODBC não funcionará.
    2. Em TraceFile, digite o caminho completo e nome do arquivo no qual o rastreio ODBC será gravado. Os arquivos de rastreio podem tornar-se grandes; especifique um diretório com bastante espaço livre em disco.
    3. No TraceDll, inclua o local da instalação do WebSphere Message Broker para concluir o caminho completo para o DLL de rastreio do ODBC.
    4. Aceite os valores padrão mostrados no arquivo odbc.ini de amostra para todas as outras entradas na sub-rotina.
      Por exemplo,no AIX:
      ;##########################################
      ;###### Sub-rotina de informações obrigatórias ######
      ;##########################################
      
      [ODBC]
      ;# Para ativar o rastreio ODBC,configure Trace=1
      Trace=0
      TraceOptions=3
      TraceFile=<Um Diretório com grande quantidade de espaço livre para conter a saída
      de rastreio>/odbctrace.out
      TraceDll=<Seu diretório de instalação do Broker>/ODBC/V6.0/lib/odbctrac.so
      InstallDir=<Seu diretório de instalação do Broker>/ODBC/V6.0
      UseCursorLib=0
      IANAAppCodePage=4
      UNICODE=UTF-8
  7. Edite a primeira sub-rotina no arquivo odbc.ini, a sub-rotina [ODBC Data Sources], para listar o DSN de cada banco de dados.
    Por exemplo,no AIX:
    ;##########################################
    ###### Lista de sub-rotinas das origens de dados #######
    ;##########################################
    [ODBC Data Sources]
    DB2DB=IBM DB2 ODBC Driver
    ORACLEDB=DataDirect 6.0 Oracle Wire Protocol
    ORACLERACDB=DataDirect 6.0 Oracle Wire Protocol (Real Application Clusters)
    SYBASEDB=DataDirect 6.0 Sybase Wire Protocol
    SYBASEDBUTF8=DataDirect 6.0 Sybase UTF8 Wire Protocol
    SQLSERVERDB=DataDirect 6.0 SQL Server Wire Protocol
    INFORMIXDB=IBM Informix ODBC Driver
    

    Liste todos os seus DSNs no arquivo odbc.ini, independentemente do gerenciador de banco de dados. No Oracle e no Sybase, é possível definir vários DSNs para que sejam resolvidos no mesmo banco de dados; entretanto, se você estiver usando a coordenação global de transações, não use essa opção, pois ela pode causar problemas de integridade nos dados.

  8. Para cada banco de dados listado na sub-rotina [ODBC Data Sources], crie uma sub-rotina no arquivo odbc.ini após a sub-rotina [ODBC Data Sources]. As entradas na sub-rotina dependem do gerenciador de banco de dados. Também ocorrem suaves diferenças entre os sistemas operacionais, por exemplo, os caminhos de arquivo para os drivers.
    Para uma instância de banco de dados DB2:
    Para Linux em x86:
    1. Em Driver, inclua o caminho completo de sua instalação do DB2.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. No Banco de Dados, digite o alias do DB2. O nome da origem de dados deve ser o mesmo que o nome do alias do banco de dados. Se você estiver utilizando um banco de dados DB2 remoto, deverá configurar sua conexão de cliente-servidor para resolver este alias para o banco de dados correto.

      Se você precisar de diversas sub-rotinas que façam referência ao mesmo banco de dados DB2, aliases deverão ser criados no DB2 usando o comando CATALOG do DB2. Esses aliases podem então ter sua própria sub-rotina no arquivo ODBCINI.

      O arquivo ODBCINI não pode ser usado para configurar aliases para o DB2.

      Para obter informações adicionais, consulte a documentação do DB2.

      Por Exemplo:

      ;# Sub-rotina DB2
      [DB2DB]
      Driver=<Seu diretório de instalação do DB2>/lib32/libdb2.so
      Description=DB2 ODBC Database
      Database=DB2DB
    Para todas as outras plataformas:
    1. Em Driver, aceite o valor, conforme mostrado no arquivo de amostra odbc.ini.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. No Banco de Dados, digite o alias do DB2. O nome da origem de dados deve ser o mesmo que o nome do alias do banco de dados. Se você estiver utilizando um banco de dados DB2 remoto, deverá configurar sua conexão de cliente-servidor para resolver este alias para o banco de dados correto. Para obter informações adicionais, consulte a documentação do DB2.

      Se você precisar de diversas sub-rotinas que façam referência ao mesmo banco de dados DB2, aliases deverão ser criados no DB2 usando o comando CATALOG do DB2. Esses aliases podem então ter sua própria sub-rotina no arquivo ODBCINI.

      O arquivo ODBCINI não pode ser usado para configurar aliases para o DB2.

      Por exemplo, no AIX:

      ;# Sub-rotina DB2
      [DB2DB]
      DRIVER=<Your DB2 install directory>/lib64/db2o.o
      Description=DB2DB DB2 ODBC Database
      Database=DB2DB
    Para um banco de dados Oracle:
    Para todas as plataformas:
    1. Em Driver, inclua o local de instalação do WebSphere Message Broker para concluir o caminho completo do driver mostrado no arquivo odbc.ini de amostra.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. Em HostName, digite o nome ou o endereço IP da máquina que está hospedando o seu sistema Oracle.
    4. No PortNumber, digite o número da porta na qual o seu servidor Oracle está atendendo, na máquina especificada em HostName.
    5. Em SID, digite o nome de serviço Oracle ao qual você deseja conectar-se no sistema especificado em HostName.
    6. Aceite os valores padrão mostrados no arquivo odbc.ini de amostra para todas as outras entradas na sub-rotina.
      Por exemplo,no AIX:
      ;# Sub-rotina Oracle
      [ORACLEDB]
      Driver=<Seu diretório de instalação do Broker>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Nome da Máquina do Servidor Oracle>
      PortNumber=<Porta na qual o Oracle está atendendo no HostName>
      SID=<Seu SID do Oracle>
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Para um banco de dados Oracle que utiliza Clusters de Aplicativos Reais:
    Para todas as plataformas:
    1. Em Driver, inclua o local de instalação do WebSphere Message Broker para concluir o caminho completo do driver mostrado no arquivo odbc.ini de amostra.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. No HostName, digite o nome ou o endereço IP da máquina que está hospedando sua instância Oracle primária (preferencial).
    4. No PortNumber, digite o número da porta na qual o seu servidor Oracle está atendendo, na máquina especificada em HostName.
    5. No ServiceName, digite o nome do serviço de Cluster de Aplicativo Real Oracle ao qual você deseja conectar-se na instância especificada em HostName.
    6. No AlternateServers, forneça uma lista de locais alternativos para esse serviço para situações quando o local primário, definido no HostName, estiver indisponível. Cada especificação de local consiste em três partes, separadas por dois pontos. Insira esses valores como uma sequência contínua; o texto nesse exemplo foi divido para melhorar a capacidade de leitura.
      HostName=<Nome do host alternativo>
      :PortNumber=<Porta listener do Oracle no servidor alternativo>
      :ServiceName=<Nome do serviço no servidor alternativo>
      Se você desejar especificar mais de um AlternateServer, separe cada especificação de local adicional com uma vírgula. Sempre que uma nova conexão com o banco de dados for necessária, por exemplo, após um failover da instância Oracle, o local primário será tentado primeiro. Entretanto, se o local primário estiver indisponível, o driver tentará então a lista de locais alternativos.
    7. Aceite os valores padrão mostrados no arquivo odbc.ini de amostra para todas as outras entradas na sub-rotina.
      Por exemplo,no AIX:
      ;# Sub-rotina Oracle Real Application Clusters
      [ORACLERACDB]
      Driver=<Seu diretório de instalação do Broker>/ODBC/V6.0/lib/UKora24.so
      Description=DataDirect 6.0 Oracle Wire Protocol
      HostName=<Nome da Máquina do Servidor Oracle>
      PortNumber=<Porta na qual o Oracle está atendendo no HostName>
      ServiceName=<Nome do Serviço do Oracle Real Application Cluster>
      AlternateServers=(HostName=<Nome do host alternativo>:PortNumber=<Porta
      na qual o Oracle está atendendo no host alternativo>:ServiceName=<Seu
      Nome do Serviço do Cluster de Aplicativo Real Oracle>)
      CatalogOptions=0
      EnableStaticCursorsForLongData=0
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      WorkArounds=536870912
      ProcedureRetResults=1
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Para um banco de dados Sybase:
    Para todas as plataformas, exceto Linux em System z:
    1. Em Driver, inclua o local de instalação do WebSphere Message Broker para concluir o caminho completo do driver mostrado no arquivo odbc.ini de amostra.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. Em Banco de Dados (Database), digite o nome do banco de dados ao qual você deseja conectar-se por padrão. Se não for especificado um valor, o valor padrão é o banco de dados definido por seu administrador de sistema para cada usuário.
    4. Em NetworkAddress, digite o endereço de rede de seu servidor Sybase ASE (este endereço é necessário para bancos de dados remoto e local). Especifique um endereço IP ou nome de servidor conforme a seguir:
      <Your Sybase server name or IP address>,<Your Sybase port number>

      Por exemplo: Sybaseserver,5000. É possível também especificar o endereço IP diretamente, por exemplo, 199.226.224.34,5000. É possível localizar o número da porta no arquivo de interfaces do Sybase denominado interfaces.

    5. Aceite os valores padrão mostrados no arquivo odbc.ini de amostra para todas as outras entradas na sub-rotina.
      Por exemplo,no AIX:
      ;# Sub-rotina Sybase
      [SYBASEDB]
      Driver=<Seu diretório de instalação do Broker>/ODBC/V6.0/lib/UKase24.so
      Description=DataDirect 6.0 Sybase Wire Protocol
      Database=<Seu Nome do Banco de Dados>
      ApplicationUsingThreads=1
      EnableDescribeParam=1
      OptimizePrepare=1
      SelectMethod=0
      NetworkAddress=<Nome do seu Servidor Sybase>,<Número da sua Porta Sybase>
      SelectUserName=1
      ColumnSizeAsCharacter=1
      EnableSPColumnTypes=2
      LoginTimeout=0
      TimestampTruncationBehavior=1
      XAConnOptBehaviour=3
      Se você desejar utilizar uma origem de dados do Sybase UNICODE UTF8, inclua a seguinte linha no final de sua sub-rotina do Sybase:
      Charset=UTF8
    Para acesso remoto a um banco de dados do Servidor SQL
    Para todas as plataformas, exceto Linux em POWER, Linux em System z e Solaris em x86-64:
    1. Em Driver, inclua o local de instalação do WebSphere Message Broker para concluir o caminho completo do driver mostrado no odbc.ini de amostra.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. No Endereço, ou:
      1. Especifique um endereço IP ou nome do servidor e um número de porta para localizar o banco de dados SQLServer a que deseja se conectar, da seguinte maneira:
        <Your SQLServer machine name or IP address>,<Your SQLServer port number>
        ou
      2. Especifique um endereço IP ou nome do servidor e um nome de instância para localizar o banco de dados SQLServer a que deseja se conectar, da seguinte maneira:
        <Your SQLServer machine name or IP address>\<Your SQLServer instance name>
        Se o nome de sua instância estiver em branco, especifique <o nome de seu computador SQLServer ou o endereço IP>
    4. Em Banco de Dados (Database), digite o nome do banco de dados ao qual você deseja conectar-se por padrão. Se não for especificado um valor, o valor padrão é o banco de dados definido por seu administrador de sistema para cada usuário.
    5. Aceite os valores padrão mostrados no arquivo odbc.ini de amostra para todas as outras entradas na sub-rotina.
      Por exemplo, no AIX:
      ;# UNIX para sub-rotina SQLServer
      [SQLSERVERDB]
      Driver=<Seu diretório de instalação do Broker>/ODBC/V6.0/lib/UKmsss24.so
      Description=DataDirect 6.0 SQL Server Wire Protocol
      Address=<Your SQLServer Machine Name>,<Your SQLServer Port Number>
      ;# Caminho alternativo para localizar o servidor usando uma instância denominada
      ;# Address=<Your SQLServer Machine Name>\<Your SQLServer Instance Name>
      AnsiNPW=Yes
      Database=db
      QuotedId=No
      ColumnSizeAsCharacter=1
      LoginTimeout=0
    Para um banco de dados Informix
    Para Linux em x86
    1. Em Driver, inclua o caminho completo de sua biblioteca do Informix Client.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. Em Nome do Servidor, digite o nome do servidor IDS do Informix.
    4. Em Banco de Dados (Database), digite o nome do banco de dados ao qual você deseja conectar-se por padrão. Se não for especificado um valor, o valor padrão é o banco de dados definido pelo administrador do sistema para cada usuário.
      Por exemplo
      ;# Sub-rotina Informix
      [INFORMIXDB]
      Driver=<Seu Diretório Informix Client>/lib/cli/iclit09b.so
      Description=IBM Informix ODBC Driver
      ServerName=<Seu Nome de Servidor Informix>
      Database=<Seu Nome do Banco de Dados>
    Para todas as outras plataformas:
    1. Em Driver, aceite o valor, conforme mostrado no arquivo de amostra odbc.ini.
    2. Em Descrição (Description), digite uma descrição significativa do banco de dados. Esse campo é somente informativo e não afeta a conexão.
    3. Em Nome do Servidor, digite o nome do servidor IDS do Informix.
    4. Em Banco de Dados (Database), digite o nome do banco de dados ao qual você deseja conectar-se por padrão. Se não for especificado um valor, o valor padrão é o banco de dados definido pelo administrador do sistema para cada usuário.
      Por exemplo, no AIX:
      ;# Sub-rotina Informix
      [INFORMIXDB]
      Driver=libinfWrapper.so
      Description=IBM Informix ODBC Driver
      ServerName=<Seu Nome de Servidor Informix>
      Database=<Seu Nome do Banco de Dados>
  9. Assegure-se de ter editado as três partes do arquivo odbc.ini:
    • A sub-rotina [Origem de Dados ODBC] na parte superior do arquivo odbc.ini.
    • Uma sub-rotina para cada origem de dados.
    • A sub-rotina [ODBC] no final do arquivo odbc.ini.
    Se você não configurar todas as três partes corretamente, os DSNs ODBC não funcionarão e o broker não conseguirá conectar-se ao banco de dados.
Agora você configurou conexões com o banco de dados no Linux e UNIX.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:50:58


Tópico de TarefaTópico de Tarefa | Versão 7.0.0.5 | bh26080_