Skip to content

Commit b00abe6

Browse files
benpankowcmpaddenerinkcochran87PedramNavid
authored
[DOC-372] Saved views guide (#23943)
## Summary & Motivation Adds a page describing catalog views, how to manipulate them, and potential use-cases. https://dagster-docs-beta-g3ci1gizo-elementl.vercel.app/dagster-plus/saved-views ## Changelog [Docs] `NOCHANGELOG` --------- Co-authored-by: colton <[email protected]> Co-authored-by: Erin Cochran <[email protected]> Co-authored-by: Pedram Navid <[email protected]>
1 parent d7bef80 commit b00abe6

File tree

2 files changed

+73
-1
lines changed

2 files changed

+73
-1
lines changed
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: "Saving asset filters as catalog views"
3+
displayed_sidebar: "dagsterPlus"
4+
---
5+
6+
# Saving asset filters as catalog views
7+
8+
Catalog views enable you to filter down your view of the Dagster Asset catalog in Dagster+, allowing you to toggle between sets of assets that you care about most.
9+
10+
You can save catalog views for your own use or share them with your team. For example, you could create views that:
11+
12+
- Filter assets based on ownership to only show those owned by your team
13+
- Filter assets based on the asset kind to give insight into the status of your ELT ingestion
14+
- Display assets with a "gold" medallion tag, showing only refined, high-quality data that analysts can use with confidence analysts can use with confidence
15+
16+
In this guide, you'll learn how to create, access, and share catalog views with others.
17+
18+
<details>
19+
<summary>Prerequisites</summary>
20+
21+
- **Organization Admin**, **Admin**, or **Editor** permissions on Dagster+
22+
- Familiarity with [Assets](/concepts/assets) and [Asset metadata](/guides/data-modeling/metadata)
23+
24+
</details>
25+
26+
27+
28+
29+
## Create catalog views
30+
31+
To view the Dagster+ Asset catalog, use the **Catalog** button on the top navigation.
32+
33+
In any Dagster+ catalog page, you can access the current catalog view, or create a new catalog view with the catalog view button on the top left of the screen. By default, this button is labeled **All assets**, and has a globe icon.
34+
35+
![Screenshot of the catalog view dropdown](/img/placeholder.svg)
36+
37+
To create a new catalog view, you have two options:
38+
1. Create a new catalog view from scratch, from the catalog view menu.
39+
2. Create a new catalog view from your current set of filters.
40+
41+
### Create a new catalog view from scratch
42+
43+
1. Click the catalog view button to open the catalog view menu. From here, click the **New** button.
44+
2. Give the view a name and optionally, a description and icon.
45+
3. Click **Add filters** to select filters to apply to the view. Filters can select a subset of assets based on their metadata, tags, kinds, owners, asset groups, or other properties.
46+
4. To make the view shareable, toggle the **Public view** switch.
47+
5. Click **Create view** to create the view.
48+
49+
![Screenshot of catalog view customization UI](/img/placeholder.svg)
50+
51+
Give your view a name and optionally a description and icon. Next, you can select one or more filters to apply to your view by clicking the "Add filters" button. Filters can select a subset of assets based on their metadata, tags, kinds, owners, asset groups, or other properties.
52+
53+
### Create a new catalog view from your current set of filters
54+
55+
When viewing the global asset lineage or asset list, you can create a new catalog view from your current set of filters.
56+
57+
1. On these pages, select one or more asset filters.
58+
2. Click **Create new catalog view**, located near the top right of the page. This will open the catalog view creation dialog with your current filters pre-populated.
59+
3. Give the view a name and optionally, a description and icon.
60+
4. To make the view shareable, toggle the **Public view** switch.
61+
5. Click **Create view** to create the view.
62+
63+
## Edit, duplicate, or delete catalog views
64+
65+
1. Click the catalog view button to open the catalog view menu.
66+
2. Search for the view you want to edit, duplicate, or delete.
67+
3. Click the **three dot menu** to the right of the view to display available options.
68+
4. If modifying the view, note that any active filters will automatically be included in the set of changes. You can also change the view's name, description, icon, and sharing settings. 5. When finished, click **Save changes**.

docs/docs-beta/sidebars.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
1+
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';
22

33
/**
44
* Creating a sidebar enables you to:
@@ -387,6 +387,10 @@ const sidebars: SidebarsConfig = {
387387
},
388388
],
389389
},
390+
{
391+
type: 'doc',
392+
id: 'dagster-plus/saved-views',
393+
},
390394
],
391395
},
392396
{

0 commit comments

Comments
 (0)