Accessing a database

With a database created, the next step is to access it.

There are a few different methods of accessing a database in Neo4j AuraDB:

  • Neo4j Browser - A browser-based interface for querying and viewing data in a database with rudimentary visualization.

  • Neo4j Bloom - A graph exploration application for visually interacting with graph data.

  • Neo4j Desktop - An installable desktop application used to manage local and cloud databases.

  • Neo4j Cypher Shell - A command-line tool used to run cypher queries against a Neo4j instance.

Tip: For first-time users, we recommend using Neo4j Browser.

Neo4j Browser

To open a database with Neo4j Browser:

  1. Navigate to the Neo4j Aura Console in your browser.

  2. Select the Open with dropdown menu on the database you want to open.

  3. Select Neo4j Browser from the dropdown menu.

  4. Enter the Username and Password credentials in the Neo4j Browser window that opens. These are the same credentials you stored when creating the database.

  5. Select Connect.

Once you have successfully connected, there are built-in guides you can complete to familiarize yourself with Neo4j Browser.

For more information on using Neo4j Browser, please see the Browser manual.

Neo4j Bloom

To open a database with Neo4j Bloom:

  1. Navigate to the Neo4j Aura Console in your browser.

  2. Select the Open with dropdown menu on the database you want to open.

  3. Select Neo4j Bloom from the dropdown menu.

  4. Enter the Username and Password credentials in the Neo4j Browser window that opens. These are the same credentials you stored when creating the database.

  5. Select Connect.

For more details on using Neo4j Bloom, please see the Neo4j Bloom documentation.

Note: Perspectives in AuraDB

Due to the nature of AuraDB’s infrastructure, it is not currently possible to share Perspectives in Bloom, as the data for a given Perspective is stored in a cookie in the user’s web browser.

An alternative is to export your Perspective as a JSON file and import it into another Bloom session.

To export a Perspective:

  1. Open the Bloom interface for your Neo4j AuraDB database.

  2. Navigate to the Perspectives Gallery.

  3. Click on the vertical ellipsis (…​) and select Export.

  4. Save the file to your local disk.

You can import perspectives by clicking the blue "Import Perspective" button in the Perspective gallery. Please note that the Perspective exposes details about your graph’s schema but not the actual data within.

For more information, see Bloom Perspectives.

Neo4j Desktop

You can connect AuraDB databases to the Neo4j Desktop application, allowing the ability to have a single portal for interacting with all instances of Neo4j, whether local or located in the cloud.

To connect to a database using Neo4j Desktop:

  1. Navigate to the Neo4j Aura Console in your browser.

  2. Copy the Connection URI of the database you want to connect to. The URI is below the database status indicator.

  3. In Neo4j Desktop, select the Projects tab and select an existing project or create a new one.

  4. Select the Add dropdown and choose Remote connection.

  5. Enter a name for the database and enter the URL from the Neo4j Aura console from the second step. Once complete, select Next.

  6. With Username/Password selected, enter your credentials and select Next. These are the same credentials you stored when creating the database.

  7. When available, activate the connection by clicking the Connect button.

Notes:

  • Neo4j Desktop only allows 1 connection at a time to a database (local or remote).

  • Deactivating an instance in Neo4j Desktop won’t shut it down or stop a remote instance - it will only temporarily close the connection to it in Neo4j Desktop.

As with other databases in Neo4j Desktop, you can install Graph Apps for monitoring and other functionality.

To do this, follow the same process to install the graph application you need, and open it from Neo4j Desktop or a web browser with the running and activated Neo4j AuraDB instance.

Neo4j Cypher Shell

You can connect to an AuraDB database using the Neo4j Cypher Shell command-line interface (CLI) and run cypher commands against your database from the command-line.

To connect to a database using Neo4j Cypher Shell:

  1. Navigate to the Neo4j Aura Console in your browser.

  2. Copy the Connection URI of the database you want to connect to. The URI is below the database status indicator.

  3. Open a terminal and navigate to the folder where you have installed Cypher Shell.

  4. Run the following cypher-shell command replacing:

    • <connection_uri> with the URI you copied in step 2.

    • <username> with the username for your database.

    • <password> with the password for your database.

      ./cypher-shell -a <connection_uri> -u <username> -p <password>

Once connected, you can run :help for a list of available commands.

Available commands:
  :begin    Open a transaction
  :commit   Commit the currently open transaction
  :exit     Exit the logger
  :help     Show this help message
  :history  Print a list of the last commands executed
  :param    Set the value of a query parameter
  :params   Print all currently set query parameters and their values
  :rollback Rollback the currently open transaction
  :source   Interactively executes cypher statements from a file
  :use      Set the active database

For help on a specific command type:
    :help command

For more information on Cypher Shell, including how to install it, please see the Cypher Shell documentation.