riverqueue 0.11.0 → 0.12.0

data/migration/postgresql/main/005_migration_unique_client.down.sql

@@ -0,0 +1,57 @@
+--
+-- Revert to migration table based only on `(version)`.
+--
+-- If any non-main migrations are present, 005 is considered irreversible.
+--
+
+DO
+$body$
+BEGIN
+    -- Tolerate users who may be using their own migration system rather than
+    -- River's. If they are, they will have skipped version 001 containing
+    -- `CREATE TABLE river_migration`, so this table won't exist.
+    IF (SELECT to_regclass('/* TEMPLATE: schema */river_migration') IS NOT NULL) THEN
+        IF EXISTS (
+            SELECT *
+            FROM /* TEMPLATE: schema */river_migration
+            WHERE line <> 'main'
+        ) THEN
+            RAISE EXCEPTION 'Found non-main migration lines in the database; version 005 migration is irreversible because it would result in loss of migration information.';
+        END IF;
+
+        ALTER TABLE /* TEMPLATE: schema */river_migration
+            RENAME TO river_migration_old;
+
+        CREATE TABLE /* TEMPLATE: schema */river_migration(
+            id bigserial PRIMARY KEY,
+            created_at timestamptz NOT NULL DEFAULT NOW(),
+            version bigint NOT NULL,
+            CONSTRAINT version CHECK (version >= 1)
+        );
+
+        CREATE UNIQUE INDEX ON /* TEMPLATE: schema */river_migration USING btree(version);
+
+        INSERT INTO /* TEMPLATE: schema */river_migration
+            (created_at, version)
+        SELECT created_at, version
+        FROM /* TEMPLATE: schema */river_migration_old;
+
+        DROP TABLE /* TEMPLATE: schema */river_migration_old;
+    END IF;
+END;
+$body$
+LANGUAGE 'plpgsql'; 
+
+--
+-- Drop `river_job.unique_key`.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    DROP COLUMN unique_key;
+
+--
+-- Drop `river_client` and derivative.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_client_queue;
+DROP TABLE /* TEMPLATE: schema */river_client;

data/migration/postgresql/main/005_migration_unique_client.up.sql

@@ -0,0 +1,79 @@
+--
+-- Rebuild the migration table so it's based on `(line, version)`.
+--
+
+DO
+$body$
+BEGIN
+    -- Tolerate users who may be using their own migration system rather than
+    -- River's. If they are, they will have skipped version 001 containing
+    -- `CREATE TABLE river_migration`, so this table won't exist.
+    IF (SELECT to_regclass('/* TEMPLATE: schema */river_migration') IS NOT NULL) THEN
+        ALTER TABLE /* TEMPLATE: schema */river_migration
+            RENAME TO river_migration_old;
+
+        CREATE TABLE /* TEMPLATE: schema */river_migration(
+            line TEXT NOT NULL,
+            version bigint NOT NULL,
+            created_at timestamptz NOT NULL DEFAULT NOW(),
+            CONSTRAINT line_length CHECK (char_length(line) > 0 AND char_length(line) < 128),
+            CONSTRAINT version_gte_1 CHECK (version >= 1),
+            PRIMARY KEY (line, version)
+        );
+
+        INSERT INTO /* TEMPLATE: schema */river_migration
+            (created_at, line, version)
+        SELECT created_at, 'main', version
+        FROM /* TEMPLATE: schema */river_migration_old;
+
+        DROP TABLE /* TEMPLATE: schema */river_migration_old;
+    END IF;
+END;
+$body$
+LANGUAGE 'plpgsql'; 
+
+--
+-- Add `river_job.unique_key` and bring up an index on it.
+--
+
+-- These statements use `IF NOT EXISTS` to allow users with a `river_job` table
+-- of non-trivial size to build the index `CONCURRENTLY` out of band of this
+-- migration, then follow by completing the migration.
+ALTER TABLE /* TEMPLATE: schema */river_job
+    ADD COLUMN IF NOT EXISTS unique_key bytea;
+
+CREATE UNIQUE INDEX IF NOT EXISTS river_job_kind_unique_key_idx ON /* TEMPLATE: schema */river_job (kind, unique_key) WHERE unique_key IS NOT NULL;
+
+--
+-- Create `river_client` and derivative.
+--
+-- This feature hasn't quite yet been implemented, but we're taking advantage of
+-- the migration to add the schema early so that we can add it later without an
+-- additional migration.
+--
+
+CREATE UNLOGGED TABLE /* TEMPLATE: schema */river_client (
+    id text PRIMARY KEY NOT NULL,
+    created_at timestamptz NOT NULL DEFAULT now(),
+    metadata jsonb NOT NULL DEFAULT '{}',
+    paused_at timestamptz,
+    updated_at timestamptz NOT NULL,
+    CONSTRAINT name_length CHECK (char_length(id) > 0 AND char_length(id) < 128)
+);
+
+-- Differs from `river_queue` in that it tracks the queue state for a particular
+-- active client.
+CREATE UNLOGGED TABLE /* TEMPLATE: schema */river_client_queue (
+    river_client_id text NOT NULL REFERENCES /* TEMPLATE: schema */river_client (id) ON DELETE CASCADE,
+    name text NOT NULL,
+    created_at timestamptz NOT NULL DEFAULT now(),
+    max_workers bigint NOT NULL DEFAULT 0,
+    metadata jsonb NOT NULL DEFAULT '{}',
+    num_jobs_completed bigint NOT NULL DEFAULT 0,
+    num_jobs_running bigint NOT NULL DEFAULT 0,
+    updated_at timestamptz NOT NULL,
+    PRIMARY KEY (river_client_id, name),
+    CONSTRAINT name_length CHECK (char_length(name) > 0 AND char_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)
+);

