Conexão com DB2 ODBC Nativo

No Scriptcase, temos disponíveis os seguintes drivers para conexão com o DB2: DB2 e DB2 ODBC Nativo. Se você estiver utilizando um ambiente próprio, pré-configurado, as extensões do DB2 devem ser habilitadas manualmente no PHP.

Nota: Os passos descritos nessa documentação só são válidos para dispositivos mac que possuem processadores com arquitetura x64

Instalando IBM DSDRIVER

Baixe o instalador do IBM DSDRIVER

• IBM DsDriver: Clique aqui

Siga os passos abaixo para instalar corretamente.

1 - Dê um duplo clique no arquivo v11.1.1fp1_macos_dsdriver.dmg

Uma nova janela do Finder será aberta com o conteúdo da imagem do disco.​

2- Execute o script de instalação:

• Na janela do Finder, localize o arquivo installDSDriver.sh.

• Dê um duplo clique no arquivo installDSDriver.sh para iniciar a instalação.

• O pacote do driver será instalado no local padrão: /Applications/dsdriver.

Configurando as variáveis de ambiente

Para que o PHP reconheça o driver Db2, configure as seguintes variáveis de ambiente:

Abra o arquivo ~/.bash_profile ou ~/.zshrc (dependendo do shell que você está usando) em um editor de texto e adicione a seguinte linha

export IBM_DB_HOME=/Applications/dsdriver
export DYLD_LIBRARY_PATH=$IBM_DB_HOME/lib
export PATH=$IBM_DB_HOME/bin:$PATH

Salve o arquivo e execute o seguinte comando para aplicar as alterações:

source ~/.bash_profile  ou  source ~/.zshrc

Configurado o ODBC Driver Manager

1- Abra o Gerenciador ODBC e, na aba Driver, adicione o driver nativo do DB2. Especifique “Driver Nativo do DB2” no slot “Nome do Driver” e “/Applications/dsdriver/lib/libdb2.dylib” no slot “Arquivo do Driver”

2 - Na aba “DSN do Sistema” do Gerenciador ODBC, crie um DSN do DB2

• No slot “Escolher um Driver”, especifique o “Driver Nativo do DB2” definido acima
• Especifique um DSN no slot “Nome da Fonte de Dados (DSN), por exemplo, “db2” e clique em “Adicionar” para criar o DSN do sistema.

Configurando o arquivo db2dsdriver.cfg

Antes de criar a conexão na interface do Scriptcase é preciso configurar o arquivo db2dsdriver.cfg

O arquivo pode vir com o nome db2dsdriver.cfg.sample. Basta criar uma cópia desse arquivo e renomear para db2dsdriver.cfg

Caso não ache o arquivo você também poderá criá-lo manualmente.

1 : Abra o arquivo db2dsdriver.cfg que está em /Applications/dsdriver/cfg/ e configure o arquivo como na estrutura abaixo e depois salve.

<configuration>
<dsncollection>
    <dsn alias="db2" name="db2" host="hotel53.torolab.ibm.com" port="5000" ldap=1/>
</dsncollection>
    <databases>
         <database name="SAMPLE" host="hotel53.torolab.ibm.com" port="5000">
         </database>
    </databases>
</configuration>

O arquivo .cfg precisa ser correspondente à configuração feita no gerenciador ODBC, ou seja, o alias e o name do DSN precisa ser o mesmo especificado no passo 2 da configuração do ODBC Driver Manager

Após ter configurado o arquivo, reinicie o apache e crie a conexão.

Criando um Conexão no Scriptcase

Veja abaixo como criar uma conexão em seu projeto do Scriptcase, utilizando o Driver habilitado e o banco de dados DB2.

1 - Acesse um projeto do seu Scriptcase.

2 - Clique no ícone Nova Conexão para criar uma conexão

ou acesse o menu Banco de Dados > Nova conexão.

Após isto, será exibida uma tela com todas as conexões de banco de dados.

3 - Selecione a conexão DB2.

Conexão

Informe os parâmetros para conexão ao seu banco de dados DB2 da seguinte forma:

• Nome da conexão: Defina o nome de sua nova conexão. Por padrão, o Scriptcase adciona o prefixo conn juntamente do nome do banco de dados.

• Driver do SGDB: Selecione o Driver DB2 para conexão. Neste exemplo, utilizamos o Driver DB2 ODBC Nativo.

• Servidor do SGDB: Informe o IP ou domínio do servidor onde o banco de dados está instalado.

• EX: dominiodoserver.com ou 192.168.254.170

• Porta: Informe a porta para conexão com o DB2. Por padrão, a porta definida é 50000.

• Base de Dados: Informe o nome do banco de dados que você irá se conectar.

• EX: SAMPLE

• Esquema: Informe o Esquema de tabelas específicas criadas para uso do usuário informado.
  • Este item é opcional caso não tenha um esquema configurado em seu banco de dados.
    
    

• Usuário: Informe o usuário para autenticar a conexão com o seu banco de dados.

• Senha: Informe a senha para concluir o processo de autenticação.

• Testar conexão: Clique neste botão para obter uma reposta da requisição do Scriptcase para saber se os parâmetros informados estão corretos.

Segurança

Nesta aba você pode definir uma criptografia SSL para sua conexão de banco de dados. Verifique abaixo como fazer isso.

security

Define o nível de segurança da conexão com o banco de dados, configurando como a conexão lida com a autenticação e a proteção dos dados em trânsito. Pode incluir definições para criptografar a comunicação entre o cliente e o servidor..

