Conexão com MySQLi

No Scriptcase, temos os seguintes drivers disponíveis para conexões com o MySQL/MariaDB: MySQL PDO e MySQLi. Se você estiver usando seu próprio ambiente pré-configurado, as extensões do MySQL/MariaDB devem ser habilitadas manualmente no PHP.

Pré-requisitos

Se você estiver usando uma instalação manual no MacOS, você precisará instalar o PHP, e o driver MySQL/MariaDB será habilitado. Clique aqui para saber como fazer isso.

1 - Verifique se o driver MySQL/MariaDB está habilitado em seu diagnóstico do Scriptcase. Veja abaixo como localizar seu diagnóstico e verifique se o driver está habilitado.

• Ao acessar o menu superior Ajuda > Diagnóstico, você pode encontrá-lo facilmente através da interface.

• Ou, acessando seu caminho de instalação do Scriptcase:

127.0.0.1/scriptcase/diagnosis.php ou domain.com/scriptcase/diagnosis.php

Criando uma conexão com o ScriptCase

O erro Server sent charset unknown to the client pode ser apresentado caso você esteja utilizado o MySQL 8 em um ambiente que utilize o PHP 7. Clique aqui e veja como contornar este erro. Este problema não ocorre em ambientes com o PHP 8.1

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

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

Conexão

Informe os parâmetros para conexão ao seu banco de dados MySQL 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 MySQL para conexão. Neste exemplo, utilizamos o Driver MySQLi.

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

• Porta: Informe a porta para conexão com o banco de dados.

• Usuário: Informe o usuário para autenticação com o seu banco de dados MySQL.

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

• Testar Conexão: Clique neste botão para saber se os dados informados foram corretos e a conexão bem sucedida.

Segurança

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

Usar SSL

Ativa ou desativa o uso de conexões seguras com o MySQL.

Chave do cliente

Caminho para a chave de identificação privada do cliente no formato PEM.

Certificado do cliente

Caminho para a chave do certificado público do cliente.

Caminho CA

Caminho para o diretório que contém o Certificado de Autoridade (CA) no formato PEM, se usado, deve especificar o mesmo certificado usado pelo servidor.

Certificado CA

Caminho para o Certificado de Autoridade (CA) no formato PEM. Esta opção, se utilizada, deve especificar o mesmo certificado que o servidor.

Chipher específico

Uma lista de números permitidos para uso com a criptografia da conexão. Se um dos números não for suportado, a conexão SSL não funcionará.

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 MySQL 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, o Scriptcase habilita esta opção.
    
    
• Views: Selecionando esta opção, as views do seu banco de dados serão exibidas.
  • Por padrão, 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, os procedimentos 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.
  • E.g.
    
    

  

• 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 mudanças 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 o client_encoding UTF-8.

• Separador de 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, o Scriptcase desabilita esta opção.
    
    
• Usar o esquema antes do nome da tabela: Definir se o esquema do banco de dados é exibido antes dos nomes das tabelas.

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

  • E.g.

  

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.