Installation et configuration de Neo4j sous Windows

Neo4j est une base de données graphique NoSQL populaire, conçue pour stocker et interroger des données riches en relations. Elle utilise le modèle de graphe de propriétés, où les données sont représentées par des nœuds (sommets), des relations (arêtes) et leurs propriétés. Neo4j prend en charge les transactions ACID et utilise le langage de requête Cypher, devenu un standard de facto pour les bases de données graphiques. Contrairement aux bases de données relationnelles qui peuvent être lentes pour les requêtes impliquant de multiples jointures, Neo4j excelle dans l'exploration des relations grâce à sa nature locale de parcours. Pour installer Neo4j sous Windows, plusieurs étapes préliminaires et de configuration sont nécessaires :

Installation du JRE Java

Neo4j étant une application Java, une Java Runtime Environment (JRE) est indispensable. Téléchargez le JRE 8 (ou une version compatible) depuis le site officiel d'Oracle.

Note : Le JDK (Java Development Kit) inclut le JRE et des outils de développement. Le JRE seul suffit pour exécuter Neo4j.

Configurez ensuite les variables d'environnement Java :

  1. Créez une variable système nommée JAVA_HOME pointant vers le répertoire d'installation du JRE (par exemple, C:\Program Files\Java\jre1.8.0_211).
  2. Modifiez la variable système Path pour inclure les chemins %JAVA_HOME%\bin et %JAVA_HOME%\jre\bin.

Vérifiez l'installation en ouvrant une invite de commande (cmd) et en tapant java -version. Une sortie indiquant la version de Java confirme le succès de la configuration.

Téléchargement et extraction de Neo4j

Téléchargez la version communautaire de Neo4j depuis le site officiel (par exemple, neo4j-community-3.2.0-windows.zip). Extrayez l'archive dans un répertoire principal, par exemple D:\Program Files\neo4j-community-3.2..

La structure principale des répertoires de Neo4j comprend :

  • bin/ : Programmes exécutables.
  • conf/ : Fichiers de configuration.
  • data/ : Données de la base de données.
  • plugins/ : Extensions et plugins.

Configuration des variables d'environnement Neo4j

Créez une variable système nommée NEO4J_HOME et définissez sa valeur sur le répertoire principal d'installation de Neo4j.

Ajoutez également %NEO4J_HOME%\bin à la variable système Path.

Configuration de Neo4j

Les paramètres de Neo4j sont gérés via le fichier conf/neo4j.conf. Par défaut, Neo4j peut démarrer sans configuration spécifique.

Emplacement des données

Pour modifier l'emplacement par défaut des fichiers de la base de données (data/graph.db), ajustez les directives suivantes dans neo4j.conf :

# dbms.active_database=graph.db
# dbms.directories.data=data

Authentification

L'authentification est activée par défaut. Pour la désactiver (non recommandé en production), décommentez la ligne suivante :

# dbms.security.auth_enabled=false

Configuration de la mémoire Java (Heap)

La mémoire allouée au tas Java est généralement calculée dynamiquement. Pour définir des tailles initiales et maximales spécifiques, décommentez et ajustez ces lignes :

# dbms.memory.heap.initial_size=512m
# dbms.memory.heap.max_size=512m

Configuration réseau

Neo4j expose plusieurs connecteurs pour différentes interfaces réseau.

Protocoles et ports

Neo4j supporte les protocoles Bolt, HTTP et HTTPS. Les ports par défaut sont :

  • Bolt : 7687
  • HTTP : 7474
  • HTTPS : 7473

Assurez-vous que le pare-feu Windows autorise le trafic entrant sur ces ports.

Adresse d'écoute

La directive dbms.connectors.default_listen_address contrôle les adresses IP sur lesquelles les connecteurs écoutent. Par défaut, seule l'adresse locale (localhost) est autorisée. Pour autoriser les connexions distantes, définissez cette valeur sur 0.0.0.0 :

# dbms.connectors.default_listen_address=0.0.0.0

Vous pouvez également configurer individuellement chaque connecteur :

# Bolt connector
dbms.connector.bolt.enabled=true
# dbms.connector.bolt.listen_address=0.0.0.0:7687

# HTTP Connector
dbms.connector.http.enabled=true
# dbms.connector.http.listen_address=0.0.0.0:7474

# HTTPS Connector
# dbms.connector.https.enabled=true
# dbms.connector.https.listen_address=0.0.0.0:7473

Démarrage de Neo4j

Vous pouvez démarrer Neo4j de deux manières :

Via la console

Ouvrez une invite de commande en tant qu'administrateur, naviguez jusqu'au répertoire bin de votre installation Neo4j et exécutez :

neo4j.bat console

Ce mode est utile pour le débogage, car il affiche les logs directement dans la console.

En tant que service Windows

Pour installler Neo4j comme un service Windows, utilisez les commandes suivantes dans le répertoire bin :

neo4j install-service

Pour gérer le service, utilisez les commandes :

neo4j start
neo4j stop
neo4j restart
neo4j status

Interface Neo4j Browser

Une fois Neo4j démarré, vous pouvez accéder à son interface web intégrée via un navigateur à l'adresse http://localhost:7474.

L'interface par défaut utilise le schéma Bolt bolt://localhost:7687. Les identifiants par défaut sont l'utilisateur neo4j avec le mot de passe neo4j. Il est impératif de changer ce mot de passe lors de la première connexion.

Création de nœuds et relations

Vous pouvez utiliser le langage Cypher dans Neo4j Browser pour créer et manipuler vos données graphiques. Voici un exemple simple :

// Créer deux nœuds de type Person
CREATE (n:Person { name: 'Andres', title: 'Developer' }) return n;
CREATE (n:Person { name: 'Vic', title: 'Developer' }) return n;

// Créer une relation 'Friend' entre Vic et Andres
MATCH (n:Person {name:"Vic"}),(m:Person {name:"Andres"}) CREATE (n)-[r:Friend]->(m) return r;

// Créer une relation inverse (peut être vue comme une relation d'amitié mutuelle)
MATCH (n:Person {name:"Vic"}),(m:Person {name:"Andres"}) CREATE (n)<-[r:Friend]-(m) return r;

Après avoir exécuté ces commandes, l'interface graphique affichera les nœuds et les relations créés.

Pour plus d'informations, consultez la documentation officiellle de Neo4j v3.2.

Étiquettes: neo4j Windows installation Configuration Java

Publié le 16 juin à 23h47