Jupyter Notebook 客户端

下载安装

• 在命令行中，首先使用pip安装 DolphinDB Jupyter Notebook 插件：

  pip install dolphindb_notebook

• 安装完成后启用插件：

  jupyter nbextension enable dolphindb/main

插件配置

Jupyter Notebook内核（kernels）是编程语言特定的进程，它们独立运行并与Jupyter应用程序及其用户界面进行交互。DolphinDB Jupyter Notebook 扩展插件提供了运行DolphinDB脚本的内核。用户需要通过以下步骤配置Jupyter Notebook的工作路径，以便在程序运行时DolphinDB内核能够顺利导入。

• 通过命令行jupyter kernelspec list查看Jupyter Notebook Kernel的工作路径

  • Linux系统

    >jupyter kernelspec list
    Available kernels:
        dolphindb   /home/admin/.local/share/jupyter/kernels/dolphindb
        python3       /home/admin/.local/share/jupyter/kernels/python3

  将/home/admin/.local/share/jupyter/kernels复制下来，方便下一步配置时粘贴。

  • Windows系统

    >jupyter kernelspec list
    Available kernels:
        dolphindb   C:\Users\admin\appdata\local\programs\python3\python37\share\jupyter\kernels\dolphindb
        python3       C:\Users\admin\appdata\local\programs\python3\python37\share\jupyter\kernels\python3

  将 C:\Users\admin\appdata\local\programs\python3\python37\share\jupyter\kernels复制下来，方便下一步配置时粘贴。

• 通过命令行 jupyter notebook --generate-config生成一个配置文件jupyter_notebook_config.py，打开这个配置文件，找到c.NotebookApp.notebook_dir选项，设为上一步复制下来的工作路径，并去掉注释#。

  注： Windows系统中，需要将路径中的一个反斜杠\都替换成两个反斜杠\\，因为一个反斜杠\会被系统误认为是转义字符。

连接服务器

• 在命令行输入 jupyter notebook，启动Jupyter Notebook。

• 在Jupyter Notebook的页面右侧点击新建，选择DolphinDB，新建一个DolphinDB notebook。

• 点击notebook工具栏的 Connect to DolphinDB Server 按钮。选择相应的server，然后点击右下角Connect按钮，即与DolphinDB server建立连接（如果不需要该server，可以点击Delete按钮删除）。

• 也可以通过New按钮，输入新的server信息，然后点击Save & Connect按钮即与DolphinDB server建立连接，并保存该信息以便下次使用。

编辑和运行脚本

连接DolphinDB Server后，在代码块区域编写DolphinDB脚本，点击运行即可运行相应代码块。每次运行DolphinDB脚本后，运行结果都会在相应的代码块下方展示。对于DolphinDB的绘图功能，以PNG展示结果。