Previsao de evasao com Oracle Machine Learning in-database

01Ambiente: Oracle AI Database 26ai Free em Docker

Banco real rodando localmente no container oracle-free (imagem gvenzl/oracle-free:slim-faststart), acessado por python-oracledb (modo thin) como usuario de aplicacao STARTUP.

$ SELECT banner_full FROM v$version
Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free
Version 23.26.3.0.0

Container

$ docker ps --filter name=oracle-free --format table {{.ID}}	{{.Image}}	{{.Status}}	{{.Ports}}	{{.Names}}
CONTAINER ID   IMAGE                               STATUS        PORTS                    NAMES
c5e7ee510d1a   gvenzl/oracle-free:slim-faststart   Up 10 hours   0.0.0.0:1521->1521/tcp   oracle-free


$ docker inspect (imagem, criacao, saude)
Image=gvenzl/oracle-free:slim-faststart | Created=2026-09-08T14:50:05.867982491Z | Status=running | Health=n/a | StartedAt=2026-09-08T14:50:17.200771836Z

$ docker logs --tail 40 oracle-free
2026-09-09T00:45:59.711121+00:00
Thread 1 advanced to log sequence 106 (LGWR switch),  current SCN: 2368261
  Current log# 2 seq# 106 mem# 0: /opt/oracle/oradata/FREE/redo02.log
2026-09-09T00:46:26.106466+00:00
Thread 1 advanced to log sequence 107 (LGWR switch),  current SCN: 2371977
  Current log# 1 seq# 107 mem# 0: /opt/oracle/oradata/FREE/redo01.log
2026-09-09T00:46:33.934639+00:00
Resize operation completed for file# 18, fname /opt/oracle/oradata/FREE/undotbs01.dbf, old size 11264K, new size 21504K
2026-09-09T00:46:52.865004+00:00
Thread 1 advanced to log sequence 108 (LGWR switch),  current SCN: 2374779
  Current log# 2 seq# 108 mem# 0: /opt/oracle/oradata/FREE/redo02.log
2026-09-09T00:47:21.185039+00:00
Thread 1 advanced to log sequence 109 (LGWR switch),  current SCN: 2381411
  Current log# 1 seq# 109 mem# 0: /opt/oracle/oradata/FREE/redo01.log
2026-09-09T00:47:25.403761+00:00
Resize operation completed for file# 18, fname /opt/oracle/oradata/FREE/undotbs01.dbf, old size 21504K, new size 31744K
2026-09-09T00:47:39.389143+00:00
Thread 1 advanced to log sequence 110 (LGWR switch),  current SCN: 2386142
  Current log# 2 seq# 110 mem# 0: /opt/oracle/oradata/FREE/redo02.log
2026-09-09T00:48:02.672513+00:00
Thread 1 advanced to log sequence 111 (LGWR switch),  current SCN: 2390381
  Current log# 1 seq# 111 mem# 0: /opt/oracle/oradata/FREE/redo01.log
2026-09-09T00:48:30.631413+00:00
Resize operation completed for file# 18, fname /opt/oracle/oradata/FREE/undotbs01.dbf, old size 31744K, new size 41984K
2026-09-09T00:48:36.252896+00:00
Thread 1 advanced to log sequence 112 (LGWR switch),  current SCN: 2395135
  Current log# 2 seq# 112 mem# 0: /opt/oracle/oradata/FREE/redo02.log
2026-09-09T00:49:07.969184+00:00
Thread 1 advanced to log sequence 113 (LGWR switch),  current SCN: 2400854
  Current log# 1 seq# 113 mem# 0: /opt/oracle/oradata/FREE/redo01.log
2026-09-09T00:49:59.260010+00:00
Begin automatic SQL Tuning Advisor run for special tuning task "SYS_AUTO_SQL_TUNING_TASK".
2026-09-09T00:50:00.905783+00:00
End automatic SQL Tuning Advisor run for special tuning task "SYS_AUTO_SQL_TUNING_TASK".
2026-09-09T00:52:17.260420+00:00
Thread 1 advanced to log sequence 114 (LGWR switch),  current SCN: 2410036
  Current log# 2 seq# 114 mem# 0: /opt/oracle/oradata/FREE/redo02.log
