Conexão com Sybase PDO ODBC

No Scriptcase, temos disponíveis os seguintes drivers para conexão com o Sybase: Sybase PDO DBLIB, Sybase PDO ODBC e Sybase. Se você estiver utilizando um ambiente próprio, pré-configurado, a extensão do Sybase deve ser habilitada manualmente no PHP.

NOTA: Se você tiver uma instalação automática do Scriptcase, os drivers Sybase PDO DBLIB e Sybase PDO ODBC já estão hablitidados.

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().

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

Abaixo estão listados os arquivos necessários para que os drivers sejam habilitados:

Você precisará entrar no site www.sap.com e baixar o Driver ODBC Sybase de 32 ou 64 bits. A arquitetura do instalador deve ser igual a arquitetura do sistema operacional.

Configurando o Sybase ODBC

NOTA: Caso possua uma fonte de dados configurada prossiga, para Criação da Conexão no Scriptcase.

1 - Acesse Painel de Controle > Sistemas e Segurança > Ferramentas Administrativas > Fontes de Dados ODBC(32 ou 64 bits), de acordo com a arquitetura do seu PHP.

2 - Selecione a aba Fonte de dados de sistema e clique em Adicionar.

3 - Escolha o driver do Sybase: * Adaptive Server Enterprise

4 - Após selecionar o driver será exibida a tela abaixo, na aba “Geral” você vai precisar informar os dados de conexão ao banco:

• Data Source Name: Nome da fonte de dados que será utilizado na criação da conexão no Scriptcase
• Server Name: IP do servidor que está o banco de dados Sybase
• Server Port: Informe a porta de conexão com o seu banco de dados. A padrão utilizada é 5002
• Database Name: Nome da sua base de dados
• Logon ID: Nome do usuário do seu banco de dados
• Service Name: Nome do serviço do seu banco de dados
• BackEnd Type: Tipo do seu banco de dados

5 - Após informar os dados acima, clique em Advanced > Client Charset > Others, para informar o charset da sua base de dados.

6 - Após realizar as configurações acima clique em OK para finalizar a criação da fonte de dados ODBC. Será exibida a tela de Administrador de Fontes de Dados ODBC onde é possível visualizar a fonte de dados criada.

Criando um Conexão no Scriptcase

Veja abaixo como criar uma conexão em seu projeto Scriptcase utilizando o banco de dados Sybase.

1 - Acesse qualquer projeto a partir de seu Scriptcase.

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

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

Depois disso, uma nova página aparecerá com todas as conexões de banco de dados.

3 - Selecione a conexão Sybase.

Conexão

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

• Nome da Conexão: Defina o nome de sua nova conexão. Por padrão, Scriptcase adiciona o prefixo conn junto com o nome do banco de dados.

• Driver do SGDB: Selecione o Driver Sybase utilizado para conectar. Neste exemplo, usamos o Driver Sybase PDO ODBC.

• Servidor do SGDB: Digite o DataSource Name onde o banco de dados foi configurado para conexão ODBC.
  • Ex: sybase__test

• Porta: Digite o número da porta para conexão com o seu banco de dados.

• Usuário: Informe o usuário para autenticar a conexão ao DataSource Name Sybase.

• Senha: Digite a senha para completar o processo de autenticação.

• Base de Dados: Digite o nome de seu banco de dados para se conectar com ele. Ou, se você quiser escolher um banco de dados diferente, clique no botão Listar Bases para mostrar todos os bancos de dados disponíveis para seu usuário.
  • Criar Base: Clicando neste botão, você criará um novo banco de dados Sybase para uso.
• Testar Conexão: Clique neste botão para obter uma resposta do pedido do Scriptcase para saber se os parâmetros inseridos estão corretos.

Filtro

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

Exibir

Permite que a conexão Sybase veja tabelas, vistas, tabelas do sistema e procedures dependendo dos itens selecionados pelo usuário. Por padrão, os itens Tabelas e Views já estão selecionados pelo Scriptcase.

• Tabelas: Ao selecionar esta opção, as tabelas em seu banco de dados serão exibidas.
  • Por padrão, Scriptcase habilita esta opção.
    
    
• Views: Selecionando esta opção, as visualizações de seu banco de dados serão exibidas.
  • Por padrão, Scriptcase habilita esta opção.
    
    

• Tabelas de sistema: Ao selecionar esta opção, as tabelas do sistema de seu banco de dados serão exibidas.

• Procedures: Ao selecionar esta opção, as procedures de seu banco de dados serão exibidos.

Filtros

Permite definir quais tabelas e proprietários sã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 a serem exibidas.
  • Por padrão, o Scriptcase deixa esta opção vazia.
  • Ex:
    
    

  

• Proprietário: Informar o usuário que vê as tabelas inseridas para exibição.
  • O usuário deve estar em letras maiúsculas, como no exemplo acima.
    
    
• Exibir: Escolha se são exibidas tabelas para o proprietário informado.

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

Avançado

Nesta aba, você tem acesso a configurações específicas para a conexão. As alterações feitas nesta sessão impactam a exibição de dados e o desempenho da aplicação.

• client_encoding: Selecione a codificação utilizada em seu banco de dados. No exemplo acima, utilizamos a codificação client_encoding UTF-8.

• Separador decimal: Selecione o tipo de separador para registros decimais, entre vírgula e ponto.
  • Por padrão, o ponto . é selecionado como um separador.
    
    
• Conexão persistente: Defina se as conexões serão fechadas após a execução de seus scripts em aplicações Scriptcase.
  • Por padrão, Scriptcase desabilita esta opção.
    
    
• Use o esquema antes do nome da tabela: Definir se o esquema do banco de dados é exibido antes dos nomes das tabelas.

  • Por padrão, Scriptcase habilita esta opção.

  • Ex:

  

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.

Método de autenticação

É possível escolher duas opções: password ou certificado. Ao escolher uma das opções, um novo campo será exibido abaixo para a configuração.

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.