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: modules/ROOT/pages/authentication-authorization/dbms-administration.adoc
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2069,9 +2069,9 @@ In this case, `+*+` means 0 or more characters, and `?` matches exactly one char
2069
2069
====
2070
2070
The name-globbing is subject to the link:{neo4j-docs-base-uri}/cypher-manual/{page-version}/syntax/naming/[Cypher Manual -> Naming rules and recommendations], with the exception that it may include dots, stars, and question marks without the need for escaping using backticks.
2071
2071
2072
-
Each part of the name-globbing separated by dots may be individually escaped.
2072
+
Each part of the name-globbing separated by dots may be individually quoted.
2073
2073
For example, `++mine.`procedureWith%`++` is allowed, but not `++mine.procedure`With%`++`.
2074
-
Also, note that wildcard characters behave as wildcards even when escaped.
2074
+
Also, note that wildcard characters behave as wildcards even when quoted.
2075
2075
For example, using `++`*`++` is equivalent to using `+*+`, and thus allows executing all functions or procedures and not only the procedure or function named `+*+`.
2076
2076
====
2077
2077
@@ -2134,7 +2134,7 @@ Users with the role `globbing6` can run procedures `mine.public.with#Special§Ch
2134
2134
2135
2135
[NOTE]
2136
2136
====
2137
-
The name-globbing may be fully or partially escaped.
2137
+
The name-globbing may be fully or partially quoted.
2138
2138
Both `+*+` and `+?+` are interpreted as wildcards in both cases.
Naming database aliases in composite databases follows the same rule as xref:database-administration/aliases/naming-aliases.adoc[naming aliases for standard databases].
217
217
However, when it comes to escaping names using backticks, there are some additional things to consider:
218
218
219
-
=== Escaping database alias and composite database names
219
+
=== Quoting database alias and composite database names
220
220
221
-
The composite database name and the database alias name need to be escaped individually.
221
+
The composite database name and the database alias name need to be quoted individually.
222
222
Backticks may be added regardless of whether the name contains special characters or not, so it is good practice to always backtick both names, e.g. `++`composite`++.++`alias`++`.
223
223
224
224
The following example creates a database alias named `my alias with spaces` as a constituent in the composite database named `my-composite-database-with-dashes`:
CREATE ALIAS `my-composite-database-with-dashes`.`my alias with spaces` FOR DATABASE `northwind-graph`
237
237
----
238
238
239
-
When not escaped individually, a database alias with the full name `my alias with.dots and spaces` gets created instead:
239
+
When not quoted individually, a database alias with the full name `my alias with.dots and spaces` gets created instead:
240
240
241
241
.Query
242
242
[source, cypher]
@@ -249,7 +249,7 @@ CREATE ALIAS `my alias with.dots and spaces` FOR DATABASE `northwind-graph`
249
249
//Examples where dots are not separators between composite name and alias name are impossible to test, because the right escaping cannot be inferred automatically.
250
250
251
251
Database alias names may also include dots.
252
-
Though these always need to be escaped in order to avoid ambiguity with the composite database and database alias split character.
252
+
Though these always need to be quoted in order to avoid ambiguity with the composite database and database alias split character.
253
253
254
254
.Query
255
255
[source, cypher, role=test-skip]
@@ -279,7 +279,7 @@ CREATE ALIAS some.alias FOR DATABASE `northwind-graph`
279
279
280
280
=== Handling parameters
281
281
282
-
When using parameters, names cannot be escaped.
282
+
When using parameters, names cannot be quoted.
283
283
When the given parameter includes dots, the first dot will be considered the divider for the composite database.
284
284
285
285
Consider the query with parameter:
@@ -315,7 +315,7 @@ Consider the same query but with the following parameter:
315
315
Since the first dot will be used as a divider, the command will attempt to create the database alias `withdot.myalias` in the composite database `mycompositedatabase`.
316
316
If `mycompositedatabase` does not exist, the command will create a database alias with the name `mycompositedatabase.withdot.myalias`, which is not part of any composite database.
317
317
318
-
In these cases, it is recommended to avoid parameters and explicitly escape the composite database name and alias name separately to avoid ambiguity.
318
+
In these cases, it is recommended to avoid parameters and explicitly quote the composite database name and alias name separately to avoid ambiguity.
319
319
320
320
=== Handling parameters
321
321
@@ -356,4 +356,4 @@ Failed to delete the specified database alias 'foo.bar': Database alias does not
356
356
357
357
Had the composite database `foo` not existed, the database alias `foo.bar` would have been dropped.
358
358
359
-
In these cases, it is recommended to avoid parameters and explicitly escape the composite database name and alias name separately to avoid ambiguity.
359
+
In these cases, it is recommended to avoid parameters and explicitly quote the composite database name and alias name separately to avoid ambiguity.
Copy file name to clipboardExpand all lines: modules/ROOT/pages/database-administration/standard-databases/naming-databases.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,7 +19,7 @@ Naming rules for databases are as follows:
19
19
The `-` (dash) and `.` (dot) characters are not legal in Cypher variables.
20
20
Names with a `-` in them must be enclosed within backticks.
21
21
For example, `CREATE DATABASE ++`main-db`++` is a valid database name.
22
-
Database names are the only identifier for which dots do not need to be escaped.
22
+
Database names are the only identifier for which dots do not need to be quoted.
23
23
For example `main.db` is a valid database name.
24
24
However, this behavior is deprecated due to the difficulty of determining if a dot is part of the database name or a delimiter for a database alias in a composite database.
0 commit comments