Skip to content

Commit

Permalink
[DOC-372] Saved views guide (#23943)
Browse files Browse the repository at this point in the history
## 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]>
  • Loading branch information
4 people authored Aug 30, 2024
1 parent d7bef80 commit b00abe6
Show file tree
Hide file tree
Showing 2 changed files with 73 additions and 1 deletion.
68 changes: 68 additions & 0 deletions docs/docs-beta/docs/dagster-plus/saved-views.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
title: "Saving asset filters as catalog views"
displayed_sidebar: "dagsterPlus"
---

# Saving asset filters as catalog views

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.

You can save catalog views for your own use or share them with your team. For example, you could create views that:

- Filter assets based on ownership to only show those owned by your team
- Filter assets based on the asset kind to give insight into the status of your ELT ingestion
- Display assets with a "gold" medallion tag, showing only refined, high-quality data that analysts can use with confidence analysts can use with confidence

In this guide, you'll learn how to create, access, and share catalog views with others.

<details>
<summary>Prerequisites</summary>

- **Organization Admin**, **Admin**, or **Editor** permissions on Dagster+
- Familiarity with [Assets](/concepts/assets) and [Asset metadata](/guides/data-modeling/metadata)

</details>




## Create catalog views

To view the Dagster+ Asset catalog, use the **Catalog** button on the top navigation.

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.

![Screenshot of the catalog view dropdown](/img/placeholder.svg)

To create a new catalog view, you have two options:
1. Create a new catalog view from scratch, from the catalog view menu.
2. Create a new catalog view from your current set of filters.

### Create a new catalog view from scratch

1. Click the catalog view button to open the catalog view menu. From here, click the **New** button.
2. Give the view a name and optionally, a description and icon.
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.
4. To make the view shareable, toggle the **Public view** switch.
5. Click **Create view** to create the view.

![Screenshot of catalog view customization UI](/img/placeholder.svg)

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.

### Create a new catalog view from your current set of filters

When viewing the global asset lineage or asset list, you can create a new catalog view from your current set of filters.

1. On these pages, select one or more asset filters.
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.
3. Give the view a name and optionally, a description and icon.
4. To make the view shareable, toggle the **Public view** switch.
5. Click **Create view** to create the view.

## Edit, duplicate, or delete catalog views

1. Click the catalog view button to open the catalog view menu.
2. Search for the view you want to edit, duplicate, or delete.
3. Click the **three dot menu** to the right of the view to display available options.
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**.
6 changes: 5 additions & 1 deletion docs/docs-beta/sidebars.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
import type { SidebarsConfig } from '@docusaurus/plugin-content-docs';

/**
* Creating a sidebar enables you to:
Expand Down Expand Up @@ -387,6 +387,10 @@ const sidebars: SidebarsConfig = {
},
],
},
{
type: 'doc',
id: 'dagster-plus/saved-views',
},
],
},
{
Expand Down

0 comments on commit b00abe6

Please sign in to comment.