You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/modules/ROOT/pages/graph-analytics-serverless.adoc
+14-11Lines changed: 14 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ There are three types of GDS Sessions:
15
15
16
16
The process of populating the session with data is called _remote projection_.
17
17
Once populated, a GDS Session can run GDS workloads, such as algorithms and machine learning models.
18
-
Results from these computations can be written back to the original source, using _remote write-back_ in the Attached and Self-managed flavours.
18
+
Results from these computations can be written back to the original source, using _remote write-back_ in the Attached and Self-managed types.
19
19
20
20
TIP: For ready-to-run notebooks, see our tutorials on GDS Sessions for xref:tutorials/graph-analytics-serverless.adoc[AuraDB] and xref:tutorials/graph-analytics-serverless-self-managed[self-managed databases].
21
21
@@ -95,9 +95,9 @@ sessions.get_or_create(
95
95
| Name | Type | Optional | Default | Description
96
96
| session_name | str | no | - | Name of the session. Must be unique within the project.
97
97
| memory | SessionMemory | no | - | Amount of memory available to the session. https://neo4j.com/docs/graph-data-science-client/{docs-version}/api/sessions/session_memory[Supported values].
98
-
| db_connection | DbmsConnectionInfo | yes | None | Bolt server URL, username, and password to a Neo4j DBMS. Required for the Attached and Self-managed flavours.
98
+
| db_connection | DbmsConnectionInfo | yes | None | Bolt server URL, username, and password to a Neo4j DBMS. Required for the Attached and Self-managed types.
99
99
| ttl | datetime.timedelta | yes | 1h | Time-to-live for the session.
100
-
| cloud_location| CloudLocation | yes | None | Aura-supported cloud provider and region where the GDS Session will run. Required for the Self-managed and Standalone flavours.
100
+
| cloud_location| CloudLocation | yes | None | Aura-supported cloud provider and region where the GDS Session will run. Required for the Self-managed and Standalone types.
101
101
| timeout | int | yes | None | Seconds to wait for the session to enter Ready state. If the time is exceeded, an error will be returned.
102
102
|===
103
103
@@ -502,9 +502,10 @@ For a full list of the available algorithms, see the https://neo4j.com/docs/grap
502
502
503
503
== Remote write-back
504
504
505
-
The GDS Session's in-memory graph was projected from data in AuraDB, so write-back operations will persist the data back to the same AuraDB instance.
506
-
When calling any write operations, the GDS Python client will automatically use the remote write-back functionality.
507
-
This includes all `.write` algorithm modes as well as all `.write` graph operations.
505
+
Persisting the results of a computation done in a GDS Session differs by the session's type.
506
+
Attached and Self-managed sessions come with built-in support for writing back algorithms results to the same Neo4j DB where the graph was projected from.
507
+
Users of Standalone sessions have to stream the results back to the client and the user has to persist it in their target system.
508
+
This section will illustrate the built-in remote write-back capability.
508
509
509
510
By default, write back will happen concurrently, in one transaction per batch.
510
511
The behaviour is controlled by three aspects:
@@ -516,7 +517,9 @@ The behaviour is controlled by three aspects:
516
517
517
518
=== Syntax
518
519
519
-
[.tabbed-example, caption = asd]
520
+
The syntax for remote write-back is identical for Attached and Self-managed sessions.
521
+
522
+
[.tabbed-example, caption = ]
520
523
====
521
524
[.include-with-graph-operation]
522
525
======
@@ -533,7 +536,7 @@ gds.graph.<operation>.write(
533
536
534
537
[.include-with-algorithm-write-mode]
535
538
======
536
-
.Remote graph write-back:
539
+
.Remote algorithm write-back:
537
540
[source, role=no-test]
538
541
----
539
542
gds.<algo>.write(
@@ -565,7 +568,7 @@ All write-back endpoints support the following additional configuration:
565
568
566
569
=== Examples
567
570
568
-
Extending the previous example, we can write back the FastRP embeddings to the AuraDB instance as follows:
571
+
Extending the previous example, we can write back the FastRP embeddings to the Neo4j DB as follows:
569
572
570
573
.Write mutated FastRP embeddings back to the database:
571
574
[source,python,role=no-test]
@@ -590,8 +593,8 @@ gds.wcc.write(
590
593
591
594
== Querying the database
592
595
593
-
You can run Cypher queries on the AuraDB instance using the `run_cypher()` method.
594
-
There is no restriction on the type of query that can be run, but it is important to note that the query will be run on the AuraDB instance, and not on the GDS Session.
596
+
You can run Cypher queries on the Neo4j DB using the `run_cypher()` method.
597
+
There is no restriction on the type of query that can be run, but it is important to note that the query will be run on the Neo4j DB, and not on the GDS Session.
595
598
Therefore, you will not be able to call any GDS procedures from the `run_cypher()` method.
596
599
597
600
.Run a Cypher query to find our written-back embeddings:
0 commit comments