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

## Visão Geral

A **Configuração de conexão com banco de dados Oracle** permite que o **Suricato Player** se comunique corretamente com o banco de dados Oracle por meio de uma fonte de dados ODBC.\
Esse processo inclui a criação do ODBC no Windows e a configuração do arquivo **suriplayers.properties**, garantindo que o serviço consiga acessar as informações necessárias para o seu funcionamento.

## Regra de Negócio

Para que a conexão com o banco de dados Oracle funcione corretamente, é obrigatório que:

* O banco de dados **Oracle** esteja acessível e operacional.
* O **Oracle Client (32-bit)** esteja instalado na máquina.
* A fonte de dados ODBC seja criada utilizando o **ODBC Data Source Administrator (32-bit)**.
* O nome da fonte de dados seja exatamente:

  ```
  Suriplayers_odbc
  ```
* O arquivo **suriplayers.properties** seja configurado com as credenciais corretas.
* O usuário possua permissão para criar e editar arquivos no sistema operacional.

Sem esses requisitos, o Suricato Player não conseguirá se conectar ao banco de dados.

## Como configurar a conexão com banco de dados Oracle

### Teste de Conexão Suricato Player Oracle

#### **Criando a fonte de dados ODBC**

{% stepper %}
{% step %}
Navegue até o diretório:

```
C:\Windows\SysWOW64
```

{% endstep %}

{% step %}
Localize e abra o arquivo:

```
odbcad32.exe
```

{% endstep %}

{% step %}
**(ODBC Data Source Administrator (32-bit))**

<figure><img src="/files/qM895ZR9yOSQKFZ8qynW" alt=""><figcaption><p><em>Diretório SysWOW64</em></p></figcaption></figure>
{% endstep %}

{% step %}
Na tela do **ODBC Data Source Administrator**, clique no botão **Adicionar**.

<figure><img src="/files/RvvExi8cc4nL9lkjIyYx" alt=""><figcaption><p><em>Exemplo - odbcad32.exe</em></p></figcaption></figure>
{% endstep %}

{% step %}
Selecione a opção correspondente ao banco de dados **Oracle**, escolhendo:

```
OracClient....
```

<figure><img src="/files/me3lbvzP6JonrpIslaRL" alt=""><figcaption><p><em>Exemplo - Criar nova fonte de dados</em></p></figcaption></figure>
{% endstep %}

{% step %}
Preencha os campos com a sua **parametrização Oracle** e, após concluir, clique no botão **Test Connection**.

<figure><img src="/files/tXSKhf1pk5yvyNHq8deS" alt=""><figcaption><p><em>Exemplo - Configuração Oracle ODBC</em></p></figcaption></figure>
{% endstep %}

{% step %}
Informe o **nome do serviço Oracle** e o **usuário** para conexão com o banco de dados. Clique em **OK** para confirmar a conexão.

<figure><img src="/files/65X5cOYMB3ujB4HKTQif" alt=""><figcaption><p><em>Exemplo - Oracle ODBC Connect</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### **Configurando o arquivo suriplayers.properties**

{% stepper %}
{% step %}
Localize o arquivo:

```
suriplayers.properties
```

<figure><img src="/files/MkSXtlbsM8e9PH9VJJyU" alt=""><figcaption><p><em>Exemplo - suriplayers.properties.txt</em></p></figcaption></figure>

Edite o arquivo informando os dados de acesso conforme o banco de dados configurado.
{% endstep %}

{% step %}
Utilize o seguinte padrão de configuração:

```
url="Dsn=TOTVS.XE_odbc;Uid=suricato;Pwd=suricato"
```

Onde:

* **TOTVS.XE\_odbc** é o nome do ODBC criado.
* **Uid** é o usuário do banco de dados.
* **Pwd** é a senha do banco de dados.

<figure><img src="/files/9LNdWb1qAjfhqUPPWxKu" alt=""><figcaption><p><em>suriplayers.properties.txt</em></p></figcaption></figure>

**Exemplo: url="Dsn=TOTVS.XE\_odbc;Uid=suricato;Pwd=suricato" onde TOTVS.XE\_odbc é o nome do ODBC que foi criado**
{% endstep %}
{% endstepper %}

## Guia Rápido de Uso

1. Abrir `odbcad32.exe` em `C:\Windows\SysWOW64`
2. Criar um ODBC do tipo **Oracle (OracClient)**
3. Nomear o ODBC como **Suriplayers\_odbc**
4. Testar a conexão
5. Editar o arquivo **suriplayers.properties** com o DSN, usuário e senha

## Glossário

* **ODBC (Open Database Connectivity)**: Padrão de conexão que permite que aplicações acessem bancos de dados.
* **ODBC Data Source Administrator (32-bit)**: Ferramenta do Windows utilizada para criar e gerenciar fontes de dados ODBC.
* **Oracle Client**: Software necessário para que aplicações consigam se conectar a um banco de dados Oracle.
* **DSN (Data Source Name)**: Nome da fonte de dados ODBC utilizada para identificar a conexão.
* **suriplayers.properties**: Arquivo de configuração responsável por armazenar os dados de conexão do Suricato Player com o banco de dados.

## FAQ – Perguntas Frequentes

<details>

<summary><strong>Por que preciso usar o ODBC 32-bit?</strong></summary>

O Suricato Player utiliza conexão via ODBC 32-bit, portanto a fonte de dados deve ser criada obrigatoriamente nesse padrão.

</details>

<details>

<summary><strong>O botão “Test Connection” retorna erro. O que verificar?</strong></summary>

Confirme se o serviço Oracle está ativo, se o Oracle Client está instalado corretamente e se os dados informados estão corretos.

</details>

<details>

<summary><strong>Posso usar outro nome para o ODBC além de Suriplayers_odbc?</strong></summary>

Não. O nome deve ser exatamente **Suriplayers\_odbc** para que o Suricato Player reconheça a conexão.

</details>

<details>

<summary><strong>O Suricato Player não conecta mesmo com o ODBC criado.</strong></summary>

Verifique se o arquivo **suriplayers.properties** foi salvo corretamente e se o nome do DSN informado corresponde ao ODBC criado.

</details>

<details>

<summary><strong>Onde encontro o arquivo suriplayers.properties?</strong></summary>

O arquivo está localizado na pasta de configuração do Suricato Player e deve ser editado conforme o banco de dados utilizado.

</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-servico-suriplayer/configuracao-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.