Comment installer et utiliser la base de données graphique Neo4j sur Debian 12

Neo4j est un système de gestion de base de données graphique haute performance pour le stockage graphique, la science des données, l’apprentissage automatique, l’analyse et la visualisation. Neo4j stocke les données dans des nœuds, des arêtes les reliant dans des relations, et des attributs de nœuds et d’arêtes.

Dans ce tutoriel, nous vous montrerons des instructions étape par étape sur l’installation et l’utilisation de la base de données graphique Neo4j sur le serveur Debian 12. Vous apprendrez également à vous connecter à neo4j via Cypher-shell et à connaître les requêtes Cypher de base.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un serveur Debian 12 avec au moins 2 Go de mémoire.
• Un utilisateur non-root avec des privilèges d’administrateur sudo.

Installer Java OpenJDK

Avant d’installer la base de données graphique Neo4j, vous devez installer Java sur votre système, et il est recommandé d’utiliser la dernière version LTS de Java - Java OpenJDK 17. Dans cette section, vous installerez Java OpenJDK 17 via le dépôt Debian.

Tout d’abord, exécutez la commande ci-dessous pour mettre à jour l’index des paquets Debian et obtenir les dernières informations sur les paquets.

sudo apt update

Maintenant, installez Java OpenJDK 17 en exécutant la commande ci-dessous. Dans le dépôt Debian 12, le paquet default-jdk fait référence à Java OpenJDK 17, qui est requis par la base de données graphique Neo4j.

sudo apt install default-jdk

Tapez y pour continuer avec l’installation.

Après avoir installé Java, vérifiez la version de Java en utilisant la commande ci-dessous. Vous devriez obtenir Java OpenJDK 17 installé sur votre système.

java -version

Installation de la base de données graphique Neo4j

Après avoir installé Java, vous êtes prêt à installer la base de données graphique Neo4j sur votre système Debian. Vous installerez les dépendances de base, configurerez le dépôt Neo4j, installerez le paquet Neo4j, puis démarrerez et activerez le service neo4j.

Pour commencer, exécutez la commande ci-dessous pour installer les outils système de base sur votre serveur Debian.

sudo apt install gnupg2 apt-transport-https wget curl -y

Maintenant, exécutez la commande suivante pour ajouter la clé GPG et le dépôt Neo4j. Dans ce cas, vous ajouterez le dépôt Neo4j à votre système.

wget -q -O- https://debian.neo4j.com/neotechnology.gpg.key | 
    gpg --dearmor | sudo tee /usr/share/keyrings/neotechnology.gpg > /dev/null 2>&1   

echo "deb [signed-by=/usr/share/keyrings/neotechnology.gpg] https://debian.neo4j.com stable latest" | 
    sudo tee /etc/apt/sources.list.d/neo4j.list

Ensuite, actualisez l’index des paquets Debian et installez le paquet Neo4j en exécutant la commande apt suivante.

sudo apt update && sudo apt install neo4j

Tapez y pour continuer avec l’installation.

Une fois que vous avez installé le paquet Neo4j, exécutez la commande systemctl suivante pour démarrer et activer le service neo4j.

sudo systemctl start neo4j  
sudo systemctl enable neo4j

Enfin, vérifiez le service neo4j en utilisant la commande ci-dessous pour vous assurer que le service fonctionne.

sudo systemctl status neo4j

Si la base de données graphique Neo4j fonctionne, la sortie active(running) s’affichera sur votre écran comme suit.

Configuration de base du déploiement de Neo4j

Maintenant que vous avez installé la base de données graphique Neo4j, la première tâche pour vous est de configurer le mot de passe administrateur de Neo4j via la ligne de commande neo4j-admin, de configurer l’adresse d’écoute et la mémoire maximale en modifiant la configuration par défaut /etc/neo4j/neo4j.conf.

Exécutez la commande neo4j-admin ci-dessous pour configurer le mot de passe par défaut pour votre installation Neo4j. Dans cet exemple, vous allez configurer le mot de passe par défaut de Neo4j à p4ssword.

neo4j-admin dbms set-initial-password p4ssword

Après avoir configuré le mot de passe par défaut de Neo4j, ouvrez la configuration de Neo4j /etc/neo4j/neo4j.conf en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/neo4j/neo4j.conf

Ajoutez votre adresse IP locale au paramètre dbms.default_listen_address pour permettre à Neo4j de fonctionner sur le réseau local. Ensuite, changez le paramètre server.memory.heap.max_size pour configurer la mémoire maximale pour la base de données graphique Neo4j. Dans ce cas, Neo4j fonctionnera à 192.168.5.15 avec une mémoire maximale de 4 Go.

