Cómo instalar y usar la base de datos gráfica Neo4j en Debian 12

Neo4j es un sistema de gestión de bases de datos gráficas de alto rendimiento para almacenamiento gráfico, ciencia de datos, ML, análisis y visualización. Neo4j almacena datos en nodos, bordes que los conectan en relaciones y atributos de nodos y bordes.

En este tutorial, te mostraremos instrucciones paso a paso sobre cómo instalar y usar la base de datos gráfica Neo4j en el servidor Debian 12. También aprenderás cómo conectarte a neo4j a través de Cypher-shell y aprenderás las consultas básicas de Cypher.

Requisitos previos

Antes de continuar, asegúrate de tener lo siguiente:

• Un servidor Debian 12 con al menos 2 GB de memoria.
• Un usuario no root con privilegios de administrador sudo.

Instalar Java OpenJDK

Antes de instalar la base de datos gráfica Neo4j, debes instalar Java en tu sistema, y se recomienda usar la última versión LTS de Java: Java OpenJDK 17. En esta sección, instalarás Java OpenJDK 17 a través del repositorio de Debian.

Primero, ejecuta el siguiente comando para actualizar el índice de paquetes de Debian y obtener la información más reciente sobre los paquetes.

sudo apt update

Ahora instala Java OpenJDK 17 ejecutando el siguiente comando. En el repositorio de Debian 12, el paquete default-jdk se refiere a Java OpenJDK 17, que requiere la base de datos gráfica Neo4j.

sudo apt install default-jdk

Escribe y para continuar con la instalación.

Después de instalar Java, verifica la versión de Java usando el siguiente comando. Deberías obtener que Java OpenJDK 17 está instalado en tu sistema.

javaversion

Instalación de la base de datos gráfica Neo4j

Después de instalar Java, estás listo para instalar la base de datos gráfica Neo4j en tu sistema Debian. Instalarás dependencias básicas, configurarás el repositorio de Neo4j, instalarás el paquete de Neo4j y luego iniciarás y habilitarás el servicio neo4j.

Para comenzar, ejecuta el siguiente comando para instalar herramientas básicas del sistema en tu servidor Debian.

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

Ahora ejecuta el siguiente comando para agregar la clave GPG y el repositorio de Neo4j. En este caso, agregarás el repositorio de Neo4j a tu sistema.

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

A continuación, actualiza el índice de paquetes de Debian e instala el paquete de Neo4j ejecutando el siguiente comando apt.

sudo apt update && sudo apt install neo4j

Escribe y para continuar con la instalación.

Una vez que hayas instalado el paquete de Neo4j, ejecuta el siguiente comando systemctl para iniciar y habilitar el servicio neo4j.

sudo systemctl start neo4j  
sudo systemctl enable neo4j

Por último, verifica el servicio neo4j usando el siguiente comando para asegurarte de que el servicio esté en funcionamiento.

sudo systemctl status neo4j

Si la base de datos gráfica Neo4j está en funcionamiento, la salida active(running) se mostrará en tu pantalla como la siguiente.

Configuración básica del despliegue de Neo4j

Ahora que has instalado la base de datos gráfica Neo4j, la primera tarea es configurar la contraseña de administrador de Neo4j a través de la línea de comandos neo4j-admin, configurar la dirección de escucha y la memoria máxima del montón modificando la configuración predeterminada /etc/neo4j/neo4j.conf.

Ejecuta el comando neo4j-admin a continuación para configurar la contraseña predeterminada para tu instalación de Neo4j. En este ejemplo, configurarás la contraseña predeterminada de Neo4j como p4ssword.

neo4j-admin dbms set-initial-password p4ssword

Después de configurar la contraseña predeterminada de Neo4j, abre la configuración de Neo4j /etc/neo4j/neo4j.conf usando el siguiente comando del editor nano.

sudo nano /etc/neo4j/neo4j.conf

Agrega tu dirección IP local al parámetro dbms.default_listen_address para permitir que Neo4j se ejecute en la red local. Luego, cambia el parámetro server.memory.heap.max_size para configurar la memoria máxima del montón para la base de datos gráfica Neo4j. En este caso, Neo4j se ejecutará en 192.168.5.15 con una memoria máxima del montón de 4 GB.

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

Cuando termines, guarda el archivo y sal del editor.

Por último, ejecuta el siguiente comando systemctl para aplicar los cambios reiniciando el servicio neo4j.

sudo systemctl restart neo4j

Conectándose a Neo4j a través de Cypher-shell

Para conectarte a la base de datos gráfica Neo4j, usa el cypher-shell. La funcionalidad de cypher-shell es similar al cliente mysql en MySQL/MariaDB y psql en PostgreSQL. El cypher-shell te permite ejecutar consultas Cypher, que es un lenguaje de consulta declarativo para la base de datos gráfica Neo4j.

Ejecuta el comando cypher-shell a continuación para iniciar sesión en la base de datos gráfica Neo4j. Cuando se te pida un nombre de usuario, ingresa el usuario predeterminado neo4j, luego ingresa tu contraseña.

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

Una vez conectado, se mostrará el mensaje ‘Conectado a Neo4j … como usuario neo4j‘ y el aviso se convertirá en ‘neo4j@neo4j>‘.

Ahora ejecuta la siguiente consulta Cypher :help para mostrar mensajes de ayuda y :exit para salir del cypher-shell. Como notaste, las consultas Cypher siempre comienzan con un punto y coma.

:help  
:exit

Además, usa la opción adicional -a para conectarte a un servidor Neo4j específico, o -u para iniciar sesión como el usuario que desees.

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

Operaciones básicas en la base de datos gráfica Neo4j

En la base de datos gráfica Neo4j, hay 3 entidades principales:

1. Nodos: las entidades de datos de la base de datos gráfica Neo4j y utilizan paréntesis () en el lenguaje de consulta Cypher.
2. Relaciones: cuando dos Nodos se conectan entre sí, se llama Relación. La Relación se representa con una flecha ->, que indica la dirección entre los Nodos.
3. Caminos: consiste en Nodos y Relaciones conectados.

Primero, ejecuta la siguiente consulta para crear un nuevo nodo con la etiqueta Movie.

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

Ahora, ejecuta la consulta a continuación para crear múltiples nodos con la misma etiqueta 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;

A continuación, ejecuta la siguiente consulta para crear nuevas relaciones entre nodos etiquetados como Person al nodo etiquetado como Movie. En este caso, la relación se llamará ACTED_IN con la propiedad 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);

Por último, ejecuta la siguiente consulta para verificar los nodos y relaciones disponibles dentro de tu base de datos gráfica Neo4j.

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

La siguiente salida confirma que cada nodo está conectado.

Conclusión

En conclusión, ahora has instalado con éxito la base de datos gráfica Neo4j en el servidor Debian 12 paso a paso. Has instalado y configurado la base de datos gráfica Neo4j, aprendido el uso básico de Cypher-shell para conectarte a Neo4j y aprendido la operación básica utilizando el lenguaje de consulta Cypher.