Graph Connections

Required Permission: Settings management (Read more about Permissions)

Table of Contents

Graph connection represents a single neo4j database, that a user can be connected to.

It is possible to create multiple graph connections, but only a single graph connection can be used (Enabled) at a time

Graph Connections panel

images/download/attachments/44508779/graph_connections.png

Graph Connections panel consists of the list of currently defined graph connections on the left, and detail of the currently selected graph connection on the right.

An active connection is marked with a green light in the list and with the ENABLED label in the detail.

To create a new connection:

  1. Click the "New connection" button in the top right corner of the Graph Connections panel. (this creates a new connection based on Default Settings)

  2. This created connection should be (by default) disabled.

  3. Enter a human distinguishable name of your new connection

  4. Graph types currently supported are neo4j 3.5+ and neo4j 4+ where neo4j 4 is preselected.

  5. Enter a Database name (in case of "Neo4j 4 Enterprise" Graph type).

  6. Enter Bolt URL, Username, and Password.

  7. If you need an encrypted connection, turn the Encryption setting on.

  8. Option "Edit Certificate" is available only for encrypted connection (where Encryption = On )

  9. Fulltext search and Schema Indexes options are available only for active/enabled

  10. Click either apply or connect. (Both options save your changes, but Connect also enables this connection and disables the current - if any)

Settings

It is possible to define (override) the default values of some graph connection properties in the graphlytic.conf file. For more information refer to Configuration.

If graphlytic.conf does not contain neo4j configuration, generic default values will be used.

Please note, that some values cannot be overridden as there is no graphlytic.conf property (N/A in the table below).

Configuration

Generic default values

Property in graphlytic.conf

Description

Name

Default

N/A

Name of the connection (just for convienence)

Bolt URL

bolt://localhost:7687

neo4j.connector.bolt

Graph Database Bolt protocol URL

Username

neo4j

neo4j.connector.username

Graph connection username

Password

admin

neo4j.connector.password

Graph connection password

Encryption

false

neo4j.connector.encrypted

Graph connection encryption. If a trusted certificate is used on the Graph Database side then just set this to true. If it's an untrusted certificate please use the UI to load the certificate into Graphlytics's Keystore. See the "Certificate" button described below.

Graph Type

NEO4J 4

neo4j.connector.type

Graph Database type

Database

neo4j

N/A

Graph Database name. Can be used with Neo4j 4 Enterprise to specify the graph (database) to connect to. If not specified then the default database specified in Neo4j is used.

Certificate button

N/A

If an untrusted certificate is used in your Graph Database please use this button to load the certificate into Graphlytics's Keystore.

Fulltext search

Fulltext Index:

  • "properties": [ ]

  • "tokens" : [ ]

Search Mode:

  • "searchMode":"instant"

  • "throttleDelay":1000

  • "minLength":0

N/A

Fulltext index configuration for this Graph Database connection. For more information please see the "Fulltext Search Configuration" chapter below.

Schema indexes

N/A

Node Schema indexes configuration for this Graph Database connection. For more information please see the "Schema Indexes Configuration" chapter below.

Fulltext Search Configuration

To change the Fulltext Search behavior:

  1. Click on the "Configure fulltext search" button,

  2. change the values

  3. if the Fulltext Index values were changes a reindex is needed. Click on the "Start reindex" button to start reindexing (this can take a while depending on the number of nodes and number of indexed properties).

    1. Note: Graphlytic is automatically creating and maintaining one fulltext index with the name "gl_fulltext_node_index".

More information about the configuration options can be found in the UI (see the picture below).

images/download/attachments/44508779/image2021-3-12_10-35-43.png

Schema Indexes Configuration

To create a Schema Index:

  1. Click on the "Configure schema indexes" button to show the modal window (pictured below),

  2. click on the "Create index" button,

  3. fill in the node Label and Property name

  4. choose if you want to create a standard index or also an unique constraint with it (INDEX_UNIQUE),

  5. click on the red button "Create index".

To drop a Schema Index:

  1. Click on the "Configure schema indexes" button to show the modal window (pictured below),

  2. click on the index's bin button in the right column.

images/download/attachments/44508779/image2021-3-12_10-46-55.png