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

## Visão Geral

Este módulo descreve o procedimento de parametrização e conectividade do Suricato Player com o banco de dados SQL Server. 

A comunicação é estabelecida por meio da arquitetura de uma fonte de dados ODBC configurada diretamente no sistema operacional Windows de 32 bits.

## Regra de Negócio

* **Disponibilidade do SGBD:** O banco de dados SQL Server deve estar previamente ativo e com conexões remotas permitidas na rede.
* **Arquitetura da Ferramenta:** É obrigatória a utilização do utilitário Administrador de Fonte de Dados ODBC (32 bits) para o registro da conexão.
* **Homologação do Driver:** O driver de comunicação selecionado para a fonte de dados deve ser obrigatoriamente o `ODBC Driver for SQL Server`.
* **Identificação da Fonte:** A Fonte de Dados de Sistema (System DSN) deve ser criada obrigatoriamente com a nomenclatura exata: `Suriplayers_odbc`.
* **Modo de Autenticação:** A validação de credenciais deve ser realizada utilizando o modo de autenticação padrão do SQL Server (usuário e senha do banco).
* **Parâmetros da Aplicação:** O arquivo `suriplayers.properties` deve estar parametrizado em conformidade com as chaves de conexão criadas no Windows.
* **Nível de Acesso:** O operador deve possuir privilégios administrativos no sistema operacional para criar registros de ODBC e modificar arquivos de configuração no diretório local.

*O não atendimento a esses requisitos impedirá a conexão do Suricato Player com o banco de dados.*

## Teste de Conexão Suricato Player SQL

#### 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
```

(**ODBC Data Source Administrator (32-bit)**)

<figure><img src="/files/XrExJ0kEqBFOuemPdYEo" alt=""><figcaption><p><em>Exemplo - 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/TzEnht8n9Xw58d7FlpvT" alt=""><figcaption><p><em>Exemplo - odbcad32.exe</em></p></figcaption></figure>
{% endstep %}

{% step %}
Selecione a opção:

```
ODBC Driver for SQL Server
```

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

{% step %}
Preencha os dados iniciais da fonte de dados conforme o seu ambiente e clique em **Avançar**.

<figure><img src="/files/kCmYXQl5n7uc3zVirXk8" alt=""><figcaption><p><em>Exemplo - Configuração SQL Server DSN</em></p></figcaption></figure>
{% endstep %}

{% step %}
Selecione a opção de **autenticação com usuário SQL Server**.
{% endstep %}

{% step %}
Preencha os campos **Login** e **Senha** e clique em **Avançar**.

<figure><img src="/files/RuMPEMJKPipCfanE6NZU" alt=""><figcaption><p><em>Exemplo - Configuração SQL Server DSN</em></p></figcaption></figure>
{% endstep %}

{% step %}
Marque a opção para **trocar para a base de dados padrão**
{% endstep %}

{% step %}
Selecione a **base de dados do Suricato**.

<figure><img src="/files/03DyUiAbJU8LNRqLwbUl" alt=""><figcaption><p><em>Exemplo - Configuração SQL Server DSN</em></p></figcaption></figure>
{% endstep %}

{% step %}
Conclua a configuração clicando em **Concluir**.

<figure><img src="/files/gZ3wbfm3ORUhkSAl05D5" alt=""><figcaption><p><em>Exemplo - Configuração SQL Server DSN</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Configurando o arquivo suriplayers.properties

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

```
suriplayers.properties
```

<figure><img src="/files/CLQeERJ1bqQ7AhJhMgBq" alt=""><figcaption><p><em>suriplayers.properties</em></p></figcaption></figure>
{% endstep %}

{% step %}
Informe os dados de acesso ao banco de dados conforme o padrão abaixo:

```
url="Dsn=Suriplayers_odbc;Uid=suricato;Pwd=suricato"
```

Onde:

* **Suriplayers\_odbc** é o nome do ODBC criado.
* **Uid** corresponde ao usuário SQL Server.
* **Pwd** corresponde à senha do usuário SQL Server.
  {% endstep %}

{% step %}
Observe que as linhas iniciadas com `#` são **linhas comentadas** e **não são consideradas** na configuração.

<figure><img src="/files/YfOJIWNdE8jTYUjrjPEp" alt=""><figcaption><p><em>suriplayers.properties</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Glossário

* **ODBC (Open Database Connectivity)**: Padrão de acesso que permite a conexão entre aplicações e bancos de dados.
* **ODBC Data Source Administrator (32-bit)**: Ferramenta do Windows para criação e gerenciamento de fontes de dados ODBC.
* **SQL Server**: Sistema de gerenciamento de banco de dados da Microsoft.
* **DSN (Data Source Name)**: Nome da fonte de dados utilizada para identificar a conexão ODBC.
* **suriplayers.properties**: Arquivo responsável por armazenar os parâmetros de conexão do Suricato Player com o banco de dados.

## FAQ – Perguntas Frequentes

<details>

<summary>Posso usar autenticação do Windows no SQL Server?</summary>

Não. O procedimento exige autenticação com **usuário SQL Server**.

</details>

<details>

<summary>O ODBC não aparece para o Suricato Player. O que verificar?</summary>

Confirme se o ODBC foi criado no **Administrador 32-bit** e se o nome está exatamente como **Suriplayers\_odbc**.

</details>

<details>

<summary>O Suricato Player não conecta após a configuração.</summary>

Verifique se o arquivo **suriplayers.properties** foi salvo corretamente e se o usuário e senha estão válidos.

</details>

<details>

<summary>As linhas comentadas no arquivo properties interferem na conexão?</summary>

Não. Linhas iniciadas com `#` são ignoradas pelo sistema.

</details>

<details>

<summary>Posso alterar o nome do DSN depois de configurado?</summary>

Não é recomendado. Caso altere, será necessário atualizar o nome no arquivo **suriplayers.properties**.

</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-oracle.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.