You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
DOC-655 Docs for updated asset selection syntax (#27672)
## Summary & Motivation
Updates "Asset selection syntax" doc with the new asset selection
syntax.
## How I Tested These Changes
Local build.
## Changelog
> Insert changelog entry or delete this section.
---------
Signed-off-by: nikki everett <nikki@dagsterlabs.com>
Co-authored-by: Marco polo <salazarm@users.noreply.github.com>
Co-authored-by: graphite-app[bot] <96075541+graphite-app[bot]@users.noreply.github.com>
Copy file name to clipboardexpand all lines: docs/docs/dagster-plus/features/asset-catalog/catalog-views.md
+17-20
Original file line number
Diff line number
Diff line change
@@ -3,12 +3,12 @@ title: "Catalog views"
3
3
sidebar_position: 100
4
4
---
5
5
6
-
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.
6
+
Catalog views enable you to filter down your view of the Dagster Asset catalog in Dagster+ with the [asset selection syntax](/guides/build/assets/asset-selection-syntax/), allowing you to toggle between sets of assets that you care about most.
7
7
8
8
You can save catalog views for your own use or share them with your team. For example, you could create views that:
9
9
10
-
-Filter assets based on ownership to only show those owned by your team
11
-
-Filter assets based on the asset kind to give insight into the status of your ELT ingestion
10
+
-Select assets based on ownership to only show those owned by your team
11
+
-Select assets based on the asset kind to give insight into the status of your ELT ingestion
12
12
- Display assets with a "gold" medallion tag, showing only refined, high-quality data that analysts can use with confidence
13
13
14
14
In this guide, you'll learn how to create, access, and share catalog views with others.
To view the Dagster+ Asset catalog, use the **Catalog** button on the top navigation.
25
-
26
-
In any Dagster+ catalog page, you can access the current catalog view, or create a new catalog view with the catalog view dropdown at the top left of the screen. By default, this button is labeled **All assets**, and has a globe icon.
24
+
On any Dagster+ Catalog page, you can access the current catalog view, or create a new catalog view with the catalog view dropdown at the top left of the screen. By default, this button is labeled **All assets**, and has a globe icon.
27
25
28
26
29
27
30
28
To create a new catalog view, you have two options:
31
29
-[Create a new catalog view from scratch](#creating-a-new-catalog-view-from-scratch), from the catalog view menu.
32
-
-[Create a new catalog view from your current set of filters](#creating-a-new-catalog-view-from-your-current-set-of-filters).
30
+
-[Create a new catalog view from your current asset selection](#creating-a-new-catalog-view-from-your-current-asset-selection).
33
31
34
32
### Creating a new catalog view from scratch
35
33
36
34
1. Click the catalog view dropdown to open the catalog view menu. From here, click the **New** button.
37
-
2.Give the view a name and optionally, a description and icon.
38
-
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.
39
-
4. To make the view shareable, toggle the **Public view** switch.
35
+
2.In the search box, enter an asset selection using the [asset selection syntax](/guides/build/assets/asset-selection-syntax/reference).
36
+
3.Give your view a name and optionally, a description and icon.
37
+
4. To share your view, toggle the **Public view** switch.
40
38
5. Click **Create view** to create the view.
41
39
42
40
43
41
44
-
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]/guides/build/assets/metadata-and-tags/), tags, kinds, owners, asset groups, or other properties.
45
-
46
-
### Creating a new catalog view from your current set of filters
42
+
### Creating a new catalog view from your current asset selection
47
43
48
-
When viewing the global asset lineage or asset list, you can create a new catalog view from your current set of filters.
44
+
When viewing the global asset lineage or asset list, you can create a new catalog view from your current asset selection.
49
45
50
-
1. On these pages, select one or more asset filters.
51
-
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.
52
-
3. Give the view a name and optionally, a description and icon.
53
-
4. To make the view shareable, toggle the **Public view** switch.
46
+
1. On these pages, enter an asset selection using the [asset selection syntax](/guides/build/assets/asset-selection-syntax/reference) in the search box.
47
+
2. Click the **globe icon** located to the right of the search box. This will open the catalog view creation dialog with your current asset selection pre-populated.
48
+
3. Give your view a name and optionally, a description and icon.
49
+
4. To share your view, toggle the **Public view** switch.
54
50
5. Click **Create view** to create the view.
55
51
56
-
52
+
57
53
58
54
## Editing, duplicating, or deleting catalog views
59
55
60
56
1. Click the **catalog view** button to open the catalog view menu.
61
57
2. Search for the view you want to edit, duplicate, or delete.
62
58
3. Click the **three dot menu** to the right of the view to display available options.
63
-
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**.
59
+
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.
60
+
5. When finished, click **Save changes**.
64
61
65
62
|[Schedules](schedules/)| Run a selection of assets at specified times with a cron expression | Regular, time-based job runs and basic time-based automation | Assets, Ops, Graphs |
20
+
|[Schedules](schedules/)| Run a [selection of assets](/guides/build/assets/asset-selection-syntax) at specified times with a cron expression | Regular, time-based job runs and basic time-based automation | Assets, Ops, Graphs |
21
21
|[Declarative automation](declarative-automation/)| A framework that allows you to set automation conditions on assets and asset checks | Asset-centric, condition-based updates | Assets only |
22
22
|[Sensors](sensors/)| Trigger runs based on events or conditions that you define, like the arrival of a new file or a change to an external system | Event-driven automation | Assets, Ops, Graphs |
23
23
|[Asset sensors](asset-sensors)| Trigger jobs when specified assets are materialized, allowing you to create dependencies between jobs or code locations. | Cross-job/location asset dependencies | Assets only |
Copy file name to clipboardexpand all lines: docs/docs/guides/automate/schedules/constructing-schedules-for-partitioned-assets-and-jobs.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -130,5 +130,5 @@ If we only want to target the `Antarctica` partition, we can create a schedule l
130
130
| <PyObjectsection="schedules-sensors"module="dagster"object="schedule"decorator /> | Decorator that defines a schedule that executes according to a given cron schedule. |
131
131
| <PyObjectsection="schedules-sensors"module="dagster"object="build_schedule_from_partitioned_job" /> | A function that constructs a schedule whose interval matches the partitioning of a partitioned job. |
132
132
| <PyObjectsection="schedules-sensors"module="dagster"object="RunRequest" /> | A class that represents all the information required to launch a single run. |
133
-
| <PyObjectsection="assets"module="dagster"object="define_asset_job" /> | A function for defining a job from a selection of assets. |
133
+
| <PyObjectsection="assets"module="dagster"object="define_asset_job" /> | A function for defining a job from a [selection of assets](/guides/build/assets/asset-selection-syntax). |
134
134
| <PyObjectsection="jobs"module="dagster"object="job"decorator /> | The decorator used to define a job. |
![graphite-app[bot]](https://avatars.githubusercontent.com/in/158384?v=4&size=40){kind=avatar}
0 commit comments