Skip to main content

Module catalog_file

Module catalog_file 

Source
Expand description

The catalog file: a versioned JSON list of the statements that defined each object, in the order they are replayed.

{
  "format": "ursa",
  "version": 1,
  "statements": [
    "CREATE VIEW ties AS SELECT * FROM 'karate_edges.csv'"
  ],
  "settings": {
    "ursa.index_storage_limit": "32GiB"
  }
}

settings holds the settings the database keeps (#327): today only ursa.index_storage_limit, as SET left it. It is written only when there is one, so a database that never had one is the same file as before; a version of Ursa older than 0.8 ignores it (and drops it if it rewrites the file, which then obeys the default limit again).

version changes only when the file’s shape does. A file with a newer version is refused; anything that is not this shape is reported as not a valid database. An empty file (touch club.ursa) is an empty catalog.

Structs§

CatalogFile
The contents of a catalog file.

Constants§

FORMAT
The format field of every catalog file.
VERSION
The catalog file version this build reads and writes.