From 3bd53138a129e64c87a4719372807f786ffe799f Mon Sep 17 00:00:00 2001 From: Therese Magnusson Date: Mon, 7 Apr 2025 12:20:10 +0200 Subject: [PATCH 1/2] Update column info for show databases to mention where composite databases return null (#2212) We updated the store column to not say `--0.0` in 2025.04 (and backported to next release of 5.LTS as well), and the currentPrimariesCount/currentSecondariesCount to be null to match what the requested versions already did. Also added the sentence about being null for composite on the columns where that was already the case. --------- Co-authored-by: Reneta Popova --- .../standard-databases/listing-databases.adoc | 24 +++++++++++++++---- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc b/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc index 2b6bab451..86a29a284 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc @@ -35,13 +35,13 @@ Depending on what you want to see, you can list: * All databases. * A particular database. -* The default database. +* The DBMS default database. * The home database. These commands return the following columns: .Listing databases output -[options="header", width="100%", cols="4m,6a,2m"] +[options="header", width="100%", cols="4m,6,2m"] |=== | Column | Description | Type @@ -81,6 +81,8 @@ The default for a standalone database is `neo4j://localhost:7687`. label:default | role | The current role of the database (`primary`, `secondary`, `unknown`). label:default-output[] + +The value for composite databases is `NULL` because it does not apply to them. | STRING | writer @@ -117,34 +119,42 @@ See <> for more information. | default | -Show if this is the default database for the DBMS. label:default-output[] +`true` if this is the default database for the DBMS. label:default-output[] Not returned by `SHOW HOME DATABASE` or `SHOW DEFAULT DATABASE`. | BOOLEAN | home | -Shown if this is the home database for the current user. label:default-output[] +`true` if this is the home database for the current user. label:default-output[] Not returned by `SHOW HOME DATABASE` or `SHOW DEFAULT DATABASE`. | BOOLEAN | `currentPrimariesCount` | Number of primaries for this database reported as running currently. It is the same as the number of rows where `role=primary` and `name=this database`. + +The value for composite databases is `NULL` because it does not apply to them.footnote:compositeDb[This change applies to versions 2025.04 and later and 5.26.5 and later.] | INTEGER | `currentSecondariesCount` | Number of secondaries for this database reported as running currently. It is the same as the number of rows where `role=secondary` and `name=this database`. + +The value for composite databases is `NULL` because it does not apply to them.footnote:compositeDb[] | INTEGER | `requestedPrimariesCount` | The requested number of primaries for this database. May be lower than current if the DBMS is currently reducing the number of copies of the database, or higher if it is currently increasing the number of copies. + +The value for composite databases is `NULL` because it does not apply to them. | INTEGER | `requestedSecondariesCount` | The requested number of secondaries for this database. May be lower than current if the DBMS is currently reducing the number of copies of the database, or higher if it is currently increasing the number of copies. + +The value for composite databases is `NULL` because it does not apply to them. | INTEGER | creationTime @@ -160,7 +170,7 @@ May be lower than current if the DBMS is currently reducing the number of copies | ZONED DATETIME | store -a| +| Information about the storage engine and the store format. The value is a string formatted as: @@ -171,6 +181,8 @@ The value is a string formatted as: ---- A database must be `online` or `deallocating` for this value to be available. For other database states the value will be `NULL`. + +The value for composite databases is `NULL` because it does not apply to them.footnote:compositeDb[] | STRING | lastCommittedTxn @@ -195,6 +207,8 @@ For other database states the value will be `NULL`. |options |The map of options applied to the database. + +The value for composite databases is `NULL` because it does not apply to them. | MAP |=== From af33192a756fc3936128a51944012f069fe2170a Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Mon, 7 Apr 2025 11:22:53 +0100 Subject: [PATCH 2/2] Update modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc --- .../standard-databases/listing-databases.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc b/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc index 86a29a284..139bb5eb9 100644 --- a/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc +++ b/modules/ROOT/pages/database-administration/standard-databases/listing-databases.adoc @@ -133,7 +133,7 @@ Not returned by `SHOW HOME DATABASE` or `SHOW DEFAULT DATABASE`. | Number of primaries for this database reported as running currently. It is the same as the number of rows where `role=primary` and `name=this database`. -The value for composite databases is `NULL` because it does not apply to them.footnote:compositeDb[This change applies to versions 2025.04 and later and 5.26.5 and later.] +The value for composite databases is `NULL` because it does not apply to them.footnote:compositeDb[This change applies to versions 5.26.5 and later.] | INTEGER | `currentSecondariesCount`