Skip to content

add additional tutorials #667

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 36 commits into
base: console
Choose a base branch
from
Open

Conversation

fiquick
Copy link
Collaborator

@fiquick fiquick commented Apr 3, 2025

No description provided.


==== Cypher syntax

All changes in the Cypher language syntax are detailed in link:https://neo4j.com/docs/cypher-manual/5/deprecations-additions-removals-compatibility[Cypher Manual -> Removals, deprecations, additions and extensions].
Copy link
Collaborator Author

@fiquick fiquick Apr 8, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is the latest version, I believe. Check with Jens.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes! It looks like it! It says Version 5 (current) in version picker

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cypher 5 is the latest until release of Cypher 25 later this year.

All changes in the Cypher language syntax are detailed in link:https://neo4j.com/docs/cypher-manual/5/deprecations-additions-removals-compatibility[Cypher Manual -> Removals, deprecations, additions and extensions].
Thoroughly review this section in the version you are moving to and make the necessary changes in your code.

Here is a short list of the main changes introduced in Neo4j 5:
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we still refer to the changes in Neo4j 5 like this?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, it's Neo4j latest.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But they weren't introduced in Neo4j latest - they were introduced in Neo4j 5
Maybe I can just drop the word introduced?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@JPryce-Aklundh how would you approach this one?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would delete this, and just have a link to the page mentioned above. You have only listed changes that were added in 5.0 - but what about 5.1, 5.2 etc? and regardless, what users will care about is feature removals, is anything. So, I ould say this

"For a full list of features removed in Neo4j 5.0, see (link here: https://development.neo4j.dev/docs/cypher-manual/current/deprecations-additions-removals-compatibility/#_removed_features_2).

(Only 5.0 made breaking changes, more will come with the release coinciding with the release of whatever release coincides with Cypher 25).

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to check how this works in Aura. A user shouldn't have to worry about Neo4j 5, I think that from their end, they go from 4.x to latest and skip over 5. Behind the scenes, they go via 5 though. The migration readiness report will tell them what to do though.


==== Cypher syntax

All changes in the Cypher language syntax are detailed in link:https://neo4j.com/docs/cypher-manual/5/deprecations-additions-removals-compatibility[Cypher Manual -> Removals, deprecations, additions and extensions].
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That is the latest version, I believe. Check with Jens.

All changes in the Cypher language syntax are detailed in link:https://neo4j.com/docs/cypher-manual/5/deprecations-additions-removals-compatibility[Cypher Manual -> Removals, deprecations, additions and extensions].
Thoroughly review this section in the version you are moving to and make the necessary changes in your code.

Here is a short list of the main changes introduced in Neo4j 5:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, it's Neo4j latest.

=== Indexes

In Neo4j latest version, BTREE indexes are replaced by RANGE, POINT, and TEXT indexes.
Before migrating a database, in Neo4j 4, you should create a matching RANGE, POINT, or TEXT index for each BTREE index (or index-backed constraint).
Copy link
Contributor

@JPryce-Aklundh JPryce-Aklundh Apr 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How can you do this before migrating? You cant create range indexes in Neo4j 4.4?
Also, text and point indexes are not replacements of btree - they add a functionality that btree didnt have.


==== Cypher syntax

All changes in the Cypher language syntax are detailed in link:https://neo4j.com/docs/cypher-manual/5/deprecations-additions-removals-compatibility[Cypher Manual -> Removals, deprecations, additions and extensions].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cypher 5 is the latest until release of Cypher 25 later this year.

fiquick and others added 18 commits April 11, 2025 14:31
Copy link
Collaborator

@AlexicaWright AlexicaWright left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some more comments.

@@ -1,4 +1,4 @@
= Migrating your Neo4j AuraDB Free instance to another AuraDB plan
= Upgrading your AuraDB Free instance to another AuraDB plan
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a migration. You upgrade your plan, but the instance needs to be migrated.

=== Indexes

Neo4j 5 replaced b-tree indexes with link:{neo4j-docs-base-uri}/cypher-manual/current/indexes/search-performance-indexes/managing-indexes/#create-range-index[range indexes].
Before migrating a database, in Neo4j 4, you should create a matching RANGE, POINT, or TEXT index for each b-tree index (or index-backed constraint).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How is this possible?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Collaborator

@AlexicaWright AlexicaWright left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few last comments.

This guarantees that Neo4j has full rights to start and work with the database files you use.

. Stop your self-managed Neo4j database.
If you are running AuraDB Virtual Dedicated Cloud or AuraDS Enterprise, you can stop only the database you want to dump using the command `STOP DATABASE {database}` in Cypher Shell or Browser.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It says to stop your self-managed database. AuraDB VDC and AuraDS Enterprise are not self-managed. You don't want to dump your Aura db, but your self-managed db.
Is the case that you have to stop the db you want to upload to as well, then we should say so explicitly.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

. Stop your Neo4j database.
If you are running AuraDB Virtual Dedicated Cloud or AuraDS Enterprise, you can stop the database you want to dump using the command STOP DATABASE Neo4j in Cypher Shell or Browser.

Docs say "STOP DATABASE" is "Not available on Aura" in the Cypher shells docs
https://neo4j.com/docs/operations-manual/current/database-administration/standard-databases/create-databases/


=== Indexes

BTREE indexes have been replaced by RANGE, POINT, and TEXT indexes.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mayeb we should say in which version they were replaced?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"BTREE indexes were replaced by RANGE, POINT, and TEXT indexes in Neo4j v5."

@neo4j-docops-agent
Copy link
Collaborator

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants