riverqueue 0.11.0 → 0.12.0

data/migration/sqlite/main/007_notification_outbox_sqlite_jsonb_and_sql_cleanup.down.sql

@@ -0,0 +1,255 @@
+--
+-- SQL cleanup rollback.
+--
+
+--
+-- Add back unused tables `river_client` and `river_client_queue`.
+--
+
+CREATE TABLE /* TEMPLATE: schema */river_client (
+    id text PRIMARY KEY NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    paused_at timestamp,
+    updated_at timestamp NOT NULL,
+    CONSTRAINT name_length CHECK (length(id) > 0 AND length(id) < 128)
+);
+
+CREATE TABLE /* TEMPLATE: schema */river_client_queue (
+    river_client_id text NOT NULL REFERENCES river_client (id) ON DELETE CASCADE,
+    name text NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    max_workers integer NOT NULL DEFAULT 0,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    num_jobs_completed integer NOT NULL DEFAULT 0,
+    num_jobs_running integer NOT NULL DEFAULT 0,
+    updated_at timestamp NOT NULL,
+    PRIMARY KEY (river_client_id, name),
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT num_jobs_completed_zero_or_positive CHECK (num_jobs_completed >= 0),
+    CONSTRAINT num_jobs_running_zero_or_positive CHECK (num_jobs_running >= 0)
+);
+
+--
+-- SQLite JSONB conversion rollback.
+--
+-- Convert JSONB binary columns back to JSON text format and restore json()
+-- defaults. The `river_job` rebuild also reverts the addition of `DEFAULT 25`
+-- to `river_job.max_attempts`.
+--
+-- SQLite doesn't allow `ALTER TABLE ADD COLUMN` with non-constant defaults like
+-- `json('{}')`, so rebuild each affected table instead.
+--
+
+--
+-- river_job
+--
+
+DROP INDEX /* TEMPLATE: schema */river_job_kind;
+DROP INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index;
+DROP INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index;
+DROP INDEX /* TEMPLATE: schema */river_job_unique_idx;
+
+ALTER TABLE /* TEMPLATE: schema */river_job RENAME TO river_job_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_job (
+    id integer PRIMARY KEY, -- SQLite aliases this to ROWID, which may reuse deleted IDs.
+    args blob NOT NULL DEFAULT '{}',
+    attempt integer NOT NULL DEFAULT 0,
+    attempted_at timestamp,
+    attempted_by blob, -- json
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    errors blob, -- json
+    finalized_at timestamp,
+    kind text NOT NULL,
+    max_attempts integer NOT NULL,
+    metadata blob NOT NULL DEFAULT (json('{}')),
+    priority integer NOT NULL DEFAULT 1,
+    queue text NOT NULL DEFAULT 'default',
+    state text NOT NULL DEFAULT 'available',
+    scheduled_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    tags blob NOT NULL DEFAULT (json('[]')),
+    unique_key blob,
+    unique_states integer,
+    CONSTRAINT finalized_or_finalized_at_null CHECK (
+        (finalized_at IS NULL AND state NOT IN ('cancelled', 'completed', 'discarded')) OR
+        (finalized_at IS NOT NULL AND state IN ('cancelled', 'completed', 'discarded'))
+    ),
+    CONSTRAINT priority_in_range CHECK (priority >= 1 AND priority <= 4),
+    CONSTRAINT queue_length CHECK (length(queue) > 0 AND length(queue) < 128),
+    CONSTRAINT kind_length CHECK (length(kind) > 0 AND length(kind) < 128),
+    CONSTRAINT state_valid CHECK (state IN ('available', 'cancelled', 'completed', 'discarded', 'pending', 'retryable', 'running', 'scheduled'))
+);
+
+INSERT INTO /* TEMPLATE: schema */river_job (
+    id,
+    args,
+    attempt,
+    attempted_at,
+    attempted_by,
+    created_at,
+    errors,
+    finalized_at,
+    kind,
+    max_attempts,
+    metadata,
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    tags,
+    unique_key,
+    unique_states
+)
+SELECT
+    id,
+    json(args),
+    attempt,
+    attempted_at,
+    CASE WHEN attempted_by IS NULL THEN NULL ELSE json(attempted_by) END,
+    created_at,
+    CASE WHEN errors IS NULL THEN NULL ELSE json(errors) END,
+    finalized_at,
+    kind,
+    max_attempts,
+    json(metadata),
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    json(tags),
+    unique_key,
+    unique_states
+FROM /* TEMPLATE: schema */river_job_old;
+
+DROP TABLE /* TEMPLATE: schema */river_job_old;
+
+CREATE INDEX /* TEMPLATE: schema */river_job_kind ON river_job (kind);
+CREATE INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index ON river_job (state, finalized_at) WHERE finalized_at IS NOT NULL;
+CREATE INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index ON river_job (state, queue, priority, scheduled_at, id);
+CREATE UNIQUE INDEX /* TEMPLATE: schema */river_job_unique_idx ON river_job (unique_key)
+    WHERE unique_key IS NOT NULL
+        AND unique_states IS NOT NULL
+        AND CASE state
+            WHEN 'available' THEN unique_states & (1 << 0)
+            WHEN 'cancelled' THEN unique_states & (1 << 1)
+            WHEN 'completed' THEN unique_states & (1 << 2)
+            WHEN 'discarded' THEN unique_states & (1 << 3)
+            WHEN 'pending'   THEN unique_states & (1 << 4)
+            WHEN 'retryable' THEN unique_states & (1 << 5)
+            WHEN 'running'   THEN unique_states & (1 << 6)
+            WHEN 'scheduled' THEN unique_states & (1 << 7)
+            ELSE 0
+        END >= 1;
+
+--
+-- river_queue
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_queue RENAME TO river_queue_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_queue (
+    name text PRIMARY KEY NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata blob NOT NULL DEFAULT (json('{}')),
+    paused_at timestamp,
+    updated_at timestamp NOT NULL
+);
+
+INSERT INTO /* TEMPLATE: schema */river_queue (
+    name,
+    created_at,
+    metadata,
+    paused_at,
+    updated_at
+)
+SELECT
+    name,
+    created_at,
+    json(metadata),
+    paused_at,
+    updated_at
+FROM /* TEMPLATE: schema */river_queue_old;
+
+DROP TABLE /* TEMPLATE: schema */river_queue_old;
+
+--
+-- river_client
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_client RENAME TO river_client_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_client (
+    id text PRIMARY KEY NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata blob NOT NULL DEFAULT (json('{}')),
+    paused_at timestamp,
+    updated_at timestamp NOT NULL,
+    CONSTRAINT name_length CHECK (length(id) > 0 AND length(id) < 128)
+);
+
+INSERT INTO /* TEMPLATE: schema */river_client (
+    id,
+    created_at,
+    metadata,
+    paused_at,
+    updated_at
+)
+SELECT
+    id,
+    created_at,
+    json(metadata),
+    paused_at,
+    updated_at
+FROM /* TEMPLATE: schema */river_client_old;
+
+--
+-- river_client_queue
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_client_queue RENAME TO river_client_queue_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_client_queue (
+    river_client_id text NOT NULL REFERENCES river_client (id) ON DELETE CASCADE,
+    name text NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    max_workers integer NOT NULL DEFAULT 0,
+    metadata blob NOT NULL DEFAULT (json('{}')),
+    num_jobs_completed integer NOT NULL DEFAULT 0,
+    num_jobs_running integer NOT NULL DEFAULT 0,
+    updated_at timestamp NOT NULL,
+    PRIMARY KEY (river_client_id, name),
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT num_jobs_completed_zero_or_positive CHECK (num_jobs_completed >= 0),
+    CONSTRAINT num_jobs_running_zero_or_positive CHECK (num_jobs_running >= 0)
+);
+
+INSERT INTO /* TEMPLATE: schema */river_client_queue (
+    river_client_id,
+    name,
+    created_at,
+    max_workers,
+    metadata,
+    num_jobs_completed,
+    num_jobs_running,
+    updated_at
+)
+SELECT
+    river_client_id,
+    name,
+    created_at,
+    max_workers,
+    json(metadata),
+    num_jobs_completed,
+    num_jobs_running,
+    updated_at
+FROM /* TEMPLATE: schema */river_client_queue_old;
+
+DROP TABLE /* TEMPLATE: schema */river_client_queue_old;
+DROP TABLE /* TEMPLATE: schema */river_client_old;
+
+--
+-- Notification outbox rollback.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_notification;

