如何在JupyterLab中配置AWS Neptune graph-notebook并使用魔法命令

问题核心原因 #

%status等魔法命令无法识别的核心原因是graph-notebook的IPython扩展未在当前运行的Jupyter内核中完成加载，你本地执行的python -m graph_notebook.start_notebook命令会自动完成扩展注册、服务启动的全流程，但你使用已部署的远程JupyterLab服务时不需要启动新服务，只需手动完成扩展加载即可。

配置步骤 #

1. 确认内核匹配 #

首先确认你当前Notebook使用的内核为已安装graph-notebook依赖的conda环境：

• 点击Notebook右上角的内核选择按钮，选中对应conda环境
• 运行Cell命令!pip list | grep graph-notebook，确认返回结果中包含graph-notebook的安装版本，说明依赖安装生效

2. 加载graph-notebook扩展 #

提供两种加载方式，按需选择：

• 单次会话生效：在Notebook首个Cell中执行以下命令，执行完成后即可直接使用相关魔法命令

  %load_ext graph_notebook.magics
  

• 永久生效（无需每次运行加载命令）：
  1. 登录远程服务器，激活你安装依赖的conda环境，执行命令ipython profile create生成默认IPython配置文件
  2. 打开配置文件~/.ipython/profile_default/ipython_config.py，找到c.InteractiveShellApp.extensions配置项，修改为如下内容：

     c.InteractiveShellApp.extensions = ['graph_notebook.magics']
     

  3. 保存配置后重启JupyterLab内核，后续所有使用该conda环境的Notebook都会自动加载魔法命令

3. 配置AWS Neptune连接 #

扩展加载完成后，执行以下命令配置Neptune连接参数，替换尖括号内容为你实际的集群信息：

%graph_notebook_host <你的Neptune集群域名>
%graph_notebook_port 8182
%graph_notebook_auth_mode DEFAULT
# 如果你的Neptune开启了IAM身份认证，将上方配置替换为 %graph_notebook_auth_mode IAM
%graph_notebook_serializer graphson_v3

配置完成后执行%status，即可正常返回Neptune集群的运行状态。

Gremlin查询与可视化使用方式 #

直接在Cell开头添加%%gremlin魔法命令，后续输入Gremlin查询语句即可，示例：

%%gremlin
g.V().limit(10).valueMap()

查询返回结果会自动提供表格、图可视化等多种展示模式，可直接切换查看。

内容的提问来源于stack exchange，提问作者aaaaa