From 48711d8b218b980426d058bf7d657e41a63e9b45 Mon Sep 17 00:00:00 2001 From: Jack Waudby Date: Tue, 6 Dec 2022 21:13:19 +0000 Subject: [PATCH 1/2] add documentation on show databases behaviour when servers are offline --- modules/ROOT/pages/databases.adoc | 4 ++++ ...cations-additions-removals-compatibility.adoc | 16 ++++++++++++++++ 2 files changed, 20 insertions(+) diff --git a/modules/ROOT/pages/databases.adoc b/modules/ROOT/pages/databases.adoc index 4b8be5845..096105ebb 100644 --- a/modules/ROOT/pages/databases.adoc +++ b/modules/ROOT/pages/databases.adoc @@ -258,6 +258,10 @@ However, some privileges enable users to see additional databases regardless of If a user has not been granted `ACCESS` privilege to any databases nor any of the above special cases, the command can still be executed but will only return the `system` database, which is always visible. ==== +[NOTE] +==== +Databases hosted on servers that are offline are also returned by this command. For such databases the `address` column displays `NULL`, the `currentStatus` column displays `unknown`, and the `statusMessage` displays `Server is unavailable`. +==== ====== diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc index 407f5c7fd..649634b25 100644 --- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc +++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc @@ -19,6 +19,22 @@ Replacement syntax for deprecated and removed features are also indicated. | Feature | Details +a| +label:functionality[] +label:updated[] +[source, cypher, role="noheader"] +---- +SHOW DATABASES +---- +a| +Changes to the visibility of databases hosted on offline servers. + +For such databases: + +* The `address` column will return `NULL`. +* The `currentStatus` column will return `unknown`. +* The `statusMessage` will return `Server is unavailable`. + a| label:functionality[] label:updated[] From 9b4e0112d6076496ea9595ffe123a59cb0de88de Mon Sep 17 00:00:00 2001 From: Jack Waudby <33488812+jackwaudby@users.noreply.github.com> Date: Wed, 14 Dec 2022 13:06:03 +0000 Subject: [PATCH 2/2] Update to reflect suggestion MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Jens Pryce-Åklundh <112686610+JPryce-Aklundh@users.noreply.github.com> --- modules/ROOT/pages/databases.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/modules/ROOT/pages/databases.adoc b/modules/ROOT/pages/databases.adoc index 096105ebb..f46d26bd6 100644 --- a/modules/ROOT/pages/databases.adoc +++ b/modules/ROOT/pages/databases.adoc @@ -260,7 +260,8 @@ If a user has not been granted `ACCESS` privilege to any databases nor any of th ==== [NOTE] ==== -Databases hosted on servers that are offline are also returned by this command. For such databases the `address` column displays `NULL`, the `currentStatus` column displays `unknown`, and the `statusMessage` displays `Server is unavailable`. +Databases hosted on servers that are offline are also returned by the `SHOW DATABASES` command. +For such databases, the `address` column displays `NULL`, the `currentStatus` column displays `unknown`, and the `statusMessage` displays `Server is unavailable`. ==== ======