Jupyter 笔记本

功能的

将 .ipynb 笔记本作为 SQLly 笔记本打开,并将 SQLly 笔记本以标准 Jupyter 格式保存回去。

Jupyter 的笔记本格式, .ipynb,由 nbformat 项目规定,JupyterLab、VS Code 和 Azure Data Studio 的 SQL 笔记本都原样使用。SQLly 会把这类文件作为 SQLly 笔记本 的形式打开这些文件并原样写出,因此笔记本可以在 SQLly 和这些工具之间来回流转,不需要来回复制粘贴。

打开 .ipynb

使用 文件 → 打开笔记本…,打开 SQL 对话框或最近文件,然后选择运行所用的连接:Azure Data Studio 笔记本里保存的连接不会跟过来。代码单元会变成 SQL 单元,Markdown 单元保持 Markdown;原本折叠的单元保持折叠。为 Jupyter 的 SQL magic 编写的单元,其开头的 %%sql 行(或 %sql 前缀)会被移除,因此 SQL 按原样运行。原始单元以 Markdown 形式导入,因此其文本不会丢失。早于 nbformat 4 的文件会被拒绝并显示消息;请在 Jupyter 中打开并保存一次以升级它们。存储的输出不会被导入:笔记本的已保存结果来自他人的连接和时间,所以你需要用自己的连接运行这些单元。

保存为 .ipynb

将笔记本保存为名称以 .ipynb 并且 SQLly 会写出标准的 nbformat 4 笔记本,带 SQL 内核,与 Azure Data Studio 写出的结构一致,VS Code 和 JupyterLab 也能打开。而从 .ipynb 会继续以该格式保存,并且 导出 Jupyter 会写一个任何笔记本的 .ipynb 副本,同时标签页保留自己的文件。SQLly 的 @name 参数会保存在笔记本的元数据中,其他工具会忽略它们,SQLly 则能重新读取。结果不会保存到文件里,SQLly 自己的 .sqlnb.json 笔记本;要共享结果,请使用 导出 Markdown.

SQLly 笔记本可以引用之前的单元格作为 {{cell_2}}。其他工具看到的只是原样文本,因此依赖单元格引用的笔记本只有在 SQLly 里才能完整运行。