A “Jupyter notebook” insight shows a snapshot (called an export) of the content of a Jupyter (Python, R, Scala) notebook. For more information, see Code notebooks.
The insight only shows a static snapshot, it does not show the “current” version of the notebook. The insight does not give the possibility to modify or run the notebook.
Unlike most other insights, a Jupyter notebook must first be published at least once by a user with “Write project content” permission on the project and “Write safe code” global permission.
Once this user has published a first time the notebook, other users can create insights pointing to it and add them on their dashboards
There can be several exports of the same Jupyter notebook. In the insight, you can choose between the different versions. This allows you to show the notebook at different points in time.
You can publish a Jupyter notebook insight from several locations:
This method is only possible if you have at least the “Write project content” permission, and the permission to create Jupyter notebook
Go to the Jupyter notebook. From the Actions menu, click on the “Publish” button. This action is also possible from the notebooks list.
This actually does three actions:
- Create a snapshot (an export) of the Jupyter notebook
- Create an insight pointing to the notebook. The insight will display the latest snapshot
- Add the insight to the specified dashboard
The tile display of a “Jupyter notebook” insight shows the content of the notebook. In the tile settings, you can select whether the code should be shown or not.
The View page of the Jupyter notebook insight shows the content of the notebook.
If you have write access to the insight, you can go to the Edit tab, where you can select between the different exports.
If you have “Write project content” access to the project and the permission to write code, you’ll be able to create a new export.