Jupyter Workspaces (Beta)

Intro

Jupyter Workspaces in Domo are a web-based interactive development environment for Jupyter notebooks, code, and data. Workspaces are tightly integrated with Domo to allow users to easily explore their Domo DataSets, leverage instantaneous code execution to develop pipelines for data science and machine learning, document their processes, create custom visualizations, and write transformed data back into Domo.

Jupyter Workspaces use the JupyterLab interface. For more information on JupyterLab, see https://jupyterlab.readthedocs.io/en/latest/

Getting this feature

If you are interested in joining the Beta for this feature, please contact your Customer Success Manager (CSM).

Accessing Jupyter Workspaces

You can access the Jupyter Workspaces from two places. The first is in the Data Center by clicking the Jupyter Workspaces tab on the left-hand side.

The second area you can access Jupyter Workspaces is from the DataSet Details view of a DataSet you wish to transform.

Configuring a Jupyter Workspace

After you have navigated to the Jupyter Workspace via one of the methods above and opened the New Workspace window, you will have four main sections to configure:

1. Name of the Workspace.
2. (Optional) Description of the Workspace.
3. Select the input DataSet(s). You can change the DataSet alias or leave it the same as the input DataSet's name.
4. Add the output DataSet(s). You can name the output DataSet to suite your needs.

Start, Stop, Edit, or Delete a Workspace

Inside of the Jupyter Workspaces tab of the Data Center, you are able to see all of the Workspaces that have been created. Clicking the wrench icon on the right side of a Workspace brings up a menu that allows users to:

• Edit - Change the Name, Description, and update the input/output DataSets of the Workspace.
• Start - If the Workspace has been stopped, this allows you to start it again.
• Stop - Stops the Workspace from running.
• Delete - Removes the Workspace completely.

Creating a Python/R Notebook

Open a running Workspace by clicking on it from the Jupyter Workspaces page. From within Jupyter, click the + symbol at the top left to open the Launcher. Select Python 3 or R under the Notebook section. The Launcher can also be used to open a Python 3/R console, terminal, text file, or Markdown file.

Working with data in Jupyter

From within Jupyter you can:

1. Import domojupyter
2. Export the data from Domo to Jupyter using: read_dataframe(<dataset alias>, query=<optional sql-like query>)
3. Write back to a different Domo DataSet (if you’ve configured an output DataSet) once you’ve made any transformations.

In the Jupyter sidebar there is a tab that shows the DataSets you’ve configured in Domo.

Double clicking on a DataSet listed there will paste a code snippet into your current cell.

Installing Additional Libraries

Python

Install libraries with pip or conda from within a notebook using ‘!’.

R

Install libraries from cran using install.packages() from within a notebook.