sslservercertificate

Especifica o caminho para o certificado SSL do servidor, usado para autenticar o servidor para o cliente e garantir que a conexão seja estabelecida com o servidor correto. Este certificado ajuda a validar a identidade do servidor para proteger a comunicação.

sslclientkeystoredb

Define o arquivo de banco de chaves (keystore) do cliente, onde são armazenadas as chaves públicas e privadas e os certificados necessários para a autenticação SSL entre o cliente e o servidor.

sslclientkeystash

Especifica o arquivo que armazena as senhas de acesso ao keystore do cliente de maneira criptografada, permitindo que o cliente acesse suas chaves e certificados sem precisar fornecer a senha diretamente.

authentication

Controla o método de autenticação a ser usado na conexão, especificando como o cliente deve se autenticar ao acessar o banco de dados (por exemplo, via usuário e senha, certificados, ou outros métodos de autenticação suportados).

sslclientlabel

Define o rótulo específico para o certificado do cliente no keystore, que será usado para identificar o certificado correto ao autenticar o cliente junto ao servidor.

Filtro

Acessando esta aba, você pode configurar quais itens do Banco de Dados serão exibidos na conexão, podendo depender ou não do proprietário.

Exibir

Permite que a conexão possa enxergar tabelas, views, tabelas do sistema e procedures dependendo dos itens selecionados pelo usuário. Por padrão, os itens Tabelas e Views já são selecionados pelo Scriptcase.

• Tabelas: Selecionando esta opção, as tabelas da sua base de dados serão exibidas.
  • Por padrão, o Scriptcase habilita esta opção.
    
    
• Views: Selecionando esta opção, as views da sua base de dados serão exibidas.
  • Por padrão, o Scriptcase habilita esta opção.
    
    

• Tabelas do Sistema: Selecionando esta opção, as tabelas do sistema da sua base de dados serão exibidas.

• Procedures: Selecionando esta opção, as procedures da sua base de dados serão exibidas.

Filtros

Permite definir quais tabelas e proprietários serão exibidos.

• Tabelas: Você pode definir nesta opção quais tabelas serão exibidas. A configuração pode conter um PREFIXO% ou nome das tabelas para exibição.
  • Por padrão, o Scriptcase deixa esta opção vazia.
  • EX:
    
    

  

• Proprietário: Informe o usuário que enxerga as tabelas informadas para exibição.
  • O usuário deve estar em maiúsculo como no exemplo acima.
    
    
• Exibir: Escolha se as tabelas do proprietário informado serão exibidas.

NOTA: Ao utilizar a filtragem de tabelas, você elimina tabelas desnecessárias para o seu projeto e melhora a performance da conexão do seu banco de dados.

Avançado

Nesta aba, você tem acesso a configurações específicas para a conexão. As configurações realizadas nesta sessão impactam na exibição dos dados e performance das aplicações.

• client_encoding: Selecione a codificação utilizada no seu banco de dados. No exemplo acima, utilizamos o client_encoding UTF-8.
  • Por padrão, esta opção é deixada em branco pelo Scriptcase.
    
    
• Separador De Decimal: Selecione o tipo do separador dos registros decimais, entre vírgula e ponto.
  • Por padrão, é selecionado o ponto . como separador.
    
    
• Conexão Persistente: Defina se as conexões serão encerradas após a execução dos seus scripts nas aplicações do Scriptcase.
  • Por padrão, o Scriptcase desativa esta opção.
    
    
• Usar o esquema antes do nome da tabela: Defina se o esquema do banco de dados será exibido antes dos nomes das tabelas.
  • Por padrão, o Scriptcase ativa esta opção.

SSH

Aqui estão as opções de SSH disponíveis na imagem e suas descrições relacionadas à conexão com o banco de dados:

Usar SSH

Habilita ou desabilita o túnel SSH para a conexão com o banco de dados. Quando ativado, a conexão com o banco de dados será roteada através do servidor SSH.

Servidor SSH

O endereço IP ou nome do host do servidor SSH que será utilizado para o tunelamento. Esta é a máquina que atuará como uma ponte para acessar o banco de dados com segurança.

Porta SSH

A porta utilizada para se conectar ao servidor SSH. A porta padrão do SSH é 22, a menos que tenha sido configurada de outra forma no servidor.

Usuário SSH

O nome de usuário utilizado para autenticação no servidor SSH. Esse usuário deve ter permissões para estabelecer uma conexão SSH.

Arquivo de certificado privado

O arquivo de chave privada utilizado para autenticação, caso o servidor SSH exija autenticação baseada em chave em vez de senha.

Porta local para porwarding

A porta local na máquina cliente que será utilizada para encaminhar o tráfego do banco de dados através do túnel SSH. Essa porta atua como uma ponte entre o cliente do banco de dados e o banco de dados remoto.

Servidor de banco a partir do SSH

O nome do host ou endereço IP do servidor de banco de dados conforme visto a partir do servidor SSH. Isso é necessário quando o banco de dados só é acessível dentro da rede do servidor SSH.

Porta do banco a partir do SSH

A porta do servidor de banco de dados que será acessada através do túnel SSH. Essa porta deve corresponder à porta de escuta do serviço de banco de dados.

Dúvidas ou Problemas de Conexão?

Contacte o nosso suporte em caso de problemas de conexão ou dúvidas a respeito deste banco de dados.