> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwsintegration.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bancos de Dados (JDBC)

> Extraia dados de qualquer banco de dados compatível com JDBC através do RWS Connect

Alguns dados só existem dentro de um banco de dados: o SQL Server de um ERP on-premise, uma instância Oracle atrás de uma VPN, uma réplica de leitura PostgreSQL sem nenhuma API na frente. Fontes de banco de dados são atendidas pelo **RWS Connect**: construímos um pipeline gerenciado que extrai do seu banco e o expõe através da **API do RWS Connect**, uma API REST simples que suas integrações extraem como qualquer outra API moderna.

## Bancos de dados suportados

Qualquer banco de dados compatível com JDBC. Exemplos comuns:

* SQL Server
* Oracle
* PostgreSQL
* MySQL / MariaDB
* IBM DB2
* Firebird
* Sybase

Se o seu banco fala JDBC, o RWS Connect consegue extrair dele.

## Quando usar

* O sistema guarda seus dados em um banco mas não expõe nenhuma API
* Você tem (ou pode criar) um usuário somente leitura ou uma réplica de leitura
* O banco fica on-premise ou atrás de uma VPN
* O dado que você precisa é o resultado de uma consulta SQL sobre várias tabelas

## Como funciona

1. **O RWS Connect conecta ao seu banco** via JDBC, através de uma [VPN](/pt-br/features/connections/vpn) quando necessário
2. **O pipeline executa as consultas combinadas** no agendamento combinado e grava os resultados em tabelas estruturadas
3. **Sua integração extrai as tabelas** através da API do RWS Connect, como qualquer outra fonte REST

Tudo o que a plataforma oferece para extrações de API funciona sem mudanças: [paginação](/pt-br/features/extract/pagination), [parâmetros dinâmicos](/pt-br/features/extract/dynamic-parameters), [regras de negócio](/pt-br/features/business-rules/overview) e [agendamento](/pt-br/features/extract/scheduling).

## O que você fornece

| Item                    | Detalhes                                                                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Motor do banco          | Motor e versão (SQL Server, Oracle, PostgreSQL, etc.)                                                                                                                     |
| Detalhes de conexão     | Host, porta e nome do banco                                                                                                                                               |
| Credenciais             | Um usuário com acesso de leitura às tabelas necessárias                                                                                                                   |
| Acesso de rede          | [Configuração de VPN](/pt-br/features/connections/vpn) ou [allowlist de IPs](/pt-br/features/connections/vpn#allowlist-de-ips), se o banco não for acessível publicamente |
| Tabelas ou consultas    | As tabelas a extrair, ou as consultas SQL cujos resultados você precisa                                                                                                   |
| Coluna incremental      | Opcional: uma coluna de data ou sequência que possamos usar para extrair apenas linhas novas ou alteradas                                                                 |
| Cadência de atualização | Com que frequência os dados devem ser atualizados                                                                                                                         |
| Nome da tabela          | O nome que você quer para cada tabela resultante                                                                                                                          |

<Tip>
  Recomendamos um usuário dedicado somente leitura. O pipeline apenas lê.
</Tip>

## Solicitando o conector

Envie um email para [connect@rwsintegration.com](mailto:connect@rwsintegration.com) com os itens acima para abrir um ticket.

<Info>
  Suas tabelas ficam prontas em até **dois dias úteis** (SLA) após o acesso e as informações acima serem fornecidos. Se o acesso exigir VPN, a [configuração da VPN](/pt-br/features/connections/vpn) leva mais dois dias úteis antes da construção do pipeline.
</Info>

## Como seus dados aparecem

* Uma tabela por tabela de origem ou consulta, com o nome combinado no ticket
* Colunas em `snake_case`
* Quando o pipeline une várias tabelas de origem em um único dataset, cada coluna recebe o prefixo da tabela de onde veio, e cada registro é entregue como um único objeto JSON plano (veja [Prefixos de coluna](/pt-br/features/extract/connect-api#prefixos-de-coluna))
* Cada execução adiciona um snapshot marcado com a data de extração, preservando o histórico
* Colunas padrão em toda tabela: `extracted_at`, `extraction_date`, `extract_start_date_parameter`, `extract_end_date_parameter`

## Próximos passos

<CardGroup cols={2}>
  <Card title="RWS Connect" icon="plug-circle-bolt" href="/pt-br/core-concepts/rws-connect">
    Entenda como o RWS Connect funciona
  </Card>

  <Card title="Consultando a API do RWS Connect" icon="magnifying-glass" href="/pt-br/features/extract/connect-api">
    Filtros, agregações, paginação e mais
  </Card>
</CardGroup>