Exportador de Metadados Oracle

Extrator Oracle

clique para acompanhar

Clientes

Cliente	Razão social / CNPJ	Contato	Conexão Oracle	Monitor	Última exportação

Dados cadastrais

Conexão Oracle

Monitor de SQL

Documentação e catálogo

Exportações

Investigações recentes

Resumo da estrutura

Nenhuma exportação concluída para este cliente ainda. Faça uma exportação (botão Exportar) para ver a estrutura.

Tabelas

Nenhuma exportação concluída ainda.

Fontes e DDL

Nenhuma exportação concluída ainda.

(escolha um objeto à esquerda)

Jobs agendados

Nenhuma exportação concluída ainda.

Job	Agenda	Estado	Exec.

Jobs do DBMS_SCHEDULER e do DBMS_JOB antigo, de cada schema exportado. Clique para ver o código.

Escolha um job à esquerda.

Cadastro

SQLs deste executável

Cadastro de executáveis

descobertos

Executável	Tipo	Título / área	Descrição	SQLs	Execuções	Conex. 7d

Conexões no listener

O agente lê o log do listener na máquina do cliente e manda só o agregado por hora: todo programa que conectou, de qual máquina, com qual usuário do sistema e se conseguiu. Diferente do monitor de SQL (uma amostra), aqui aparece até a integração que entra e sai em um segundo.

Programa	Conexões	Falhas	Máquinas	Usuários do SO	Serviço	Última

SQLs capturados

atualizar a cada 5 s

Estrutura do banco (exportações por schema)

SQL executado (monitor)

Agente (últimas 24 h)

Log das cargas

Histórico do cliente

1Conexão com o banco

Nome do cliente

Escolha um cliente salvo para preencher a conexão automaticamente. As análises ficam agrupadas por cliente.

IP / Servidor

Banco ou túnel na sua máquina? Use localhost normalmente — o sistema resolve o acesso internamente.

Porta

Serviço (SERVICE_NAME)

Usuário

Senha

Ao testar a conexão com o nome do cliente preenchido, o perfil é salvo automaticamente no servidor.

Conexões salvas

2O que exportar

Cliente

Schema a exportar

Conexão ainda não testada nesta sessão. Clique em Testar e listar schemas para validar a conexão do cliente.

Tabelas, colunas, constraints e índices (CSV)

Código-fonte PL/SQL (procedures, packages, triggers)

Scripts DDL (CREATE) de cada objeto

Somente tabelas com dados (ignora tabelas vazias, com base nas estatísticas do banco)

3Explorar o que foi extraído

Top 20 maiores tabelas (por linhas nas estatísticas — clique para abrir)

Clique numa tabela para abrir a ficha completa em janela (colunas, constraints, índices e DDL).

(escolha um arquivo à esquerda)

Busque por nomes de colunas, comentários, objetos e dentro do código-fonte PL/SQL

Relacionamentos

Pergunte sobre o sistema

Cruza os metadados extraídos com o SQL que o banco realmente executou. Ex.: quem grava na tabela PCPEDC, o que o package FATURAMENTO faz, quais rotinas mexem em estoque.

Investigação profunda — a IA segue a trilha em vários passos (mais lenta, melhor para causa-raiz)

Sem a chave do DeepSeek cadastrada em Integrações, a resposta vem só como ficha estruturada — sem o texto corrido.

Consultando metadados e SQL capturado...

Monitor de SQL executado

O Oracle guarda o SQL recente em V$SQL, um cache que se perde com o tempo. O monitor lê esse cache de tempos em tempos e acumula tudo aqui, com o executável e a linha que emitiu cada comando. Exige que o usuário da conexão enxergue as views V$ (SELECT_CATALOG_ROLE).

Dados de

Programas que conectam no banco, pelo MODULE da sessão. Versões do mesmo executável aparecem agrupadas. "SQL direto" = comandos enviados pelo programa sem passar por rotina PL/SQL.

"No dicionário = não" significa que a tabela aparece no SQL executado mas ficou fora da exportação estática (filtro antigo ou schema ainda não exportado) — uma reexportação completa resolve e o mapa é relido automaticamente.

Execuções por hora (snapshots começaram em 05/08)

Qualidade da extração e uso do MCP pelos agentes de IA.

Dossiê automático: módulos, rotinas principais (resumo da IA), tabelas centrais e quem opera. Também via MCP (documentacao_do_sistema).

DeepSeek — respostas em linguagem natural

Usado pela tela Pesquisar para redigir a resposta em cima do que a busca encontrou. A chave fica guardada neste servidor. Sem ela, a pesquisa continua funcionando — apenas sem o texto corrido.

Chave da API

Modelo

deepseek-chat responde direto; deepseek-reasoner raciocina mais antes de responder, custando mais tempo e tokens.

4Integração com o Claude Code (MCP)

O Claude Code se conecta neste sistema por MCP e consulta os metadados extraídos enquanto você desenvolve: estrutura de tabelas, código PL/SQL, relações entre objetos e busca no código. Copie os comandos abaixo e execute no terminal da máquina onde o Claude Code roda.