data/migration/postgresql/main/006_bulk_unique.down.sql

@@ -0,0 +1,16 @@
+
+--
+-- Drop `river_job.unique_states` and its index.
+--
+
+DROP INDEX /* TEMPLATE: schema */river_job_unique_idx;
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    DROP COLUMN unique_states;
+
+CREATE UNIQUE INDEX IF NOT EXISTS river_job_kind_unique_key_idx ON /* TEMPLATE: schema */river_job (kind, unique_key) WHERE unique_key IS NOT NULL;
+
+--
+-- Drop `river_job_state_in_bitmask` function.
+--
+DROP FUNCTION /* TEMPLATE: schema */river_job_state_in_bitmask;

data/migration/postgresql/main/006_bulk_unique.up.sql

@@ -0,0 +1,40 @@
+CREATE OR REPLACE FUNCTION /* TEMPLATE: schema */river_job_state_in_bitmask(bitmask BIT(8), state /* TEMPLATE: schema */river_job_state)
+RETURNS boolean
+LANGUAGE SQL
+IMMUTABLE
+AS $$
+    SELECT CASE state
+        WHEN 'available' THEN get_bit(bitmask, 7)
+        WHEN 'cancelled' THEN get_bit(bitmask, 6)
+        WHEN 'completed' THEN get_bit(bitmask, 5)
+        WHEN 'discarded' THEN get_bit(bitmask, 4)
+        WHEN 'pending'   THEN get_bit(bitmask, 3)
+        WHEN 'retryable' THEN get_bit(bitmask, 2)
+        WHEN 'running'   THEN get_bit(bitmask, 1)
+        WHEN 'scheduled' THEN get_bit(bitmask, 0)
+        ELSE 0
+    END = 1;
+$$;
+
+--
+-- Add `river_job.unique_states` and bring up an index on it.
+--
+-- This column may exist already if users manually created the column and index
+-- as instructed in the changelog so the index could be created `CONCURRENTLY`.
+--
+ALTER TABLE /* TEMPLATE: schema */river_job ADD COLUMN IF NOT EXISTS unique_states BIT(8);
+
+-- This statement uses `IF NOT EXISTS` to allow users with a `river_job` table
+-- of non-trivial size to build the index `CONCURRENTLY` out of band of this
+-- migration, then follow by completing the migration.
+CREATE UNIQUE INDEX IF NOT EXISTS river_job_unique_idx ON /* TEMPLATE: schema */river_job (unique_key)
+    WHERE unique_key IS NOT NULL
+      AND unique_states IS NOT NULL
+      AND /* TEMPLATE: schema */river_job_state_in_bitmask(unique_states, state);
+
+-- Remove the old unique index. Users who are actively using the unique jobs
+-- feature and who wish to avoid deploy downtime may want od drop this in a
+-- subsequent migration once all jobs using the old unique system have been
+-- completed (i.e. no more rows with non-null unique_key and null
+-- unique_states).
+DROP INDEX /* TEMPLATE: schema */river_job_kind_unique_key_idx;

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