2026-09-09T01:00:24.449105+00:00
FREEPDB1(3):TABLE SYS.WRI$_OPTSTAT_HISTHEAD_HISTORY: ADDED INTERVAL PARTITION SYS_P759 (46273) VALUES LESS THAN (TO_DATE(' 2026-09-10 00:00:00', 'SYYYY-MM-DD HH24:MI:SS', 'NLS_CALENDAR=GREGORIAN'))
FREEPDB1(3):TABLE SYS.WRI$

02Dados carregados: logs do LMS em EVENTOS_LMS

Eventos por fase (colunas virtuais NUM_FASE / CAPITULO / FLG_ALUNO calculadas no banco)

Tabelas do projeto (USER_TABLES)

03Feature engineering in-database (views + SQL Macro)

Duas unidades de analise. Transicao de fase (aluno x fase k: evadiu = 0 eventos na fase k+1) e risco semanal (aluno x corte t, domingos de 2026-02-01 a 2026-08-02: inativo_21d = 0 eventos em (t, t+21d]). Features usam apenas eventos ≤ t; a mesma SQL Macro FN_FEATURES_SEMANAIS serve treino e scoring (sem training/serving skew).

FEATURES_TRANSICAO_FASE - rotulos por fase

BASE_RISCO_SEMANAL - treino (cortes < 2026-06-01) e teste (≥ 2026-06-01)

Cortes semanais

04Modelos Oracle Machine Learning treinados no banco

DBMS_DATA_MINING.CREATE_MODEL2 com PREP_AUTO = ON: o modelo carrega a preparacao (normalizacao, tratamento de nulos). Nenhum dado saiu do banco; o treino le as views VW_TREINO_*.

USER_MINING_MODELS

USER_MINING_MODEL_SETTINGS (configuracoes informadas)

Atributos (USER_MINING_MODEL_ATTRIBUTES)

05Avaliacao no conjunto de teste (validacao temporal)

Metricas por modelo (AUC via DBMS_DATA_MINING.COMPUTE_ROC e contraprova em SQL; limiar 0,5)

Precisao, captura e lift no top-20% de risco (fila operacional: contatar 1 em cada 5 alunos)

Taxa observada por faixa de risco

Lift por decil - RETENA_INATIVO21_RF (COMPUTE_LIFT)

Importancia de atributos (Random Forest, DM$VA)

Coeficientes do GLM de transicao (DM$VD)

06Scoring por SQL: PREDICTION_PROBABILITY + PREDICTION_DETAILS

VW_RISCO_ALUNO_ATUAL pontua o ultimo corte (ultimo dia com eventos) com os modelos OML; PRC_ATUALIZAR_RISCO persiste em RISCO_ALUNO_SNAPSHOT (agendado por DBMS_SCHEDULER). Faixas: Alto ≥ 0,60 | Medio 0,30-0,60 | Baixo.

Distribuicao por faixa

20 alunos de maior risco (fatores = PREDICTION_DETAILS top 3, XML convertido em texto)

Agendamento (USER_SCHEDULER_JOBS)

07JSON pronto para API e JSON Relational Duality View

VW_RISCO_JSON monta o payload completo com JSON_OBJECT / JSON_ARRAYAGG (pronto para ORDS ou API Gateway). RISCO_ALUNO_DV e uma JSON Relational Duality View (26ai): documento por aluno com leitura e escrita - o coordenador atualiza o status pelo app e a tabela relacional continua a fonte unica.

