pldebugger
pldebugger
pldebugger is a PostgreSQL extension that provides a server-side debugger for PL/pgSQL functions and procedures. It enables step-by-step debugging, breakpoints, and variable inspection for stored procedures, and is supported by tools such as pgAdmin.
Follow the quick start to set up extension-update email
alerts first, then use the CronJob to install and refresh the catalog. These
examples inherit image references and runtime settings from the catalog. The Cluster YAML
is an excerpt: replace imageCatalogRef: ... with your catalog reference and
keep your existing instance and storage settings.
Usage
1. Add the pldebugger extension image to your Cluster
Define the pldebugger extension under the postgresql.extensions section of
your Cluster resource. Note that plugin_debugger must be added to
shared_preload_libraries. For example:
apiVersion: postgresql.cnpg.io/v1
kind: Cluster
metadata:
name: cluster-pldebugger
spec:
imageCatalogRef: ...
postgresql:
shared_preload_libraries:
- plugin_debugger
extensions:
- name: pldebugger
2. Enable the extension in a database
Once the extension's files are available in the cluster, you can install it in a database in either of two ways:
- Declaratively, using a CloudNativePG
Databaseresource. - Through SQL, by running
CREATE EXTENSION pldbgapi;in the target database.
Platform teams may make extension containers available across their clusters without installing every extension in every database. Install only the extensions a database uses; letting users enable them through SQL alongside the rest of their DDL schema management code can be a convenient approach.
For extensions that normally require superuser privileges, platform teams can use pgextwlist to allow non-superusers to install an administrator-approved selection of extensions.
3. Verify installation
Once the database is ready, connect to it with psql and run:
\dx
You should see pldbgapi listed among the installed extensions.
Known Caveats
shared_preload_librariesrequired: Theplugin_debuggershared library must be listed inshared_preload_libraries. Without it,CREATE EXTENSION pldbgapiwill fail.- SQL extension name differs from image name: The extension image is named
pldebuggerbut the PostgreSQL extension object ispldbgapi. UseCREATE EXTENSION pldbgapi(notpldebugger). - License:
pldebuggeris Artistic-2.0, which is why it is hosted in the CNPG Extensions project rather than upstream.
Licenses and Copyright
This container image contains software that may be licensed under various open-source licenses.
All relevant license and copyright information for the pldebugger extension
and its dependencies are bundled within the image at:
/licenses/
By using this image, you agree to comply with the terms of the licenses contained therein.
Overview
pldebugger is a PostgreSQL extension that provides a server-side debugger for PL/pgSQL functions and procedures. It enables step-by-step debugging, breakpoints, and variable inspection for stored procedures, and is supported by tools such as pgAdmin.
Package details
- Extension version
- 1-1.10
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Trixie · amd64
Project links
- Debian source package ↗tracker.debian.org/pkg/pldebugger
- Upstream homepage ↗git.postgresql.org/gitweb/?p=pldebugger.git
- Source repository ↗github.com/EnterpriseDB/pldebugger
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION pldbgapi;- SQL version
1.1— differs from extension version 1-1.10
PostgreSQL parameters
| Parameter | Value |
|---|---|
shared_preload_libraries | 'plugin_debugger' |
These recipe settings are used in automated smoke tests.
OpenSSF scorecard
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software.
View information about checks. Automated results are informational only; some categories may not apply to this project.
Scanned · View OpenSSF report ↗
Dangerous-WorkflowUnknown
Determines if the project's GitHub Action workflows avoid dangerous patterns.
Reasoning: no workflows found
Binary-Artifacts10
Determines if the project has generated executable (binary) artifacts in the source repository.
Reasoning: no binaries found in the repo
Branch-Protection0
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: branch protection not enabled on development/release branches
- Warn: branch protection not enabled for branch 'master'
Code-Review0
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: Found 2/24 approved changesets -- score normalized to 0
Maintained1
Determines if the project is "actively maintained".
Reasoning: 2 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 1
Token-PermissionsUnknown
Determines if the project's workflows follow the principle of least privilege.
Reasoning: No tokens found
Fuzzing0
Determines if the project uses fuzzing.
Reasoning: project is not fuzzed
- Warn: no fuzzer integrations found
Pinned-DependenciesUnknown
Determines if the project has declared and pinned the dependencies of its build process.
Reasoning: no dependencies found
SAST0
Determines if the project uses static code analysis.
Reasoning: SAST tool is not run on all commits -- score normalized to 0
- Warn: 0 commits out of 8 are checked with a SAST tool
Security-Policy0
Determines if the project has published a security policy.
Reasoning: security policy file not detected
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
CII-Best-Practices0
Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.
Reasoning: no effort to earn an OpenSSF best practices badge detected
License0
Determines if the project has defined a license.
Reasoning: license file not detected
- Warn: project does not have a license file
Overview
pldebugger is a PostgreSQL extension that provides a server-side debugger for PL/pgSQL functions and procedures. It enables step-by-step debugging, breakpoints, and variable inspection for stored procedures, and is supported by tools such as pgAdmin.
Package details
- Extension version
- 1-1.10
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Trixie · arm64
Project links
- Debian source package ↗tracker.debian.org/pkg/pldebugger
- Upstream homepage ↗git.postgresql.org/gitweb/?p=pldebugger.git
- Source repository ↗github.com/EnterpriseDB/pldebugger
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION pldbgapi;- SQL version
1.1— differs from extension version 1-1.10
PostgreSQL parameters
| Parameter | Value |
|---|---|
shared_preload_libraries | 'plugin_debugger' |
These recipe settings are used in automated smoke tests.
OpenSSF scorecard
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software.
View information about checks. Automated results are informational only; some categories may not apply to this project.
Scanned · View OpenSSF report ↗
Dangerous-WorkflowUnknown
Determines if the project's GitHub Action workflows avoid dangerous patterns.
Reasoning: no workflows found
Binary-Artifacts10
Determines if the project has generated executable (binary) artifacts in the source repository.
Reasoning: no binaries found in the repo
Branch-Protection0
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: branch protection not enabled on development/release branches
- Warn: branch protection not enabled for branch 'master'
Code-Review0
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: Found 2/24 approved changesets -- score normalized to 0
Maintained1
Determines if the project is "actively maintained".
Reasoning: 2 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 1
Token-PermissionsUnknown
Determines if the project's workflows follow the principle of least privilege.
Reasoning: No tokens found
Fuzzing0
Determines if the project uses fuzzing.
Reasoning: project is not fuzzed
- Warn: no fuzzer integrations found
Pinned-DependenciesUnknown
Determines if the project has declared and pinned the dependencies of its build process.
Reasoning: no dependencies found
SAST0
Determines if the project uses static code analysis.
Reasoning: SAST tool is not run on all commits -- score normalized to 0
- Warn: 0 commits out of 8 are checked with a SAST tool
Security-Policy0
Determines if the project has published a security policy.
Reasoning: security policy file not detected
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
CII-Best-Practices0
Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.
Reasoning: no effort to earn an OpenSSF best practices badge detected
License0
Determines if the project has defined a license.
Reasoning: license file not detected
- Warn: project does not have a license file
Overview
pldebugger is a PostgreSQL extension that provides a server-side debugger for PL/pgSQL functions and procedures. It enables step-by-step debugging, breakpoints, and variable inspection for stored procedures, and is supported by tools such as pgAdmin.
Package details
- Extension version
- 1-1.10
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Bookworm · amd64
Project links
- Debian source package ↗tracker.debian.org/pkg/pldebugger
- Upstream homepage ↗git.postgresql.org/gitweb/?p=pldebugger.git
- Source repository ↗github.com/EnterpriseDB/pldebugger
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION pldbgapi;- SQL version
1.1— differs from extension version 1-1.10
PostgreSQL parameters
| Parameter | Value |
|---|---|
shared_preload_libraries | 'plugin_debugger' |
These recipe settings are used in automated smoke tests.
OpenSSF scorecard
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software.
View information about checks. Automated results are informational only; some categories may not apply to this project.
Scanned · View OpenSSF report ↗
Dangerous-WorkflowUnknown
Determines if the project's GitHub Action workflows avoid dangerous patterns.
Reasoning: no workflows found
Binary-Artifacts10
Determines if the project has generated executable (binary) artifacts in the source repository.
Reasoning: no binaries found in the repo
Branch-Protection0
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: branch protection not enabled on development/release branches
- Warn: branch protection not enabled for branch 'master'
Code-Review0
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: Found 2/24 approved changesets -- score normalized to 0
Maintained1
Determines if the project is "actively maintained".
Reasoning: 2 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 1
Token-PermissionsUnknown
Determines if the project's workflows follow the principle of least privilege.
Reasoning: No tokens found
Fuzzing0
Determines if the project uses fuzzing.
Reasoning: project is not fuzzed
- Warn: no fuzzer integrations found
Pinned-DependenciesUnknown
Determines if the project has declared and pinned the dependencies of its build process.
Reasoning: no dependencies found
SAST0
Determines if the project uses static code analysis.
Reasoning: SAST tool is not run on all commits -- score normalized to 0
- Warn: 0 commits out of 8 are checked with a SAST tool
Security-Policy0
Determines if the project has published a security policy.
Reasoning: security policy file not detected
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
CII-Best-Practices0
Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.
Reasoning: no effort to earn an OpenSSF best practices badge detected
License0
Determines if the project has defined a license.
Reasoning: license file not detected
- Warn: project does not have a license file
Overview
pldebugger is a PostgreSQL extension that provides a server-side debugger for PL/pgSQL functions and procedures. It enables step-by-step debugging, breakpoints, and variable inspection for stored procedures, and is supported by tools such as pgAdmin.
Package details
- Extension version
- 1-1.10
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Bookworm · arm64
Project links
- Debian source package ↗tracker.debian.org/pkg/pldebugger
- Upstream homepage ↗git.postgresql.org/gitweb/?p=pldebugger.git
- Source repository ↗github.com/EnterpriseDB/pldebugger
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION pldbgapi;- SQL version
1.1— differs from extension version 1-1.10
PostgreSQL parameters
| Parameter | Value |
|---|---|
shared_preload_libraries | 'plugin_debugger' |
These recipe settings are used in automated smoke tests.
OpenSSF scorecard
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software.
View information about checks. Automated results are informational only; some categories may not apply to this project.
Scanned · View OpenSSF report ↗
Dangerous-WorkflowUnknown
Determines if the project's GitHub Action workflows avoid dangerous patterns.
Reasoning: no workflows found
Binary-Artifacts10
Determines if the project has generated executable (binary) artifacts in the source repository.
Reasoning: no binaries found in the repo
Branch-Protection0
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: branch protection not enabled on development/release branches
- Warn: branch protection not enabled for branch 'master'
Code-Review0
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: Found 2/24 approved changesets -- score normalized to 0
Maintained1
Determines if the project is "actively maintained".
Reasoning: 2 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 1
Token-PermissionsUnknown
Determines if the project's workflows follow the principle of least privilege.
Reasoning: No tokens found
Fuzzing0
Determines if the project uses fuzzing.
Reasoning: project is not fuzzed
- Warn: no fuzzer integrations found
Pinned-DependenciesUnknown
Determines if the project has declared and pinned the dependencies of its build process.
Reasoning: no dependencies found
SAST0
Determines if the project uses static code analysis.
Reasoning: SAST tool is not run on all commits -- score normalized to 0
- Warn: 0 commits out of 8 are checked with a SAST tool
Security-Policy0
Determines if the project has published a security policy.
Reasoning: security policy file not detected
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
CII-Best-Practices0
Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.
Reasoning: no effort to earn an OpenSSF best practices badge detected
License0
Determines if the project has defined a license.
Reasoning: license file not detected
- Warn: project does not have a license file
Dependencies
Packages shipped in this image, including the extension itself.
1 packages · Scanned
| Package / installed version | License evidence | Advisories |
|---|---|---|
postgresql-18-pldebugger ↗ 1:1.10-1.pgdg13+2 | LicenseRef-Artistic | No ↗ |
No packages match these filters. Try a different name or license, or clear the filters.
Dependencies
Packages shipped in this image, including the extension itself.
1 packages · Scanned
| Package / installed version | License evidence | Advisories |
|---|---|---|
postgresql-18-pldebugger ↗ 1:1.10-1.pgdg13+2 | LicenseRef-Artistic | No ↗ |
No packages match these filters. Try a different name or license, or clear the filters.
Dependencies
Packages shipped in this image, including the extension itself.
1 packages · Scanned
| Package / installed version | License evidence | Advisories |
|---|---|---|
postgresql-18-pldebugger ↗ 1:1.10-1.pgdg12+2 | LicenseRef-Artistic | No ↗ |
No packages match these filters. Try a different name or license, or clear the filters.
Dependencies
Packages shipped in this image, including the extension itself.
1 packages · Scanned
| Package / installed version | License evidence | Advisories |
|---|---|---|
postgresql-18-pldebugger ↗ 1:1.10-1.pgdg12+2 | LicenseRef-Artistic | No ↗ |
No packages match these filters. Try a different name or license, or clear the filters.
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-pldebugger/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: pldebugger Source: https://git.postgresql.org/gitweb/?p=pldebugger.git Files: * Copyright: Copyright (c) 2004-2017 EnterpriseDB Corporation. All Rights Reserved. License: Artistic On Debian systems, the Artistic license is located in /usr/share/common-licenses/Artistic
SHA256: 70204d120ec2212dd64a7f07008d406a48cc6d2df7ddc1fd041a5c574fad0433
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-pldebugger/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: pldebugger Source: https://git.postgresql.org/gitweb/?p=pldebugger.git Files: * Copyright: Copyright (c) 2004-2017 EnterpriseDB Corporation. All Rights Reserved. License: Artistic On Debian systems, the Artistic license is located in /usr/share/common-licenses/Artistic
SHA256: 70204d120ec2212dd64a7f07008d406a48cc6d2df7ddc1fd041a5c574fad0433
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-pldebugger/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: pldebugger Source: https://git.postgresql.org/gitweb/?p=pldebugger.git Files: * Copyright: Copyright (c) 2004-2017 EnterpriseDB Corporation. All Rights Reserved. License: Artistic On Debian systems, the Artistic license is located in /usr/share/common-licenses/Artistic
SHA256: 70204d120ec2212dd64a7f07008d406a48cc6d2df7ddc1fd041a5c574fad0433
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-pldebugger/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: pldebugger Source: https://git.postgresql.org/gitweb/?p=pldebugger.git Files: * Copyright: Copyright (c) 2004-2017 EnterpriseDB Corporation. All Rights Reserved. License: Artistic On Debian systems, the Artistic license is located in /usr/share/common-licenses/Artistic
SHA256: 70204d120ec2212dd64a7f07008d406a48cc6d2df7ddc1fd041a5c574fad0433
Versions
Extension versions and the images built from them.
Tagged GHCR builds fetched .
