Jupyter 筆記本

功能性的

將 .ipynb 筆記本開啟為 SQLly 筆記本,並將 SQLly 筆記本以標準 Jupyter 格式儲存回去。

純粹是來講好話的 🎤 .ipynb,是由 nbformat 專案規範的,並且被 JupyterLab、VS Code 和 Azure Data Studio 的 SQL 筆記本原樣使用。SQLly 可以將這些檔案作為 SQLly 筆記本 再寫回去,所以筆記本可以在 SQLly 和那些工具之間直接流動,不必來一場複製貼上工程。

開啟 .ipynb

使用 檔案 → 開啟筆記本…、Open SQL 對話方塊或最近開啟的檔案,然後選擇要在哪個連線上執行:Azure Data Studio 筆記本裡儲存的連線不會跟著過來。程式碼儲存格會變成 SQL 儲存格,Markdown 儲存格仍是 Markdown;原本摺疊的儲存格保持摺疊。為 Jupyter 的 SQL magic 寫的儲存格,開頭的 %%sql 行(或 %sql 前綴)會被移除,SQL 便照原樣執行。原始儲存格以 Markdown 匯入,文字不會遺失。早於 nbformat 4 的檔案會遭拒並附上訊息;請先在 Jupyter 中開啟並存檔一次來升級。已儲存的輸出不會匯入:筆記本裡儲存的結果是別人當時用別的連線跑出來的,你得用自己的連線執行這些儲存格。

另存為 .ipynb

將筆記本存成以 .ipynb ,SQLly 就會以 SQL 核心寫出標準的 nbformat 4 筆記本,格式與 Azure Data Studio 寫的相同,VS Code 和 JupyterLab 也打得開。而一個筆記本若從 .ipynb 會繼續以該格式儲存,而 匯出 Jupyter 位於筆記本工具列中,會寫出 .ipynb 副本,同時分頁保持自己的檔案。SQLly 的 @name 參數會一併存放在筆記本的中繼資料裡,其他工具會忽略它們,而 SQLly 會再次讀取。結果不會存進檔案,就像 SQLly 自己的 .sqlnb.json 筆記本;要分享結果,請使用 匯出 Markdown.

SQLly 筆記本可以引用先前的儲存格作為 {{cell_2}}。其他工具只會照字面看到那段文字,所以依賴儲存格參照的筆記本只有在 SQLly 裡才能完整執行。