From e225650cc6724f44ae55fb4f4d1b0d21c315324b Mon Sep 17 00:00:00 2001 From: Tatiana Al-Chueyr Date: Tue, 14 Jan 2025 13:56:46 +0000 Subject: [PATCH 1/3] Improve Cosmos select docs To include the changes introduced in the PR #1150 --- docs/configuration/selecting-excluding.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/configuration/selecting-excluding.rst b/docs/configuration/selecting-excluding.rst index 9ee778e51..7b7008346 100644 --- a/docs/configuration/selecting-excluding.rst +++ b/docs/configuration/selecting-excluding.rst @@ -17,6 +17,9 @@ The ``select`` and ``exclude`` parameters are lists, with values like the follow - ``config.materialized:table``: include/exclude models with the config ``materialized: table`` - ``path:analytics/tables``: include/exclude models in the ``analytics/tables`` directory - ``+node_name+1`` (graph operators): include/exclude the node with name ``node_name``, all its parents, and its first generation of children (`dbt graph selector docs `_) +- ``+/path/to/model_g+`` (graph operators): include/exclude all the nodes in the path ``/path/to/model_g``, their parents and children +- ``+tag:nightly`` (graph operators): include/exclude all nodes that have tag ``nightly`` and their parents. +- ``+config.materialized:view`` (graph operators): include/exclude all the nodes that have the materialization ``view`` and their parents - ``@node_name`` (@ operator): include/exclude the node with name ``node_name``, all its descendants, and all ancestors of those descendants. This is useful in CI environments where you want to build a model and all its descendants, but you need the ancestors of those descendants to exist first. - ``tag:my_tag,+node_name`` (intersection): include/exclude ``node_name`` and its parents if they have the tag ``my_tag`` (`dbt set operator docs `_) - ``['tag:first_tag', 'tag:second_tag']`` (union): include/exclude nodes that have either ``tag:first_tag`` or ``tag:second_tag`` From 9a5eaf8b758dd4872f86eff695cb290b36b00920 Mon Sep 17 00:00:00 2001 From: Tatiana Al-Chueyr Date: Wed, 15 Jan 2025 13:43:42 +0000 Subject: [PATCH 2/3] Update docs/configuration/selecting-excluding.rst --- docs/configuration/selecting-excluding.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/selecting-excluding.rst b/docs/configuration/selecting-excluding.rst index 7b7008346..f04a0988d 100644 --- a/docs/configuration/selecting-excluding.rst +++ b/docs/configuration/selecting-excluding.rst @@ -15,7 +15,7 @@ The ``select`` and ``exclude`` parameters are lists, with values like the follow - ``tag:my_tag``: include/exclude models with the tag ``my_tag`` - ``config.materialized:table``: include/exclude models with the config ``materialized: table`` -- ``path:analytics/tables``: include/exclude models in the ``analytics/tables`` directory +- ``path:analytics/tables``: include/exclude models in the ``analytics/tables`` directory. In this example, `analytics/table` is a relative path, but absolute paths are also supported. - ``+node_name+1`` (graph operators): include/exclude the node with name ``node_name``, all its parents, and its first generation of children (`dbt graph selector docs `_) - ``+/path/to/model_g+`` (graph operators): include/exclude all the nodes in the path ``/path/to/model_g``, their parents and children - ``+tag:nightly`` (graph operators): include/exclude all nodes that have tag ``nightly`` and their parents. From 0f08af2602b08ac1bf18fc164c5b5729de4bca0a Mon Sep 17 00:00:00 2001 From: Tatiana Al-Chueyr Date: Wed, 15 Jan 2025 13:43:59 +0000 Subject: [PATCH 3/3] Update docs/configuration/selecting-excluding.rst --- docs/configuration/selecting-excluding.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/selecting-excluding.rst b/docs/configuration/selecting-excluding.rst index f04a0988d..b116937cb 100644 --- a/docs/configuration/selecting-excluding.rst +++ b/docs/configuration/selecting-excluding.rst @@ -17,7 +17,7 @@ The ``select`` and ``exclude`` parameters are lists, with values like the follow - ``config.materialized:table``: include/exclude models with the config ``materialized: table`` - ``path:analytics/tables``: include/exclude models in the ``analytics/tables`` directory. In this example, `analytics/table` is a relative path, but absolute paths are also supported. - ``+node_name+1`` (graph operators): include/exclude the node with name ``node_name``, all its parents, and its first generation of children (`dbt graph selector docs `_) -- ``+/path/to/model_g+`` (graph operators): include/exclude all the nodes in the path ``/path/to/model_g``, their parents and children +- ``+/path/to/model_g+`` (graph operators): include/exclude all the nodes in the absolute path ``/path/to/model_g``, their parents and children. Relative paths are also supported. - ``+tag:nightly`` (graph operators): include/exclude all nodes that have tag ``nightly`` and their parents. - ``+config.materialized:view`` (graph operators): include/exclude all the nodes that have the materialization ``view`` and their parents - ``@node_name`` (@ operator): include/exclude the node with name ``node_name``, all its descendants, and all ancestors of those descendants. This is useful in CI environments where you want to build a model and all its descendants, but you need the ancestors of those descendants to exist first.