uniform_resource

Description

Immutable resource and content information. On multiple executions,
uniform_resource are inserted only if the the content (see unique
index for details). For historical logging, uniform_resource has foreign
key references to both ur_ingest_session and ur_ingest_session_fs_path
tables to indicate which particular session and ingestion path the
resourced was inserted during.

Table Definition

CREATE TABLE "uniform_resource" (
    "uniform_resource_id" VARCHAR PRIMARY KEY NOT NULL,
    "device_id" VARCHAR NOT NULL,
    "ingest_session_id" VARCHAR NOT NULL,
    "ingest_fs_path_id" VARCHAR,
    "uri" TEXT NOT NULL,
    "content_digest" TEXT NOT NULL,
    "content" BLOB,
    "nature" TEXT,
    "size_bytes" INTEGER,
    "last_modified_at" TIMESTAMP,
    "content_fm_body_attrs" TEXT CHECK(json_valid(content_fm_body_attrs) OR content_fm_body_attrs IS NULL),
    "frontmatter" TEXT CHECK(json_valid(frontmatter) OR frontmatter IS NULL),
    "elaboration" TEXT CHECK(json_valid(elaboration) OR elaboration IS NULL),
    "created_at" TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    "created_by" TEXT DEFAULT 'UNKNOWN',
    "updated_at" TIMESTAMP,
    "updated_by" TEXT,
    "deleted_at" TIMESTAMP,
    "deleted_by" TEXT,
    "activity_log" TEXT,
    FOREIGN KEY("device_id") REFERENCES "device"("device_id"),
    FOREIGN KEY("ingest_session_id") REFERENCES "ur_ingest_session"("ur_ingest_session_id"),
    FOREIGN KEY("ingest_fs_path_id") REFERENCES "ur_ingest_session_fs_path"("ur_ingest_session_fs_path_id"),
    UNIQUE("device_id", "content_digest", "uri", "size_bytes", "last_modified_at")
)

Columns

Name	Type	Default	Nullable	Children	Parents	Comment
uniform_resource_id	VARCHAR		false	uniform_resource_transform ur_ingest_session_fs_path_entry ur_ingest_session_task		uniform_resource ULID primary key
device_id	VARCHAR		false		device	which device row introduced this resource
ingest_session_id	VARCHAR		false		ur_ingest_session	which ur_ingest_session row introduced this resource
ingest_fs_path_id	VARCHAR		true		ur_ingest_session_fs_path	which ur_ingest_session_fs_path row introduced this resource
uri	TEXT		false			the resource’s URI (dependent on how it was acquired and on which device)
content_digest	TEXT		false			’-’ when no hash was computed (not NULL); content_digest for symlinks will be the same as their target
content	BLOB		true			either NULL if no content was acquired or the actual blob/text of the content
nature	TEXT		true			file extension or MIME
size_bytes	INTEGER		true
last_modified_at	TIMESTAMP		true			{“isSqlDomainZodDescrMeta”:true ,“isDateSqlDomain”:true ,“isDateTime”:true }
content_fm_body_attrs	TEXT		true			each component of frontmatter-based content ({ frontMatter: ”, body: ”, attrs: {…} })
frontmatter	TEXT		true			meta data or other “frontmatter” in JSON format
elaboration	TEXT		true			anything that doesn’t fit in other columns (JSON)
created_at	TIMESTAMP	CURRENT_TIMESTAMP	true
created_by	TEXT	’UNKNOWN’	true
updated_at	TIMESTAMP		true
updated_by	TEXT		true
deleted_at	TIMESTAMP		true
deleted_by	TEXT		true
activity_log	TEXT		true			{“isSqlDomainZodDescrMeta”:true ,“isJsonSqlDomain”:true }

Constraints

Name	Type	Definition
uniform_resource_id	PRIMARY KEY	PRIMARY KEY (uniform_resource_id)
- (Foreign key ID: 0)	FOREIGN KEY	FOREIGN KEY (ingest_fs_path_id) REFERENCES ur_ingest_session_fs_path (ur_ingest_session_fs_path_id) ON UPDATE NO ACTION ON DELETE NO ACTION MATCH NONE
- (Foreign key ID: 1)	FOREIGN KEY	FOREIGN KEY (ingest_session_id) REFERENCES ur_ingest_session (ur_ingest_session_id) ON UPDATE NO ACTION ON DELETE NO ACTION MATCH NONE
- (Foreign key ID: 2)	FOREIGN KEY	FOREIGN KEY (device_id) REFERENCES device (device_id) ON UPDATE NO ACTION ON DELETE NO ACTION MATCH NONE
sqlite_autoindex_uniform_resource_2	UNIQUE	UNIQUE (device_id, content_digest, uri, size_bytes, last_modified_at)
sqlite_autoindex_uniform_resource_1	PRIMARY KEY	PRIMARY KEY (uniform_resource_id)
-	CHECK	CHECK(json_valid(content_fm_body_attrs) OR content_fm_body_attrs IS NULL)
-	CHECK	CHECK(json_valid(frontmatter) OR frontmatter IS NULL)
-	CHECK	CHECK(json_valid(elaboration) OR elaboration IS NULL)

Indexes

Name	Definition
idx_uniform_resourcedevice_iduri	CREATE INDEX “idx_uniform_resourcedevice_iduri” ON “uniform_resource”(“device_id”, “uri”)
sqlite_autoindex_uniform_resource_2	UNIQUE (device_id, content_digest, uri, size_bytes, last_modified_at)
sqlite_autoindex_uniform_resource_1	PRIMARY KEY (uniform_resource_id)

Relations