@@ -0,0 +1,56 @@
+--
+-- SQL cleanup rollback.
+--
+
+--
+-- Add back unused tables `river_client` and `river_client_queue`.
+--
+
+CREATE UNLOGGED TABLE /* TEMPLATE: schema */river_client (
+    id text PRIMARY KEY NOT NULL,
+    created_at timestamptz NOT NULL DEFAULT now(),
+    metadata jsonb NOT NULL DEFAULT '{}',
+    paused_at timestamptz,
+    updated_at timestamptz NOT NULL,
+    CONSTRAINT name_length CHECK (char_length(id) > 0 AND char_length(id) < 128)
+);
+
+CREATE UNLOGGED TABLE /* TEMPLATE: schema */river_client_queue (
+    river_client_id text NOT NULL REFERENCES /* TEMPLATE: schema */river_client (id) ON DELETE CASCADE,
+    name text NOT NULL,
+    created_at timestamptz NOT NULL DEFAULT now(),
+    max_workers bigint NOT NULL DEFAULT 0,
+    metadata jsonb NOT NULL DEFAULT '{}',
+    num_jobs_completed bigint NOT NULL DEFAULT 0,
+    num_jobs_running bigint NOT NULL DEFAULT 0,
+    updated_at timestamptz NOT NULL,
+    PRIMARY KEY (river_client_id, name),
+    CONSTRAINT name_length CHECK (char_length(name) > 0 AND char_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)
+);
+
+--
+-- Revert addition of `DEFAULT 25` to `river_job.max_attempts`.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    ALTER COLUMN max_attempts DROP DEFAULT;
+
+--
+-- Changes `river_queue.updated_at` to revert the default of `CURRENT_TIMESTAMP`.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_queue
+    ALTER COLUMN updated_at DROP DEFAULT;
+
+--
+-- SQLite JSONB conversion rollback.
+--
+-- No-op. PostgreSQL already stores River JSON columns as jsonb.
+
+--
+-- Notification outbox rollback.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_notification;

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

