Read the run-provenance log from a persist schema

Answers "which config produced this network, and when" without hand-written SQL. One row per lnk_pipeline_run() call; by default only the most recent run per watershed group.

Usage

lnk_log_read(conn, cfg, aoi = NULL, latest = TRUE)

Arguments

conn

DBI connection to the pipeline database.

cfg

An lnk_config object — supplies the persist schema.

aoi

Optional watershed group code to filter to.

latest

Logical. When TRUE (default), return only the newest run per watershed group. FALSE returns the full history.

Value

A tibble, newest first.

Details

A watershed group present in <persist_schema>.streams but absent here was modelled before provenance logging existed (link#127) — absence means pre-provenance vintage, not an error. Rows are never backfilled, because the config and code state that produced them is not recoverable and a synthetic row would be fabricated provenance.

See also

Other compare: lnk_access(), lnk_compare_mapping_code(), lnk_compare_rollup(), lnk_compare_wsg(), lnk_mapping_code(), lnk_parity_annotate(), lnk_rollup_wsg()

Examples

if (FALSE) { # \dontrun{
conn <- lnk_db_conn()
cfg  <- lnk_config("default")

# What produced the current PINE network?
lnk_log_read(conn, cfg, aoi = "PINE")

# Every run, newest first.
lnk_log_read(conn, cfg, latest = FALSE)
} # }