This VS Code extension is an alpha-quality proof of concept. It leverages Microsoft’s Jupyter extension to bring the notebook paradigm to developers working with InterSystems IRIS servers, both local and remote.
New File.... This option is also available on the Welcome page.
Detecting Kernelsbutton in the upper right of the notebook.
Existing Jupyter Server....
Enter the URL of the running Jupyter server.
?token=1when prompted. Replace servername with the name of the Server Manager definition you previously created. Replace namespace with the target namespace on that server. Do not omit the colon between these two elements. For example
IRIS231 USER. Don’t leave this blank, else the display name will default to
localhost, meaning you won’t be able to distinguish between entries you create for different servername:namespace combinations.
Tip: To avoid having to load this class into other namespaces on the same server you can add a %ALL package mapping of the
PolyglotKernelpackage to the default code database of the namespace you initially connected to.
IRIS ObjectScript INTkernel.
write $zversion,!,$namespace,!,$job,!and click the Execute Cell button on the left. The output from the command will appear below the cell.
Note: If you forget to start the line with a space it won’t be syntax-colored correctly but it will still execute.
write $zversion,! write $namespace,! write $job,!
IRIS SQLkernel. Use cells to run SQL statements, for example:
SELECT 123 AS One, 456 AS Two
IRIS Pythonkernel and run some Python code inside IRIS (‘IRIS Embedded Python’), for example:
Polyglot IRISkernel. Begin each cell with a ‘magic’ line to indicate what language you are scripting in:
Note: Cells of a Polyglot IRIS notebook are not language-aware, so they lack syntax coloring, completions etc. The so-called ‘cell magics’ tell the server-side code executor class which language to run, but the Jupyter notebook extension is not currently able to use them to vary the cell language in the editor.
The Jupyter PowerToys extension adds a Kernels view to a dedicated Jupyter view container. Access this from its activity bar icon to explore remote servers, kernelspecs and active kernels (sessions).
Please open issues at https://github.com/intersystems-community/vscode-iris-jupyter-server/issues
The InterSystems Developer Community is also a good place for discussion.