Add a page about resharding a database and a few other improvements by renetapopova · Pull Request #2960 · neo4j/docs-operations

renetapopova · 2026-03-25T17:30:06Z

This PR contains the following changes to pages:

Moved the examples of how to create a sharded property database from the Data ingestion page to Creating sharded property databases.
Renamed the page Data ingestion to Data import
Created a new page called Resharding a database.

Moved the section Resizing and resharding from Admin operations to the new page
Moved Split an existing database into shards (offline)
Add information about creating a sharded property database from a backup of a standard database and a backup of a sharded property database.

EmelieBondesson

A few small comments but apart from that it looks good to me

…atabase into the database foo-sharded-new

renetapopova · 2026-03-30T14:37:00Z

The test failure is not related to this PR.

chamocarrot · 2026-04-01T21:00:02Z

+You can use the `neo4j-admin database copy` command to create a sharded property database from a standard database, specifying the number of property shards for the new database.
+The existing database must be stopped during the copying process.
+
+The following options should be specified for the `neo4j-admin database copy` command:


As they are not mandatory it should not say "should" but "can". Or maybe write:
The following options will be used for the neo4j-admin database copy command

But if you don't specify them, you can't split an existing database into shards.

This section is about this, not about the copy command per se.

My comment comes from that:
--copy-schema: You can do it without it, and actually we are writing "if needed"
--target-location can be skipped and --target-format then skipped as well or set to database and then the database stores will be created in the neo4j store location.
This is cosmetic so we can take later discussions :)

chamocarrot · 2026-04-01T21:31:37Z


-There are several ways to load data into a sharded property database:
+There are several ways to import data into a sharded property database, depending on your use case and the size of your dataset.
+All of these methods require that the database is not running.


This is conflicting with presenting LOAD CSV right after (it needs a running database). And neo4j-admin can be run with a neo4j already running. Only issue would be competing for resources (memory and cpu). Unless there is a very potent reason why this phrase was included maybe is better to remove it until we have a better wording.

…-ingestion.adoc

neo4j-docops-agent · 2026-04-02T08:38:00Z

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

renetapopova requested review from EmelieBondesson and jackwaudby March 25, 2026 17:30

renetapopova added the 2026.03 label Mar 25, 2026

renetapopova force-pushed the spd-resharding branch from 486f7c5 to cc07cc6 Compare March 25, 2026 17:30

EmelieBondesson approved these changes Mar 26, 2026

View reviewed changes

jackwaudby self-assigned this Mar 26, 2026

renetapopova commented Mar 26, 2026

View reviewed changes

Comment thread modules/ROOT/pages/scalability/sharded-property-databases/resharding-sharded-databases.adoc Outdated