caged_to_duckdb: Grava um data.frame de microdados do CAGED em uma tabela...

View source: R/database.R

caged_to_duckdbR Documentation

Grava um data.frame de microdados do CAGED em uma tabela DuckDB

Description

Evita duplicatas por competência: antes de inserir, verifica quais competências do data.frame já existem na tabela e insere apenas as novas via DBI::dbAppendTable() (útil para re-rodar o pipeline sem apagar dados anteriores). Com overwrite_competencies = TRUE, as competências presentes no data.frame são apagadas e regravadas.

Usage

caged_to_duckdb(
  df,
  db_path = NULL,
  table = NULL,
  overwrite_competencies = FALSE,
  .con = NULL
)

Arguments

df

data.frame or tibble. Data returned by caged_parse().

db_path

character or NULL. Path to the file .duckdb. Pode ser NULL se .con for fornecido.

table

character or NULL. Name of the destination table. If NULL, detecta automaticamente pela coluna fonte_tipo do data.frame.

overwrite_competencies

logical. If TRUE, deletes records for the competency before inserting (avoids duplicates on re-runs). Default: FALSE.

.con

a DBI connection object (optional). If provided, db_path is ignored and the existing connection is reused. The caller is responsible for closing the connection.

Details

A coluna competencia usada como chave identifica o arquivo de origem: competenciamov em caged_mov, competenciadec em caged_for, competenciaexc em caged_exc e competencia_declarada em caged_antigo e caged_ajustes. Para análises pelo mês da movimentação, use a coluna competenciamov.

As tabelas criadas são:

  • caged_mov, caged_for, caged_exc — para dados de 2020 em diante

  • caged_antigo — para dados até 2019 (CAGED antigo)

  • caged_ajustes — ajustes retroativos do CAGED antigo

Value

invisible: number of rows inserted.

See Also

caged_parse() para gerar o data.frame de entrada.

caged_load() para o pipeline completo.

Examples

## Not run: 
# Parse e grava em um único fluxo (requer arquivo baixado)
df <- caged_parse("CAGEDMOV202301.7z")
caged_to_duckdb(df, db_path = file.path(tempdir(), "caged.duckdb"))

# Regravar uma competência já existente
caged_to_duckdb(df, db_path = file.path(tempdir(), "caged.duckdb"),
                overwrite_competencies = TRUE)

## End(Not run)


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