hll
hll
Provides HyperLogLog types and aggregates for approximate distinct-counting. See the upstream project for its API and release history.
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 hll extension image to your Cluster
apiVersion: postgresql.cnpg.io/v1
kind: Cluster
metadata:
name: cluster-hll
spec:
imageCatalogRef: ...
postgresql:
extensions:
- name: hll
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 hll;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
Connect to the database with psql and run \dx to check the installed extensions.
A SQL check that exercises the installed extension is:
SELECT (SELECT hll_cardinality(hll_add_agg(hll_hash_integer(i))) BETWEEN 95 AND 105 FROM generate_series(1,100) AS s(i));
Package, dependencies and maintenance
The image installs PGDG package postgresql-18-hll at the Debian version recorded in metadata.hcl. Package updates are tracked by Renovate; review changes against the package's control file and rerun the target's build. The package is available for PostgreSQL 18 on both Bookworm and Trixie, amd64 and arm64. It depends on the CNPG PostgreSQL 18 base image and libc; no additional runtime package is installed. The hll module uses Apache-2.0 licensing. Its Debian copyright file is included under /licenses/. The extension includes vendored MurmurHash3 code (public domain, no independent version).
Overview
Provides HyperLogLog types and aggregates for approximate distinct-counting. See the upstream project for its API and release history.
Package details
- Extension version
- 2.21
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Trixie · amd64
Project links
- Debian source package ↗tracker.debian.org/pkg/postgresql-hll
- Upstream homepage ↗github.com/citusdata/postgresql-hll
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION hll;- SQL version
2.21
PostgreSQL parameters
None specified
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-ProtectionUnknown
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
Code-Review10
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: all changesets reviewed
Maintained3
Determines if the project is "actively maintained".
Reasoning: 4 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 3
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 30 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
License10
Determines if the project has defined a license.
Reasoning: license file detected
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0
Overview
Provides HyperLogLog types and aggregates for approximate distinct-counting. See the upstream project for its API and release history.
Package details
- Extension version
- 2.21
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Trixie · arm64
Project links
- Debian source package ↗tracker.debian.org/pkg/postgresql-hll
- Upstream homepage ↗github.com/citusdata/postgresql-hll
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION hll;- SQL version
2.21
PostgreSQL parameters
None specified
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-ProtectionUnknown
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
Code-Review10
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: all changesets reviewed
Maintained3
Determines if the project is "actively maintained".
Reasoning: 4 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 3
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 30 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
License10
Determines if the project has defined a license.
Reasoning: license file detected
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0
Overview
Provides HyperLogLog types and aggregates for approximate distinct-counting. See the upstream project for its API and release history.
Package details
- Extension version
- 2.21
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Bookworm · amd64
Project links
- Debian source package ↗tracker.debian.org/pkg/postgresql-hll
- Upstream homepage ↗github.com/citusdata/postgresql-hll
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION hll;- SQL version
2.21
PostgreSQL parameters
None specified
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-ProtectionUnknown
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
Code-Review10
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: all changesets reviewed
Maintained3
Determines if the project is "actively maintained".
Reasoning: 4 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 3
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 30 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
License10
Determines if the project has defined a license.
Reasoning: license file detected
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0
Overview
Provides HyperLogLog types and aggregates for approximate distinct-counting. See the upstream project for its API and release history.
Package details
- Extension version
- 2.21
- Image built
- Publisher
- cnpg-extensions
- Build
- Debian
- Platform
- PG 18 · Bookworm · arm64
Project links
- Debian source package ↗tracker.debian.org/pkg/postgresql-hll
- Upstream homepage ↗github.com/citusdata/postgresql-hll
Links from package metadata, recipe update rules, or reviewed upstream mappings.
Database setup
- Required extensions
- None specified
- SQL installation
CREATE EXTENSION hll;- SQL version
2.21
PostgreSQL parameters
None specified
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-ProtectionUnknown
Determines if the default and release branches are protected with GitHub's branch protection settings.
Reasoning: internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
Code-Review10
Determines if the project requires human code review before pull requests (aka merge requests) are merged.
Reasoning: all changesets reviewed
Maintained3
Determines if the project is "actively maintained".
Reasoning: 4 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 3
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 30 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
License10
Determines if the project has defined a license.
Reasoning: license file detected
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0
Dependencies
Packages shipped in this image, including the extension itself.
1 packages · Scanned
| Package / installed version | License evidence | Advisories |
|---|---|---|
postgresql-18-hll ↗ 2.21-1.pgdg13+3 | Apache-2.0 AND GPL-2.0-only AND GPL-2.0-or-later AND LicenseRef-public | 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-hll ↗ 2.21-1.pgdg13+3 | Apache-2.0 AND GPL-2.0-only AND GPL-2.0-or-later AND LicenseRef-public | 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-hll ↗ 2.21-1.pgdg12+3 | Apache-2.0 AND GPL-2.0-only AND GPL-2.0-or-later AND LicenseRef-public | 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-hll ↗ 2.21-1.pgdg12+3 | Apache-2.0 AND GPL-2.0-only AND GPL-2.0-or-later AND LicenseRef-public | 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-hll/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: postgresql-hll Source: https://github.com/citusdata/postgresql-hll Files: * Copyright: 2013 Timon Karnezos <timon.karnezos@gmail.com> Copyright 2013 Aggregate Knowledge, Inc. License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems, the full text of the Apache License version 2.0 can be found in the file `/usr/share/common-licenses/Apache-2.0'. Files: src/MurmurHash3.* Copyright: MurmurHash3 was written by Austin Appleby, and is placed in the public domain. The author hereby disclaims copyright to this source code. License: public Public domain. Files: debian/* Copyright: 2013 Cyril Bouthors <cyril@bouthors.org> License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/> . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
SHA256: 7b218450cb732f2946f43e91cd4b16b9ca9f7049a823b4c2e6437c1cf91d9d36
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-hll/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: postgresql-hll Source: https://github.com/citusdata/postgresql-hll Files: * Copyright: 2013 Timon Karnezos <timon.karnezos@gmail.com> Copyright 2013 Aggregate Knowledge, Inc. License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems, the full text of the Apache License version 2.0 can be found in the file `/usr/share/common-licenses/Apache-2.0'. Files: src/MurmurHash3.* Copyright: MurmurHash3 was written by Austin Appleby, and is placed in the public domain. The author hereby disclaims copyright to this source code. License: public Public domain. Files: debian/* Copyright: 2013 Cyril Bouthors <cyril@bouthors.org> License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/> . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
SHA256: 7b218450cb732f2946f43e91cd4b16b9ca9f7049a823b4c2e6437c1cf91d9d36
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-hll/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: postgresql-hll Source: https://github.com/citusdata/postgresql-hll Files: * Copyright: 2013 Timon Karnezos <timon.karnezos@gmail.com> Copyright 2013 Aggregate Knowledge, Inc. License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems, the full text of the Apache License version 2.0 can be found in the file `/usr/share/common-licenses/Apache-2.0'. Files: src/MurmurHash3.* Copyright: MurmurHash3 was written by Austin Appleby, and is placed in the public domain. The author hereby disclaims copyright to this source code. License: public Public domain. Files: debian/* Copyright: 2013 Cyril Bouthors <cyril@bouthors.org> License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/> . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
SHA256: 7b218450cb732f2946f43e91cd4b16b9ca9f7049a823b4c2e6437c1cf91d9d36
Licenses
Original license files shipped in the selected container image.
1 file read directly from /licenses.
/licenses/postgresql-18-hll/copyrightRead notice
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: postgresql-hll Source: https://github.com/citusdata/postgresql-hll Files: * Copyright: 2013 Timon Karnezos <timon.karnezos@gmail.com> Copyright 2013 Aggregate Knowledge, Inc. License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems, the full text of the Apache License version 2.0 can be found in the file `/usr/share/common-licenses/Apache-2.0'. Files: src/MurmurHash3.* Copyright: MurmurHash3 was written by Austin Appleby, and is placed in the public domain. The author hereby disclaims copyright to this source code. License: public Public domain. Files: debian/* Copyright: 2013 Cyril Bouthors <cyril@bouthors.org> License: GPL-2+ This package is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. . This package is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. . You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/> . On Debian systems, the complete text of the GNU General Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
SHA256: 7b218450cb732f2946f43e91cd4b16b9ca9f7049a823b4c2e6437c1cf91d9d36
Versions
Extension versions and the images built from them.
Tagged GHCR builds fetched .
