# Configuração Coringa De Conexão Com Banco De Dados – SQL

## Visão Geral

A **Configuração coringa de conexão com banco de dados – SQL** é um recurso utilizado para estabelecer a comunicação do Suricato Middleware com bancos **SQL Server** em cenários específicos de incompatibilidade entre sistemas operacionais ou clientes de banco de dados.

Este tipo de configuração deve ser utilizado **apenas quando a conexão padrão (URL e Driver oficial)** não puder ser aplicada. O processo envolve a criação do arquivo `persistence.xml` dentro do arquivo `.jar` do Middleware e a alteração manual das strings de conexão utilizando o **driver JTDS**.

O passo a passo abaixo orienta como realizar essa configuração de forma segura e correta.

## Regra de Negócio

Para que a configuração coringa funcione corretamente, é obrigatório atender aos seguintes requisitos:

* O banco de dados deve ser **SQL Server**.
* A configuração só deve ser utilizada quando houver **incompatibilidade entre sistemas operacionais ou clientes de banco de dados**.
* O Middleware deve estar instalado corretamente no servidor.
* O arquivo `persistence.xml` deve existir dentro do `.jar` do Middleware.
* O driver **JTDS** deve ser utilizado nas strings de conexão.
* O serviço **SQL Server Browser** deve estar iniciado quando a conexão utilizar **instância nomeada**.
* O usuário e a senha do banco de dados devem estar válidos.

## Como fazer a Configuração Coringa

{% stepper %}
{% step %}

### Criar a configuração padrão do Middleware

Realize a configuração do Middleware conforme o procedimento padrão, garantindo a criação do arquivo `persistence.xml` dentro do arquivo `.jar` do Middleware.
{% endstep %}

{% step %}

### Acessar o diretório do Middleware

1. Acesse o diretório:

   `C:\Program Files\Telematica\Suricato\SuricatoMiddleware`
2. Localize o executável **`suricato.config.exe`**.
3. Execute o arquivo **como administrador**.

<figure><img src="/files/iIZHknE0YCKqXRLc8Mii" alt=""><figcaption><p><em>Exemplo – Executar Suricato.config</em></p></figcaption></figure>
{% endstep %}

{% step %}

### Permitir execução do aplicativo

Caso o servidor possua controle de conta de usuário (UAC):

* Autorize a execução clicando em **"SIM"** quando solicitado.

<figure><img src="/files/XRbRLM0oOGug2y3g4XP2" alt=""><figcaption><p><em>Exemplo – Permitir Aplicativo</em></p></figcaption></figure>
{% endstep %}

{% step %}

### Configurar os dados de conexão

Preencha os campos conforme desejado e clique em **"Testar"**:

* O sistema realizará um teste de conexão com a base informada.
* Será exibido o resultado de **falha ou sucesso**.
* Clique em **"Salvar"** para gravar as configurações no arquivo `.properties`.

#### **Campos de configuração – SQL**

* **Servidor**: Endereço do servidor de banco de dados.
* **Base**: Nome do banco de dados.
* **Instância**: Nome da instância (somente se for instância nomeada).
* **Porta**: Porta de acesso ao banco de dados (padrão: **1433**).
* **Usuário**: `Suricato`.
* **Senha**: `suricato` (caso não tenha sido alterada).

**Observação:** O serviço **SQL Server Browser** deve estar iniciado para conexões que utilizam instância nomeada.

<figure><img src="/files/NFjmvlf1T9R8xG8fjxpq" alt=""><figcaption><p><em>Exemplo – Configuração Banco de Dados SQL</em></p></figcaption></figure>
{% endstep %}

{% step %}

### Editar manualmente o persistence.xml

1. Localize o arquivo **`suricato.middleware.jar`** no diretório do Middleware.
2. Abra o arquivo utilizando **WinRAR** ou **ZIP** para explorar seu conteúdo.

<figure><img src="/files/5CMSQuV8ssOqe4tixRaE" alt=""><figcaption><p><em>Exemplo – WinRAR suricato.middleware</em></p></figcaption></figure>

3. Acesse a pasta **`META-INF`**.

<figure><img src="/files/OhPTMOGzHWmOsCqV9WMt" alt=""><figcaption></figcaption></figure>

4. Localize o arquivo **`persistence.xml`**.
5. Abra o arquivo com o **Bloco de Notas**.
6. Edite as linhas de **Driver** e **URL** conforme o exemplo abaixo:

```
br.com.tsi.gerenciador.bd.driver=net.sourceforge.jtds.jdbc.Driver;
br.com.tsi.gerenciador.bd.url=jdbc:jtds:sqlserver://172.16.14.249:1433/suricato;useLOBs=true;
br.com.tsi.gerenciador.bd.usuario= Suricato;
br.com.tsi.gerenciador.bd.senha= Senha criptografada;
```

<figure><img src="/files/GOYlvbxjKITc9u9qtK7N" alt=""><figcaption><p><em>Note – gerenciador properties</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Guia Rápido de Uso

1. Criar a configuração padrão do Middleware.
2. Executar o **suricato.config.exe** como administrador.
3. Preencher os dados do banco SQL Server.
4. Testar e salvar a conexão.
5. Abrir o arquivo **suricato.middleware.jar**.
6. Editar o arquivo `META-INF/persistence.xml`.
7. Substituir Driver e URL pela string **JTDS**.

## Glossário

* **JTDS**: Driver JDBC alternativo utilizado para conexão com SQL Server em ambientes com incompatibilidade.
* **persistence.xml**: Arquivo responsável pelas configurações de persistência e conexão com o banco de dados.
* **SQL Server Browser**: Serviço do SQL Server responsável por permitir conexões via instância nomeada.

## FAQ – Perguntas Frequentes

<details>

<summary>Quando devo utilizar a configuração coringa de conexão SQL?</summary>

Somente quando houver incompatibilidade entre sistemas operacionais ou clientes de banco de dados. Caso contrário, utilize a URL e o Driver oficial.

</details>

<details>

<summary>Posso usar essa configuração para outros bancos além do SQL Server?</summary>

Não. Esta configuração é recomendada exclusivamente para **SQL Server**.

</details>

<details>

<summary>O teste de conexão falha mesmo com os dados corretos. O que verificar?</summary>

Verifique se o serviço **SQL Server Browser** está ativo e se a porta configurada está liberada.

</details>

<details>

<summary>É obrigatório editar o persistence.xml manualmente?</summary>

Sim. A configuração coringa exige a substituição manual do Driver e da URL para o padrão JTDS.

</details>

<details>

<summary>O Middleware não inicia após a alteração do arquivo .jar. O que fazer?</summary>

Confirme se o arquivo `persistence.xml` foi salvo corretamente e se a estrutura do `.jar` não foi alterada indevidamente.

</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-servico-middleware/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.