permuteseq

Pseudo-randomly permute sequences with a format-preserving encryption on elements

Overview

Package	Version	Category	License	Language
`permuteseq`	`1.2.2`	FUNC	PostgreSQL	C

ID	Extension	Bin	Lib	Load	Create	Trust	Reloc	Schema
4540	`permuteseq`	No	Yes	No	Yes	No	Yes	-

Related	`sequential_uuids` `pg_uuidv7` `snowflake` `pg_idkit` `pgx_ulid` `uuid-ossp` `pg_uuid_v8` `typeid`

Version

Type	Repo	Version	PG Ver	Package	Deps
EXT	PIGSTY	`1.2.2`	1817161514	`permuteseq`	-
RPM	PIGSTY	`1.2.2`	1817161514	`permuteseq_$v`	-
DEB	PIGSTY	`1.2.2`	1817161514	`postgresql-$v-permuteseq`	-

OS / PG	PG18	PG17	PG16	PG15	PG14
el8.x86_64	PIGSTY 1.2.2 el8.x86_64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el8.x86_64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el8.x86_64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el8.x86_64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.2.2 · 13.0KiB	PIGSTY 1.2.2 el8.x86_64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el8.x86_64.rpm PIGSTY · 1.2.2 · 13.0KiB
el8.aarch64	PIGSTY 1.2.2 el8.aarch64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.2.2 · 13.4KiB	PIGSTY 1.2.2 el8.aarch64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.2.2 · 13.4KiB	PIGSTY 1.2.2 el8.aarch64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.2.2 · 13.4KiB	PIGSTY 1.2.2 el8.aarch64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el8.aarch64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el8.aarch64.rpm PIGSTY · 1.2.2 · 13.2KiB
el9.x86_64	PIGSTY 1.2.2 el9.x86_64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.x86_64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.x86_64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.x86_64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.2.2 · 12.8KiB	PIGSTY 1.2.2 el9.x86_64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el9.x86_64.rpm PIGSTY · 1.2.2 · 12.8KiB
el9.aarch64	PIGSTY 1.2.2 el9.aarch64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.aarch64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.aarch64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el9.aarch64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.2.2 · 12.8KiB	PIGSTY 1.2.2 el9.aarch64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el9.aarch64.rpm PIGSTY · 1.2.2 · 12.8KiB
el10.x86_64	PIGSTY 1.2.2 el10.x86_64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.2.2 · 13.1KiB	PIGSTY 1.2.2 el10.x86_64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el10.x86_64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.2.2 · 13.2KiB	PIGSTY 1.2.2 el10.x86_64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.2.2 · 12.8KiB	PIGSTY 1.2.2 el10.x86_64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el10.x86_64.rpm PIGSTY · 1.2.2 · 12.8KiB
el10.aarch64	PIGSTY 1.2.2 el10.aarch64.pg18 : permuteseq_18 permuteseq_18-1.2.2-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.2.2 · 13.3KiB	PIGSTY 1.2.2 el10.aarch64.pg17 : permuteseq_17 permuteseq_17-1.2.2-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.2.2 · 13.3KiB	PIGSTY 1.2.2 el10.aarch64.pg16 : permuteseq_16 permuteseq_16-1.2.2-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.2.2 · 13.3KiB	PIGSTY 1.2.2 el10.aarch64.pg15 : permuteseq_15 permuteseq_15-1.2.2-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.2.2 · 13.0KiB	PIGSTY 1.2.2 el10.aarch64.pg14 : permuteseq_14 permuteseq_14-1.2.2-1PIGSTY.el10.aarch64.rpm PIGSTY · 1.2.2 · 13.0KiB
d12.x86_64	PIGSTY 1.2.2 d12.x86_64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d12.x86_64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d12.x86_64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d12.x86_64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.2.2 · 14.5KiB	PIGSTY 1.2.2 d12.x86_64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~bookworm_amd64.deb PIGSTY · 1.2.2 · 14.5KiB
d12.aarch64	PIGSTY 1.2.2 d12.aarch64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d12.aarch64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d12.aarch64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d12.aarch64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.2.2 · 14.4KiB	PIGSTY 1.2.2 d12.aarch64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~bookworm_arm64.deb PIGSTY · 1.2.2 · 14.4KiB
d13.x86_64	PIGSTY 1.2.2 d13.x86_64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~trixie_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d13.x86_64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~trixie_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d13.x86_64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~trixie_amd64.deb PIGSTY · 1.2.2 · 15.4KiB	PIGSTY 1.2.2 d13.x86_64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~trixie_amd64.deb PIGSTY · 1.2.2 · 14.5KiB	PIGSTY 1.2.2 d13.x86_64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~trixie_amd64.deb PIGSTY · 1.2.2 · 14.5KiB
d13.aarch64	PIGSTY 1.2.2 d13.aarch64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~trixie_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d13.aarch64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~trixie_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d13.aarch64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~trixie_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 d13.aarch64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~trixie_arm64.deb PIGSTY · 1.2.2 · 14.5KiB	PIGSTY 1.2.2 d13.aarch64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~trixie_arm64.deb PIGSTY · 1.2.2 · 14.4KiB
u22.x86_64	PIGSTY 1.2.2 u22.x86_64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~jammy_amd64.deb PIGSTY · 1.2.2 · 15.8KiB	PIGSTY 1.2.2 u22.x86_64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~jammy_amd64.deb PIGSTY · 1.2.2 · 16.3KiB	PIGSTY 1.2.2 u22.x86_64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~jammy_amd64.deb PIGSTY · 1.2.2 · 16.3KiB	PIGSTY 1.2.2 u22.x86_64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~jammy_amd64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 u22.x86_64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~jammy_amd64.deb PIGSTY · 1.2.2 · 15.1KiB
u22.aarch64	PIGSTY 1.2.2 u22.aarch64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~jammy_arm64.deb PIGSTY · 1.2.2 · 15.6KiB	PIGSTY 1.2.2 u22.aarch64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~jammy_arm64.deb PIGSTY · 1.2.2 · 16.1KiB	PIGSTY 1.2.2 u22.aarch64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~jammy_arm64.deb PIGSTY · 1.2.2 · 16.1KiB	PIGSTY 1.2.2 u22.aarch64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~jammy_arm64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 u22.aarch64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~jammy_arm64.deb PIGSTY · 1.2.2 · 15.1KiB
u24.x86_64	PIGSTY 1.2.2 u24.x86_64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~noble_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u24.x86_64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~noble_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u24.x86_64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~noble_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u24.x86_64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~noble_amd64.deb PIGSTY · 1.2.2 · 15.0KiB	PIGSTY 1.2.2 u24.x86_64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~noble_amd64.deb PIGSTY · 1.2.2 · 15.0KiB
u24.aarch64	PIGSTY 1.2.2 u24.aarch64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~noble_arm64.deb PIGSTY · 1.2.2 · 15.6KiB	PIGSTY 1.2.2 u24.aarch64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~noble_arm64.deb PIGSTY · 1.2.2 · 15.6KiB	PIGSTY 1.2.2 u24.aarch64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~noble_arm64.deb PIGSTY · 1.2.2 · 15.6KiB	PIGSTY 1.2.2 u24.aarch64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~noble_arm64.deb PIGSTY · 1.2.2 · 14.8KiB	PIGSTY 1.2.2 u24.aarch64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~noble_arm64.deb PIGSTY · 1.2.2 · 14.8KiB
u26.x86_64	PIGSTY 1.2.2 u26.x86_64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~resolute_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.x86_64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~resolute_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.x86_64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~resolute_amd64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.x86_64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~resolute_amd64.deb PIGSTY · 1.2.2 · 15.2KiB	PIGSTY 1.2.2 u26.x86_64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~resolute_amd64.deb PIGSTY · 1.2.2 · 15.1KiB
u26.aarch64	PIGSTY 1.2.2 u26.aarch64.pg18 : postgresql-18-permuteseq postgresql-18-permuteseq_1.2.2-1PIGSTY~resolute_arm64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.aarch64.pg17 : postgresql-17-permuteseq postgresql-17-permuteseq_1.2.2-1PIGSTY~resolute_arm64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.aarch64.pg16 : postgresql-16-permuteseq postgresql-16-permuteseq_1.2.2-1PIGSTY~resolute_arm64.deb PIGSTY · 1.2.2 · 15.9KiB	PIGSTY 1.2.2 u26.aarch64.pg15 : postgresql-15-permuteseq postgresql-15-permuteseq_1.2.2-1PIGSTY~resolute_arm64.deb PIGSTY · 1.2.2 · 15.1KiB	PIGSTY 1.2.2 u26.aarch64.pg14 : postgresql-14-permuteseq postgresql-14-permuteseq_1.2.2-1PIGSTY~resolute_arm64.deb PIGSTY · 1.2.2 · 15.1KiB

