# Configuração coringa de conexão com banco de dados - SQL

## Visão Geral

Este módulo descreve o procedimento de parametrização de contingência para conexão do Suricato REP ao banco de dados SQL Server utilizando o driver JTDS. 

Esta configuração é restrita a cenários específicos onde há incompatibilidade técnica entre sistemas operacionais ou clientes oficiais de banco de dados.

## Regra de Negócio

* **Homologação de SGBD:** O banco de dados de destino deve ser obrigatoriamente SQL Server.
* **Cenário de Aplicação:** A configuração JTDS deve ser utilizada estritamente quando houver incompatibilidade imposta pelo sistema operacional ou pelos clientes de banco de dados.
* **Prioridade de Driver:** Caso não exista incompatibilidade técnica no ambiente, é obrigatório o uso da URL e do driver oficial de conexão do fabricante.
* **Parametrização Obrigatória:** O arquivo `suricato-rep.properties` deve ser configurado corretamente com as propriedades do driver alternativo.
* **Empacotamento do Arquivo:** O arquivo `suricato-rep.properties` deve ser obrigatoriamente reinserido e compactado dentro do arquivo `suricato_rep.jar` após a edição.
* **Validação de Serviço:** O serviço do Suricato REP deve ser iniciado por meio do gerenciador de Serviços do Windows para a validação final da conectividade.

{% hint style="info" %}
Esta configuração só é recomendada somente para SQL Server e quando existe uma incompatibilidade entre os sistemas operacionais ou clientes de banco de dados, caso contrário utilizar URL e Driver oficial de conexão.
{% endhint %}

## Como configurar a conexão com o banco

<figure><img src="/files/72bEBiEDuFov8xr8H0EP" alt=""><figcaption><p><em>Edit – suricato-rep.properties</em></p></figcaption></figure>

{% stepper %}
{% step %}
Acesse o diretório de instalação do Suricato REP.
{% endstep %}

{% step %}
Localize o arquivo **suricato-rep.properties**.
{% endstep %}

{% step %}
Abra o arquivo utilizando o **Bloco de Notas**.
{% endstep %}

{% step %}
Configure os parâmetros conforme o padrão **SQL – JTDS** apresentado abaixo.
{% endstep %}

{% step %}
Ajuste os dados de conexão conforme o ambiente.
{% endstep %}

{% step %}
Salve o arquivo após a edição.
{% endstep %}
{% endstepper %}

### SQL – JTDS

```
database.dbms=SQL_SERVER
database.driver=net.sourceforge.jtds.jdbc.Driver
database.url=jtds:jdbc:sqlserver://endereço IP ou Host/Nome do banco de dados;useLOBs=true;
database.user=suricato
database.password=7ab94ad05faf709069 (Caso a senha não tenha sido alterada)
```

<figure><img src="/files/03O8dphQnf7H4huMo1Bx" alt=""><figcaption><p><em>Configuração – Suricato-rep.properties</em></p></figcaption></figure>

{% stepper %}
{% step %}
Após configurar o arquivo **suricato-rep.properties**, acesse novamente o diretório do Suricato REP.
{% endstep %}

{% step %}
Localize o arquivo **suricato\_rep.jar**.
{% endstep %}

{% step %}
Abra o arquivo **suricato\_rep.jar** utilizando o **WinRAR** ou **ZIP**.
{% endstep %}

{% step %}
Adicione o arquivo **suricato-rep.properties** dentro do **suricato\_rep.jar**.
{% endstep %}

{% step %}
Salve as alterações realizadas.
{% endstep %}
{% endstepper %}

<figure><img src="/files/TtEQuPK9PYh7wNsoLXXj" alt=""><figcaption><p><em>Exemplo – suricato_rep.jar WinRAR</em></p></figcaption></figure>

<figure><img src="/files/xqTCchEbNwLNuAQqVdr2" alt=""><figcaption><p><em>Exemplo – suricato_rep.jar WinRAR</em></p></figcaption></figure>

### Inicialização do Serviço

{% stepper %}
{% step %}
Após concluir a configuração, acesse o **Services do Windows**.
{% endstep %}

{% step %}
Localize o serviço do **Suricato REP**.
{% endstep %}

{% step %}
Inicie o serviço para realizar o teste de funcionamento.
{% endstep %}
{% endstepper %}

## Glossário

* **JTDS:** Driver alternativo utilizado para conexão com SQL Server em cenários de incompatibilidade.

## FAQ – Perguntas Frequentes

<details>

<summary><strong>Quando devo utilizar a conexão JTDS?</strong></summary>

Apenas quando houver incompatibilidade entre o sistema operacional ou o cliente de banco de dados e o driver oficial do SQL Server.

</details>

<details>

<summary><strong>Posso usar JTDS em qualquer cenário?</strong></summary>

Não. Sempre que possível, deve-se utilizar o driver e a URL oficial de conexão.

</details>

<details>

<summary><strong>O serviço não inicia após a configuração JTDS, o que verificar?</strong></summary>

Verifique se o arquivo suricato-rep.properties foi inserido corretamente no suricato\_rep.jar e se os dados de conexão estão corretos.

</details>

<details>

<summary><strong>A senha padrão pode ser utilizada?</strong></summary>

Sim, desde que não tenha sido alterada no banco de dados.

</details>

<details>

<summary><strong>Onde valido se a configuração funcionou?</strong></summary>

A validação ocorre ao iniciar o serviço do Suricato REP no Services do Windows.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-suricato-rep/configuracao-de-conexao-com-banco-de-dados/configuracao-coringa-de-conexao-com-banco-de-dados-sql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.