Skip to content

Commit 3fd7192

Browse files
chore: add warning for Postgres breaking changes. (#7448)
Disable-check: force-changelog-file Disable-check: commit-count
1 parent 910cbbf commit 3fd7192

File tree

1 file changed

+24
-8
lines changed

1 file changed

+24
-8
lines changed

README.md

Lines changed: 24 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,31 @@ time-series data. It is engineered up from PostgreSQL and packaged as a
1010
PostgreSQL extension, providing automatic partitioning across time and space
1111
(partitioning key), as well as full SQL support.
1212

13-
If you prefer not to install or administer your instance of TimescaleDB, try the
14-
30 day free trial of [Timescale](https://console.cloud.timescale.com/signup), our fully managed cloud offering.
15-
Timescale is pay-as-you-go. We don't charge for storage you dont use, backups, snapshots, ingress or egress.
13+
> [!WARNING]
14+
>
15+
> The latest Postgres minor releases (17.1, 16.5, 15.9, 14.14, 13.17, 12.21), released 2024-11-14, have an unexpected
16+
> breaking ABI change that will crash existing deployments of TimescaleDB, unless used with
17+
> a TimescaleDB binary explicitly built against those new minor PG versions.
18+
>
19+
> If you are using TimescaleDB, we recommend NOT upgrading to these latest minor versions at this time.
20+
> We have temporarily paused our normal process of automatically upgrading customers of our managed clouds to those minor
21+
> releases, as well as paused our automated community/OSS builds, as we work with the PG community how to address in
22+
> upcoming versions.
23+
>
24+
> See the thread on pgsql-hackers: https://www.postgresql.org/message-id/flat/CABOikdNmVBC1LL6pY26dyxAS2f%2BgLZvTsNt%3D2XbcyG7WxXVBBQ%40mail.gmail.com.
25+
>
26+
> Thanks for your understanding! 🙏
27+
28+
29+
If you prefer not to install or administer your instance of TimescaleDB, try the
30+
30 day free trial of [Timescale](https://console.cloud.timescale.com/signup), our fully managed cloud offering.
31+
Timescale is pay-as-you-go. We don't charge for storage you dont use, backups, snapshots, ingress or egress.
1632

1733
To determine which option is best for you, see [Timescale Products](https://tsdb.co/GitHubTimescaleProducts)
18-
for more information about our Apache-2 version, TimescaleDB Community (self-hosted), and Timescale
34+
for more information about our Apache-2 version, TimescaleDB Community (self-hosted), and Timescale
1935
Cloud (hosted), including: feature comparisons, FAQ, documentation, and support.
2036

21-
Below is an introduction to TimescaleDB. For more information, please check out
37+
Below is an introduction to TimescaleDB. For more information, please check out
2238
these other resources:
2339
- [Developer Documentation](https://docs.timescale.com/getting-started/latest/services/)
2440
- [Slack Channel](https://slack-login.timescale.com)
@@ -48,7 +64,7 @@ actual data. This single-table view, which we call a
4864
is comprised of many chunks, which are created by partitioning
4965
the hypertable's data in either one or two dimensions: by a time
5066
interval, and by an (optional) "partition key" such as
51-
device id, location, user id, etc.
67+
device id, location, user id, etc.
5268

5369
Virtually all user interactions with TimescaleDB are with
5470
hypertables. Creating tables and indexes, altering tables, inserting
@@ -63,7 +79,7 @@ such.
6379

6480
PostgreSQL's out-of-the-box settings are typically too conservative for modern
6581
servers and TimescaleDB. You should make sure your `postgresql.conf`
66-
settings are tuned, either by using [timescaledb-tune](https://github.com/timescale/timescaledb-tune)
82+
settings are tuned, either by using [timescaledb-tune](https://github.com/timescale/timescaledb-tune)
6783
or doing it manually.
6884

6985
#### Creating a hypertable
@@ -120,7 +136,7 @@ analysis that are not present in vanilla PostgreSQL. (For example, the `time_buc
120136
available via a free trial. Create a PostgreSQL database in the cloud with TimescaleDB pre-installed
121137
so you can power your application with TimescaleDB without the management overhead.
122138

123-
TimescaleDB is also available pre-packaged for several platforms such as Linux, Windows, MacOS, Docker, and
139+
TimescaleDB is also available pre-packaged for several platforms such as Linux, Windows, MacOS, Docker, and
124140
Kubernetes. For more information, see [Install TimescaleDB](https://docs.timescale.com/self-hosted/latest/install/).
125141

126142
To build from source, see [Building from source](https://github.com/timescale/timescaledb/blob/main/docs/BuildSource.md).

0 commit comments

Comments
 (0)