data/migration/sqlite/main/007_notification_outbox_sqlite_jsonb_and_sql_cleanup.up.sql

@@ -0,0 +1,261 @@
+--
+-- Notification outbox.
+--
+
+CREATE TABLE /* TEMPLATE: schema */river_notification (
+    id integer PRIMARY KEY AUTOINCREMENT,
+    created_at timestamp NOT NULL DEFAULT (datetime('now', 'subsec')),
+    payload text NOT NULL,
+    topic text NOT NULL,
+    CONSTRAINT topic_length CHECK (length(topic) > 0 AND length(topic) < 128)
+);
+
+CREATE INDEX /* TEMPLATE: schema */river_notification_created_at_idx ON river_notification (created_at);
+CREATE INDEX /* TEMPLATE: schema */river_notification_topic_id_idx ON river_notification (topic, id);
+
+--
+-- SQLite JSONB conversion.
+--
+-- Convert JSON text columns to JSONB binary format for more efficient storage
+-- and processing, and update column defaults from json() to jsonb().
+--
+-- SQLite doesn't allow `ALTER TABLE ADD COLUMN` with non-constant defaults like
+-- `jsonb('{}')`, so rebuild each affected table instead.
+--
+
+--
+-- river_job
+--
+
+DROP INDEX /* TEMPLATE: schema */river_job_kind;
+DROP INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index;
+DROP INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index;
+DROP INDEX /* TEMPLATE: schema */river_job_unique_idx;
+
+ALTER TABLE /* TEMPLATE: schema */river_job RENAME TO river_job_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_job (
+    id integer PRIMARY KEY, -- SQLite aliases this to ROWID, which may reuse deleted IDs.
+    args blob NOT NULL DEFAULT (jsonb('{}')),
+    attempt integer NOT NULL DEFAULT 0,
+    attempted_at timestamp,
+    attempted_by blob, -- json
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    errors blob, -- json
+    finalized_at timestamp,
+    kind text NOT NULL,
+    max_attempts integer NOT NULL,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    priority integer NOT NULL DEFAULT 1,
+    queue text NOT NULL DEFAULT 'default',
+    state text NOT NULL DEFAULT 'available',
+    scheduled_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    tags blob NOT NULL DEFAULT (jsonb('[]')),
+    unique_key blob,
+    unique_states integer,
+    CONSTRAINT finalized_or_finalized_at_null CHECK (
+        (finalized_at IS NULL AND state NOT IN ('cancelled', 'completed', 'discarded')) OR
+        (finalized_at IS NOT NULL AND state IN ('cancelled', 'completed', 'discarded'))
+    ),
+    CONSTRAINT priority_in_range CHECK (priority >= 1 AND priority <= 4),
+    CONSTRAINT queue_length CHECK (length(queue) > 0 AND length(queue) < 128),
+    CONSTRAINT kind_length CHECK (length(kind) > 0 AND length(kind) < 128),
+    CONSTRAINT state_valid CHECK (state IN ('available', 'cancelled', 'completed', 'discarded', 'pending', 'retryable', 'running', 'scheduled'))
+);
+
+INSERT INTO /* TEMPLATE: schema */river_job (
+    id,
+    args,
+    attempt,
+    attempted_at,
+    attempted_by,
+    created_at,
+    errors,
+    finalized_at,
+    kind,
+    max_attempts,
+    metadata,
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    tags,
+    unique_key,
+    unique_states
+)
+SELECT
+    id,
+    jsonb(args),
+    attempt,
+    attempted_at,
+    CASE WHEN attempted_by IS NULL THEN NULL ELSE jsonb(attempted_by) END,
+    created_at,
+    CASE WHEN errors IS NULL THEN NULL ELSE jsonb(errors) END,
+    finalized_at,
+    kind,
+    max_attempts,
+    jsonb(metadata),
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    jsonb(tags),
+    unique_key,
+    unique_states
+FROM /* TEMPLATE: schema */river_job_old;
+
+DROP TABLE /* TEMPLATE: schema */river_job_old;
+
+CREATE INDEX /* TEMPLATE: schema */river_job_kind ON river_job (kind);
+CREATE INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index ON river_job (state, finalized_at) WHERE finalized_at IS NOT NULL;
+CREATE INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index ON river_job (state, queue, priority, scheduled_at, id);
+CREATE UNIQUE INDEX /* TEMPLATE: schema */river_job_unique_idx ON river_job (unique_key)
+    WHERE unique_key IS NOT NULL
+        AND unique_states IS NOT NULL
+        AND CASE state
+            WHEN 'available' THEN unique_states & (1 << 0)
+            WHEN 'cancelled' THEN unique_states & (1 << 1)
+            WHEN 'completed' THEN unique_states & (1 << 2)
+            WHEN 'discarded' THEN unique_states & (1 << 3)
+            WHEN 'pending'   THEN unique_states & (1 << 4)
+            WHEN 'retryable' THEN unique_states & (1 << 5)
+            WHEN 'running'   THEN unique_states & (1 << 6)
+            WHEN 'scheduled' THEN unique_states & (1 << 7)
+            ELSE 0
+        END >= 1;
+
+--
+-- river_queue
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_queue RENAME TO river_queue_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_queue (
+    name text PRIMARY KEY NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    paused_at timestamp,
+    updated_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+INSERT INTO /* TEMPLATE: schema */river_queue (
+    name,
+    created_at,
+    metadata,
+    paused_at,
+    updated_at
+)
+SELECT
+    name,
+    created_at,
+    jsonb(metadata),
+    paused_at,
+    updated_at
+FROM /* TEMPLATE: schema */river_queue_old;
+
+DROP TABLE /* TEMPLATE: schema */river_queue_old;
+
+--
+-- river_client
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_client RENAME TO river_client_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_client (
+    id text PRIMARY KEY NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    paused_at timestamp,
+    updated_at timestamp NOT NULL,
+    CONSTRAINT name_length CHECK (length(id) > 0 AND length(id) < 128)
+);
+
+INSERT INTO /* TEMPLATE: schema */river_client (
+    id,
+    created_at,
+    metadata,
+    paused_at,
+    updated_at
+)
+SELECT
+    id,
+    created_at,
+    jsonb(metadata),
+    paused_at,
+    updated_at
+FROM /* TEMPLATE: schema */river_client_old;
+
+--
+-- river_client_queue
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_client_queue RENAME TO river_client_queue_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_client_queue (
+    river_client_id text NOT NULL REFERENCES river_client (id) ON DELETE CASCADE,
+    name text NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    max_workers integer NOT NULL DEFAULT 0,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    num_jobs_completed integer NOT NULL DEFAULT 0,
+    num_jobs_running integer NOT NULL DEFAULT 0,
+    updated_at timestamp NOT NULL,
+    PRIMARY KEY (river_client_id, name),
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT num_jobs_completed_zero_or_positive CHECK (num_jobs_completed >= 0),
+    CONSTRAINT num_jobs_running_zero_or_positive CHECK (num_jobs_running >= 0)
+);
+
+INSERT INTO /* TEMPLATE: schema */river_client_queue (
+    river_client_id,
+    name,
+    created_at,
+    max_workers,
+    metadata,
+    num_jobs_completed,
+    num_jobs_running,
+    updated_at
+)
+SELECT
+    river_client_id,
+    name,
+    created_at,
+    max_workers,
+    jsonb(metadata),
+    num_jobs_completed,
+    num_jobs_running,
+    updated_at
+FROM /* TEMPLATE: schema */river_client_queue_old;
+
+DROP TABLE /* TEMPLATE: schema */river_client_queue_old;
+DROP TABLE /* TEMPLATE: schema */river_client_old;
+
+--
+-- SQL cleanup.
+--
+
+--
+-- Drop unused tables `river_client` and `river_client_queue`.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_client_queue;
+DROP TABLE /* TEMPLATE: schema */river_client;
+
+--
+-- Adds `DEFAULT 25` to `river_job.max_attempts`.
+--
+
+-- This may look odd in that we're adding a brand new column, but it's because
+-- SQLite doesn't support anything beyond the most trivial DDL.
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    RENAME COLUMN max_attempts TO max_attempts_old;
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    ADD COLUMN max_attempts integer NOT NULL DEFAULT 25;
+
+UPDATE /* TEMPLATE: schema */river_job
+SET max_attempts = max_attempts_old;
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    DROP COLUMN max_attempts_old;

data/migration/sqlite/main/008_job_id_autoincrement.down.sql

@@ -0,0 +1,121 @@
+-- Rebuild river_job to restore SQLite's default ROWID allocation behavior.
+
+-- Rebuilding river_job would discard schema installed by River Pro. Check
+-- schema objects instead of migration records to also catch manually applied
+-- Pro migrations and the legacy workflow migration line.
+CREATE TEMP TABLE river_job_pro_schema_guard (
+    id integer NOT NULL
+);
+
+CREATE TEMP TRIGGER river_job_pro_schema_guard_enforce
+    BEFORE INSERT ON river_job_pro_schema_guard
+    WHEN EXISTS (
+        SELECT 1
+        FROM /* TEMPLATE: schema */sqlite_master
+        WHERE name IN ('river_job_sequence', 'river_job_workflow_scheduling', 'river_workflow')
+    )
+BEGIN
+    SELECT RAISE(ABORT, 'River SQLite migration 008 cannot run while River Pro schema is installed');
+END;
+
+INSERT INTO river_job_pro_schema_guard (id) VALUES (1);
+
+DROP TRIGGER river_job_pro_schema_guard_enforce;
+DROP TABLE river_job_pro_schema_guard;
+
+DROP INDEX /* TEMPLATE: schema */river_job_kind;
+DROP INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index;
+DROP INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index;
+DROP INDEX /* TEMPLATE: schema */river_job_unique_idx;
+
+ALTER TABLE /* TEMPLATE: schema */river_job RENAME TO river_job_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_job (
+    id integer PRIMARY KEY,
+    args blob NOT NULL DEFAULT (jsonb('{}')),
+    attempt integer NOT NULL DEFAULT 0,
+    attempted_at timestamp,
+    attempted_by blob, -- json
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    errors blob, -- json
+    finalized_at timestamp,
+    kind text NOT NULL,
+    max_attempts integer NOT NULL DEFAULT 25,
+    metadata blob NOT NULL DEFAULT (jsonb('{}')),
+    priority integer NOT NULL DEFAULT 1,
+    queue text NOT NULL DEFAULT 'default',
+    state text NOT NULL DEFAULT 'available',
+    scheduled_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    tags blob NOT NULL DEFAULT (jsonb('[]')),
+    unique_key blob,
+    unique_states integer,
+    CONSTRAINT finalized_or_finalized_at_null CHECK (
+        (finalized_at IS NULL AND state NOT IN ('cancelled', 'completed', 'discarded')) OR
+        (finalized_at IS NOT NULL AND state IN ('cancelled', 'completed', 'discarded'))
+    ),
+    CONSTRAINT priority_in_range CHECK (priority >= 1 AND priority <= 4),
+    CONSTRAINT queue_length CHECK (length(queue) > 0 AND length(queue) < 128),
+    CONSTRAINT kind_length CHECK (length(kind) > 0 AND length(kind) < 128),
+    CONSTRAINT state_valid CHECK (state IN ('available', 'cancelled', 'completed', 'discarded', 'pending', 'retryable', 'running', 'scheduled'))
+);
+
+INSERT INTO /* TEMPLATE: schema */river_job (
+    id,
+    args,
+    attempt,
+    attempted_at,
+    attempted_by,
+    created_at,
+    errors,
+    finalized_at,
+    kind,
+    max_attempts,
+    metadata,
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    tags,
+    unique_key,
+    unique_states
+)
+SELECT
+    id,
+    args,
+    attempt,
+    attempted_at,
+    attempted_by,
+    created_at,
+    errors,
+    finalized_at,
+    kind,
+    max_attempts,
+    metadata,
+    priority,
+    queue,
+    state,
+    scheduled_at,
+    tags,
+    unique_key,
+    unique_states
+FROM /* TEMPLATE: schema */river_job_old;
+
+DROP TABLE /* TEMPLATE: schema */river_job_old;
+
+CREATE INDEX /* TEMPLATE: schema */river_job_kind ON river_job (kind);
+CREATE INDEX /* TEMPLATE: schema */river_job_state_and_finalized_at_index ON river_job (state, finalized_at) WHERE finalized_at IS NOT NULL;
+CREATE INDEX /* TEMPLATE: schema */river_job_prioritized_fetching_index ON river_job (state, queue, priority, scheduled_at, id);
+CREATE UNIQUE INDEX /* TEMPLATE: schema */river_job_unique_idx ON river_job (unique_key)
+    WHERE unique_key IS NOT NULL
+        AND unique_states IS NOT NULL
+        AND CASE state
+            WHEN 'available' THEN unique_states & (1 << 0)
+            WHEN 'cancelled' THEN unique_states & (1 << 1)
+            WHEN 'completed' THEN unique_states & (1 << 2)
+            WHEN 'discarded' THEN unique_states & (1 << 3)
+            WHEN 'pending'   THEN unique_states & (1 << 4)
+            WHEN 'retryable' THEN unique_states & (1 << 5)
+            WHEN 'running'   THEN unique_states & (1 << 6)
+            WHEN 'scheduled' THEN unique_states & (1 << 7)
+            ELSE 0
+        END >= 1;