Review of the page Comparing relational to graph database #497

lidiazuin · 2025-09-25T13:26:34Z

No description provided.

AlexicaWright

Nice and concise! I left some comments :)

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

AlexicaWright · 2025-09-26T08:28:25Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

-The data stays remarkably similar to its form in the real world - small, normalized, yet richly connected entities.
-This allows you to query and view your data from any imaginable point of interest, supporting many different use cases.
+By assembling nodes and relationships into connected structures, graph databases enable building models that map closely to a problem domain.
+Each node contains relationships to other nodes, and these relationship are organized by type and direction, holding or not additional attributes.


I'm not sure I understand this sentence? Nodes don't contain the actual relationships to other nodes and both nodes and relationships can have properties, if that's what "attributes" here refers to.

AlexicaWright · 2025-09-26T08:54:27Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

-Each node (entity or attribute) in the graph database model directly and physically contains a list of relationship records that represent the relationships to other nodes.
-These relationship records are organized by type and direction and may hold additional attributes.
-Whenever you run the equivalent of a _JOIN_ operation, the graph database uses this list, directly accessing the connected nodes and eliminating the need for expensive search-and-match computations.
+Whenever you run xref:cypher-intro/cypher-sql.adoc[the equivalent of a `JOIN` operation], the graph database uses these relationships, directly accessing the connected nodes and eliminating the need for expensive search-and-match computations.


I'm not sure if this simplification is technically accurate, or whether it actually matters? To be safe, I'd just use the original.

AlexicaWright · 2025-09-26T08:56:47Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc


-As you can probably imagine from the structural differences discussed above, the data models for relational versus graph are very different.
-The straightforward graph structure results in much simpler and more expressive data models than those produced using traditional relational or other NoSQL databases.
+If you are familiar with the relational data model that has tables, columns, relationship cardinalities, and other components, graph data modeling will not seem entirely foreign.


But the models are very different?

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

AlexicaWright · 2025-09-26T09:20:46Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

+In Cypher, the syntax remains concise and focused on domain components and their connections, thus expressing the pattern to find or create data more visually and clearly.
+
+Other clauses outside of the basic pattern matching still look very similar to SQL, as Cypher was built on the predecessor language’s foundation. 
+You can see the similarities and differences in 


Is there a missing link here?

AlexicaWright · 2025-09-26T09:20:54Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

+
+Other clauses outside of the basic pattern matching still look very similar to SQL, as Cypher was built on the predecessor language’s foundation. 
+You can see the similarities and differences in 
+If you want to learn how to move your data from a relational database to a graph, see 


Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

AlexicaWright

Some more suggestions!

AlexicaWright · 2025-09-26T11:55:10Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

-These relationship records are organized by type and direction and may hold additional attributes.
-Whenever you run the equivalent of a _JOIN_ operation, the graph database uses this list, directly accessing the connected nodes and eliminating the need for expensive search-and-match computations.
+By assembling nodes and relationships into connected structures, graph databases enable building models that map closely to a problem domain.
+Whenever you run xref:cypher-intro/cypher-sql.adoc[the equivalent of a `JOIN` operation], the graph database uses this list, directly accessing the connected nodes and eliminating the need for expensive search-and-match computations.


But now the list doesn't refer to anything, since it hasn't been defined.

AlexicaWright · 2025-09-26T11:57:01Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc


-As you can probably imagine from the structural differences discussed above, the data models for relational versus graph are very different.
-The straightforward graph structure results in much simpler and more expressive data models than those produced using traditional relational or other NoSQL databases.
+Despite similarities, the design of a xref:data-modeling/index.adoc[graph data model] still needs to be based upon requirements for access, queries, performance expectation, and business logic.


But no similarities have been mentioned?

How about something like:
The data models for relational databases and graph databases are vastly different, as a result of the structural differences described earlier/previously/above.
The graph model needs to consider access requirements, expected queries and performance, as well as business logic.

This still applies, no similarities are mentioned, only differences.

Ah sorry, I forgot to update this one

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

AlexicaWright · 2025-09-26T12:02:32Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

+By assembling nodes and relationships into connected structures, graph databases enable building models that map closely to a problem domain.
+Whenever you run xref:cypher-intro/cypher-sql.adoc[the equivalent of a `JOIN` operation], the graph database uses this list, directly accessing the connected nodes and eliminating the need for expensive search-and-match computations.

 This ability to pre-materialize relationships into the database structure allows Neo4j to provide performance of several orders of magnitude above others, especially for join-heavy queries, allowing users to leverage a _minutes to milliseconds_ advantage.


Also, the youtube video is NINE years old, maybe there is something slightly more updated we could use?

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

AlexicaWright

