diff --git a/docs/index.rst b/docs/index.rst index 83232238b..776d7d4bb 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -86,13 +86,10 @@ Getting Support The project has a friendly and growing community. For discussions, use the Github `discussions page `_ or join our `chat room `_. You can also report or search for bugs/features on the Github `issues `_ page. -.. toctree:: - :glob: - :caption: Release Notes - :reversed: - :maxdepth: 1 +Release Notes +------------- - releases/* +The release notes are published on `PostgREST's GitHub release page `_. Tutorials --------- diff --git a/docs/releases/v09.0.0.rst b/docs/releases/v09.0.0.rst deleted file mode 100644 index 5827f542a..000000000 --- a/docs/releases/v09.0.0.rst +++ /dev/null @@ -1,130 +0,0 @@ - -9.0.0 -===== - -This major version is released with PostgreSQL 14 compatibility and is accompanied with new features and bug fixes. You can look at the detailed changelog and download the pre-compiled binaries on the `GitHub release page `_. - -Features --------- - -PostgreSQL 14 compatibility -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -PostgreSQL 14 Beta 1 tightened its GUC naming scheme making it impossible to use multiple dots (``.``) and dashes (``-``) on custom GUC parameters, this caused our `old HTTP Context `_ to fail across all requests. Thankfully, `@robertsosinski `_ got the PostgreSQL team to reconsider allowing multiple dots in the GUC name, allowing us to avoid a major breaking change. You can see the full discussion `here `_. - -Still, dashes cannot be used on PostgreSQL 14 custom GUC parameters, so we changed our HTTP Context :ref:`to namespace using a mix of dots and JSON `. On older PostgreSQL versions we still use the settings legacy names. If you wish to use the new JSON GUCs on these versions, set the :ref:`db-use-legacy-gucs` config option to false. - -Resource Embedding with Top-level Filtering -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Historically, Resource Embedding was always done with a query that included the equivalent of a ``LEFT JOIN``, which meant you could not -exclude any of the top-level resource rows. You can now use :ref:`embedding_top_level_filter` to do the equivalent of an ``INNER JOIN``, thus you can filter the top-level resource rows with any of the available operators. - -Partitioned Tables -~~~~~~~~~~~~~~~~~~ - -Partitioned tables now integrate with all the feature set. You can :ref:`embed partitioned tables `, UPSERT, INSERT(with a correctly generated Location header) and make OPTIONS requests on them. They're also included in the generated OpenAPI. - -Functions(RPC) -~~~~~~~~~~~~~~ - -* Functions with a :ref:`single unnamed parameter ` can now be used to POST raw ``bytea``, ``text`` or ``json/jsonb``. - -Horizontal Filtering -~~~~~~~~~~~~~~~~~~~~ - -* The ``unknown`` value for three-valued logic can now be used on the ``is`` :ref:`operator `. - -* Escaping double quotes(``"``) in double-quoted surrounded strings is now possible by using backslashes, e.g. ``?col=in.("Double\"Quote")``. Backslashes can be escaped with a preceding backslash, e.g. ``?col=in.("Back\\slash")``. See :ref:`reserved-chars`. - -Administration -~~~~~~~~~~~~~~ - -* A ``Retry-After`` header is now added when PostgREST is doing :ref:`automatic_recovery`. - -Error messages -~~~~~~~~~~~~~~ - -* :ref:`embed_disamb` now shows an improved error message that includes relevant hints for clearing out the ambiguous embedding. - -Documentation improvements -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* Added ``curl`` snippets to the :ref:`api` page. - -* Added the :ref:`automatic_recovery` section. - -* Added the :ref:`nested_embedding` section. - -* Added the :ref:`logical_operators` section. - -* Added the :ref:`templates` and :ref:`devops` sections to the :doc:`Ecosystem `. - -Bug fixes ---------- - -* Correct RPC return type handling for RETURNS TABLE with a single column (`#1930 `_). - -* Schema Cache query failing with ``standard_conforming_strings = off`` (`#1992 `_). - -* OpenAPI missing default values for String types (`#1871 `_). - -Breaking changes ----------------- - -* Dropped support for PostgreSQL 9.5 as it already reached its end-of-life according to `PostgreSQL versioning policy `_. - -* Partitions of a `partitioned table `_ are no longer included in the :ref:`schema_cache`. This is so errors are not generated when doing resource embedding on partitioned tables. - -* Dropped support for doing :ref:`hint_disamb` using dots instead of exclamation marks, e.g. doing ``select=*,projects.client_id(*)`` instead of ``select=*,projects!client_id(*)``). Using dots was undocumented and deprecated back in `v6.0.2 `_. - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* `Daniel Babiak `_ -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v09.0.1.rst b/docs/releases/v09.0.1.rst deleted file mode 100644 index bac8795b1..000000000 --- a/docs/releases/v09.0.1.rst +++ /dev/null @@ -1,89 +0,0 @@ - -9.0.1 -===== - -This version includes important fixes for production environments and other miscellaneous fixes. You can download the pre-compiled binaries on the `GitHub release page `_. - -Bug Fixes ---------- - -* Keep working when ``EMFILE (Too many open files)`` is reached. (`#2042 `_) - -* Disable parallel GC for better performance on higher core CPUs (`#2294 `_). Thanks to `NoRedInk for their blog post `_ that lead us to this fix. - -* Fix using CPU while idle. (`#1076 `_) - -* Fix reading database configuration properly when ``=`` is present in the value. (`#2120 `_) - -* Fix ``is`` not working with upper or mixed case values like ``NULL``, ``TrUe``, ``FaLsE``. (`#2077 `_) - -* Execute deferred constraint triggers when using ``Prefer: tx=rollback``. (`#2020 `_) - -* Ignore ``Content-Type`` headers for ``GET`` requests when calling RPCs. (`#2147 `_) - - * Previously, ``GET`` without parameters, but with ``Content-Type: text/plain`` or ``Content-Type: application/octet-stream`` would fail with ``404 Not Found``, even if a function without arguments was available. - -* Fix wrong CORS header from ``Authentication`` to ``Authorization``. (`#1724 `_) - -* Fix ``json`` and ``jsonb`` columns showing a type in OpenAPI spec. (`#2165 `_) - -* Remove trigger functions from the schema cache and OpenAPI output, because they can't be called directly anyway. (`#2135 `_) - -* Remove aggregates, procedures and window functions from the schema cache and OpenAPI output. (`#2101 `_) - -* Fix schema cache loading when views with ``XMLTABLE`` and ``DEFAULT`` are present. (`#2024 `_) - -* Fix ``--dump-schema`` running with a wrong PG version. (`#2153 `_) - -* Fix misleading disambiguation error where the content of the ``relationship`` key looks like valid syntax. (`#2239 `_) - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* `Daniel Babiak `_ -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v10.0.0.rst b/docs/releases/v10.0.0.rst deleted file mode 100644 index e703324a4..000000000 --- a/docs/releases/v10.0.0.rst +++ /dev/null @@ -1,227 +0,0 @@ - -10.0.0 -====== - -Features --------- - -XML/SOAP support for RPC -~~~~~~~~~~~~~~~~~~~~~~~~ - -RPC now understands the ``text/xml`` media type, allowing SQL functions to send XML output(``Accept: text/xml``) and receive XML input(``Content-Type: text/xml``). This makes SOAP endpoints possible, check the :ref:`create_soap_endpoint` how-to and the :ref:`scalar_return_formats` reference for more details. - -GeoJSON support -~~~~~~~~~~~~~~~ - -GeoJSON is supported across the board(reads, writes, RPC) with the ``Accept: application/geo+json`` header, this depends on PostGIS from the versions 3.0.0 and up. The :ref:`working with PostGIS section ` has an example to get you started. - -Execution Plan -~~~~~~~~~~~~~~ - -The :ref:`execution plan ` of a request is now obtainable with the ``Accept: application/vnd.pgrst.plan`` header. The result can be in ``text`` or ``json`` formats and is compatible with EXPLAIN vizualizers like `explain.depesz.com `_ or `explain.dalibo.com `_. - -Resource Embedding -~~~~~~~~~~~~~~~~~~ - -- A :ref:`one-to-one relationship ` is now detected when a foreign key is unique. - -- Using :ref:`computed_relationships`, you can add custom relationships or override automatically detected ones. This makes :ref:`resource_embedding` possible on Foreign Data Wrappers and complex SQL views. - -Horizontal/Vertical Filtering -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- :ref:`Accessing fields of a Composite type or elements of an Array type ` is now possible with the arrow operators(``->``, ``->>``) in the same way you would access a JSON type fields. - -- :ref:`pattern_matching` operators for `POSIX regular expressions `_ are now available: ``match`` and ``imatch``, equivalent in PostgreSQL to ``~`` and ``~*`` respectively. - -Insertions/Updates -~~~~~~~~~~~~~~~~~~ - -- ``limit`` can now affect the number of updated/deleted rows. See :ref:`limited_update_delete`. - -OpenAPI -~~~~~~~ - -You can now activate the "Authorize" button in SwaggerUI by enabling the :ref:`openapi-security-active` configuration. Add your JWT token prepending :code:`Bearer` to it and you'll be able to request protected resources. - -Administration -~~~~~~~~~~~~~~ - -- Two :ref:`health check endpoints ` are now exposed in a secondary port. - -- :ref:`pgrst_logging` now shows the database user. - -- It is now possible to execute PostgREST without specifying any configuration variable. The three that were mandatory on the previous versions, are no longer so. - - - If :ref:`db-uri` is not set, PostgREST will use the `libpq environment variables `_ for the database connection. - - If :ref:`db-schemas` is not set, it will use the database ``public`` schema. - - If :ref:`db-anon-role` is not set, it will not allow anonymous requests. - -Error messages -~~~~~~~~~~~~~~ - -- To increase consistency, all the errors messages are now normalized. The ``hint``, ``details``, ``code`` and ``message`` fields will always be present in the body, each one defaulting to a ``null`` value. In the same way, the :ref:`errors that were raised ` with ``SQLSTATE`` now include the ``message`` and ``code`` in the body. - -- To further clarify the source of an error, we now add a ``PGRST`` prefix to the error code of all the errors that are PostgREST-specific and don't come from the database. These errors have unique codes that identify them and are documented in the :ref:`pgrst_errors` section. - -Documentation improvements -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* Added a :doc:`/how-tos/working-with-postgresql-data-types` how-to, which contains explanations and examples on how to work with different PostgreSQL data types such as timestamps, ranges or PostGIS types, among others. - -* Added in-database and environment variable settings for each :ref:`configuration variable `. - -* Added the :ref:`file_descriptors` subsection. - -* Added a reference page for :ref:`error_source`. - -* Moved the :ref:`error_source` and the :ref:`status_codes` sections to the :ref:`errors reference page `. - -* Moved the *Casting type to custom JSON* how-to to the :ref:`casting_range_to_json` subsection. - -* Removed direct links for PostgREST versions older than 8.0 from the versions menu. - -* Removed the *Embedding table from another schema* how-to. - -* Restructured the :ref:`resource_embedding` section: - - - Added a :ref:`one-to-many` and :ref:`many-to-one` subsections. - - - Renamed the *Embedding through join tables* subsection to :ref:`many-to-many`. - -* Split up the *Insertions/Updates* section into :ref:`insert` and :ref:`update`. - -Breaking changes ----------------- - -* Many-to-many relationships now require that foreign key columns be part of the join table composite key - - - This was needed to reduce :ref:`embed_disamb` errors in complex schemas(`#2070 `_). - - - For migrating to this version, the less invasive method is to use :ref:`computed_relationships` to replace the previous many-to-many relationships. - - - Otherwise you can change your join table primary key. For example with ``alter table permission_user drop constraint permission_user_pkey, add primary key (id, user_id, permission_id);`` - -* Views now are not detected when embedding using :ref:`target_disamb`. - - - This embedding form was easily made ambiguous whenever a new view was added(`#2277 `_). - - - For migrating to this version, you can use :ref:`computed_relationships` to replace the previous view relationships. - - - :ref:`hint_disamb` works as usual on views. - -* ``limit/offset`` now limits the affected rows on ``UPDATE``/``DELETE`` - - - Previously, ``limit``/``offset`` only limited the returned rows but not the actual updated rows(`#2156 `_) - -* ``max-rows`` is no longer applied on ``POST``, ``PATCH``, ``PUT`` and ``DELETE`` returned rows - - - This was misleading because the affected rows were not really affected by ``max-rows``, only the returned rows were limited(`#2155 `_) - -* Return ``204 No Content`` without ``Content-Type`` for RPCs returning ``VOID`` - - - Previously, those RPCs would return ``null`` as a body with ``Content-Type: application/json`` (`#2001 `_). - -* Using ``Prefer: return=representation`` no longer returns a ``Location`` header - - - This reduces unnecessary computing for all insertions (`#2312 `_) - -Bug fixes ---------- - -* Return ``204 No Content`` without ``Content-Type`` for ``PUT`` (`#2058 `_) - -* Clarify error for failed schema cache load. (`#2107 `_) - - - From ``Database connection lost. Retrying the connection`` to ``Could not query the database for the schema cache. Retrying.`` - -* Fix silently ignoring filter on a non-existent embedded resource (`#1771 `_) - -* Remove functions, which are not callable due to unnamed arguments, from schema cache and OpenAPI output. (`#2152 `_) - -* Fix accessing JSON array fields with ``->`` and ``->>`` in ``?select=`` and ``?order=``. (`#2145 `_) - -* Ignore ``max-rows`` on ``POST``, ``PATCH``, ``PUT`` and ``DELETE`` (`#2155 `_) - -* Fix inferring a foreign key column as a primary key column on views (`#2254 `_) - -* Restrict generated many-to-many relationships (`#2070 `_) - - - Only adds many-to-many relationships when a table has foreign keys to two other tables and these foreign key columns are part of the table's primary key columns. - -* Allow casting to types with underscores and numbers (e.g. ``select=oid_array::_int4``) (`#2278 `_) - -* Prevent views from breaking one-to-many/many-to-one embeds when using column or foreign key as target (`#2277 `_, `#2238 `_, `#1643 `_) - - - When using a column or foreign key as target for embedding (``/tbl?select=*,col-or-fk(*)``), only tables are now detected and views are not. - - - You can still use a column or an inferred foreign key on a view to embed a table (``/view?select=*,col-or-fk(*)``) - -* Increase the ``db-pool-timeout`` to 1 hour to prevent frequent high connection latency (`#2317 `_) - -* The search path now correctly identifies schemas with uppercase and special characters in their names (regression) (`#2341 `_) - -* "404 Not Found" on nested routes and "405 Method Not Allowed" errors no longer start an empty database transaction (`#2364 `_) - -* Fix inaccurate result count when an inner embed was selected after a normal embed in the query string (`#2342 `_) - -* ``OPTIONS`` requests no longer start an empty database transaction (`#2376 `_) - -* Allow using columns with dollar sign ($) without double quoting in filters and ``select`` (`#2395 `_) - -* Fix loop crash error on startup in PostgreSQL 15 beta 3. ``Log: "UNION types \"char\" and text cannot be matched."`` (`#2410 `_) - -* Fix race conditions managing database connection helper (`#2397 `_) - -* Allow ``limit=0`` in the request query to return an empty array (`#2269 `_) - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* `Daniel Babiak `_ -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v10.2.0.rst b/docs/releases/v10.2.0.rst deleted file mode 100644 index 96121b410..000000000 --- a/docs/releases/v10.2.0.rst +++ /dev/null @@ -1,153 +0,0 @@ - -10.2.0 -====== - -This minor version adds bug fixes and some features that provide stability to v10.0.0. These release notes include the changes added in versions `10.1.0 `_, `10.1.1 `_ and `10.1.2 `_. You can look at the detailed changelog and download the pre-compiled binaries on the `GitHub release page `_. - -Features --------- - -Pool Connection Lifetime -~~~~~~~~~~~~~~~~~~~~~~~~ - -To prevent memory leaks caused by long-lived connections, PostgREST limits their lifetime in the pool through :ref:`db-pool-max-lifetime`. - -Pool Connection Acquisition Timeout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -There is now a time limit to wait for pool connections to be acquired. If a new request cannot get a connection in the time specified in :ref:`db-pool-acquisition-timeout` then a response with a ``504`` status is returned. - -Documentation improvements -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* Added HTTP status codes to the :ref:`pgrst_errors`. - -* Added a how-to on :ref:`sql-user-management-using-postgres-users-and-passwords`. - -* Updated the :ref:`Heroku installation page `. - -Changes -------- - -* Removed ``db-pool-timeout`` option because it was removed in the ``hasql-pool`` library that PostgREST uses for SQL connections. (`#2444 `_) - -Deprecated ----------- - -* Deprecate bulk-calls when including the ``Prefer: params=multiple-objects`` in the request. It is preferable to use a function with an :ref:`array ` or JSON parameter for a better performance. (`#1385 `_) - -Bug fixes ---------- - -* Reduce allocations communication with PostgreSQL, particularly for request bodies. (`#2261 `_, `#2349 `_, `#2467 `_) - -* Fix ``SIGUSR1`` to fully flush the connection pool. (`#2401 `_, `#2444 `_) - -* Fix opening an empty transaction on failed resource embedding. (`#2428 `_) - -* Fix embedding the same table multiple times. (`#2455 `_) - -* Fix a regression when embedding views where base tables have a different column order for foreign key columns (`#2518 `_) - -* Fix a regression with the ``Location`` header when :ref:`inserting ` into views with primary keys from multiple tables (`#2458 `_) - -* Fix a regression in OpenAPI output with mode ``follow-privileges`` (`#2356 `_) - -* Fix infinite recursion when loading schema cache with self-referencing view (`#2283 `_) - -* Return status code ``200`` instead of ``404`` for ``PATCH`` requests which don't affect any rows (`#2343 `_) - -* Treat the :ref:`computed relationships ` that do not return ``SETOF`` as M2O/O2O relationship (`#2481 `_) - -* Fix embedding a computed relationship with a normal relationship (`#2534 `_) - -* Fix error message when ``[]`` is used inside ``select`` (`#2362 `_) - -* Disallow ``!inner`` on computed columns (`#2475 `_) - -* Ignore leading and trailing spaces in column names when parsing the query string (`#2285 `_) - -* Fix ``UPSERT`` with PostgreSQL 15 (`#2545 `_) - -* Fix embedding views with multiple references to the same base column (`#2459 `_) - -* Fix regression when embedding views with partial references to multi column foreign keys (`#2548 `_) - -* Fix regression when requesting ``limit=0`` and ``db-max-row`` is set (`#2558 `_) - -* Return a clear error without hitting the database when trying to update or insert an unknown column with ``?columns`` (`#2542 `_) - -* Fix bad M2M embedding on RPC (`#2565 `_) - -* Replace misleading error message when no function is found with a hint containing functions/parameters names suggestions (`#2575 `_) - -* Move explanation about "single parameters" from the ``message`` to the ``details`` in the error output (`#2582 `_) - -* Replace misleading error message when no relationship is found with a hint containing parent/child names suggestions (`#2569 `_) - -* Add the required OpenAPI items object when the parameter is an array (`#1405 `_) - -* Add upsert headers for ``POST`` requests to the OpenAPI output (`#2592 `_) - -* Fix foreign keys pointing to ``VIEW`` instead of ``TABLE`` in OpenAPI output (`#2623 `_) - -* Consider any PostgreSQL authentication failure as fatal and exit immediately (`#2622 `_) - -* Fix ``NOTIFY pgrst`` not reloading the db connections catalog cache (`#2620 `_) - -* Fix ``db-pool-acquisition-timeout`` not logging to stderr when the timeout is reached (`#2667 `_) - -* Fix PostgreSQL resource leak with long-lived connections through the :ref:`db-pool-max-lifetime` configuration (`#2638 `_) - -* There is now a stricter parsing of the query string. Instead of silently ignoring, the parser now returns a :ref:`PostgREST error ` on invalid syntax. (`#2537 `_) - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* `Daniel Babiak `_ -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v11.0.1.rst b/docs/releases/v11.0.1.rst deleted file mode 100644 index 10257fa85..000000000 --- a/docs/releases/v11.0.1.rst +++ /dev/null @@ -1,123 +0,0 @@ -11.0.1 -====== - -These release notes include the changes in versions `11.0.0 `_ and `11.0.1 `_. The detailed changelog and pre-compiled binaries are available on the `GitHub release pages `_. - -Features --------- - -Transactions -~~~~~~~~~~~~ - -- New configurable :ref:`isolation_lvl`. -- New :ref:`impersonated_settings`. - -Inserts -~~~~~~~ - -- New :ref:`bulk_insert_default`. - -Functions -~~~~~~~~~ - -- Filters on Table-Valued Functions are now guaranteed to be inlined. See :ref:`function_inlining`. - -Horizontal Filtering -~~~~~~~~~~~~~~~~~~~~ - -- New ``isdistinct`` :ref:`operator `. It is a direct translation of `IS DINTINCT FROM `_. -- New ``and/all`` :ref:`modifiers`. - -Resource Embedding -~~~~~~~~~~~~~~~~~~ - -- New :ref:`top_level_order`. -- New :ref:`spread_embed`. -- New :ref:`null_embed`. -- New :ref:`empty_embed`. - -OpenAPI -~~~~~~~ - -- Allow :ref:`overriding the OpenAPI title `. -- Allow :ref:`override_openapi`. - -Admin -~~~~~ - -- New :ref:`trace_header`. - -Documentation improvements -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- New :ref:`transactions` reference. -- New :ref:`connection_pool` reference. -- Split :ref:`api` into other sub-references. -- Split :ref:`authn` into :ref:`db_authz` and :ref:`sql_user_management`. -- Split :ref:`admin` into :ref:`intgrs`, :ref:`nginx` and :ref:`connection_pool`. - -Bug fixes ---------- - -- Please check the "Fixed" section on https://github.com/PostgREST/postgrest/releases/tag/v11.0.0 and https://github.com/PostgREST/postgrest/releases/tag/v11.0.1. - -Breaking changes ----------------- - -- Removed Bulk Call with ``Prefer: params=multiple-objects`` on Stored Procedures. -- To comply with `RFC 9110 `_, the Range header is now only considered on GET. - - + Other methods will ignore it and instead should use the ``limit/offset``. - + PUT requests no longer return an error when this header is present (using limit/offset still triggers the error) - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* `Roboflow `_ -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* Zac Miller -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v11.1.0.rst b/docs/releases/v11.1.0.rst deleted file mode 100644 index 55cba22e2..000000000 --- a/docs/releases/v11.1.0.rst +++ /dev/null @@ -1,73 +0,0 @@ -11.1.0 -====== - -Features --------- - -Connection Pool -~~~~~~~~~~~~~~~ - -- New :ref:`db-pool-max-idletime`. It enables a :ref:`dyn_conn_pool`. - -Configuration -~~~~~~~~~~~~~ - -- New :ref:`in_db_config`. It no longer requires high privileges and can be used on cloud-hosted databases. - -Bug fixes ---------- - -- Fix dropping schema cache reload notifications. -- Stop automatic recovery when the error is "no password supplied". - -Thanks ------- - -Big thanks from the `PostgREST team `_ to our sponsors! - -.. container:: image-container - - .. image:: ../_static/cybertec-new.png - :target: https://www.cybertec-postgresql.com/en/?utm_source=postgrest.org&utm_medium=referral&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/2ndquadrant.png - :target: https://www.2ndquadrant.com/en/?utm_campaign=External%20Websites&utm_source=PostgREST&utm_medium=Logo - :width: 13em - - .. image:: ../_static/retool.png - :target: https://retool.com/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/gnuhost.png - :target: https://gnuhost.eu/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - - .. image:: ../_static/supabase.png - :target: https://supabase.com/?utm_source=postgrest%20backers&utm_medium=open%20source%20partner&utm_campaign=postgrest%20backers%20github&utm_term=homepage - :width: 13em - - .. image:: ../_static/oblivious.jpg - :target: https://oblivious.ai/?utm_source=sponsor&utm_campaign=postgrest - :width: 13em - -* `Roboflow `_ -* Evans Fernandes -* Jan Sommer -* `Franz Gusenbauer `_ -* Zac Miller -* Tsingson Qin -* Michel Pelletier -* Jay Hannah -* Robert Stolarz -* Nicholas DiBiase -* Christopher Reid -* Nathan Bouscal -* Daniel Rafaj -* David Fenko -* Remo Rechkemmer -* Severin Ibarluzea -* Tom Saleeba -* Pawel Tyll - -If you like to join them please consider `supporting PostgREST development `_. diff --git a/docs/releases/v11.2.0.rst b/docs/releases/v11.2.0.rst deleted file mode 100644 index 48809ae62..000000000 --- a/docs/releases/v11.2.0.rst +++ /dev/null @@ -1,4 +0,0 @@ -11.2.0 -====== - -Starting from this version, the release notes will be posted on PostgREST's GitHub release page. Please see https://github.com/PostgREST/postgrest/releases/tag/v11.2.0. diff --git a/docs/releases/v11.2.1.rst b/docs/releases/v11.2.1.rst deleted file mode 100644 index e5cf84b9b..000000000 --- a/docs/releases/v11.2.1.rst +++ /dev/null @@ -1,4 +0,0 @@ -11.2.1 -====== - -v11.2.1 is a maintenance release that addresses bugs introduced in v11.2.0. Also PostgreSQL 16 is now tested and confirmed to work. For more details, see https://github.com/PostgREST/postgrest/releases/tag/v11.2.1. diff --git a/postgrest.dict b/postgrest.dict index a0bdd592e..4157efafc 100644 --- a/postgrest.dict +++ b/postgrest.dict @@ -10,38 +10,31 @@ authenticator backoff balancer booleans -Bouscal Builtins buildpack Bytea Cardano cd centric -changelog coercible conf Cloudflare config cors CORS -CPUs cryptographically CSV DDL DOM DevOps -DiBiase dockerize eq ETH Ethereum EveryLayout -Fenko -Fernandes filename FreeBSD fts -GC GeoJSON GHC Github @@ -62,7 +55,6 @@ hstore HTTP HTTPS HV -Ibarluzea Inlining inlined Integrations @@ -106,9 +98,7 @@ openapi ORM ov passphrase -Pawel PBKDF -Pelletier PgBouncer pgcrypto pgjwt @@ -122,7 +112,6 @@ phraseto plainto plfts poolers -POSIX PostGIS PostgreSQL PostgreSQL's @@ -134,30 +123,23 @@ pre preflight plpgsql psql -Qin RabbitMQ -Rafaj RDS reallyreallyreallyreallyverysafe -Rechkemmer Redux refactor reloadable Reloadable -Remo requester's RESTful RLS RPC RSA -Saleeba safeupdate savepoint schemas schema's -Severin SHA -Sommer signup SIGUSR sl @@ -167,19 +149,15 @@ sr SSL stateful stdout -Stolarz supervisees SvelteKit -SwaggerUI syslog systemd todo todos tos -Tsingson tsquery tx -Tyll TypeScript UI ui @@ -208,4 +186,3 @@ Websockets webuser wfts www -Zac