Visualizations

A visualization is embedded in a dashboard card. Visualizations have different types, each of which expects different types of data.

Queries

Each visualization uses a Cypher query which is specified in the dashboard card to retrieve data from your Neo4j database and display it.

Edit the card by using the more menu […​] at the top right of a card and then Edit card.

In the Query tab of the card, you can either use Natural language to generate a query or write your own Cypher query.

Natural language

When using Natural language, you can either write your own statement or question, or select from a number of Suggested prompts or Recent prompts.

visualization natural language
Figure 1. Using natural language to create a visualization

When creating a card with natural language, an AI analyzes your database schema, that is, the node labels and relationship types of your database. It cannot read the actual data in your database.

Examples

To create a bar chart which displays the number of orders per customer:

  1. Use Add card at the bottom right of the page.

  2. In the new card, select Bar chart from the chart type drop-down at the top right.

  3. Select the Natural language tab at the top and paste the following prompt, then Generate:

Create a bar chart which displays the number of orders per customer. Use the contact name of the customer. Limit the results to 10.

To create a line chart which displays the number of product categories by order dates:

In the dashboard page tab:

  1. Use Add card at the bottom right of the page.

  2. In the new card, select Line chart from the chart type drop-down at the top right.

  3. Select the Natural language tab at the top and paste the following prompt, then Generate:

    Create a line chart which displays the number of product categories per order, by the order date. Limit the results to 20.

Writing natural language instructions

Here is what you can do to improve the results of natural language statements or questions:

  • Be explicit about nodes and relationships. Use the exact node labels and relationship types you want to query.

  • State the direction of relationships. "Orders ordering a product" is directional while "ordered products" is less so.

  • Specify properties and filters. Mention the exact property and qualifier, such as "orders ordered after september 1996" or "…​ where the product caterogy is 'produce'".

  • Define return values: names, counts, relationships, or paths, such as "return the product name" or "return the product units in stock".

Cypher

visualization cypher
Figure 2. Using Cypher to create a visualization

Cypher syntax is generally supported, see Cypher and Aura and Query data.

Keep the following best practices in mind when writing your Cypher queries:

  1. Use a LIMIT clause in your query to keep the result size manageable.

  2. Ensure that you return the correct data types for the correct visualization type.

Recent lists your latest queries.