Skip to content

Commit e043f3e

Browse files
github-actions[bot]github-actions[bot]
committed
Deployed by GitHub Actions
1 parent bdeb337 commit e043f3e

6 files changed

Lines changed: 77 additions & 7 deletions

File tree

‎main/advanced_config/jobs_importing/index.html‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -860,7 +860,7 @@ <h3 id="defining-some-jobs-to-be-imported-to-only-specific-environments">Definin
860860
</ul>
861861
</li>
862862
</ul>
863-
<p>As an example, if a job is named <code>My daily job [[uat:my-daily-job]]</code> :</p>
863+
<p>As an example, if a job is named <code>My daily job [[uat:my-daily-job]]</code> (or has <code>[[uat:my-daily-job]]</code> in its description when using <code>--use-desc-for-id</code>) :</p>
864864
<ul>
865865
<li><code>dbt-jobs-as-code import-jobs ... --filter uat</code> will import the job ✅</li>
866866
<li><code>dbt-jobs-as-code import-jobs ...</code> without a filter will import the job ✅</li>
@@ -894,7 +894,7 @@ <h3 id="defining-some-jobs-to-be-imported-to-only-specific-environments">Definin
894894
<span class="md-icon" title="Last update">
895895
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
896896
</span>
897-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">February 21, 2025</span>
897+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">May 18, 2026</span>
898898
</span>
899899

900900

‎main/changelog/index.html‎

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@
7272
<div data-md-component="skip">
7373

7474

75-
<a href="#116" class="md-skip">
75+
<a href="#118" class="md-skip">
7676
Skip to content
7777
</a>
7878

@@ -692,6 +692,24 @@
692692
</label>
693693
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
694694

695+
<li class="md-nav__item">
696+
<a href="#118" class="md-nav__link">
697+
<span class="md-ellipsis">
698+
1.18
699+
</span>
700+
</a>
701+
702+
</li>
703+
704+
<li class="md-nav__item">
705+
<a href="#117" class="md-nav__link">
706+
<span class="md-ellipsis">
707+
1.17
708+
</span>
709+
</a>
710+
711+
</li>
712+
695713
<li class="md-nav__item">
696714
<a href="#116" class="md-nav__link">
697715
<span class="md-ellipsis">
@@ -808,6 +826,15 @@
808826
<h1>Changelog</h1>
809827

810828
<p>To see the details of all changes, head to the GitHub repo</p>
829+
<h3 id="118">1.18</h3>
830+
<ul>
831+
<li>Add <code>--use-desc-for-id</code> flag (env var: <code>DBT_JOBS_AS_CODE_USE_DESC_FOR_ID</code>) to store the <code>[[&lt;identifier&gt;]]</code> tag in the job description instead of the job name. This is useful when keeping job names clean in the dbt Cloud UI is a requirement. Supported by all commands: <code>plan</code>, <code>sync</code>, <code>validate</code>, <code>import-jobs</code>, <code>link</code>, <code>unlink</code>, <code>deactivate-jobs</code>.</li>
832+
</ul>
833+
<h3 id="117">1.17</h3>
834+
<ul>
835+
<li>Validate that job descriptions don't exceed the 255 character limit before sending to the API.</li>
836+
<li>Drop Python 3.9 support (EOL) and update dependencies.</li>
837+
</ul>
811838
<h3 id="116">1.16</h3>
812839
<ul>
813840
<li>Add support for <code>cost_optimization_features</code> in job definitions. Valid values are <code>state_aware_orchestration</code> and <code>efficient_testing</code>. This allows for dbt users on the Fusion engine to configure cost optimization natively in their YAML job definitions.</li>
@@ -869,7 +896,7 @@ <h3 id="10">1.0</h3>
869896
<span class="md-icon" title="Last update">
870897
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
871898
</span>
872-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">March 5, 2026</span>
899+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">May 18, 2026</span>
873900
</span>
874901

875902

‎main/cli/index.html‎

