From e29260d754d4c5bcbf642b8d8cd1eafd0aef2098 Mon Sep 17 00:00:00 2001 From: Laurence Isla Date: Thu, 5 Oct 2023 15:18:25 -0500 Subject: [PATCH] Version not set when invalid URI or key/value format --- docs/references/admin.rst | 6 ++++-- docs/references/api/tables_views.rst | 2 +- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/references/admin.rst b/docs/references/admin.rst index 34ba883ba..e54d542a9 100644 --- a/docs/references/admin.rst +++ b/docs/references/admin.rst @@ -106,9 +106,11 @@ When debugging a problem it's important to verify the running PostgREST version. ------------------------------ PostgREST 11.1.0 -.. note:: +.. important:: - The server sets the `fallback_application_name `_ for this query to work. To override the value set ``application_name`` on the connection string. + - The server sets the `fallback_application_name `_ to the connection URI for this query to work. To override the value set ``application_name`` on the connection string. + - The version will only be set if it's a valid URI (`RFC 3986 `_). This means any special characters must be urlencoded. + - The version will not be set if the connection string is in `keyword/value format `_. - The ``stderr`` logs also contain the version, as noted on :ref:`pgrst_logging`. diff --git a/docs/references/api/tables_views.rst b/docs/references/api/tables_views.rst index 518a58e2e..fd46d856c 100644 --- a/docs/references/api/tables_views.rst +++ b/docs/references/api/tables_views.rst @@ -196,7 +196,7 @@ Pattern Matching The pattern-matching operators (:code:`like`, :code:`ilike`, :code:`match`, :code:`imatch`) exist to support filtering data using patterns instead of concrete strings, as described in the `PostgreSQL docs `__. -To ensure best performance on larger data sets, an `appropriate index `__ should be used and even then, it depends on the pattern value and actual data statistics whether an existing index will be used by the query planner or not. +To ensure best performance on larger data sets, an `appropriate index `__ should be used and even then, it depends on the pattern value and actual data statistics whether an existing index will be used by the query planner or not. .. _fts: