From 891062269404a9666e3db83b756ba7aeeabf1947 Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Tue, 21 Feb 2023 11:49:51 +0100 Subject: [PATCH 1/6] first update --- modules/ROOT/content-nav.adoc | 2 + modules/ROOT/pages/aura-and-cypher/index.adoc | 39 +++++++++++++++++++ 2 files changed, 41 insertions(+) create mode 100644 modules/ROOT/pages/aura-and-cypher/index.adoc diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc index e3a260fbd..1bf753884 100644 --- a/modules/ROOT/content-nav.adoc +++ b/modules/ROOT/content-nav.adoc @@ -7,6 +7,8 @@ ** xref:introduction/uniqueness.adoc[] ** xref:introduction/clause_composition.adoc[] +* xref:aura-and-cypher/index.adoc[] + * xref:syntax/index.adoc[] ** xref:syntax/values.adoc[] ** xref:syntax/naming.adoc[] diff --git a/modules/ROOT/pages/aura-and-cypher/index.adoc b/modules/ROOT/pages/aura-and-cypher/index.adoc new file mode 100644 index 000000000..57bcf4316 --- /dev/null +++ b/modules/ROOT/pages/aura-and-cypher/index.adoc @@ -0,0 +1,39 @@ += Aura and Cypher + +== Introduction + +Aura is Neo4j's fully managed cloud service. +It consists of AuraDB and AuraDS. +AuraDB is a graph database service for developers building intelligent applications, and AuraDS is a graph data science service for data scientists building predictive models and workflows. + +AuraDB is available on three tiers: AuraDB Free, AuraDB Pro, and AuraDB Enterprise. +For more information, see link:{neo4j-docs-base-uri}/aura/auradb[Aura docs - Neo4j AuraDB overview]. + +AuraDS is available on two tiers: AuraDS Pro and AuraDS Enterprise. +For more information, see link:{neo4j-docs-base-uri}/aura/aurads[Aura docs - Neo4j AuraDS overview] + +== Using Cypher on Aura + +Most Cypher clauses are available on all tiers of Aura. +There are, however, some clauses which are not possible to run on any Aura instance. +For example, it is not possible to create, alter or drop databases using Aura, nor is it possible to alter or drop servers. + +There are also certain features of Cypher which are only available on AuraDB Enterprise. +These fall under the role-based access clauses of Cypher. +For example, it is possible to create and drop roles using Aura DB Enterprise, but not using any other tier of Aura. + +The Cypher Manual uses two different labels to differentiate this distinction: + +[options="header,cols=""2a,2a"] +|=== +| Label | Description +| label:not-on-aura[Not available on Aura] | Cypher feature not available on any tier of Aura. +| label:aura-db-enterprise[AuraDB Enterprise] | Cypher feature only available on AuraDB Enterprise. +|=== + +== Aura and the Cypher Cheat Sheet + +Each different tier of Aura has a customized version of the Cypher Cheat Sheet which only shows the features of Cypher available for the chosen tier. + +The Aura Cheat Sheet can be accessed here. +Note that the default tier is AuraDB Enterprise. From 643da3c3954694fc6a428af0822af5e1f23218cc Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Wed, 22 Feb 2023 09:24:01 +0100 Subject: [PATCH 2/6] second update --- modules/ROOT/pages/aura-and-cypher/index.adoc | 17 +++++++++++------ modules/ROOT/pages/databases.adoc | 2 +- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/modules/ROOT/pages/aura-and-cypher/index.adoc b/modules/ROOT/pages/aura-and-cypher/index.adoc index 57bcf4316..24729a1bb 100644 --- a/modules/ROOT/pages/aura-and-cypher/index.adoc +++ b/modules/ROOT/pages/aura-and-cypher/index.adoc @@ -4,7 +4,7 @@ Aura is Neo4j's fully managed cloud service. It consists of AuraDB and AuraDS. -AuraDB is a graph database service for developers building intelligent applications, and AuraDS is a graph data science service for data scientists building predictive models and workflows. +AuraDB is a graph database service for developers building intelligent applications, and AuraDS is a graph data science service for data scientists building predictive models and analytics workflows. AuraDB is available on three tiers: AuraDB Free, AuraDB Pro, and AuraDB Enterprise. For more information, see link:{neo4j-docs-base-uri}/aura/auradb[Aura docs - Neo4j AuraDB overview]. @@ -19,21 +19,26 @@ There are, however, some clauses which are not possible to run on any Aura insta For example, it is not possible to create, alter or drop databases using Aura, nor is it possible to alter or drop servers. There are also certain features of Cypher which are only available on AuraDB Enterprise. -These fall under the role-based access clauses of Cypher. -For example, it is possible to create and drop roles using Aura DB Enterprise, but not using any other tier of Aura. +These can be categorized as the role-based access clauses of Cypher. +For example, it is not possible to create and drop roles using AuraDB Free, AuraDB Pro, AuraDS Pro, or AuraDS Enterprise, but it is possible using AuraDB Enterprise. The Cypher Manual uses two different labels to differentiate this distinction: +[role=not-on-aura] [options="header,cols=""2a,2a"] |=== | Label | Description -| label:not-on-aura[Not available on Aura] | Cypher feature not available on any tier of Aura. -| label:aura-db-enterprise[AuraDB Enterprise] | Cypher feature only available on AuraDB Enterprise. +| label:not-on-aura[] | Cypher feature not available on any tier of Aura. +| label:aura-db-enterprise[] | Cypher feature only available on AuraDB Enterprise. |=== +//// +TODO: remove comment blocks once Aura Cheat Sheet has been published. + == Aura and the Cypher Cheat Sheet Each different tier of Aura has a customized version of the Cypher Cheat Sheet which only shows the features of Cypher available for the chosen tier. -The Aura Cheat Sheet can be accessed here. +The Aura Cheat Sheet can be accessed here: //Add url when available Note that the default tier is AuraDB Enterprise. +//// diff --git a/modules/ROOT/pages/databases.adoc b/modules/ROOT/pages/databases.adoc index 0e78c7f87..87d9bd06f 100644 --- a/modules/ROOT/pages/databases.adoc +++ b/modules/ROOT/pages/databases.adoc @@ -912,7 +912,7 @@ SHOW DATABASE customers YIELD name, requestedStatus, currentStatus ====== -[role=enterprise-edition] +[role=enterprise-edition not-on-aura] [[administration-databases-start-database]] == Starting databases From b87a22f4a5afcd6a48c9646a69bbee23abdabdc3 Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Wed, 22 Feb 2023 09:43:52 +0100 Subject: [PATCH 3/6] update three --- modules/ROOT/pages/aura-and-cypher/index.adoc | 12 ++++++------ modules/ROOT/pages/databases.adoc | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/modules/ROOT/pages/aura-and-cypher/index.adoc b/modules/ROOT/pages/aura-and-cypher/index.adoc index 24729a1bb..b681d6039 100644 --- a/modules/ROOT/pages/aura-and-cypher/index.adoc +++ b/modules/ROOT/pages/aura-and-cypher/index.adoc @@ -14,13 +14,13 @@ For more information, see link:{neo4j-docs-base-uri}/aura/aurads[Aura docs - Neo == Using Cypher on Aura -Most Cypher clauses are available on all tiers of Aura. -There are, however, some clauses which are not possible to run on any Aura instance. -For example, it is not possible to create, alter or drop databases using Aura, nor is it possible to alter or drop servers. +Most Cypher features are available on all tiers of Aura. +There are, however, some features which are not available on any Aura instance. +For example, it is not possible to create, alter, or drop databases using Aura, nor is it possible to alter or drop servers. -There are also certain features of Cypher which are only available on AuraDB Enterprise. -These can be categorized as the role-based access clauses of Cypher. -For example, it is not possible to create and drop roles using AuraDB Free, AuraDB Pro, AuraDS Pro, or AuraDS Enterprise, but it is possible using AuraDB Enterprise. +There are also certain Cypher features which are only available on AuraDB Enterprise. +These can be categorized as the role-based access-control features of Cypher. +For example, it is not possible to create, alter, or drop roles using AuraDB Free, AuraDB Pro, AuraDS Pro, or AuraDS Enterprise, but it is possible using AuraDB Enterprise. The Cypher Manual uses two different labels to differentiate this distinction: diff --git a/modules/ROOT/pages/databases.adoc b/modules/ROOT/pages/databases.adoc index 87d9bd06f..0e78c7f87 100644 --- a/modules/ROOT/pages/databases.adoc +++ b/modules/ROOT/pages/databases.adoc @@ -912,7 +912,7 @@ SHOW DATABASE customers YIELD name, requestedStatus, currentStatus ====== -[role=enterprise-edition not-on-aura] +[role=enterprise-edition] [[administration-databases-start-database]] == Starting databases From cb9a962f09e294025d6731e065140c28a43333d8 Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Wed, 22 Feb 2023 10:27:22 +0100 Subject: [PATCH 4/6] relocate to introduction --- modules/ROOT/content-nav.adoc | 3 +-- .../{aura-and-cypher/index.adoc => introduction/aura.adoc} | 1 - 2 files changed, 1 insertion(+), 3 deletions(-) rename modules/ROOT/pages/{aura-and-cypher/index.adoc => introduction/aura.adoc} (99%) diff --git a/modules/ROOT/content-nav.adoc b/modules/ROOT/content-nav.adoc index 1bf753884..9e920a6cf 100644 --- a/modules/ROOT/content-nav.adoc +++ b/modules/ROOT/content-nav.adoc @@ -6,8 +6,7 @@ ** xref:introduction/transactions.adoc[] ** xref:introduction/uniqueness.adoc[] ** xref:introduction/clause_composition.adoc[] - -* xref:aura-and-cypher/index.adoc[] +** xref:introduction/aura.adoc[] * xref:syntax/index.adoc[] ** xref:syntax/values.adoc[] diff --git a/modules/ROOT/pages/aura-and-cypher/index.adoc b/modules/ROOT/pages/introduction/aura.adoc similarity index 99% rename from modules/ROOT/pages/aura-and-cypher/index.adoc rename to modules/ROOT/pages/introduction/aura.adoc index b681d6039..38ee1aaf7 100644 --- a/modules/ROOT/pages/aura-and-cypher/index.adoc +++ b/modules/ROOT/pages/introduction/aura.adoc @@ -24,7 +24,6 @@ For example, it is not possible to create, alter, or drop roles using AuraDB Fre The Cypher Manual uses two different labels to differentiate this distinction: -[role=not-on-aura] [options="header,cols=""2a,2a"] |=== | Label | Description From 73a991c92cb614bc2027185766a91b10cbfa1972 Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Wed, 22 Feb 2023 13:31:08 +0100 Subject: [PATCH 5/6] post-review update --- modules/ROOT/pages/introduction/aura.adoc | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/introduction/aura.adoc b/modules/ROOT/pages/introduction/aura.adoc index 38ee1aaf7..1b56264cf 100644 --- a/modules/ROOT/pages/introduction/aura.adoc +++ b/modules/ROOT/pages/introduction/aura.adoc @@ -4,12 +4,21 @@ Aura is Neo4j's fully managed cloud service. It consists of AuraDB and AuraDS. -AuraDB is a graph database service for developers building intelligent applications, and AuraDS is a graph data science service for data scientists building predictive models and analytics workflows. +AuraDB is a graph database service for developers building intelligent applications, and AuraDS is a Graph Data Science (GDS) service for data scientists building predictive models and analytics workflows. + +AuraDB is available on the following tiers: + +* AuraDB Free +* AuraDB Pro +* AuraDB Enterprise -AuraDB is available on three tiers: AuraDB Free, AuraDB Pro, and AuraDB Enterprise. For more information, see link:{neo4j-docs-base-uri}/aura/auradb[Aura docs - Neo4j AuraDB overview]. -AuraDS is available on two tiers: AuraDS Pro and AuraDS Enterprise. +AuraDS is available on the following tiers: + +* AuraDS Pro +* AuraDS Enterprise + For more information, see link:{neo4j-docs-base-uri}/aura/aurads[Aura docs - Neo4j AuraDS overview] == Using Cypher on Aura From 19a935571337b999ceb40e1ee80084490450c244 Mon Sep 17 00:00:00 2001 From: JPryce-Aklundh Date: Wed, 22 Feb 2023 16:28:17 +0100 Subject: [PATCH 6/6] post-review corrections --- modules/ROOT/pages/introduction/aura.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/introduction/aura.adoc b/modules/ROOT/pages/introduction/aura.adoc index 1b56264cf..449df071e 100644 --- a/modules/ROOT/pages/introduction/aura.adoc +++ b/modules/ROOT/pages/introduction/aura.adoc @@ -24,10 +24,10 @@ For more information, see link:{neo4j-docs-base-uri}/aura/aurads[Aura docs - Neo == Using Cypher on Aura Most Cypher features are available on all tiers of Aura. -There are, however, some features which are not available on any Aura instance. +There are, however, some features which are not available to Aura instances. For example, it is not possible to create, alter, or drop databases using Aura, nor is it possible to alter or drop servers. -There are also certain Cypher features which are only available on AuraDB Enterprise. +There are also certain Cypher features which are only available on AuraDB Enterprise instances. These can be categorized as the role-based access-control features of Cypher. For example, it is not possible to create, alter, or drop roles using AuraDB Free, AuraDB Pro, AuraDS Pro, or AuraDS Enterprise, but it is possible using AuraDB Enterprise.