Lines changed: 43 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -811,7 +811,7 @@
811811
<h1 id="cli-reference">CLI reference</h1>
812812
<p>This page provides documentation for our command line tools.</p>
813813
<h2 id="dbt-jobs-as-code">dbt-jobs-as-code</h2>
814-
<p>dbt-jobs-as-code 1.17.1.dev4+g4856cfa</p>
814+
<p>dbt-jobs-as-code 1.17.1.dev20+g1645dbc</p>
815815
<p>A CLI to allow defining dbt Cloud jobs as code</p>
816816
<p><strong>Usage:</strong></p>
817817
<div class="highlight"><pre><span></span><code>dbt-jobs-as-code [OPTIONS] COMMAND [ARGS]...
@@ -896,6 +896,12 @@ <h3 id="deactivate-jobs">deactivate-jobs</h3>
896896
<td>None</td>
897897
</tr>
898898
<tr>
899+
<td><code>--use-desc-for-id</code></td>
900+
<td>boolean</td>
901+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
902+
<td><code>False</code></td>
903+
</tr>
904+
<tr>
899905
<td><code>--help</code></td>
900906
<td>boolean</td>
901907
<td>Show this message and exit.</td>
@@ -983,6 +989,12 @@ <h3 id="import-jobs">import-jobs</h3>
983989
<td>None</td>
984990
</tr>
985991
<tr>
992+
<td><code>--use-desc-for-id</code></td>
993+
<td>boolean</td>
994+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
995+
<td><code>False</code></td>
996+
</tr>
997+
<tr>
986998
<td><code>--help</code></td>
987999
<td>boolean</td>
9881000
<td>Show this message and exit.</td>
@@ -1033,6 +1045,12 @@ <h3 id="link">link</h3>
10331045
<td><code>False</code></td>
10341046
</tr>
10351047
<tr>
1048+
<td><code>--use-desc-for-id</code></td>
1049+
<td>boolean</td>
1050+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
1051+
<td><code>False</code></td>
1052+
</tr>
1053+
<tr>
10361054
<td><code>--help</code></td>
10371055
<td>boolean</td>
10381056
<td>Show this message and exit.</td>
@@ -1101,6 +1119,12 @@ <h3 id="plan">plan</h3>
11011119
<td>None</td>
11021120
</tr>
11031121
<tr>
1122+
<td><code>--use-desc-for-id</code></td>
1123+
<td>boolean</td>
1124+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
1125+
<td><code>False</code></td>
1126+
</tr>
1127+
<tr>
11041128
<td><code>--help</code></td>
11051129
<td>boolean</td>
11061130
<td>Show this message and exit.</td>
@@ -1169,6 +1193,12 @@ <h3 id="sync">sync</h3>
11691193
<td>None</td>
11701194
</tr>
11711195
<tr>
1196+
<td><code>--use-desc-for-id</code></td>
1197+
<td>boolean</td>
1198+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
1199+
<td><code>False</code></td>
1200+
</tr>
1201+
<tr>
11721202
<td><code>--fail-fast</code></td>
11731203
<td>boolean</td>
11741204
<td>Stop subsequent operations if any step fails during sync.</td>
@@ -1242,6 +1272,12 @@ <h3 id="unlink">unlink</h3>
12421272
<td>None</td>
12431273
</tr>
12441274
<tr>
1275+
<td><code>--use-desc-for-id</code></td>
1276+
<td>boolean</td>
1277+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
1278+
<td><code>False</code></td>
1279+
</tr>
1280+
<tr>
12451281
<td><code>--help</code></td>
12461282
<td>boolean</td>
12471283
<td>Show this message and exit.</td>
@@ -1285,6 +1321,12 @@ <h3 id="validate">validate</h3>
12851321
<td><code>False</code></td>
12861322
</tr>
12871323
<tr>
1324+
<td><code>--use-desc-for-id</code></td>
1325+
<td>boolean</td>
1326+
<td>Store the [[identifier]] tag in the job description instead of the job name.</td>
1327+
<td><code>False</code></td>
1328+
</tr>
1329+
<tr>
12881330
<td><code>--help</code></td>
12891331
<td>boolean</td>
12901332
<td>Show this message and exit.</td>

‎main/getting_started/index.html‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -852,6 +852,7 @@ <h2 id="pre-requisites">Pre-requisites</h2>
852852
<ul>
853853
<li><code>DBT_API_KEY</code>: [Mandatory] The dbt Cloud API key to interact with dbt Cloud. Can be a Service Token (preferred, would require the "job admin" scope) or the API token of a given user</li>
854854
<li><code>DBT_BASE_URL</code>: [Optional] By default, the tool queries <code>https://cloud.getdbt.com</code>, if your dbt Cloud instance is hosted on another domain, define it in this env variable (e.g. <code>https://emea.dbt.com</code>)</li>
855+
<li><code>DBT_JOBS_AS_CODE_USE_DESC_FOR_ID</code>: [Optional] When set to <code>True</code>, stores the <code>[[&lt;identifier&gt;]]</code> tag in the job description instead of the job name. See <code>--use-desc-for-id</code> for details.</li>
855856
</ul>
856857
<h2 id="how-to-use-dbt-jobs-as-code">How to use <code>dbt-jobs-as-code</code></h2>
857858
<p><code>dbt-jobs-as-code</code> can be used in many different ways:</p>
@@ -951,7 +952,7 @@ <h2 id="how-to-contribute-to-dbt-jobs-as-code">How to contribute to <code>dbt-jo
951952
<span class="md-icon" title="Last update">
952953
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
953954
</span>
954-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">February 21, 2025</span>
955+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">May 18, 2026</span>
955956
</span>
956957

957958

‎main/search/search_index.json‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎main/sitemap.xml.gz‎

0 Bytes
Binary file not shown.

0 commit comments

Comments
 (0)