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 マジック用に書かれたセルは、先頭の %%sql 行 (または %sql プレフィックス)が取り除かれるため、SQL は書かれたとおりに実行されます。Raw セルは 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 でしか完全には実行できません。