pgsql_tweaks

Overview

Version

Build

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

pig build pkg pgsql_tweaks         # build RPM / DEB packages

Install

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

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

dnf install -y pgsql_tweaks_18       # PG 18
dnf install -y pgsql_tweaks_17       # PG 17
dnf install -y pgsql_tweaks_16       # PG 16
dnf install -y pgsql_tweaks_15       # PG 15
dnf install -y pgsql_tweaks_14       # PG 14

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

Create Extension:

CREATE EXTENSION pgsql_tweaks;

Usage

Sources: Codeberg README, documentation site, Codeberg tags.

pgsql_tweaks provides DBA-oriented helper functions and views in the pgsql_tweaks schema. The upstream test matrix covers PostgreSQL 14 through PostgreSQL 19 beta 1; Pigsty packages it for PostgreSQL 14-18.

Data Type Check Functions

SELECT pgsql_tweaks.is_date('2024-01-15');
SELECT pgsql_tweaks.is_time('10:30:00');
SELECT pgsql_tweaks.is_timestamp('2024-01-15 10:30:00');
SELECT pgsql_tweaks.is_real('3.14');
SELECT pgsql_tweaks.is_double_precision('3.14');
SELECT pgsql_tweaks.is_numeric('3.14');
SELECT pgsql_tweaks.is_bigint('9223372036854775807');
SELECT pgsql_tweaks.is_integer('42');
SELECT pgsql_tweaks.is_smallint('42');
SELECT pgsql_tweaks.is_boolean('true');
SELECT pgsql_tweaks.is_json('{"a":1}');
SELECT pgsql_tweaks.is_jsonb('{"a":1}');
SELECT pgsql_tweaks.is_hex('FF');

System Information Functions

SELECT pgsql_tweaks.pg_schema_size('public');
SELECT * FROM pgsql_tweaks.role_inheritance();

Encoding Functions

SELECT pgsql_tweaks.is_encoding('UTF8');
SELECT pgsql_tweaks.is_latin1('abc');
SELECT pgsql_tweaks.return_not_part_of_latin1('abc');
SELECT pgsql_tweaks.replace_latin1('abc', '?');
SELECT pgsql_tweaks.return_not_part_of_encoding('abc', 'UTF8');
SELECT pgsql_tweaks.replace_encoding('abc', 'UTF8', '?');

Aggregate Functions

• gap_fill, for filling gaps in time series.
• array_min, array_max, array_avg, and array_sum.

Format And Conversion Functions

SELECT pgsql_tweaks.date_de(current_date);
SELECT pgsql_tweaks.datetime_de(now());
SELECT pgsql_tweaks.to_unix_timestamp(now());
SELECT pgsql_tweaks.hex2bigint('FF');

Utility Functions

SELECT pgsql_tweaks.is_empty('');
SELECT pgsql_tweaks.array_trim(ARRAY['a', '', 'b']);
SELECT pgsql_tweaks.get_markdown_doku_by_schema('pgsql_tweaks');

System Information Views

• pg_db_views, pg_foreign_keys, pg_functions, pg_active_locks.
• pg_table_matview_infos, pg_object_ownership, pg_partitioned_tables_infos.
• pg_unused_indexes, pg_bloat_info, pg_table_bloat, pg_missing_indexes.
• pg_role_permissions, pg_role_infos.

Statistic And Monitoring Views

• statistics_top_ten_query_times, top_ten_query_average_time_in_seconds.
• statistics_top_ten_time_consuming_queries, statistics_top_ten_memory_usage_queries.
• statistics_top_ten_called_queries, statistics_top_ten_rows_returned_queries.
• statistics_top_ten_shared_block_hits_queries, statistics_top_ten_wal_records_generated_queries.
• statistics_query_activity.
• monitoring_wal, wal_archiving, monitoring_active_locks, monitoring_replication.
• monitoring_database_conflicts, monitoring_blocked_and_blocking_activity.
• monitoring_follower_wal_status, monitoring_vacuum.

Caveats

• Some views/functions depend on additional PostgreSQL supplied modules; upstream lists pg_stat_statements and pgstattuple.
• The Codeberg tag for v1.0.3 says release files were added; no material user-facing function or view delta was identified from the README and tag metadata.