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.
File
menu select New File...
. This option is also available on the Welcome page.Jupyter Notebook
.Detecting Kernels
button in the upper right of the notebook.Existing Jupyter Server...
.Enter the URL of the running Jupyter server
.http://localhost:50773/
servername:
namespace?token=1
when 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 http://localhost:50773/iris231:USER?token=1
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.PolyglotKernel.CodeExecutor
. Choose Yes
.Tip: To avoid having to load this class into other namespaces on the same server you can add a %ALL package mapping of the
PolyglotKernel
package to the default code database of the namespace you initially connected to.
IRIS ObjectScript INT
kernel.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 SQL
kernel. Use cells to run SQL statements, for example:SELECT 123 AS One, 456 AS Two
IRIS Python
kernel and run some Python code inside IRIS (‘IRIS Embedded Python’), for example:print('Hello world')
Polyglot IRIS
kernel. Begin each cell with a ‘magic’ line to indicate what language you are scripting in:
%%objectscript
%%python
%%sql
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).
Initial development of this extension by George James Software was sponsored by InterSystems.
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.
Initial Release