caged_adjustments_load: Pipeline completo para o CAGED Ajustes

View source: R/adjustments.R

caged_adjustments_loadR Documentation

Pipeline completo para o CAGED Ajustes

Description

Baixa, parseia e grava os arquivos do CAGED Ajustes no banco DuckDB local.

Usage

caged_adjustments_load(
  years,
  months = seq_len(12L),
  db_path,
  destdir = NULL,
  force_download = FALSE,
  overwrite_competencies = FALSE,
  timeout = 300
)

Arguments

years

integer vector. Desired years. Maximum: 2019.

months

integer vector. Desired months (1–12). Default: seq_len(12L). Para 2002–2009 o MTE publica um arquivo anual; ele é baixado uma única vez e apenas os meses pedidos (pela competencia_declarada) são gravados.

db_path

character. Path to the file .duckdb.

destdir

character or NULL. Cache directory for ⁠.7z⁠ files. Default: tools::R_user_dir("datacaged", "cache").

force_download

logical. If TRUE, re-downloads even if already cached. Default: FALSE.

overwrite_competencies

logical. If TRUE, overwrites competencies already in the database. Default: FALSE.

timeout

integer. Timeout in seconds. Default: 300.

Details

O CAGED Ajustes contém correções retroativas de vínculos do CAGED antigo (até 2019). Cada arquivo ⁠CAGEDEST_AJUSTES_{MM}{AAAA}.7z⁠ registra movimentações ajustadas após a declaração original — essencial para reconstrução de séries históricas mais precisas.

Os dados são gravados na tabela caged_ajustes do banco DuckDB, com o mesmo schema do caged_antigo.

Value

invisível: tibble com estatísticas do banco após a carga.

See Also

caged_load() para Novo CAGED (2020+) e CAGED antigo (até 2019).

caged_hf_files() com type = "ajustes" para listar disponibilidade.

Examples

## Not run: 
# List available adjustment competencies first
avail <- caged_hf_files(type = "ajustes", n = 3, verbose = FALSE)

if (nrow(avail) > 0) {
  db <- file.path(tempdir(), "caged_ajustes.duckdb")

  # Download and load adjustments
  caged_adjustments_load(
    years   = avail$ano[1],
    months  = avail$mes[1],
    db_path = db
  )

  con <- caged_connect(db)
  # List tables and records
  dplyr::tbl(con, "caged_ajustes") |>
    dplyr::group_by(competencia) |>
    dplyr::count() |>
    dplyr::collect()
  DBI::dbDisconnect(con, shutdown = TRUE)
}

## End(Not run)


datacaged documentation built on Oct. 13, 2026, 1:06 a.m.