# Configuração de conexão com banco de dados
## Visão Geral
Esta funcionalidade permite configurar a **conexão do Middleware com o banco de dados** utilizado pelo SURICATO.\
Por meio do utilitário **suricato.config.exe**, é possível informar os dados do banco (Oracle ou SQL Server), testar a conexão e salvar as configurações automaticamente no arquivo de propriedades do sistema.
Essa etapa é essencial para garantir que o Middleware consiga acessar, gravar e consultar as informações do sistema corretamente.
## Regras de Negócio
* A configuração deve ser realizada **antes** da inicialização do Middleware.
* O teste de conexão precisa retornar **sucesso** para que o sistema funcione corretamente.
* As configurações são salvas automaticamente no arquivo `.properties` do Middleware.
* Alterações na conexão podem exigir **reinício do serviço** para entrar em vigor.
* O utilitário **suricato.config.exe** deve ser executado como administrador.
## Como configurar a Conexão com o Banco de Dados
Acesse: `C:\Program Files\Telematica\Suricato\SuricatoMiddleware` e execute `suricato.config.exe` como Administrador. Permita alterações quando solicitado.
Preencha os parâmetros de conexão e clique em *Testar*. Ao salvar, as configurações serão gravadas no arquivo `.properties` correspondente.
| oracle | MSSQ |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| | |
|
Dados típicos
|
Dados típicos
|
|
servidor: Servidor do Suricato
SID: Localizado no arquivo listener.ora
porta: 1521
usuário: suricato
senha: suricato
|
servidor: Servidor do Suricato
Base: Nome do Banco de dados
porta: 1433
usuário: suricato
senha: suricato
|
Verifique se o SQL Server Browser está iniciado para instâncias.
## Guia Rápido de Uso
### Como testar e configurar a conexão com o banco de dados
1. **Acesse o diretório do Middleware**\
Navegue até a pasta:
```
C:\Program Files\Telematica\Suricato\SuricatoMiddleware
```
2. **Execute o configurador**\
Localize o arquivo **suricato.config.exe** e execute-o **como administrador**.
3. **Permita a execução**\
Caso o sistema solicite autorização para realizar alterações, clique em **Sim**.
4. **Preencha os dados do banco de dados**\
Escolha o tipo de banco (Oracle ou SQL Server) e informe os dados conforme o ambiente.
5. **Teste a conexão**\
Clique em **Testar**.
* Sucesso: a conexão com o banco está correta.
* Falha: revise os dados informados.
6. **Salve as configurações**\
Clique em **Salvar** para gravar as informações no arquivo `.properties` do Middleware.
### Parâmetros de Configuração
#### Oracle
* **Servidor**: Endereço do servidor de banco de dados
* **SID**: Identificador do banco (localizado no arquivo `listener.ora`)
* **Porta**: Porta de conexão (padrão: 1521, localizada no `tnsnames.ora`)
* **Usuário**: suricato
* **Senha**: suricato (caso não tenha sido alterada)
#### SQL Server
* **Servidor**: Endereço do servidor de banco de dados
* **Base**: Nome do banco de dados
* **Instância**: Nome da instância (caso seja nomeada)
* **Porta**: Porta de acesso (padrão: 1433)
* **Usuário**: suricato
* **Senha**: suricato (caso não tenha sido alterada)
{% hint style="danger" %}
**Atenção**: Para conexões SQL Server que utilizam **instância nomeada**, o serviço **SQL Server Browser** deve estar iniciado.
{% endhint %}
## Clique aqui e Aprenda a configuração coringa de Conexão com o banco de dados - SQL
> Agora, o serviço de envio de e-mails automáticos foi integrado ao fluxo de comunicações externas para atuar como um log de erros proativo.
>
> **Funcionamento do Alerta:**
>
> Sempre que o sistema identificar um dado incorreto (inconsistência de formato, campos vazios ou erro de validação) durante a tentativa de envio de informações para uma API de terceiros, um e-mail de alerta será disparado automaticamente para os responsáveis.
## FAQ – Perguntas Frequentes
Para que serve o suricato.config.exe?
Ele é utilizado para configurar e testar a conexão do Middleware com o banco de dados do SURICATO.
Preciso parar o Middleware para alterar a configuração?
Recomenda-se que o serviço esteja parado durante a configuração. Após salvar as alterações, o Middleware deve ser reiniciado.
O que acontece se o teste de conexão falhar?
O Middleware não conseguirá acessar o banco de dados. É necessário revisar servidor, porta, base/SID, usuário e senha.
Posso usar Oracle ou SQL Server?
Sim. O SURICATO suporta ambos, desde que os dados de conexão estejam corretamente configurados.
Onde as configurações são salvas?
As informações são gravadas automaticamente no arquivo `.properties` do Middleware.
Qual usuário padrão do banco de dados?
Por padrão:
* **Usuário**: suricato
* **Senha**: suricato\
\&#xNAN;*(caso não tenha sido alterada pelo administrador do banco)*
---
# 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.md?ask=
```
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.