Uses metadata-only API requests to identify years containing changed, added,
or removed deliveries. Once one changed delivery is found, remaining
deliveries in that year are skipped because the complete annual XML cache
must be replaced. Cruise-series, gear, taxa, and coded-field reference tables
are refreshed on every run. If the database schema is incompatible with this
package
version, a complete sibling database is built with
compileDatabase and safely swapped into place.
Usage
updateDatabase(
years = NULL,
dbPath = "~/IMR_biotic_BES_database",
dbIndexFile = file.path(dbPath, "dbIndex.rda"),
dbName = NULL,
verbose = FALSE
)Arguments
- years
Optional integer vector limiting metadata checks and incremental replacements. A schema compatibility rebuild always includes all years.
- dbPath
Character string specifying the folder where the duckdb and dbIndex files should be saved.
- dbIndexFile
Character string specifying the file path where the index of the database should be saved. Must include
.rdaat the end. The index is used by BioticExplorer.- dbName
Character string or
NULL. IfNULLuses the default name ("bioticexplorer").- verbose
Logical; emit one metadata-check message per delivery. The default uses a progress bar in interactive sessions and bounded milestone messages in non-interactive logs.