Skip to main content

What are Notebooks?

Notebooks are interactive workspaces for exploring data. Like Jupyter notebooks, they let you:
  • Run SQL and Python code in cells
  • Mix queries with markdown notes
  • Visualize results inline
  • Save and share your analysis

Creating a Notebook

1

Go to Notebooks

Click Notebooks in the sidebar
2

Create New

Click + New Notebook
3

Name Your Notebook

Give it a meaningful title like “Q1 Sales Analysis”

Working with Cells

Notebooks contain cells that hold your code or text:

Types of Cells

Adding Cells

  1. Click between cells or at the bottom
  2. Click + Add Cell
  3. Choose the cell type

Running Cells

  • Click the ▶ Run button on a cell
  • Or press Shift + Enter to run and move to next
  • Or press Ctrl + Enter to run and stay

SQL Cells

Write SQL queries against your connected databases:
Results appear as a table below the cell.

Python Cells

Use Python for advanced analysis:

Markdown Cells

Add documentation with Markdown:

Sharing Notebooks

  1. Click Share in the top right
  2. Choose team members or copy a link
  3. Set permissions (view/edit)

Saving Work

  • Notebooks auto-save as you work
  • Click Save to save manually
  • Use Version History to restore previous versions

Keyboard Shortcuts

Tips

Start with SQL

Fetch data first, then process with Python

Use Markdown Liberally

Document your thought process

Name Variables Clearly

Makes sharing easier for teammates

Break Into Small Cells

Easier to debug and re-run sections