Left some more comments, I know you love them ;)

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

AlexicaWright · 2025-09-30T09:49:57Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc


-In the above relational example, we search the Person table on the left (potentially millions of rows) to find the user Alice and her person ID of 815. Then, we search the Person-Department table (orange middle table) to locate all the rows that reference Alice's person ID (815). Once we retrieve the 3 relevant rows, we go to the Department table on the right to search for the actual values of the department IDs (111, 119, 181).
-Now we know that Alice is part of the 4Future, P0815, and A42 departments.
+. Search the `Employees` table (potentially with millions of rows) to find the user Alice and her ID of 815. 


Millions of rows? What company has millions of employees?

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

AlexicaWright

Looks good! One broken link and one comment to address.

AlexicaWright · 2025-10-07T08:12:01Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc


-As you can probably imagine from the structural differences discussed above, the data models for relational versus graph are very different.
-The straightforward graph structure results in much simpler and more expressive data models than those produced using traditional relational or other NoSQL databases.
+Despite similarities, the design of a xref:data-modeling/index.adoc[graph data model] still needs to be based upon requirements for access, queries, performance expectation, and business logic.


This still applies, no similarities are mentioned, only differences.

AlexicaWright · 2025-10-07T08:19:02Z

modules/ROOT/pages/appendix/graphdb-concepts/graphdb-vs-rdbms.adoc

+In Cypher, the syntax remains concise and focused on domain components and their connections, thus expressing the pattern to find or create data more visually and clearly.
+
+Other clauses outside of the basic pattern matching still look very similar to SQL, as Cypher was built on the predecessor language’s foundation. 
+You can see the similarities and differences in ref:/cypher-intro/cypher-sql.adoc[Comparing Cypher with SQL].


Suggested change

You can see the similarities and differences in ref:/cypher-intro/cypher-sql.adoc[Comparing Cypher with SQL].

You can see the similarities and differences in xref:/cypher-intro/cypher-sql.adoc[Comparing Cypher with SQL].

neo4j-docops-agent · 2025-10-07T12:46:07Z

Thanks for the documentation updates.

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

AlexicaWright

Looks great! Thanks @lidiazuin 👍

* Review of the page Comparing relational to graph database * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * Fixes after review * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * fixes after review * updated package log * updated package-lock * fixes after review --------- Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

* Review of the page Comparing relational to graph database (#497) * Review of the page Comparing relational to graph database * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * Fixes after review * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * fixes after review * updated package log * updated package-lock * fixes after review --------- Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com> * fixing issues --------- Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

Review of the page Comparing relational to graph database

9baf2e2

lidiazuin added the cherry-pick-this-to-main label Sep 25, 2025

Merge branch 'dev' into transition-rel2graph

0f4e823

lidiazuin requested a review from AlexicaWright September 26, 2025 08:40

AlexicaWright reviewed Sep 26, 2025

View reviewed changes

lidiazuin and others added 2 commits September 26, 2025 11:27

Apply suggestions from code review

8fba6e1

Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

Fixes after review

416124a

AlexicaWright reviewed Sep 29, 2025

View reviewed changes

Apply suggestions from code review

ff913cb

Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

AlexicaWright reviewed Sep 30, 2025

View reviewed changes

lidiazuin and others added 2 commits September 30, 2025 13:10

Apply suggestions from code review

01bf2dc

Co-authored-by: Jessica Wright <49636617+AlexicaWright@users.noreply.github.com>

fixes after review

24360d8

lidiazuin requested a review from AlexicaWright October 2, 2025 09:36

lidiazuin added 2 commits October 3, 2025 10:41

updated package log

9567533

updated package-lock

fa354ac

AlexicaWright reviewed Oct 7, 2025

View reviewed changes

fixes after review

c600842

AlexicaWright approved these changes Oct 7, 2025

View reviewed changes

lidiazuin merged commit d2d468d into neo4j:dev Oct 7, 2025
5 checks passed

lidiazuin deleted the transition-rel2graph branch October 7, 2025 12:54

lidiazuin mentioned this pull request Oct 7, 2025

Review of the page Comparing relational to graph database (#497) #498

Merged

	You can see the similarities and differences in ref:/cypher-intro/cypher-sql.adoc[Comparing Cypher with SQL].
	You can see the similarities and differences in xref:/cypher-intro/cypher-sql.adoc[Comparing Cypher with SQL].

Review of the page Comparing relational to graph database #497

Review of the page Comparing relational to graph database #497

Uh oh!

Conversation

lidiazuin commented Sep 25, 2025

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

neo4j-docops-agent commented Oct 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AlexicaWright left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

neo4j-docops-agent commented Oct 7, 2025 •

edited

Loading