Feedback Imprimir

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:8091/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 do 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

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 pdo_ibm e 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 pdo_ibm e ibm_db2. Veja o exemplo abaixo:

extension=ibm_db2
extension=pdo_ibm

Habilitando extensões do DB2

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

Configuração do DsDriver DB2

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

Configuração do DsDriver DB2

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

Configuração do DsDriver DB2

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

Configuração do DsDriver DB2

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

Configuração do DsDriver DB2

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 ApacheScriptcase9php73 e clique com o botão direito neste serviço, depois em Reiniciar.

Reiniciando Apache

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:

Gerenciador ODBC

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.

Criando DSN

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

Selecionando Driver ODBC

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

Nomeando DSN

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

DSN credenciais

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

DSN Database

  • 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

Criando uma nova conexão

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

Criando uma 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.

Selecionando a conexão ao banco de dados

Conexão

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

Conectando ao banco de dados

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

Testando a conexão ao banco de dados

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.

Filtrando a conexão do banco de dados

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:

    Exemplo da utilização do prefixo


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

Configuração avançada da conexão do banco de dados

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