weygu/nebulagraph-jupyter

jupyter_nebulagraph 镜像文档

概述

jupyter_nebulagraph（前身为ipython-ngql）是一个Python包，旨在方便从Jupyter Notebook或iPython环境直接连接NebulaGraph。它简化了创建、调试和共享与NebulaGraph交互的Jupyter Notebook的流程，提升协作效率。

!https://github.com/wey-gu/jupyter_nebulagraph/assets/***/61fccff2-c9be-43a0-a26f-6f5a00b1c198

https://img.shields.io/badge/Tool***NebulaGraph-blue](https://github.com/vesoft-inc/nebula) https://img.shields.io/badge/Jupyter-Supported-brightgreen](https://github.com/jupyterlab/jupyterlab) https://img.shields.io/docker/v/weygu/nebulagraph-jupyter?label=Image&logo=docker](https://hub.docker.com/r/weygu/nebulagraph-jupyter) https://img.shields.io/badge/Docker-Extension-blue?logo=docker](https://hub.docker.com/extensions/weygu/nebulagraph-dd-ext) https://img.shields.io/github/v/release/wey-gu/jupyter_nebulagraph?label=Version](https://github.com/wey-gu/jupyter_nebulagraph/releases) https://img.shields.io/pypi/v/jupyter_nebulagraph](https://pypi.org/project/jupyter_nebulagraph/) https://colab.research.google.com/assets/colab-badge.svg](https://colab.research.google.com/github/wey-gu/jupyter_nebulagraph/blob/main/docs/get_started.ipynb) https://img.shields.io/badge/docs-%E9%98%85%E8%AF%BB%E6%96%87%E6%A1%A3-blue](https://jupyter-nebulagraph.readthedocs.io/)

快速体验

直接在Google Colab体验：https://colab.research.google.com/assets/colab-badge.svg](https://colab.research.google.com/github/wey-gu/jupyter_nebulagraph/blob/main/docs/get_started.ipynb)

核心功能与特性

使用场景

• 图数据库查询与分析：直接在Jupyter Notebook中编写、调试NebulaGraph查询语句
• 数据可视化：将查询结果以图形式直观展示，辅助分析图数据结构
• 数据导入：通过CSV文件快速加载数据到NebulaGraph
• 协作与分享：创建包含NebulaGraph交互逻辑的Notebook，便于团队协作

部署与使用

Docker快速启动

bash
docker run -p 8888:8888 docker.xuanyuan.run/weygu/nebulagraph-jupyter

启动后，访问http://localhost:8888，使用容器日志中的token登录Jupyter Notebook。

基本使用流程

1. 连接NebulaGraph：

   python
   %ngql --address <nebulagraph地址> --port 9669 --user <用户名> --password <密码>
   

2. 执行查询：

   python
   %%ngql
   MATCH p=(v:player{name:"Tim Duncan"})-->(v2:player) RETURN p;
   

3. 可视化结果：

   python
   %ng_draw
   

4. 加载CSV数据：

   python
   %ng_load --source /path/to/actor.csv --tag player --vid 0 --props 1:name,2:age --space basketballplayer
   

完整指南

有关详细的安装、配置和高级功能，请参阅https://jupyter-nebulagraph.readthedocs.io/zh/latest/%E3%80%82

致谢

• 本项目灵感来源于https://github.com/catherinedevlin/ipython-sql%EF%BC%8C%E6%84%9F%E8%B0%A2Catherine Devlin。
• 图可视化功能基于https://github.com/WestHealth/pyvis%E5%AE%9E%E7%8E%B0%EF%BC%8C%E6%84%9F%E8%B0%A2https://github.com/WestHealth%E3%80%82
• 特别感谢Vesoft Inc.和https://github.com/vesoft-inc/nebula%E7%9A%84%E6%94%AF%E6%8C%81%E3%80%82