MotherDuck UI quick tour

Login

To log in to MotherDuck UI, please go to app.motherduck.com. You will be redirected to our web UI.

Main Window

Executing a sample query

After you log in, run the following SQL query:

SELECT 
  country_name, city, pm25_concentration AS pm25_pollution
FROM sample_data.who.ambient_air_quality
WHERE year=2019 AND pm25_concentration IS NOT NULL
ORDER BY pm25_pollution ASC

This query accesses the Sample Data Database which is attached by default.

MotherDuck executes this query in the cloud. Query results are saved into your browser into an interactive panel for fast data exploration with data sorting, filtering, and pivoting.

Diving into your data with Column Explorer

Exploring tables or resultsets

The Column Explorer allows you to see stats on either a selected table or the resultset from the selected notebook cell.

Seeing value frequencies

For each column, you'll see the column type, the most commonly-occurring values and the percentage of values that are NULL.

In the case the values are numerical, you'll see a histogram visualization.

Charting time series

If you have time series data, you'll also see a chart in the Column Explorer.

Writing queries with Autocomplete

MotherDuck Web UI supports autocomplete. As you write SQL in the UI, on every keystroke autocomplete brings up query syntax suggestions. You can turn off autocomplete in Web UI settings, found by clicking your profile in the top-right and choosing "Settings."

Writing SQL with confidence using FixIt

FixIt helps you resolve common SQL errors by offering fixes in-line.

FixIt uses a large language model (LLM) to generate suggestions; it feeds the error, the query, and additional context into an LLM to generate a new line that fixes the query.

Settings

MotherDuck settings are found by clicking your profile at the top-right. These settings are specific to each MotherDuck user.

UI settings

• Enable autocomplete when typing
• Enable inline SQL error fix suggestions

Secrets

MotherDuck enables you to query cloud blob stores without supplying credentials each time. Currently, credentials are supported for AWS S3 and Azure Blob Storage.

Service token

This section contains a long token which can be used for authenticating to MotherDuck.

Keyboard shortcuts

MotherDuck supports the following keyboard shortcuts.

Use Alt for Windows/Linux and ⌥ for Mac. Use Ctrl for Windows/Linux and ⌘ for Mac.

Command	Action
Ctrl/⌘ + Enter	Execute query in currently selected cell.
Alt/⌥ + Enter	Execute query in currently selected cell, then insert new cell at bottom of notebook and select the new cell.
Tab	When editing a query, indent current line. When navigating the notebook, advance to next UI element/button. Hit Esc to allow Tab to no longer indent current line and advance to next UI element instead.
Shift + Tab	When editing a query, de-indent current line. When navigating the notebook, move to previous UI element/button. Hit Esc to allow Shift-Tab to no longer de-indent current line and move to previous UI element instead.
Esc	Change Tab key behavior to navigate the UI instead of indent/de-indent editor text. Once another cell is selected, Tab behavior reverts to indent/de-indent.
Ctrl/⌘ + / or Ctrl + /	Toggle comment on all highlighted lines in query editor by prepending or removing "-- " at the start of each line. Will comment out the highlighted lines unless all lines are already commented out, in which case it will uncomment.
Ctrl/⌘ + z	Undo query edits within currently selected cell.
Ctrl/⌘ + Shift + z	Redo query edits within currently selected cell.
Ctrl/⌘ + ↑	Move currently selected cell up.
Ctrl/⌘ + ↓	Move currently selected cell down.