The Lake screen

The Lake screen is the home of the Lake: a dashboard of your datasources, a tab for each one you open, and the checks the screen runs while a source is busy. Use this page to find your way around the workspace; the tree panel and its search have their own pages.

Get around the screen

  1. In the sidebar, click Lake.
  2. The screen has two parts. The left panel holds the tree and its search box: see The Lake tree and Search and filter the Lake. The right area switches between the views below.
ViewWhat it showsShortcut
DashboardYour datasources as cards, grouped by type or by folder.Alt+2
Relationship DiagramThe diagram of Lake tables. See Relationship diagram.Alt+3
WorkflowsThe Lake workflows. See Workflows in the Lake.Alt+4
Add datasourceThe list of source types, to connect a new datasource. See Add a data source.Alt+N

The Alt shortcuts work anywhere on the Lake screen. Point at a view button to read its tooltip, such as Lake dashboards - datasources and tables for Dashboard and Manage workflows and transfer tables for Workflows.

Use the toolbar

Above the tree sits its toolbar. Most buttons are icons. Point at one to read its name.

ButtonWhat it does
NewOpens a menu of source types, grouped by category.
RefreshReloads the schema shown in the Lake without contacting the source. It spins while it runs.
Add FolderOpens New folder. Type a name, pick a colour and click Create.
DeployDeploys the selected tables, after a Deploy Selected Items? confirmation. See Deploy tables.
View SourceOpens the source panel for the selected datasource, database or schema. See Import tables.
DeleteDeletes the selected items after you confirm. See Delete Lake items.
Batch selectShows checkboxes, so you can tick several items at once.
Batch editOpens batch edit for the selected datasource. See Batch edit and organise.
Expand allOpens every folder, datasource, database, schema and workflow group. Tables stay closed.
Collapse allCloses every open row.

Tooltips explain why a button is off. For example, Deploy needs a table that is not deployed and has a primary key, and Batch edit needs a ready datasource.

Use the Dashboard

  1. Click Dashboard, then switch the grouping with By type or By folder.
  2. Each group card shows a count beside an icon. Point at an icon to read its name: Tables, Workflows, Deployed, Pending Deployment or Missing PK. A table counted as Missing PK has no primary key, so it cannot be deployed.
  3. Click Add data source on a group card to connect a new datasource; the card's folder or type is applied to the form.

Empty and loading states:

Work with datasource tabs

Read what a source is doing

A datasource that is ready shows no badge; what each badge on a tree row means is explained in The Lake tree. Only a connector install shows step-by-step progress; a sync or a load reports a single Processing state.

The Error Details panel shows the failure message: Copy copies it, Copied confirms, and Close closes the panel. If the copy fails, it shows Unable to copy.

While a source is Processing or Installing, the screen checks it every 10 seconds. After about three and a half minutes without progress it stops and shows Idle; Refresh in the right-click menu starts the checks again. An open datasource form checks again every 5 seconds while the source is processing or installing.

After you create a datasource, the screen watches it for up to 30 minutes. When it becomes ready, its source panel opens by itself; if it fails, a toast says the source failed and points you to the datasource for the details. The messages behind a failure are in Lake troubleshooting.

Open the Lake on a specific item

The add flow has its own links; see Add a data source.

Use keyboard shortcuts

The Alt shortcuts work anywhere on the Lake screen; the tree shortcuts work while a row in the tree has focus. On a Mac, use ⌘ in place of Ctrl.

ActionShortcut
Show panel / Hide panelAlt+1
DashboardAlt+2
Relationship DiagramAlt+3
WorkflowsAlt+4
Add NewAlt+N
Edit (datasources and tables)Enter
View SourceCtrl+U
Show WorkflowsAlt+W
DuplicateAlt+C
Batch EditCtrl+Shift+E
Sync SchemaCtrl+Shift+S
RefreshCtrl+R (not in Safari)
DeleteCtrl+Backspace

Check your permissions

ControlPermission
The Lake item in the sidebarView Lake Objects, or Add/Modify Lake Objects
The Workflows viewView Lake Workflow Objects
DeployAdd/Modify Lake Objects
DeleteRemove Lake Objects
Sync Schema and Stop SyncExecute/Abort Lake Objects

For the full picture, see Who can do what in the Lake.

Questions, answered

My datasource shows Idle. Is it stuck?

No. Idle means the screen stopped checking after a datasource stayed Processing for about three and a half minutes. Right-click the datasource and choose Refresh to see its real state; if it is still working, the checks start again.

Why does a stopped sync show Stopped in grey?

Stopped records a sync you ended yourself, in grey because nothing is broken. A red Failed badge is an operation that went wrong. To see the message behind a failure, click the badge or see Run, stop and troubleshoot loads.

What does Missing PK mean on a group card?

It counts the tables in the group that have no primary key. A table without one cannot be deployed, so the count shows what stands between you and a deploy. See Configure a table.

How many datasource tabs can I keep open?

Up to 20, and they come back when you reopen the Lake.

Which view does the Lake open on next time?

The one you used last, for 24 hours: Dashboard, Relationship Diagram or Workflows. After that the Lake starts on Dashboard. The add view is never the one you return to.

Can I link a colleague straight to a datasource?

Yes. ?openDataSourceId=<id> opens that datasource's tab, and ?focusDataSourceId=<id> scrolls the tree to it and briefly highlights it. ?focus=<name> works too, but prefer the id, because names can repeat. The Lake clears the parameter once it is used, so the link opens its target each time it is followed.

Can I hide the tree panel?

Yes. Hide panel / Show panel, or Alt+1, collapses and restores the left panel. It comes back the way you left it.

Do my dashboard groups keep their order?

Yes, in this browser. Drag a card by its Drag to reorder handle; By type and By folder keep separate orders.

Are the numbers on the group cards live?

They refresh on their own about once a minute, so a card can be a moment behind.

Why is there no Refresh shortcut in Safari?

In Safari, ⌘R reloads the page, so the key never reaches the app and Refresh has no shortcut there. The Refresh item stays in the right-click menu; use it instead.