Skip to contents

Tests different download strategies (direct, year-partitioned, column-restricted) on a given table and reports timing, row counts, and data quality metrics.

Usage

vigiar_benchmark(
  tabela,
  strategies = c("direct", "year_asc_desc", "minimal_columns"),
  repeticoes = 3L,
  timeout = 120
)

Arguments

tabela

Table name to benchmark.

strategies

Character vector of strategies to test. Options: "direct", "year_asc_desc", "minimal_columns", "all".

repeticoes

Number of repetitions per strategy.

timeout

Timeout per download in seconds.

Value

A tibble with columns: estrategia, tempo_medio, tempo_min, tempo_max, n_linhas, n_colunas, n_ausentes, taxa_sucesso.

Examples

# \dontrun{
vigiar_conectar()
#> Sessao VIGIAR ja esta ativa. Use refresh = TRUE para renovar.
vigiar_status()
#> Dashboard VIGIAR online. Esquema de dados consistente.
vigiar_benchmark("df_anual", repeticoes = 1)
#> 
#> ── VIGIAR Benchmark ────────────────────────────────────────────────────────────
#> Tabela: df_anual
#> Repeticoes por estrategia: 1
#> Sessao criada em: 2026-10-10 15:44:32
#> ────────────────────────────────────────────────────────────────────────────────
#> 
#> ── Estrategia: direct ──
#> 
#> ℹ Repeticao 1/1
#> ℹ Baixando tabela 'df_anual'...
#> ℹ Repeticao 1/1

#> ℹ Filtro UF='RJ' (UF): 0 linhas (de 10000).
#> ℹ Repeticao 1/1

#> ✔ Tabela 'df_anual' baixada: 0 linhas x 7 colunas (4.5s)
#> ℹ Repeticao 1/1

#> ✔ 0 linhas x 7 cols (4.5s)
#> ℹ Repeticao 1/1

#> 
#> ℹ Repeticao 1/1

#> ── Estrategia: year_asc_desc ──
#> ℹ Repeticao 1/1

#> 
#> ℹ Repeticao 1/1

#> ✔ Repeticao 1/1 [4.5s]
#> 
#> ℹ Repeticao 1/1
#> ℹ Baixando tabela 'df_anual'...
#> ℹ Repeticao 1/1

#> ℹ Filtro UF='RJ' (UF): 184 linhas (de 10000).
#> ℹ Repeticao 1/1

#> ✔ Tabela 'df_anual' baixada: 184 linhas x 4 colunas (2.6s)
#> ℹ Repeticao 1/1

#> ℹ Baixando tabela 'df_anual'...
#> ℹ Repeticao 1/1

#> ℹ Filtro UF='RJ' (UF): 184 linhas (de 10000).
#> ℹ Repeticao 1/1

#> ✔ Tabela 'df_anual' baixada: 184 linhas x 4 colunas (2.6s)
#> ℹ Repeticao 1/1

#> ✔ 368 linhas x 4 cols (5.2s)
#> ℹ Repeticao 1/1

#> 
#> ℹ Repeticao 1/1

#> ── Estrategia: minimal_columns ──
#> ℹ Repeticao 1/1

#> 
#> ℹ Repeticao 1/1

#> ✔ Repeticao 1/1 [5.3s]
#> 
#> ℹ Repeticao 1/1
#> ℹ Baixando tabela 'df_anual'...
#> ℹ Repeticao 1/1

#> ℹ Filtro UF='RJ' (UF): 0 linhas (de 10000).
#> ℹ Repeticao 1/1

#> ✔ Tabela 'df_anual' baixada: 0 linhas x 4 colunas (2.7s)
#> ℹ Repeticao 1/1

#> ✔ 0 linhas x 4 cols (2.7s)
#> ℹ Repeticao 1/1

#> ────────────────────────────────────────────────────────────────────────────────
#> ℹ Repeticao 1/1

#> 
#> ℹ Repeticao 1/1

#> ── Resultados ──────────────────────────────────────────────────────────────────
#> ℹ Repeticao 1/1

#> ✔ Melhor estrategia: minimal_columns (2.7s medio)
#> ℹ Repeticao 1/1

#> ✔ Repeticao 1/1 [2.8s]
#> 
#> # A tibble: 3 × 10
#>   estrategia      tempo_medio tempo_min tempo_max tempo_dp n_linhas n_colunas
#>   <chr>                 <dbl>     <dbl>     <dbl>    <dbl>    <int>     <int>
#> 1 direct                 4.47      4.47      4.47       NA        0         7
#> 2 year_asc_desc          5.23      5.23      5.23       NA      368         4
#> 3 minimal_columns        2.72      2.72      2.72       NA        0         4
#> # ℹ 3 more variables: n_ausentes <int>, taxa_sucesso <dbl>, repeticoes <dbl>
# }