Token de API

Usuário dedicado claude-mcp, sem senha — acessa a API apenas por token e pode ser revogado sem afetar seu login.

Instalar as dependências (uma vez)

Exportação que o Claude vai consultar

Fixa o cliente/schema no comando abaixo. Deixe em "deixar o Claude escolher" para trabalhar com vários clientes — aí você diz na conversa: "use a exportação do cliente X".

Registrar no Claude Code

Conferir a conexão

claude mcp list

Deve aparecer vsystems-extrator: ... - ✔ Connected.

Ferramentas disponíveis

Exemplos de perguntas

Clique para copiar e colar no Claude Code.

Agente do Extrator — instalação no cliente

O agente é um serviço pequeno (um único arquivo Python) que roda na rede do cliente, junto ao Oracle do ERP. Ele só faz conexão de saída HTTPS para este servidor: recebe as consultas de leitura (dicionário de dados, fontes PL/SQL, DDL, V$SQL), executa no banco e devolve as linhas. Nenhuma porta é aberta no cliente e a senha do Oracle nunca sai de lá.

[ rede do cliente ]                                  [ ext.vsystems.com.br ]
 Oracle do ERP  <—— agente.py  —— HTTPS (saída) ——>  servidor do extrator
 (somente leitura)   heartbeat 60 s, fila de comandos,     exportação, monitor, IA
                     linhas em lotes, auto-update

Cuidado com o servidor do cliente

Pausa a consulta quando o load da máquina ou do Oracle (V$OSSTAT) passa do teto e retoma sozinho.
Respiro entre lotes de linhas, teto de memória, prioridade baixa de CPU e disco, limites do systemd.
Os limites são ajustáveis por cliente (bloco Limites de carga abaixo).
Só executa SELECT, ALTER SESSION SET e o ajuste do DBMS_METADATA. Qualquer outro comando é recusado.

1Pré-requisitos na máquina do cliente

Linux ou Windows que enxergue o Oracle (de preferência o próprio servidor do banco).
Python 3.7+ (Linux: o instalador instala; Windows: python.org, marque "Add to PATH").
Saída HTTPS para ext.vsystems.com.br (porta 443).
Usuário Oracle vsextrator somente leitura — script na tela Instalação.
Oracle 11g: o agente ativa o modo thick sozinho usando as bibliotecas do próprio Oracle da máquina.

2Passo a passo

Cadastre o cliente com o modo Agente instalado no cliente.
Escolha o cliente abaixo e baixe o instalador pronto (Linux ou Windows).
Na máquina do cliente, rode o instalador informando usuário e senha do Oracle.
Em até 1 minuto o cliente aparece online. Clique em Exportar na ficha e ligue o Monitor.

3Instalar em um cliente

Escolha o cliente para ver a chave, o instalador pronto e os comandos.

4Operação e problemas comuns

Comandos na máquina do cliente

Linux
  vsextrator-agente status      # serviço + configuração
  vsextrator-agente testar      # conecta no Oracle e mostra a versão
  vsextrator-agente logs        # log ao vivo
  vsextrator-agente descobrir   # redescobre o DSN do Oracle
  vsextrator-agente restart

Windows (PowerShell como administrador)
  python C:\ProgramData\vsextrator-agente\agente.py --status
  python C:\ProgramData\vsextrator-agente\agente.py --testar
  schtasks /Run /TN vsextrator-agente
  type C:\ProgramData\vsextrator-agente\agent.log

Arquivos: /opt/vsextrator-agente (Linux) ou C:\ProgramData\vsextrator-agente (Windows). O config.json guarda a senha (permissão só do administrador).

Atualização

Automática: quando este servidor publica uma versão nova, o agente baixa por HTTPS, confere o sha256 e reinicia sozinho em até 5 minutos. Versão publicada agora: ?.

Se algo não funcionar

Cliente offline	O serviço não está rodando ou não alcança o servidor. `vsextrator-agente status`; confira saída HTTPS para `ext.vsystems.com.br` (proxy/firewall).
chave inválida (403)	A chave foi regenerada na ficha ou o instalador é de outro cliente. Baixe o instalador de novo e reinstale.
Oracle inacessível: ORA-12541	Listener não responde no DSN configurado. `vsextrator-agente descobrir` ou reinstale com `--dsn host:1521/SERVICO` (ou `host:1521:SID` em Winthor antigo).
ORA-01017	Usuário ou senha errados. Reinstale com a senha certa (o instalador só regrava o `config.json`).
ORA-00942 / ORA-01031	Falta grant. Rode o script da tela Instalação (`SELECT ANY DICTIONARY`, `SELECT_CATALOG_ROLE` e `SELECT ANY TABLE`).
DPY-3010	Oracle 11g com driver thin. O agente tenta o modo thick com as bibliotecas locais; se não achar, instale o Instant Client ou `cx_Oracle` na máquina.
pausado por carga	Normal: o servidor do cliente está ocupado e o agente espera baixar. Ajuste os limites na ficha se for restritivo demais.
Python não encontrado	Windows: instale o Python 3 com "Add to PATH" e rode o instalador de novo.

