Notebooks Jupyter

fonctionnel

Ouvrez des notebooks .ipynb comme notebooks SQLly et réenregistrez les notebooks SQLly au format Jupyter standard.

Le format de notebook de Jupyter, .ipynb, est spécifié par le projet nbformat et utilisé tel quel par JupyterLab, VS Code et les notebooks SQL d'Azure Data Studio. SQLly ouvre ces fichiers comme Notebooks SQLly et les réécrit, de sorte qu'un notebook peut circuler entre SQLly et ces outils sans avoir besoin d'une séance de copier-coller.

Ouverture d’un .ipynb

Utilisez Fichier → Ouvrir un notebook…, la boîte de dialogue Open SQL, ou un fichier récent, puis choisissez la connexion sur laquelle l'exécuter : la connexion enregistrée d'un notebook Azure Data Studio n'est pas transférée. Les cellules de code deviennent des cellules SQL et les cellules Markdown restent Markdown ; une cellule qui était réduite reste réduite. Les cellules écrites pour les magics SQL de Jupyter se voient retirer la %%sql (ou le préfixe %sql ) supprimé, de sorte que le SQL s’exécute tel qu’écrit. Les cellules brutes arrivent comme Markdown, de sorte que leur texte n’est pas perdu. Les fichiers plus anciens que le nbformat 4 sont refusés avec un message ; ouvrez-les et enregistrez-les une fois dans Jupyter pour les mettre à jour. Les résultats enregistrés ne sont pas importés : les résultats sauvegardés d’un carnet provenaient de la connexion de quelqu’un d’autre à un autre moment, donc vous exécutez les cellules avec votre propre connexion.

Enregistrement sous .ipynb

Enregistrez un carnet sous un nom se terminant par .ipynb et SQLly écrit un notebook nbformat 4 standard avec un noyau SQL, dans le même format qu'Azure Data Studio, que VS Code et JupyterLab ouvrent également. Un notebook ouvert depuis un .ipynb garde son format lors de l'enregistrement, et Exporter vers Jupyter dans la barre d'outils du notebook écrit une copie .ipynb une copie de n'importe quel carnet tandis que l'onglet garde son propre fichier. Les paramètres @name de SQLly suivent dans les métadonnées du carnet, où les autres outils les ignorent et SQLly les récupère à nouveau. Les résultats ne sont pas enregistrés dans le fichier, tout comme avec les carnets .sqlnb.json notebooks propres à SQLly ; pour partager les résultats, utilisez Exporter en Markdown.

Les notebooks SQLly peuvent faire référence à une cellule antérieure sous la forme {{cell_2}}. D'autres outils considèrent ce texte comme écrit, donc un carnet qui s'appuie sur des références de cellules fonctionne entièrement uniquement dans SQLly.