$ SELECT PAYLOAD FROM VW_RISCO_JSON
{
  "produto": "Retena",
  "gerado_em": "2026-09-09T01:02:20.848+00:00",
  "dt_corte": "2026-08-26",
  "dt_scoring": "2026-09-08T19:26:31",
  "modelo": "RETENA_INATIVO21_RF (Oracle Machine Learning, Random Forest, in-database)",
  "horizonte_dias": 21,
  "total_alunos": 203,
  "resumo": {
    "alto": 59,
    "medio": 15,
    "baixo": 129,
    "prob_media": 0.3145
  },
  "alunos": [
    {
      "aluno": "Aluno 0045",
      "fase": 4,
      "prob_inativo_21d": 0.9237,
      "faixa": "Alto",
      "recencia_dias": 76,
      "eventos_28d": 0,
      "progresso_fase": 0.3636,
      "prob_evasao_fase": 0.9296,
      "fatores": [
        {
          "atributo": "RECENCIA_DIAS",
          "valor": "76",
          "peso": 82.1,
          "rank": 1
        },
        {
          "atributo": "DIAS_ATIVOS_28D",
          "valor": "0",
          "peso": 36.51,
          "rank": 2
        },
        {
          "atributo": "EVENTOS_28D",
          "valor": "0",
          "peso": 21.55,
          "rank": 3
        }
      ],
      "acao_sugerida": "Contato ativo do tutor (telefone/WhatsApp) em 48h",
      "status_atendimento": "PENDENTE"
    },
    {
      "aluno": "Aluno 0046",
      "fase": 3,
      "prob_inativo_21d": 0.9237,
      "faixa": "Alto",
      "recencia_dias": 76,
      "eventos_28d": 0,
      "progresso_fase": 0,
      "prob_evasao_fase": 0.8915,
      "fatores": [
        {
          "atributo": "RECENCIA_DIAS",
          "valor": "76",
          "peso": 82.1,
          "rank": 1
        },
        {
          "atributo": "DIAS_ATIVOS_28D",
          "valor": "0",
          "peso": 36.51,
          "rank": 2
        },
        {
          "atributo": "EVENTOS_28D",
          "valor": "0",
          "peso": 21.55,
          "rank": 3
        }
      ],
      "acao_sugerida": "Contato ativo do tutor (telefone/WhatsApp) em 48h",
      "status_atendimento": "PENDENTE"
    },
    {
      "aluno": "Aluno 0047",
      "fase": 1,
      "prob_inativo_21d": 0.9237,
      "faixa": "Alto",
      "recencia_dias": 76,
      "eventos_28d": 0,
      "progresso_fase": 1,
      "prob_evasao_fase": 0.7227,
      "fatores": [
        {
          "atributo": "RECENCIA_DIAS",
          "valor": "76",
          "peso": 82.1,
          "rank": 1
        },
        {
          "atributo": "DIAS_ATIVOS_28D",
          "valor": "0",
          "peso": 36.51,
          "rank": 2
        },
        {
          "atributo": "EVENTOS_28D",
          "valor": "0",
          "peso": 21.55,
          "rank": 3
        }
      ],
      "acao_sugerida": "Contato ativo do tutor (telefone/WhatsApp) em 48h",
      "status_atendimento": "PENDENTE"
    },
    "... (203 alunos no payload completo)"
  ]
}

$ SELECT JSON_SERIALIZE(dv.DATA) FROM RISCO_ALUNO_DV dv ORDER BY dv.DATA.probInativo21d.number() DESC FETCH FIRST 1 ROWS ONLY
[
  {
    "_id": "Aluno 0045",
    "_metadata": {
      "etag": "EE8E2EC488242FF9EA2BE0B6ABBD2616",
      "asof": "000000000024D497"
    },
    "fatoresTop3": "RECENCIA_DIAS=76 (peso 82.10); DIAS_ATIVOS_28D=0 (peso 36.51); EVENTOS_28D=0 (peso 21.55)",
    "recenciaDias": 76,
    "nomeFase": "Fase 4",
    "atendimento": {
      "status": "PENDENTE",
      "observacao": null
    },
    "probInativo21d": 0.9237,
    "eventos28d": 0,
    "dtCorte": "2026-08-26T00:00:00",
    "faixa": "Alto",
    "acaoSugerida": "Contato ativo do tutor (telefone/WhatsApp) em 48h",
    "fase": 4,
    "dtScoring": "2026-09-08T19:26:31.193284"
  }
]

08Consultas prontas para APEX (07_apex_ready.sql) - resultados reais

As cinco consultas abaixo foram executadas neste momento contra o banco. No APEX, os literais da CTE "parametros" viram itens de pagina (:P1_TICKET_MENSAL etc.).

1) FILA DE SEGUNDA-FEIRA - quem contatar, por que e o que fazer (pagina inicial do coordenador) - 25 linha(s) em 0.01 s

2) FUNIL POR FASE - quantos iniciaram cada fase, quantos avancaram e onde a coorte se perde - 5 linha(s) em 0.01 s

3) MAPA DE ATRITO POR CAPITULO - em qual capitulo os alunos "travam" antes de evadir - 43 linha(s) em 5.38 s

4) RECEITA EM RISCO - por faixa e total, parametrizada pelo ticket medio da IES - 4 linha(s) em 0.00 s

5) REATIVACOES - alunos ja inativos (> 21 dias sem acesso no corte) que voltaram nos 21 dias seguintes - 6 linha(s) em 0.01 s