Skip to content

Commit 9c620cb

Browse files
gvasquezvargasgvasquezvargas
authored
Merge pull request #6570 from EnterpriseDB/release/2025-02-28a
Release: 2025-02-28a
2 parents 341d8be + f71201e commit 9c620cb

31 files changed

+289
-65
lines changed

‎advocacy_docs/edb-postgres-ai/ai-accelerator/installing/complete.mdx

+17
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: "Completing and verifying the extension installation"
33
navTitle: "Completing the installation"
44
description: "Completing and verifying the installation of the AI Database and File System extensions."
5+
deepToC: true
56
---
67

78
### Installing the AI Database extension
@@ -15,6 +16,22 @@ CREATE EXTENSION
1516
edb=#
1617
```
1718

19+
#### Proxy settings
20+
21+
If you are using a HTTP proxy, you may need to set the `HTTP_PROXY` and `HTTPS_PROXY` environment variables in Postgres's environment. You can do this by adding the following lines to the `environment` file in the `main` directory of the Postgres data directory.
22+
23+
For example, on Ubuntu with Community Postgres, the `environment` file is located at `/etc/postgresql/16/main/environment`. Run the following commands to add the proxy settings to the `environment` file and restart the Postgres service.
24+
25+
```bash
26+
echo "HTTP_PROXY = 'http://<yourproxysettings>/'" | sudo tee -a /etc/postgresql/16/main/environment
27+
echo "HTTPS_PROXY = 'http://<yourproxysettings>/'" | sudo tee -a /etc/postgresql/16/main/environment
28+
sudo systemctl restart postgresql@16-main
29+
```
30+
31+
Replace `<yourproxysettings>` with your proxy settings. If you are using a different version of Postgres, replace `16` with your version number. Consult the documentation for your Postgres distribution for the location of the `environment` file.
32+
33+
Airgapped environments are not supported at this time.
34+
1835
### Installing the File System extension
1936

2037
The File System extension is an extension that provides a set of functions to interact with the file system from within the database. The extension is installed using the `CREATE EXTENSION` command.

‎advocacy_docs/edb-postgres-ai/ai-accelerator/models/using-models.mdx

+11-3
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,15 @@ Pipelines has a model registry that manages configured instances of models. Any
88

99
## Discover the preloaded models
1010

11-
Pipelines comes with a set of pre-created models that you can use out of the box.
11+
Pipelines comes with a set of pre-created models that you can use out of the box.
1212

1313
To find them, you can run the following query:
1414

1515
```sql
1616
SELECT * FROM aidb.list_models();
1717
```
1818

19-
This will return a list of all the models that are currently created in the system. If you have not created any models, you'll see the default models that come with Pipelines.
19+
This will return a list of all the models that are currently configured in the system. If you have not created any models, you'll see the default models that come with Pipelines.
2020

2121
```text
2222
name | provider | options
@@ -27,7 +27,15 @@ This will return a list of all the models that are currently created in the syst
2727
dummy | dummy | {"config={}"}
2828
```
2929

30-
The `bert`, `clip`, and `t5` models are all pre-created and ready to use. The `dummy` model is a placeholder model that can be used for testing purposes.
30+
The `bert`, `clip`, and `t5` models are all pre-configured and ready to use. The `dummy` model is a placeholder model that can be used for testing purposes.
31+
32+
!!! note First use of local models
33+
The first time you use any of the local models, the model will be downloaded from [HuggingFace](https://huggingface.co/). The model is then run locally.
34+
Subsequent uses of the model will be faster, as the model will be cached locally.
35+
36+
If you use a proxy, ensure that it is [configured on the Postgres server](../installing/complete#proxy-settings).
37+
38+
!!!
3139

3240
## Creating a Model
3341

‎advocacy_docs/pg_extensions/extensionrefs.json

+1
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,7 @@
102102
"edbspl": "https://www.enterprisedb.com/docs/epas/latest/application_programming/epas_compat_spl/02_spl_programs/",
103103
"spl_check": "https://www.enterprisedb.com/docs/pg_extensions/spl_check/",
104104
"parallel_clone": "undefined",
105+
"pg_global_temporary_tables_(pgtt)":"https://www.enterprisedb.com/docs/pg_extensions/pgtt/",
105106
"pglogical_3.x": "https://www.enterprisedb.com/docs/pgd/3.7/pglogical/",
106107
"refdata": "https://www.enterprisedb.com/docs/pg_extensions/advanced_storage_pack/",
107108
"postgis": "https://www.enterprisedb.com/docs/postgis/latest/",

‎advocacy_docs/pg_extensions/index.mdx

+2-1
Large diffs are not rendered by default.

‎advocacy_docs/pg_extensions/index.mdx.in

+1
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ navigation:
1010
- query_advisor
1111
- wait_states
1212
- pgaudit
13+
- pgtt
1314
- pg_failover_slots
1415
- pgRouting
1516
- pg_squeeze

‎advocacy_docs/pg_extensions/ldap_sync/installing.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Before you begin the installation process:
2222

2323
- Install [pg_cron](https://github.com/citusdata/pg_cron)
2424

25-
- Install plpython3u utility to run ldap2pg
25+
- Install the [plpython3u](https://www.postgresql.org/docs/current/plpython.html) procedural language to run ldap2pg. Note that `plpython3u` is a potential security risk as it's an “untrusted” language.
2626

2727
- Install [ldap2pg](https://ldap2pg.readthedocs.io/en/latest/).
2828

‎advocacy_docs/pg_extensions/pg_failover_slots/rel_notes/index.mdx

+2
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ about the release that introduced the feature.
1515
| Version | Release Date |
1616
| --------------------------- | ------------ |
1717
| [1.1.0](pg_failover_slots_1.1.0_rel_notes) | 27 Aug 2024 |
18+
| [1.0.1](pg_failover_slots_1.0.1_rel_notes) | 07 Jun 2023 |
1819
| [1.0.0](pg_failover_slots_1.0.0_rel_notes) | 31 Mar 2023 |
1920

2021

2122

23+

‎advocacy_docs/pg_extensions/pg_failover_slots/rel_notes/pg_failover_slots_1.0.1_rel_notes.mdx

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Release notes for PG Failover Slots version 1.0.1
3+
navTitle: "Version 1.0.1"
4+
---
5+
6+
This release of PG Failover Slots includes:
7+
8+
| Type | Description |
9+
| ------- | --------------------------------------- |
10+
| Bug fix | Fix support for PG13 and older. The missing interfaces caused either disconnects or outright crashes on PG13 and older. |
11+
| Improvement | Test compatibility improvements. Tests now work on PG11, and are more resilient to testing on slower machines. |
12+
| Improvement | PG16 compatibility improvements |
13+
| General | Various minor cleanups |

‎advocacy_docs/pg_extensions/pgrouting/configuring.mdx

+5-3
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,12 @@ title: Configuring pgRouting
33
navTitle: Configuring
44
---
55
!!! Note
6-
`pgRouting` depends on PostGIS. To install PostGIS, see [EDB PostGIS](https://www.enterprisedb.com/docs/postgis/latest/)
6+
pgRouting depends on PostGIS. To install PostGIS, see [EDB PostGIS](https://www.enterprisedb.com/docs/postgis/latest/)
77

8-
To enable `pgRouting`, create the extension.
8+
To enable pgRouting, create the extension:
99

10+
```
1011
CREATE EXTENSION pgrouting;
12+
```
1113

12-
For additional configuration information, see the [Configuring pgRouting](https://docs.pgrouting.org/latest/en/pgRouting-installation.html#configuring) in the official documentation.
14+
For additional configuration information, see [Configuring pgRouting](https://docs.pgrouting.org/latest/en/pgRouting-installation.html#configuring) in the official pgRouting documentation.

‎advocacy_docs/pg_extensions/pgrouting/index.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ directoryDefaults:
1010
product: pgRouting
1111
---
1212

13-
`pgRouting` is an extension released as open source software under the PostgreSQL License.
13+
pgRouting is an extension released as open source software under the PostgreSQL License.
1414

15-
`pgRouting` provides geospatial routing functionality.
15+
pgRouting provides geospatial routing functionality.
1616

17-
For more information about `pgRouting`, see:
17+
For more information about pgRouting, see:
1818

1919
- [Installing pgRouting](installing.mdx)
2020
- [Configuring pgRouting](configuring.mdx)

‎advocacy_docs/pg_extensions/pgrouting/installing.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Installing pgRouting
33
navTitle: Installing
44
---
55

6-
`pgRouting` is supported on the same platforms as the Postgres distribution you're using. Support for `pgRouting` starts with Postgres 13. For details, see:
6+
pgRouting is supported on the same platforms as the Postgres distribution you're using. Support for pgRouting starts with Postgres 13. For details, see:
77

88
- [EDB Postgres Advanced Server Product Compatibility](https://www.enterprisedb.com/platform-compatibility#epas)
99
- [PostgreSQL Product Compatibility](https://www.enterprisedb.com/resources/platform-compatibility#pg)

‎advocacy_docs/pg_extensions/pgrouting/using.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@ title: Using pgRouting
33
navTitle: Using
44
---
55

6-
For more information on using `pgRouting`, see [Getting Started](https://github.com/pgRouting/pgRouting?tab=readme-ov-file#getting-started) in the `pgRouting` official documentation.
6+
For more information on using pgRouting, see [Getting Started](https://github.com/pgRouting/pgRouting?tab=readme-ov-file#getting-started) in the pgRouting official documentation.

‎advocacy_docs/pg_extensions/pgtt/configuring.mdx

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: Configuring pgtt
3+
navTitle: Configuring
4+
---
5+
6+
To enable `pgtt`, create the extension in the database:
7+
8+
```sql
9+
CREATE EXTENSION pgtt;
10+
```
11+
12+
For additional configuration information after enabling the extension, see the [pgtt official documentation](https://github.com/darold/pgtt?tab=readme-ov-file#configuration).

‎advocacy_docs/pg_extensions/pgtt/index.mdx

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
title: 'pgtt'
3+
indexCards: none
4+
navigation:
5+
- rel_notes
6+
- installing
7+
- configuring
8+
- using
9+
directoryDefaults:
10+
product: pgtt
11+
---
12+
13+
`pgtt` is an extension released as open source software under the PostgreSQL License.
14+
15+
`pgtt` provides the ability to create, manage and use Oracle-style Global Temporary Tables.
16+
17+
For more information about `pgtt`, see:
18+
19+
- [Installing pgtt](installing.mdx)
20+
- [Configuring pgtt](configuring.mdx)
21+
- [Using pgtt](using.mdx)

‎advocacy_docs/pg_extensions/pgtt/installing.mdx

+66
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
title: Installing pgtt
3+
navTitle: Installing
4+
---
5+
6+
`pgtt` is supported on the same platforms as the Postgres distribution you're using. Support for `pgtt` starts with Postgres 12. For details, see:
7+
8+
- [EDB Postgres Advanced Server Product Compatibility](https://www.enterprisedb.com/platform-compatibility#epas)
9+
- [PostgreSQL Product Compatibility](https://www.enterprisedb.com/resources/platform-compatibility#pg)
10+
- [EDB Postgres Extended Server Product Compatibility](https://www.enterprisedb.com/resources/platform-compatibility#epas_extended)
11+
12+
## Installation
13+
14+
Before you begin the installation process:
15+
16+
- Install Postgres. See:
17+
18+
- [Installing EDB Postgres Advanced Server](/epas/latest/installing/)
19+
20+
- [Installing PostgreSQL](https://www.postgresql.org/download/)
21+
22+
- [Installing EDB Postgres Extended Server](/pge/latest/installing/)
23+
24+
- Set up the repository.
25+
26+
Setting up the repository is a one-time task. If you've already set up your repository, you don't need to perform this step.
27+
28+
To set up the repository, go to [EDB repositories](https://www.enterprisedb.com/repos-downloads) and follow the instructions provided there.
29+
30+
## Install the package
31+
32+
The syntax for the package install command is:
33+
34+
```shell
35+
# For SLES, CentOS, RHEL and its derivatives
36+
sudo <package-manager> -y install edb-<postgres><postgres_version>-pgtt0
37+
38+
# For Debian and Ubuntu
39+
sudo <package-manager> -y install edb-<postgres><postgres_version>-pgtt-0
40+
```
41+
42+
Where:
43+
- `<package-manager>`is the package manager used with your operating system:
44+
45+
| Package manager | Operating system |
46+
| --------------- | -------------------------------- |
47+
| dnf | RHEL 8/9 and derivatives |
48+
| yum | RHEL 7 and derivatives, CentOS 7 |
49+
| zypper | SLES |
50+
| apt-get | Debian and derivatives |
51+
52+
- `<postgres>` is the distribution of Postgres you're using:
53+
54+
| Postgres distribution | Value |
55+
| ---------------------------- | ---------- |
56+
| PostgreSQL | pg |
57+
| EDB Postgres Advanced Server | as |
58+
| EDB Postgres Extended Server | postgresextended |
59+
60+
- `<postgres_version>` is the version of Postgres you're using.
61+
62+
For example, to install pgtt for EDB Postgres Advanced Server 15 on a RHEL 8 platform:
63+
64+
```shell
65+
sudo dnf -y install edb-as15-pgtt0
66+
```

‎advocacy_docs/pg_extensions/pgtt/rel_notes/index.mdx

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: 'pgtt release notes'
3+
navTitle: "Release notes"
4+
indexCards: none
5+
---
6+
The `pgtt` documentation describes the latest version of `pgtt`, including minor releases and patches. These release notes cover what was new in each release. For new functionality introduced in a minor or patch release, there are also indicators in the content about the release that introduced the feature.
7+
8+
| Version | Release Date |
9+
| ----------------------------------- | ------------ |
10+
| [4.0](pgtt_4.0_rel_notes) | 30 May 2024 |

‎advocacy_docs/pg_extensions/pgtt/rel_notes/pgtt_4.0_rel_notes.mdx

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: Release notes for pgtt
3+
navTitle: "Version 4.0"
4+
---
5+
6+
For `pgtt` release notes, see the [pgtt official change log](https://github.com/darold/pgtt/releases).

‎advocacy_docs/pg_extensions/pgtt/using.mdx

+6
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
title: Using pgtt
3+
navTitle: Using
4+
---
5+
6+
For more information on using `pgtt`, see [Use of the extension](https://github.com/darold/pgtt?tab=readme-ov-file#use-of-the-extension) in the `pgtt` official documentation.

‎advocacy_docs/pg_extensions/query_advisor/installing.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Installing Query Advisor
33
navTitle: Installing
44
---
55

6-
EDB Query Advisor is supported on the same platforms as the Postgres distribution you're using. Support for EDB Query Advisor starts with Postgres 12. For details, see:
6+
EDB Query Advisor is supported on the same platforms as the Postgres distribution you're using. Support for EDB Query Advisor starts with Postgres 13. For details, see:
77
- [EDB Postgres Advanced Server Product Compatibility](https://www.enterprisedb.com/platform-compatibility#epas)
88

99
- [PostgreSQL Product Compatibility](https://www.enterprisedb.com/resources/platform-compatibility#pg)

‎advocacy_docs/pg_extensions/query_advisor/rel_notes/index.mdx

+2
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: 'EDB Query Advisor release notes'
33
navTitle: "Release notes"
44
indexCards: none
55
navigation:
6+
- query_advisor_1.2.0_rel_notes
67
- query_advisor_1.1.1_rel_notes
78
- query_advisor_1.0.0_rel_notes
89
---
@@ -14,6 +15,7 @@ about the release that introduced the feature.
1415

1516
| Version | Release Date |
1617
|----------------------------------------|--------------|
18+
| [1.2.0](query_advisor_1.2.0_rel_notes) | 28 Feb 2025 |
1719
| [1.1.1](query_advisor_1.1.1_rel_notes) | 12 Sep 2024 |
1820
| [1.0.0](query_advisor_1.0.0_rel_notes) | 10 May 2023 |
1921

‎advocacy_docs/pg_extensions/query_advisor/rel_notes/query_advisor_1.2.0_rel_notes.mdx

+10
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Release notes for Query Advisor version 1.2.0
3+
navTitle: "Version 1.2.0"
4+
---
5+
6+
This release of Query Advisor includes:
7+
8+
| Type | Description |
9+
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
10+
| Enhancement | New columns are added to the output of the `query_advisor_index_recommendations` and `query_advisor_statistics_recommendations` functions. For more information, see [using query advisor](../using.mdx).|

‎advocacy_docs/pg_extensions/query_advisor/using.mdx

+14-13
Original file line numberDiff line numberDiff line change
@@ -8,23 +8,23 @@ EDB Query Advisor defines functions and views.
88
## Functions
99

1010
### query_advisor_index_recommendations(min_filter, min_selectivity)
11+
1112
Performs a global index suggestion.
1213

1314
By default, only predicates filtering at least 1000 rows and 30% of the rows in average are considered. You can use the `min_filter` and `min_selectivity` parameters to override the default.
1415

15-
The function generates the one- and two-column index candidates based on the predicates it collects. It replans all related workload queries in the presence of the hypothetical index with respect to each candidate. It recommends the list of indexes that bring the most value to the workload. It also shows the estimated index size and percentage cost reduction in the workload queries. You can decide, based on the size and benefit ratio, which indexes are the most useful for you.
16+
The function generates the one- and two-column index candidates based on the predicates it collects. It replans all related workload queries in the presence of the hypothetical index with respect to each candidate. It recommends the list of indexes that bring the most value to the workload. It also shows the estimated index size, estimated percentage cost reduction, total cost, absolute benefit and query ID's of the benefited queries in the workload. You can decide, based on the size and benefit ratio, which indexes are the most useful for you.
1617

1718
For example:
1819

1920
```sql
2021
# running as postgres user
21-
select * from query_advisor_index_recommendations(0,0);
22+
select * from query_advisor_index_recommendations();
2223
__OUTPUT__
23-
| index | estimated_size_in_bytes | estimated_pct_cost_reduction |
24-
+---------------------------------------------------------------+-------------------------+------------------------------+
25-
| CREATE INDEX ON nation USING btree (n_name); | 8192 | 14.619857 |
26-
| CREATE INDEX ON supplier USING btree (s_suppkey,s_nationkey); | 933888 | 0.63003576 |
27-
| CREATE INDEX ON partsupp USING btree (ps_suppkey); | 50159616 | 13.254544 |
24+
index | estimated_size_in_bytes | estimated_pct_cost_reduction | total_cost | abs_benefit | benefited_queryids
25+
-----------------------------------------------+-------------------------+------------------------------+------------+-------------+------------------------
26+
CREATE INDEX ON public.test USING btree (a); | 2605056 | 49.87271 | 3386 | 1688.69 | {-4599253246525795071}
27+
CREATE INDEX ON public.test1 USING btree (a); | 2605056 | 49.87271 | 3386 | 1688.69 | {28196068180564065}
2828
(3 rows)
2929
```
3030
### query_advisor_statistics_recommendations(min_err_estimate_num, min_err_estimate_ratio)
@@ -35,19 +35,20 @@ By default, `min_err_estimate_num` and `min_err_estimate_ratio` are set to `0`.
3535

3636
The function generates potential candidates from the multi-column filters of your queries. Then, these candidates are processed by exploring different possible combinations. Currently the focus is on statistics for two columns at a time.
3737

38-
It also shows the weights to each candidate. Weights are based on how many queries would benefit from those extended statistics and what the execution cost of the queries would be.
38+
It also shows the weights to each candidate. Weights are based on how many queries would benefit from those extended statistics and what the execution cost of the queries would be. It shows query ID's of the benefited queries for which the recommendations are beneficial.
3939

4040
For example:
4141

4242
```sql
4343
# running as postgres user
4444
select * from query_advisor_statistics_recommendations();
4545
__OUTPUT__
46-
| statistics | weight |
47-
+----------------------------------------------------------------------------------------+--------------------+
48-
| CREATE STATISTICS part_p_brand_p_container ON p_brand, p_container FROM public.part; | 4940012.436935346 |
49-
| CREATE STATISTICS part_p_brand_p_type ON p_brand, p_type FROM public.part; | 306202.2549564565 |
50-
| CREATE STATISTICS part_p_brand_p_size ON p_brand, p_size FROM public.part; | 2879764.4054564573 |
46+
statistics | weight | benefited_queryids
47+
--------------------------------------------------------+----------+----------------------------------------------------------------
48+
CREATE STATISTICS test1_a_b ON a, b FROM public.test1; | 7506.09 | {238391330592834993}
49+
CREATE STATISTICS test_a_b ON a, b FROM public.test; | 15012.09 | {6121296315499460229,-4518452432473118207,238391330592834993}
50+
CREATE STATISTICS test_a_c ON a, c FROM public.test; | 15012.09 | {-3664340941915161122,-4518452432473118207,238391330592834993}
51+
CREATE STATISTICS test_b_c ON b, c FROM public.test; | 11384.09 | {-4518452432473118207,238391330592834993}
5152
(3 rows)
5253
```
5354

0 commit comments

Comments
 (0)