envvar

Fetch the value of an environment variable

Overview

PackageVersionCategoryLicenseLanguage
pg_envvar1.0.1UTILPostgreSQLC
IDExtensionBinLibLoadCreateTrustRelocSchema
4270envvarNoYesNoYesNoNo-
Relatedsession_variable gzip bzip zstd http pg_net pg_curl pgjq

Version

TypeRepoVersionPG VerPackageDeps
EXTPIGSTY1.0.11817161514pg_envvar-
RPMPIGSTY1.0.11817161514pg_envvar_$v-
DEBPIGSTY1.0.11817161514postgresql-$v-pg-envvar-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
d13.x86_64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
d13.aarch64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
u22.x86_64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
u22.aarch64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
u24.x86_64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
u24.aarch64
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1
PIGSTY 1.0.1

Build

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

pig build pkg pg_envvar         # build RPM / DEB packages

Install

You can install pg_envvar 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:

pig install pg_envvar;          # Install for current active PG version
pig ext install -y pg_envvar -v 18  # PG 18
pig ext install -y pg_envvar -v 17  # PG 17
pig ext install -y pg_envvar -v 16  # PG 16
pig ext install -y pg_envvar -v 15  # PG 15
pig ext install -y pg_envvar -v 14  # PG 14
dnf install -y pg_envvar_18       # PG 18
dnf install -y pg_envvar_17       # PG 17
dnf install -y pg_envvar_16       # PG 16
dnf install -y pg_envvar_15       # PG 15
dnf install -y pg_envvar_14       # PG 14
apt install -y postgresql-18-pg-envvar   # PG 18
apt install -y postgresql-17-pg-envvar   # PG 17
apt install -y postgresql-16-pg-envvar   # PG 16
apt install -y postgresql-15-pg-envvar   # PG 15
apt install -y postgresql-14-pg-envvar   # PG 14

Create Extension:

CREATE EXTENSION envvar;

Usage

envvar: Access environment variables from PostgreSQL

Provides a single function to read environment variables from the database server.

Function

get_env(name TEXT) RETURNS TEXT

Returns the value of the specified environment variable set on the database server, or NULL if not set.

Examples

SELECT get_env('PGTZ');
-- UTC

SELECT get_env('HOME');
-- /var/lib/postgresql

SELECT get_env('PATH');
-- /usr/local/sbin:/usr/local/bin:...

SELECT get_env('NONEXISTENT');
-- NULL

Schema Support

You can install the extension into a specific schema:

CREATE SCHEMA env;
CREATE EXTENSION envvar SCHEMA env;

SELECT env.get_env('PGTZ');

Last Modified 2026-03-12: add pg extension catalog (95749bf)