Instalação no cliente — usuário vsextrator no Oracle

O extrator conecta no Oracle do cliente com um usuário somente leitura. Ele não cria objetos nem altera dados: lê o dicionário (tabelas, colunas, constraints, índices, fontes PL/SQL, DDL) e o cache de SQL (V$SQL, V$SQL_PLAN, V$SESSION) para o monitor. Peça ao DBA do cliente para executar o script abaixo como SYS ou SYSTEM.

1Script de criação (executar como SYS/SYSTEM)

-- Extrator de Metadados VSystems - usuario de leitura (VSEXTRATOR)
-- Troque a senha antes de executar. Em Oracle 12c+ multitenant,
-- execute conectado no PDB do Winthor (ALTER SESSION SET CONTAINER = nome_do_pdb).

CREATE USER vsextrator IDENTIFIED BY "TroqueEstaSenha#2026"
  DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP
  QUOTA 0 ON USERS;

-- entrar no banco
GRANT CREATE SESSION TO vsextrator;

-- dicionario de dados completo (DBA_TABLES, DBA_TAB_COLUMNS, DBA_CONSTRAINTS,
-- DBA_INDEXES, DBA_SOURCE, DBA_DEPENDENCIES...)
GRANT SELECT ANY DICTIONARY TO vsextrator;

-- views de desempenho (V$SQL, V$SQLAREA, V$SQL_PLAN, V$SESSION, V$VERSION)
-- e DBMS_METADATA.GET_DDL de objetos de outros schemas
GRANT SELECT_CATALOG_ROLE TO vsextrator;

-- leitura das tabelas de todos os schemas (consultas de diagnostico e
-- investigacao sobre os dados; continua sem nenhum privilegio de escrita)
GRANT SELECT ANY TABLE TO vsextrator;

-- a senha nao pode expirar: o monitor coleta sozinho, 24h por dia
CREATE PROFILE vsextrator_perfil LIMIT
  PASSWORD_LIFE_TIME UNLIMITED
  FAILED_LOGIN_ATTEMPTS UNLIMITED;
ALTER USER vsextrator PROFILE vsextrator_perfil;

-- caso o usuario ja exista e esteja bloqueado/expirado:
-- ALTER USER vsextrator ACCOUNT UNLOCK;
-- ALTER USER vsextrator IDENTIFIED BY "TroqueEstaSenha#2026";

2Conferir os acessos (conectado como vsextrator)

-- cada consulta deve devolver um numero, sem ORA-00942
SELECT COUNT(*) FROM dba_objects;
SELECT COUNT(*) FROM dba_source;
SELECT COUNT(*) FROM v$sql;
SELECT COUNT(*) FROM v$sql_plan;
SELECT COUNT(*) FROM v$session;
SELECT DBMS_METADATA.GET_DDL('TABLE', 'PCPEDC', 'WINT') FROM dual;
SELECT COUNT(*) FROM WINT.PCPEDC;  -- SELECT ANY TABLE

3O que cada permissão faz

`CREATE SESSION`	conectar no banco
`SELECT ANY DICTIONARY`	dicionário `DBA_*`: estrutura, comentários, fontes PL/SQL, dependências
`SELECT_CATALOG_ROLE`	views `V$` (SQL executado, planos, sessões) e DDL via `DBMS_METADATA`
`SELECT ANY TABLE`	leitura das tabelas de todos os schemas, para consultas de diagnóstico sobre os dados
`QUOTA 0`	garante que o usuário não grava nada
`PASSWORD_LIFE_TIME UNLIMITED`	evita a coleta parar por senha expirada (ORA-28001)

4Como o servidor chega ao Oracle do cliente

Agente instalado no cliente recomendado

Um serviço pequeno (um arquivo Python) roda na rede do cliente, junto ao Oracle, e só faz conexão de saída HTTPS para ext.vsystems.com.br. O servidor manda as consultas de leitura, o agente executa no banco e devolve as linhas. Nenhuma porta é aberta no cliente e a senha do Oracle fica só lá.

Cadastre o cliente com o modo Agente instalado no cliente.
Na tela Agente (ou na ficha do cliente), baixe o instalador pronto (Linux ou Windows).
Na máquina do cliente, rode o instalador informando usuário e senha do Oracle. O agente descobre o banco sozinho e aparece online na ficha em até 1 minuto.

Conexão direta

Quando o banco é alcançável pelo servidor (IP público ou VPN): cadastre IP, porta (normalmente 1521), serviço, usuário e senha. O firewall do cliente precisa liberar a porta do listener para o IP do servidor.

5Depois disso

Cadastre o cliente em Clientes → Novo cliente (usuário vsextrator) e teste.
Na ficha do cliente, clique em Exportar para a primeira extração da estrutura do banco.
Ligue o Monitor para começar a capturar os SQLs executados.

Log do sistema

atualizar

(sem atividade ainda)

VSystems • Exportador de Metadados Oracle

Exportador de Metadados Oracle

Relacionamentos

Novo cliente

Executável

Nova exportação —

Agente no cliente —