Skip to content

Commit fce50a8

Browse files
committed
include section about constituent names
1 parent 5fb0c7e commit fce50a8

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

modules/ROOT/pages/values-and-types/graph-references.adoc

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
11
= Graph references
22
:description: Information about Cypher's graph reference values.
33

4-
Graph references are values used to specify which graph to operate on in a query.
5-
They are principally used with the xref:clauses/use.adoc[`USE`] clause and xref:functions/graph.adoc[graph functions], such as `graph.byName()`.
4+
Graph references are values used to specify which graph is targeted in a query.
5+
They are principally used with the xref:clauses/use.adoc[`USE`] clause, xref:functions/graph.adoc[graph functions], such as `graph.byName()` and when referring to databases and aliases in administration commands.
6+
7+
The output of the name column in `SHOW DATABASES` and `SHOW ALIASES FOR DATABASE` can be used as an identifier when referring to a specific graph references.
8+
9+
When referring to a constituent in a composite database, the identifier is defined as <composite-name>.<alias-name>, where the dot functions as a separator between the composite database name and the alias name. While we do not recommend creating databases or aliases containing dots, it is possible to refer to the alias `some.alias` in the composite `some.composite` as `some.composite.some.alias`.
610

711
[[static-graph-references]]
812
== Static graph references
@@ -32,7 +36,7 @@ The following rules apply for graph references when using identifiers (static gr
3236

3337
* Graph references passed as identifiers such as `USE <graph-reference>` apply the escaping rules of xref::syntax/naming.adoc#symbolic-names-escaping-rules[symbolic names]. Graph names can either be unquoted or need to be quoted in its entirety, e.g. `USE neo4j` or `USE `db-with-dash``.
3438

35-
* Graph references passed as graph functions such as `USE graph.byName(<graph-reference>)` apply the escaping rules of xref:values-and-types/boolean-numeric-string.adoc#string-literal-escape-sequences[string literals]. Note that quotes are considered as part of the name, e.g. `USE graph.byName('`db-with-dash`') would try to resolve the graph reference ``db-with-dash``.
39+
* Graph references passed as graph functions such as `USE graph.byName(<graph-reference>)` apply the escaping rules of xref:values-and-types/boolean-numeric-string.adoc#string-literal-escape-sequences[string literals]. Note that quotes are considered as part of the name, e.g. `USE graph.byName('`db-with-dash`')` would try to resolve the graph reference ``db-with-dash``.
3640

3741

3842
For example, the graph reference `db-with-dash` can be passed as:

0 commit comments

Comments
 (0)