From 4197c550854a95a631aea6e026c45f3911be2f7d Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 10 Jul 2024 10:55:17 +0100 Subject: [PATCH] add nodes to project state doc (#5654) this pr continue's @dbeatty10 's [pr](https://github.com/dbt-labs/docs.getdbt.com/pull/5641) and adds Analysis Saved query, and Unit tests to the nodes table. Resolves #5648 --------- Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Co-authored-by: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> --- .../docs/docs/dbt-cloud-apis/project-state.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/website/docs/docs/dbt-cloud-apis/project-state.md b/website/docs/docs/dbt-cloud-apis/project-state.md index 71b367cb5ad..1007f31effe 100644 --- a/website/docs/docs/dbt-cloud-apis/project-state.md +++ b/website/docs/docs/dbt-cloud-apis/project-state.md @@ -59,18 +59,24 @@ Most Discovery API use cases will favor the _applied state_ since it pertains to ## Affected states by node type +The following table shows the states of dbt nodes and how they are affected by the Discovery API. + | Node | Executed in DAG | Created by execution | Exists in database | Lineage | States | |-----------------------------------------------|------------------|----------------------|--------------------|-----------------------|----------------------| -| [Model](/docs/build/models) | Yes | Yes | Yes | Upstream & downstream | Applied & definition | -| [Source](/docs/build/sources) | Yes | No | Yes | Downstream | Applied & definition | -| [Seed](/docs/build/seeds) | Yes | Yes | Yes | Downstream | Applied & definition | -| [Snapshot](/docs/build/snapshots) | Yes | Yes | Yes | Upstream & downstream | Applied & definition | +| [Analysis](/docs/build/analyses) | No | No | No | Upstream | Definition | | [Data test](/docs/build/data-tests) | Yes | Yes | No | Upstream | Applied & definition | | [Exposure](/docs/build/exposures) | No | No | No | Upstream | Definition | -| [Metric](/docs/build/metrics-overview) | No | No | No | Upstream & downstream | Definition | -| [Semantic model](/docs/build/semantic-models) | No | No | No | Upstream & downstream | Definition | | [Group](/docs/build/groups) | No | No | No | Downstream | Definition | | [Macro](/docs/build/jinja-macros) | Yes | No | No | N/A | Definition | +| [Metric](/docs/build/metrics-overview) | No | No | No | Upstream & downstream | Definition | +| [Model](/docs/build/models) | Yes | Yes | Yes | Upstream & downstream | Applied & definition | +| [Saved queries](/docs/build/saved-queries)
(not in API) | N/A | N/A | N/A | N/A | N/A | +| [Seed](/docs/build/seeds) | Yes | Yes | Yes | Downstream | Applied & definition | +| [Semantic model](/docs/build/semantic-models) | No | No | No | Upstream & downstream | Definition | +| [Snapshot](/docs/build/snapshots) | Yes | Yes | Yes | Upstream & downstream | Applied & definition | +| [Source](/docs/build/sources) | Yes | No | Yes | Downstream | Applied & definition | +| [Unit tests](/docs/build/unit-tests) | Yes | Yes | No | Downstream | Definition | + ## Caveats about state/metadata updates