Preview and Dependants

A view's window has a Preview tab that loads the view's rows and a Dependants tab that lists the objects using the view. Use them to check what a view returns and who relies on it before you change or drop the view. The view window itself is described in Views.

Preview the view's rows

1. Open the view from the Warehouse tree and click Preview.
2. To load the rows, click Refresh. Nothing loads on its own; before the first load the tab reads "Load the view preview to get started".
3. While the first load runs, the tab reads "Loading the view preview…" and shows Stop. Click Stop to cancel the load; a cancelled load is not an error and the tab keeps the rows it already had.
4. In a loaded grid, the toolbar's Refresh data control reloads the rows and turns into Stop while a reload runs.
5. If the query fails, a banner reads Query failed with the reason under it and a Retry button. Click Retry to run the query again.

Rows from the last good load stay on screen when a query fails, so you keep the rows you were reading while you fix the problem. Until the view has a saved record, the tab reads View Not Created with "Please save the view first to preview data"; save the view first.

Export the preview

Use Export data in the grid toolbar to save the preview rows to a file. The file is named after the view; if the window has no title, the name falls back to view_<id>.

Review the objects that use the view

1. Open the view and click Dependants.
2. Read the groups. Objects group by kind in a fixed order: Dimension, Fact, Dictionary, Static, View, Transformation, Lake, Mind, Write-back, Reference, Presentation and Semantic model. Only the kinds in use appear, and each group card carries its count.
3. Click a row to open what it names. Warehouse objects open their windows, a Lake row opens its editor, a Presentation row opens its deck, and a Semantic model row opens its page. A Reference row opens the table it points at.
4. Point at a row's pencil to see the action: Edit dimension, Edit fact, Edit dictionary, Edit static, Edit view, Edit lake, Edit write-back, Edit transformation, Start new chat, Edit reference, Open presentation or Open semantic model.
5. A Mind row works in two ways. Clicking it opens the Mind's Sources when you can open the Mind's settings panel, and starts a new chat when you cannot. The pencil always starts a new chat, and the View mind sources shortcut appears only when you can open that panel.

The same Dependants tab appears on Dimension, Fact and Static tables; the shared rules are described in Dependencies and dependants.

When the list is not complete

• Rows that stand for objects outside your access are summarised by count, like "2 presentations you cannot access". They are informational only: they carry no names and are not links.
• If the check could not be completed, the tab shows Dependants could not be determined and leaves the failed check out of the list. Treat the list as incomplete rather than empty.
• With nothing found, the tab reads No dependants found and "This view is not currently used by any downstream objects."
• If the list cannot load, it reads Failed to load dependants with the reason under it and a Retry button. Click Retry to load it again.

Questions, answered

Why do the Preview and Dependants tabs say "View Not Created"?

The view has not been saved yet. Until the view has a saved record, Preview reads View Not Created with "Please save the view first to preview data", and Dependants shows the same title with "Please save the view first to view its dependants". Save the view's General step first; both tabs fill in after the first save.

How do I stop a preview that is still loading?

Click Stop. It appears in the empty state while the first load runs, in the Query failed banner while a retry runs, and in the grid toolbar while a reload runs. Stopping cancels the load and is not treated as an error.

What name does the exported view preview get?

The file is named after the view. If the window has no title, the name falls back to view_<id>. Export from the grid toolbar with Export data.

How do I open something from the Dependants list?

Click the row. Warehouse objects open their windows, a Presentation opens its deck, a Semantic model opens its page, and a Reference opens the table it points at. Hover a row to reveal the pencil; its tooltip names the action, from Edit dimension to Open semantic model.

How do I open a Mind that uses the view?

Click the Mind row. It opens the Mind's Sources when you can open the Mind's settings panel; when you cannot, it starts a new chat instead. The pencil starts a new chat either way, and the View mind sources shortcut appears only when you can open that panel.

Why is a dependant shown only as a count?

It stands for objects outside your access, like "2 presentations you cannot access". Such rows are informational: they carry no names, are not links, and cannot be opened.

What do the slide numbers next to a presentation mean?

They name where in the deck the view is used, like slide 4 or slides 4, 7.

What does "Dependants could not be determined" mean?

The dependants check could not be completed. The tab shows the warning Dependants could not be determined with the text "DataPrism dependants could not be determined because the check failed. Acting on the assumption that this table is unused may be unsafe." The failed check is not counted as a dependant, so the rows you see may be incomplete.