@@ -0,0 +1,44 @@
+--
+-- Notification outbox.
+--
+
+CREATE TABLE /* TEMPLATE: schema */river_notification (
+    id bigserial PRIMARY KEY,
+    created_at timestamptz NOT NULL DEFAULT now(),
+    payload text NOT NULL,
+    topic text NOT NULL,
+    CONSTRAINT topic_length CHECK (length(topic) > 0 AND length(topic) < 128)
+);
+
+CREATE INDEX river_notification_created_at_idx ON /* TEMPLATE: schema */river_notification (created_at);
+CREATE INDEX river_notification_topic_id_idx ON /* TEMPLATE: schema */river_notification (topic, id);
+
+--
+-- SQLite JSONB conversion.
+--
+-- No-op. PostgreSQL already stores River JSON columns as jsonb.
+
+--
+-- 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`.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_job
+    ALTER COLUMN max_attempts SET DEFAULT 25;
+
+--
+-- Changes `river_queue.updated_at` to have a default of `CURRENT_TIMESTAMP`.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_queue
+    ALTER COLUMN updated_at SET DEFAULT CURRENT_TIMESTAMP;

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

@@ -0,0 +1,3 @@
+-- No-op. PostgreSQL sequences already prevent automatically generated job IDs
+-- from being reused.
+SELECT 1;

data/migration/postgresql/main/008_job_id_autoincrement.up.sql

@@ -0,0 +1,3 @@
+-- No-op. PostgreSQL sequences already prevent automatically generated job IDs
+-- from being reused.
+SELECT 1;

data/migration/sqlite/main/001_create_river_migration.down.sql

@@ -0,0 +1 @@
+DROP TABLE /* TEMPLATE: schema */river_migration;

data/migration/sqlite/main/001_create_river_migration.up.sql

@@ -0,0 +1,8 @@
+CREATE TABLE /* TEMPLATE: schema */river_migration (
+    id integer PRIMARY KEY,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    version integer NOT NULL,
+    CONSTRAINT version CHECK (version >= 1)
+);
+
+CREATE UNIQUE INDEX /* TEMPLATE: schema */river_migration_version_idx ON river_migration (version);

data/migration/sqlite/main/002_initial_schema.down.sql

@@ -0,0 +1,8 @@
+--
+-- Normally `river_job` and `river_job_notify()` are dropped here, but since
+-- SQLite was added well after 002 came about, we push that to version 006 index.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_job;
+
+DROP TABLE /* TEMPLATE: schema */river_leader;

data/migration/sqlite/main/002_initial_schema.up.sql

@@ -0,0 +1,19 @@
+--
+-- Normally `river_job` and `river_job_notify()` are raised here, but since
+-- SQLite was added well after 002 came about, we push that to version 006 index.
+--
+
+-- Dummy `river_job` table so that there's something to truncate in tests when
+-- migrated to this version specifically.
+CREATE TABLE /* TEMPLATE: schema */river_job (
+    id integer PRIMARY KEY
+);
+
+CREATE TABLE /* TEMPLATE: schema */river_leader (
+    elected_at timestamp NOT NULL,
+    expires_at timestamp NOT NULL,
+    leader_id text NOT NULL,
+    name text PRIMARY KEY NOT NULL,
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT leader_id_length CHECK (length(leader_id) > 0 AND length(leader_id) < 128)
+);

data/migration/sqlite/main/003_river_job_tags_non_null.down.sql

@@ -0,0 +1,6 @@
+--
+-- Normally `river_job.tags` is set back to nullable here, but since SQLite was
+-- added well after 003 came about, we push that to version 006 index.
+--
+
+SELECT 1;

data/migration/sqlite/main/003_river_job_tags_non_null.up.sql

@@ -0,0 +1,6 @@
+--
+-- Normally `river_job.tags` is set to `NOT NULL` with a `DEFAULT` here, but since
+-- SQLite was added well after 003 came about, we push that to version 006 index.
+--
+
+SELECT 1;

data/migration/sqlite/main/004_pending_and_more.down.sql

@@ -0,0 +1,26 @@
+--
+-- Normally, args and metadata both become `NOT NULL`, `pending` is added, and
+-- the constraint `finalized_at` is changed, but because SQLite was added later,
+-- we've just pushed all of this to an initial `river_job` creation in 006.
+--
+
+--
+-- Drop `river_queue`.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_queue;
+
+--
+-- Reverse changes to `river_leader`.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_leader;
+
+CREATE TABLE /* TEMPLATE: schema */river_leader (
+    elected_at timestamp NOT NULL,
+    expires_at timestamp NOT NULL,
+    leader_id text NOT NULL,
+    name text PRIMARY KEY NOT NULL,
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT leader_id_length CHECK (length(leader_id) > 0 AND length(leader_id) < 128)
+);

data/migration/sqlite/main/004_pending_and_more.up.sql

@@ -0,0 +1,33 @@
+--
+-- Normally, args and metadata both become `NOT NULL`, `pending` is added, and
+-- the constraint `finalized_at` is changed, but because SQLite was added later,
+-- we've just pushed all of this to an initial `river_job` creation in 006.
+--
+
+--
+-- Create table `river_queue`.
+--
+
+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
+);
+
+--
+-- Alter `river_leader` to add a default value of 'default` to `name`. SQLite
+-- doesn't allow schema modifications, so this redefines the table entirely.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_leader;
+
+CREATE TABLE /* TEMPLATE: schema */river_leader (
+    elected_at timestamp NOT NULL,
+    expires_at timestamp NOT NULL,
+    leader_id text NOT NULL,
+    name text PRIMARY KEY NOT NULL DEFAULT 'default' CHECK (name = 'default'),
+    CONSTRAINT name_length CHECK (length(name) > 0 AND length(name) < 128),
+    CONSTRAINT leader_id_length CHECK (length(leader_id) > 0 AND length(leader_id) < 128)
+);

data/migration/sqlite/main/005_migration_unique_client.down.sql