dbms.default_listen_address=192.168.5.15  
  
server.memory.heap.initial_size=512m  
server.memory.heap.max_size=4096m

Lorsque vous avez terminé, enregistrez le fichier et quittez l’éditeur.

Enfin, exécutez la commande systemctl ci-dessous pour appliquer les modifications en redémarrant le service neo4j.

sudo systemctl restart neo4j

Connexion à Neo4j via Cypher-shell

Pour vous connecter à la base de données graphique Neo4j, utilisez le cypher-shell. La fonctionnalité de cypher-shell est similaire au client mysql sur MySQL/MariaDB et psql sur PostgreSQL. Le cypher-shell vous permet d’exécuter des requêtes Cypher, qui est un langage de requête déclaratif pour la base de données graphique Neo4j.

Exécutez la commande cypher-shell ci-dessous pour vous connecter à la base de données graphique Neo4j. Lorsque vous êtes invité à entrer un nom d’utilisateur, saisissez l’utilisateur par défaut neo4j, puis saisissez votre mot de passe.

cypher-shell -a 'neo4j://192.168.5.15:7687'

Une fois connecté, le message ‘Connecté à Neo4j … en tant qu’utilisateur neo4j‘ s’affichera et l’invite deviendra comme ‘neo4j@neo4j>‘.

Maintenant, exécutez la requête Cypher suivante :help pour afficher les messages d’aide et :exit pour quitter le cypher-shell. Comme vous l’avez remarqué, les requêtes Cypher commencent toujours par un point-virgule.

:help  
:exit

De plus, utilisez l’option supplémentaire -a pour vous connecter à un serveur Neo4j spécifique, ou -u pour vous connecter en tant qu’utilisateur souhaité.

cypher-shell -a 'neo4j://192.168.5.15:7687' -u neo4j -p p4ssword

Opérations de base dans la base de données graphique Neo4j

Dans la base de données graphique Neo4j, il y a 3 entités principales :

1. Nœuds : les entités de données de la base de données graphique Neo4j et utilisent des parenthèses () dans le langage de requête Cypher.
2. Relations : lorsque deux nœuds se connectent entre eux, on parle de relation. La relation est représentée par une flèche ->, qui indique la direction entre les nœuds.
3. Chemins : ils consistent en des nœuds et des relations connectés.

Tout d’abord, exécutez la requête suivante pour créer un nouveau nœud avec le label Movie.

CREATE (a:Movie {title:'The Matrix', released: 1999}) RETURN a;

Maintenant, exécutez la requête ci-dessous pour créer plusieurs nœuds avec le même label Person.

CREATE (a:Person {name:'Keanu Reeves', born: 1964}) RETURN a;  
CREATE (a:Person {name:'Carrie-Anne Moss', born: 1967}) RETURN a;  
CREATE (a:Person {name:'Laurence Fishburne', born: 1961}) RETURN a;

Ensuite, exécutez la requête suivante pour créer de nouvelles relations entre les nœuds étiquetés Person et le nœud étiqueté Movie. Dans ce cas, la relation sera nommée ACTED_IN avec la propriété roles.

MATCH (a:Person), (b:Movie) WHERE (a.name = 'Keanu Reeves') AND b.title = 'The Matrix' CREATE (a)-[r:ACTED_IN {roles:['Neo']}]->(b);  
MATCH (a:Person), (b:Movie) WHERE (a.name = 'Carrie-Anne Moss') AND b.title = 'The Matrix' CREATE (a)-[r:ACTED_IN {roles:['Trinity']}]->(b);  
MATCH (a:Person), (b:Movie) WHERE (a.name = 'Laurence Fishburne') AND b.title = 'The Matrix' CREATE (a)-[r:ACTED_IN {roles:['Morpheus']}]->(b);

Enfin, exécutez la requête suivante pour vérifier les nœuds et les relations disponibles dans votre base de données graphique Neo4j.

MATCH (s)-[r]->(e)  
RETURN s.name AS Name, e.title AS Title, r.roles AS As;

La sortie suivante confirme que chaque nœud est connecté.

Conclusion

En conclusion, vous avez maintenant installé avec succès la base de données graphique Neo4j sur le serveur Debian 12 étape par étape. Vous avez installé et configuré la base de données graphique Neo4j, appris l’utilisation de base de Cypher-shell pour vous connecter à Neo4j et appris les opérations de base en utilisant le langage de requête Cypher.