omni_session

Overview

Version

Build

You can build the RPM / DEB packages for omnigres using pig build:

pig build pkg omnigres         # build RPM / DEB packages

Install

You can install omnigres directly. First, make sure the PGDG and PIGSTY repositories are added and enabled:

pig repo add pgsql -u          # Add repo and update cache

Install the extension using pig or apt/yum/dnf:

• Install
• pig
• dnf
• apt

pig install omnigres;          # Install for current active PG version

pig ext install -y omnigres -v 18  # PG 18
pig ext install -y omnigres -v 17  # PG 17
pig ext install -y omnigres -v 16  # PG 16
pig ext install -y omnigres -v 15  # PG 15
pig ext install -y omnigres -v 14  # PG 14

dnf install -y omnigres_18       # PG 18
dnf install -y omnigres_17       # PG 17
dnf install -y omnigres_16       # PG 16
dnf install -y omnigres_15       # PG 15
dnf install -y omnigres_14       # PG 14

apt install -y postgresql-18-omnigres   # PG 18
apt install -y postgresql-17-omnigres   # PG 17
apt install -y postgresql-16-omnigres   # PG 16
apt install -y postgresql-15-omnigres   # PG 15
apt install -y postgresql-14-omnigres   # PG 14

Create Extension:

CREATE EXTENSION omni_session CASCADE;  -- requires: omni_var, omni_id, omni_web, omni_httpd, omni_polyfill

Usage

omni_session: Session management

The omni_session extension provides standardized session management, creating an unlogged omni_session.sessions table for active sessions. Works primarily with the HTTP stack.

Session Handler for HTTP

Request handler – Extracts session UUID from a _session cookie:

SELECT omni_session.session_handler(request);
-- Optional: session_handler(request, cookie_name => 'my_session')

Creates a new session if the cookie is missing or invalid, sets the omni_session.session transaction variable.

Response handler – Sets the session cookie on the response:

SELECT omni_session.session_handler(response);

Cookie parameters:

Direct Session ID Handling

-- Create or validate a session:
SELECT omni_session.session_handler(null::omni_session.session_id);
-- Returns new session ID and sets omni_session.session transaction variable