Conexão com DB2 PDO ODBC

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

Pré-requisitos

Antes de prosseguir nesta documentação, verifique a arquitetura do seu PHP. Para que os drivers sejam habilitados corretamente, os arquivos devem ser baixados de acordo com a arquitetura utilizada.

• No seu Scriptcase, existe o arquivo info.php, acesse-o pela URL: http://127.0.0.1:8092/scriptcase/info.php, onde você irá encontrar a informação referente a arquitetura no phpinfo().

NOTA: Se você estiver utilizando o instalador automático do Scriptcase, a arquitetura do PHP será a mesma do instalador que você baixou. Realize o download do IBM Data Server Runtime Client de acordo com a arquitetura do seu PHP.

• Arquitetura x86 = 32 bits
• Arquitetura x64 = 64 bits

Abaixo estão listados os arquivos necessários para que os drivers do DB2 sejam habilitados.

Arquivos necessários:

x64

• IBM Data Server Runtime Client 11.5(x64): Clique Aqui

x86

• IBM Data Server Runtime Client 11.5(x86): Clique Aqui

Outros Arquivos

• Extensões PHP (PHP_PDO_IBM e PHP_IBM_DB2): Clique Aqui

Configurando o DB2 PDO ODBC no Windows

Antes de instalar o IBM Data Server Runtime Client, você precisa habilitar as extensões no PHP para que o Scriptcase reconheça os drivers de conexão com o DB2. Siga os passos abaixo para habilitar corretamente todos os drivers no Scriptcase.

IMPORTANTE: Se você estiver utilizando o instalador automático do Scriptcase, as extensões já estão habilitadas no PHP, necessitando apenas da instalação do client. Prossiga para o item 3.

1 - Extraia o arquivo .zip e copie os arquivos das extensões php_pdo_ibm e php_ibm_db2 .dll baixados anteriormente para a pasta ext do seu PHP.

2 - No arquivo php.ini, localizado em C:\php, adicione as linhas referente as extensões do DB2 php_pdo_ibm e php_ibm_db2. Veja o exemplo abaixo:

extension=ibm_db2
extension=pdo_ibm

3 - Após o download, siga o wizard de instalação clicando em avançar mantendo os valores padões do instalador.

4 - Aceite os termos e prossiga com a instalação.

5 - Clique em Avançar, para manter os valores padrões do instalador

6 - Clique em Instalar, para iniciar o processo de instalação

7 - Clique em concluir, para finalizar a instalação.

8 - Reinicie o serviço do Apache através do Gerenciador de Tarefas.

• Abra o Gerenciador de Tarefas e clique na aba Serviços.

• Procure pelo serviço ApacheScriptcase9php81 e clique com o botão direito neste serviço, depois em Reiniciar.

Realizando a criação do DSN para conexão

Para realizar a conexão com o Driver DB2 PDO ODBC, você precisa criar manualmente um DataSource Name nos arquivos do DB2. Siga os passos descritos abaixo para realizar esta configuração.

ATENÇÃO: O ODBC deve ser criado no mesmo Servidor onde está instalado o ScriptCase.

1 - Acesse o seu Gerenciador de fonte de dados ODBC e selecione de acordo com a sua arquitetura. Selecionaremos a versão x64:

2 - Ao entrar no Administrador de Fontes de Dados ODBC, selecione a aba DSN de Sistema e clique em Adicionar para criar sua conexão com seu Banco de Dados.

3 - Após isto, é necessário selecionar o Driver para conexão com o DB2. Selecione o Driver: IBM DB2 ODBC DRIVER.

4 - Agora, é preciso definir o nome do DSN e o alias do Banco de dados.

• Nome da Origem de Dados: Informe o nome que o DSN irá ter para que você possa utilizá-lo no Scriptcase.

• Alias do banco de dados: Inclua e informe o nome do Banco de dados que você irá se conectar.

• Descrição: Adicione uma descrição para o DSN.

4.1 - Após informar o nome e a descrição clique no botãoApós informar o nome e a descrição clique no botão Incluir.

• ID de Usuário: Informe o usuário para autenticar com o banco de dados DB2.

• Senha: Informe a senha correspondente para autenticar com o usuário informado.

• Salvar Senha: Ao marcar esta opção, a senha fica armazenada para autenticações futuras e testes de conexão.

4.2 - Agora, para configurar o banco de dados clique na aba TCP/IP.

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

• Alias do Banco de Dados: Informe o alias do banco de dados, se o banco possuir. Caso não, utilize o mesmo nome do banco de dados.

• Nome do host: Informe o IP ou domínio do servidor onde o banco DB2 está instalado.

• Número da Porta: Informe a porta para conexão. Por padrão, bancos DB2 utilizam a porta 50000.

Para finalizar, clique em OK.

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.

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 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 para conexão. Neste exemplo, utilizamos o Driver DB2 PDO ODBC.

• Servidor do SGDB: Informe o DSN de Sistema criado na Fonte de Dados ODBC.

• EX: db2

• 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.

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.

• 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.

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.