Quick start using AWS CloudShell
This guide helps you get started quickly by using AWS CloudShell to connect to and query your Neptune cluster directly from the AWS Management Console.
Time to complete: Approximately 2 minutes
Cost: CloudShell is available at no additional charge.
Creating a Neptune cluster incurs charges.
For pricing details, see
Amazon Neptune pricing
Prerequisites
An AWS account. If you don't have one, see Setting up your AWS account.
A Neptune cluster with status Available. If you don't already have one, see Launching a Neptune DB cluster using the AWS Management Console to create one.
Step 1: Connect to your Neptune cluster
Connect to your Neptune cluster using AWS CloudShell. CloudShell automatically provisions a shell environment connected to your cluster's VPC. You don't need to configure security groups or set up notebooks to interact with the database.
To connect to your cluster
-
In the Neptune console, under Clusters, locate the cluster you created.
-
Select the check box next to your cluster.
-
Choose Connect to cluster.
Note
This button becomes active after you select the check box next to your cluster and the cluster status shows as Available.
The CloudShell Run command screen appears.
-
Choose Run to connect to the cluster. Provisioning the VPC environment takes a few seconds.
After you connect, the graphsh console appears,
providing an interactive shell for running graph queries.
Step 2: Insert and query data
Now that you are connected to your cluster, run a few queries to get familiar with Amazon Neptune. The following examples use openCypher, one of the query languages supported by Neptune.
To insert nodes and relationships
Run the following query to create two person nodes and a relationship:
CREATE (a:Person {name: 'Alice', age: 30}), (b:Person {name: 'Bob', age: 40}), (a)-[:KNOWS]->(b)
The output looks similar to the following:
╭────────╮ │ result │ ├────────┤ │ [] │ ╰────────╯
To find nodes
Run the following query to return all person names in alphabetical order:
MATCH (p:Person) RETURN p.name AS name ORDER BY name
The output looks similar to the following:
╭───────╮ │ name │ ├───────┤ │ Alice │ │ Bob │ ╰───────╯
Next steps
You have completed this quick start. To continue learning, explore the following features:
Overview of Amazon Neptune features – Learn about the key capabilities of Amazon Neptune.
Amazon Neptune Serverless – Automatically scale your cluster capacity based on workload.
Managing Your Amazon Neptune Database – Manage your clusters, instances, and configurations.
To avoid ongoing charges, delete the Neptune cluster if you created it only for this quick start. For instructions, see Managing Your Amazon Neptune Database.