Build

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

pig build pkg permuteseq         # build RPM / DEB packages

Install

You can install permuteseq 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 install permuteseq;          # Install for current active PG version

pig

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

dnf

dnf install -y permuteseq_18       # PG 18
dnf install -y permuteseq_17       # PG 17
dnf install -y permuteseq_16       # PG 16
dnf install -y permuteseq_15       # PG 15
dnf install -y permuteseq_14       # PG 14

apt

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

Create Extension:

CREATE EXTENSION permuteseq;

Usage

permuteseq: scalable pseudo-random permutations of sequences

Generate unique, non-sequential, random-looking series of numbers without storing previous values. Uses a Feistel cipher with cycle-walking for format-preserving encryption.

CREATE EXTENSION permuteseq;

Functions

Function	Description
`permute_nextval(seq_oid, crypt_key bigint)`	Advance sequence and return encrypted value within sequence bounds
`reverse_permute(seq_oid, value bigint, crypt_key bigint)`	Compute original value from its permuted element
`range_encrypt_element(clear_val bigint, min_val bigint, max_val bigint, crypt_key bigint)`	Encrypt a bigint in a given range
`range_decrypt_element(crypt_val bigint, min_val bigint, max_val bigint, crypt_key bigint)`	Decrypt a previously encrypted value

Examples

CREATE SEQUENCE s MINVALUE -10000 MAXVALUE 15000;

-- Generate random-looking unique values from a sequence
SELECT permute_nextval('s'::regclass, 123456789012345)
  FROM generate_series(1, 10);

-- Reverse a permuted value back to the original
SELECT reverse_permute('s'::regclass, -545, 123456789012345);
-- -10000

-- Encrypt/decrypt within an arbitrary range
SELECT range_encrypt_element(91919191919, 1e10::bigint, 1e11::bigint, 123456789012345);
-- 83028080992

SELECT range_decrypt_element(83028080992, 1e10::bigint, 1e11::bigint, 123456789012345);
-- 91919191919

permuteseq

Overview

Version

Build

Install

Usage

Functions

Examples

Was this page helpful?