> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/product-docs/integracoes/databases/oracle.md).

# Oracle

Este guia detalha todos os pré-requisitos, configuração do ativo e métodos de conexão disponíveis.

## Métodos

É ofertado 4 possibilidades para se conectar a Banco de Dados Oracle:

{% stepper %}
{% step %}
**WEB CLI**

Linha de comando direto pela console do PAM no navegador
{% endstep %}

{% step %}
**WEB GUI**

Interface gráfica nativa do PAM, sendo carregada direto pela console do PAM para executar queries
{% endstep %}

{% step %}
**CONEXAO GUIADA**

É disponibilizado tokens de conexao, efemeros ou usuário e senha temporários (#JIT = Just-In-Time Access, #PED = Privileged Access on Demand).

Gera informações de conexão para qualquer cliente DB
{% endstep %}

{% step %}
**APLICATIVO VIRTUAL**

Pode ser publicado no PAM aplicativos Oracle para acesso GUI pelo PAM.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Proteja a conexão com SSL/TLS**

Ao utilizar os métodos de conexão descritos acima, recomendamos proteger a conexão no destino.

DataDike é compatível com TLS 1.2.
{% endhint %}

***

### Cadastre o Banco de Dados Oracle

## Passo 1: Cadastro

1. Navegue até **Console → Asset List** (menu lateral esquerdo).
2. Na árvore de ativos, selecione ou crie um nó (ex: *Bancos de Dados → Produção*).

Criar o ativo

1. Clique em **"+ Create"** (botão superior direito).
2. Na janela de seleção de plataforma, escolha:
   * Tipo: **Database**
   * Plataforma: **Oracle**
3. Preencha os campos obrigatórios:

| Campo        | Valor                             | Observação                         |
| ------------ | --------------------------------- | ---------------------------------- |
| **Name**     | Ex: `Oracle-Producao-ERP`         | Nome identificador único           |
| **Address**  | IP ou hostname do servidor Oracle | Ex: `10.0.1.50`                    |
| **Port**     | `1521`                            | Porta padrão do Oracle Listener    |
| **Database** | Service Name da instância         | Ex: `ORCL` ou `pdb1.empresa.local` |
| **Nodes**    | Selecionar o nó na árvore         | Pode ser selecionado antes         |

## Passo 2: Credenciais

1. Na aba **"Accounts"** do ativo recém-criado, clique em **"+ Create"**.
2. Preencha:
   * **Name:** Ex: `svc-readonly`
   * **Username:** O usuário Oracle (ex: `pam_svc`)
   * **Password:** A senha do usuário Oracle
3. Salve a conta.

## Passo 3: Autorização de acesso

1. Navegue até **Console → Permissions → Asset Permissions**.
2. Clique em **"+ Create"**.
3. Configure:
   * **Users/User Groups:** Selecione os usuários que devem ter acesso.
   * **Assets:** Selecione o ativo Oracle criado.
   * **Accounts:** Selecione a conta cadastrada (ou *@ALL* para todas).
   * **Expire Date:** Defina prazo se necessário.
4. Salve a autorização.

#### Testar Conectividade

1. No ativo Oracle, clique no ícone **"Test"** (ou acesse o asset e selecione a conta → Test).
2. O sistema tentará conectar ao Oracle. Resultado esperado: **Sucesso**.

   #### Métodos de Conexão com Oracle

   **A. Web GUI (Editor SQL no navegador)**

   1. Acesse **Workbench** (menu lateral).
   2. Localize o ativo Oracle na lista de ativos autorizados.
   3. Clique para abrir. Selecione a conta desejada.
   4. O editor SQL será aberto no navegador com funcionalidades:
      * Executar queries SQL
      * Salvar queries favoritas
      * Exportar resultados para CSV
      * Histórico de comandos

   **B. DB Client (DBeaver via Proxy)**

   1. Acesse **Workbench → Database**.
   2. Selecione o ativo Oracle → Método: **DB Client**.
   3. O sistema abrirá o DBeaver conectado automaticamente.
   4. Alternativa: Copie as informações de conexão e configure manualmente:
      * Host: `<IP_HOST>`
      * Port: porta alocada
      * SID/Service: conforme configurado

   **C. DB Connection Guide**

   1. No ativo Oracle, selecione método **"DB Guide"**.
   2. O sistema exibirá todas as informações necessárias para conexão manual:
      * Host e Porta
      * Username e Password (temporários/proxy)
      * Database / Service Name
      * Linha de comando para `sqlplus`
   3. Use estas informações para conectar com qualquer ferramenta (SQL Developer, Toad, DataGrip, etc.).

   **D. RemoteApp (Navicat / DBeaver publicado)**

   1. Pré-requisito: RemoteApp configurado com Navicat ou DBeaver publicado no PAM.
   2. Selecione método **"RemoteApp"** ao conectar.
   3. O Navicat/DBeaver será aberto em sessão remota com conexão pré-configurada ao Oracl

      #### Troubleshooting Oracle

      | Problema                          | Causa Provável                                    | Solução                                                           |
      | --------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------- |
      | Erro "OCI library not found"      | OCI não instalado ou path incorreto               | Instalar Oracle Instant Client 21+ e configurar `LD_LIBRARY_PATH` |
      | Erro "TNS: no listener"           | Listener Oracle desligado ou bloqueio de firewall | Verificar `lsnrctl status` no Oracle e abrir porta 1521           |
      | Caracteres corrompidos na Web GUI | Character set não-UTF8 sem `NLS_LANG`             | Configurar `NLS_LANG` no servidor                                 |
      | Oracle SQL Developer não conecta  | Versão 23.1 incompatível com OCI                  | Usar SQL Developer 22.x                                           |
      | Erro "ORA-12514: TNS no service"  | Service Name incorreto no ativo                   | Verificar Service Name (não confundir com SID)                    |
      | Timeout na conexão                | Firewall entre PAM e Oracle                       | Liberar porta 1521 (ou customizada) do PAM para o Oracle          |
      | Windows client OCI antigo         | OCI local < v19                                   | Baixar Oracle Instant Client 19c+ manualmente                     |

      > **💡 Dica:** O fluxo básico para qualquer banco de dados é: **Criar Ativo** (Database) → **Adicionar Conta** (credencial) → **Criar Autorização** (vincular usuário ao ativo) → **Conectar via Workbench**.