@@ -0,0 +1,37 @@
+--
+-- Revert to migration table based only on `(version)`.
+--
+-- If any non-main migrations are present, 005 is considered irreversible.
+--
+
+ALTER TABLE /* TEMPLATE: schema */river_migration
+    RENAME TO river_migration_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_migration (
+    id integer PRIMARY KEY,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    version integer NOT NULL,
+    CONSTRAINT version CHECK (version >= 1)
+);
+
+CREATE UNIQUE INDEX /* TEMPLATE: schema */river_migration_version_idx ON river_migration (version);
+
+INSERT INTO /* TEMPLATE: schema */river_migration
+    (created_at, version)
+SELECT created_at, version
+FROM /* TEMPLATE: schema */river_migration_old;
+
+DROP TABLE /* TEMPLATE: schema */river_migration_old;
+
+--
+-- Normally, `unique_key` and an index are added here, but because SQLite was
+-- added later, we've just pushed all of this to an initial `river_job` creation
+-- in 006.
+--
+
+--
+-- Drop `river_client` and derivative.
+--
+
+DROP TABLE /* TEMPLATE: schema */river_client_queue;
+DROP TABLE /* TEMPLATE: schema */river_client;

data/migration/sqlite/main/005_migration_unique_client.up.sql

@@ -0,0 +1,64 @@
+--
+-- Rebuild the migration table so it's based on `(line, version)`.
+--
+
+DROP INDEX /* TEMPLATE: schema */river_migration_version_idx;
+
+ALTER TABLE /* TEMPLATE: schema */river_migration
+    RENAME TO river_migration_old;
+
+CREATE TABLE /* TEMPLATE: schema */river_migration (
+    line text NOT NULL,
+    version integer NOT NULL,
+    created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT line_length CHECK (length(line) > 0 AND length(line) < 128),
+    CONSTRAINT version_gte_1 CHECK (version >= 1),
+    PRIMARY KEY (line, version)
+);
+
+INSERT INTO /* TEMPLATE: schema */river_migration
+    (created_at, line, version)
+SELECT created_at, 'main', version
+FROM /* TEMPLATE: schema */river_migration_old;
+
+DROP TABLE /* TEMPLATE: schema */river_migration_old;
+
+--
+-- Normally, `unique_key` and an index are added here, but because SQLite was
+-- added later, we've just pushed all of this to an initial `river_job` creation
+-- in 006.
+--
+
+--
+-- Create `river_client` and derivative.
+--
+-- This feature hasn't quite yet been implemented, but we're taking advantage of
+-- the migration to add the schema early so that we can add it later without an
+-- additional migration.
+--
+
+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)
+);
+
+-- Differs from `river_queue` in that it tracks the queue state for a particular
+-- active client.
+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)
+);

data/migration/sqlite/main/006_bulk_unique.down.sql

@@ -0,0 +1,7 @@
+DROP TABLE /* TEMPLATE: schema */river_job;
+
+-- Dummy `river_job` table so that there's something to truncate in tests when
+-- migrated to this version specifically.
+CREATE TABLE /* TEMPLATE: schema */river_job (
+    id integer PRIMARY KEY
+);

data/migration/sqlite/main/006_bulk_unique.up.sql

@@ -0,0 +1,63 @@
+-- Only drops the trivial `river_job` we created in 002 which puts a placeholder
+-- in place so that the right tables exist in the right versions. We don't
+-- bother migrating any job data because it's not possible to have had any real
+-- jobs by that point because this version (006) preexists the addition of SQLite.
+DROP TABLE /* TEMPLATE: schema */river_job;
+
+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'))
+);
+
+-- All these indexes are normally brought up in version 002.
+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);
+
+-- Not raised because SQLite doesn't support Gin indexes. These aren't used in
+-- River anyway.
+-- CREATE INDEX river_job_args_index ON /* TEMPLATE: schema */river_job USING GIN(args);
+-- CREATE INDEX river_job_metadata_index ON /* TEMPLATE: schema */river_job USING GIN(metadata);
+
+-- SQLite doesn't support SQL functions, so where the bit extraction logic below
+-- goes in the `river_job_state_in_bitmask` function in Postgres, here it's
+-- baked right into the index. Use of helpers that don't exist in SQLite like
+-- `get_bit` are also dropped by necessity.
+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;