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 :
- Créez une variable système nommée
JAVA_HOMEpointant vers le répertoire d'installation du JRE (par exemple,C:\Program Files\Java\jre1.8.0_211). - Modifiez la variable système
Pathpour inclure les chemins%JAVA_HOME%\binet%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.