Feedback
  1. conexoes scriptcase
  2. mssql
  3. windows
  4. Conexão com MSSQL Server NATIVE SRV

Conexão com MSSQL Server NATIVE SRV

No Scriptcase, temos disponíveis os seguintes drivers para conexão com o SQL Server no Windows: MSSQL Server NATIVE SRV, MSSQL Server NATIVE SRV PDO e MSSQL Server ODBC. Se você estiver utilizando um ambiente próprio, pré-configurado, as extensões do MSSQL 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 Microsoft ODBC Driver 13 For SQL Server de acordo com a arquitetura do seu PHP.

Arquitetura do PHP

  • Arquitetura x86 = 32 bits
  • Arquitetura x64 = 64 bits
Lista de arquivos

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

NOTA: Se for necessário a utilização de Identificadores de banco de dados em suas tabelas, recomendamos a utilização das aspas duplas ( “ ) ao invés dos colchetes ( [ ] ) devido ao conflito com a sintaxe das variáveis globais do Scriptcase. Utilizar os colchetes como Identificadores de banco de dados, poderá acarretar em problemas no funcionamento das aplicações do Scriptcase.

Configurando o MSSQL Server Native SRV

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_sqlsrv_81_nts_x64 e php_sqlsrv_81_nts_x64 .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 MSSQL Server php_pdo_sqlsrv_81_nts_x64 e php_sqlsrv_81_nts_x64. Veja o exemplo abaixo:

extension=pdo_sqlsrv_81_nts_x64
extension=sqlsrv_81_nts_x64

Habilitando extensões do MSSQL

3 - Após baixar o arquivo do Microsoft ODBC Driver 13 For SQL Server anteriormente, execute o instalador e siga os passos abaixo:

Wizard de instalação.

4 - Aceite os termos do contrato de licença e clique em avançar.

Wizard de instalação.

5 - Marque a opção “ODBC Driver for SQL Server SDK”, pois os componentes que vamos precisar também estão nesta opção.

Wizard de instalação.

  • Nesta opção deixe marcado a opção “Client Components”.

6 - Clique em Instalar para iniciar a instalação do client.

Wizard de instalação.

7 - Os recursos do programa que você selecionou estão sendo instalados.

Wizard de instalação.

8 - Clique em concluir para sair.

Wizard de instalação.

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

Reiniciando Apache

Criando um Conexão no Scriptcase

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

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 MSSQL Server.

Selecionando a conexão ao banco de dados

Conexão

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

  • Servidor do SGDB: Informe o IP ou domínio do servidor onde o banco de dados está instalado e a sua instância separados por uma barra invertida.

  • EX: dominiodoserver.com\SQLEXPRESS ou 192.168.254.170\SQLEXPRESS

  • Porta: Informe a porta para conexão com o MSSQL Server. Por padrão, a porta definida é 1433.

  • Base de Dados: Liste e selecione o banco de dados que você irá se conectar.

  • EX: samples

  • 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

Segurança

Aba segurança, onde é definida as configurações de criptografia da conexão.

Segurança na conexão do banco de dados

  • Encrypt

    Essa propriedade especifica se a comunicação com o servidor SQL deve ser criptografada. Para habilitar a criptografia, você deve definir essa propriedade como “true”. Isso garante que os dados enviados entre o cliente e o servidor sejam protegidos por criptografia.

  • trustservercertificate

    Defina como “true” para especificar que o driver não valida o certificado TLS/SSL do servidor.

    Se for “true”, o certificado TLS/SSL do servidor será automaticamente confiável quando a camada de comunicação for criptografada usando TLS.

  • trustStore

    O caminho (incluindo o nome do arquivo) para o arquivo trustStore do certificado. O arquivo trustStore contém a lista de certificados nos quais o cliente confia.

    Quando essa propriedade não é especificada ou é definida como nula, o driver depende das regras de consulta da fábrica do gerenciador confiável para determinar qual armazenamento de certificados usar.

  • trustStorePassword

    A senha usada para verificar a integridade dos dados do trustStore.

    Se a propriedade trustStore estiver configurada, mas a propriedade trustStorePassword não estiver configurada, a integridade do trustStore não será verificada.

  • hostnameInCertificate

    O nome do host a ser usado para validar o certificado TLS/SSL do SQL Server.

    Esta propriedade permite especificar o nome do host esperado no certificado do servidor SQL. Isso é útil para garantir que a conexão seja feita apenas com o servidor correto e não com um servidor mal-intencionado que possa estar usando um certificado inválido.

    Nota: Esta propriedade é usada em combinação com as propriedades encrypt / autenticação e a propriedade trustServerCertificate . Esta propriedade afeta a validação do certificado, se a conexão usar criptografia TLS e o trustServerCertificate estiver definido como “false”. Certifique-se de que o valor foi passado para hostNameInCertificatecorresponde ao Nome Comum (CN) ou ao nome DNS no Nome Alternativo do Assunto (SAN) no certificado do servidor para que uma conexão TLS seja bem-sucedida. Para obter mais informações sobre o suporte à criptografia, consulte Noções básicas sobre suporte à criptografia .

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.