<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>Atlas Blog</title>
        <link>https://atlasgo.io/blog</link>
        <description>Atlas Blog</description>
        <lastBuildDate>Thu, 19 Nov 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>en</language>
        <item>
            <title><![CDATA[Your Software Factory Stops at the Database]]></title>
            <link>https://atlasgo.io/blog/2026/11/19/software-factory-database</link>
            <guid>https://atlasgo.io/blog/2026/11/19/software-factory-database</guid>
            <pubDate>Thu, 19 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Software factories ship code with no human in the loop, but what a migration costs depends on the data, not the code. How Atlas checks the migrations, queries, functions, and triggers an agent writes against bounds the team sets once, on synthetic data and on a masked production snapshot.]]></description>
            <content:encoded><![CDATA[<p>In August, I wrote that
<a class="" href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database">the AI-native SDLC playbook stops at the database</a>. Code is
cheap to regenerate. The data in your production database isn't. Software factories make this sharper.
An agent takes a ticket, writes the code, runs the tests, and ships it, with no human in the loop.
That works for code because code has gates. Tests say whether it's correct, and a bad deploy rolls
back.</p>
<p>A migration has no such gate. It can pass every test and still lock your largest table for minutes,
because what it costs depends on the data, not the code. Today, the gate is a person who reads the
migration and knows which tables are big. A factory doesn't have that person.</p>
<p>In this post, I'll show how we close that gap in Atlas. The team writes down what database code may
cost: migrations, queries, functions, procedures, and triggers. Atlas measures every agent's change
against those limits twice, first on synthetic data in the agent's sandbox, then on a masked
production snapshot before deploy.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="correct-is-not-the-same-as-safe">Correct Is Not the Same as Safe<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#correct-is-not-the-same-as-safe" class="hash-link" aria-label="Direct link to Correct Is Not the Same as Safe" title="Direct link to Correct Is Not the Same as Safe" translate="no">​</a></h2>
<p><a class="" href="https://atlasgo.io/versioned/lint">Migration linting</a> catches known patterns, like an
<a class="" href="https://atlasgo.io/lint/analyzers#PG101">index created without <code>CONCURRENTLY</code></a>, and enforces the team's policies, such
as no destructive changes. That's governance, and a factory still needs it. Tests check that the code
properly handles the data. Neither tells you how long a statement will hold a lock, because
that depends on how many rows the table has and what they look like.</p>
<p>The expensive cases are ordinary ones:</p>
<ul>
<li class="">Changing a column type can rewrite the whole table.</li>
<li class="">Building an index sorts every row and spills to disk once the sort outgrows its memory.</li>
<li class="">Adding <code>NOT NULL</code> or a <code>CHECK</code> constraint scans the table under a lock.</li>
<li class="">Recreating a materialized view runs its query again.</li>
<li class="">A backfill touches every row its <code>WHERE</code> clause matches.</li>
<li class="">A query, function, or trigger that filters on a column with no index reads every row, each time
it runs.</li>
</ul>
<p>On an empty dev database, these take milliseconds to complete, because an agent only sees the schema,
not the 300 million rows behind it.</p>
<p>In our experience, the common practice is to let agents add tables and nullable columns, and send
everything else to a person. But the same change can be safe on one table and cause an outage on
another. An index on a 10,000-row table is nothing. On a 500 GB table, it's an incident. And even with
a person in the loop, reading the code doesn't predict the impact.</p>
<p>The question isn't what kind of change it is. It's what the change costs on your data and your
database, in the locks it holds and whether it chokes the server or runs it out of disk space.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="write-the-limits-down">Write the Limits Down<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#write-the-limits-down" class="hash-link" aria-label="Direct link to Write the Limits Down" title="Direct link to Write the Limits Down" translate="no">​</a></h2>
<p>We recently added <a class="" href="https://atlasgo.io/testing/profile#profile-expectations">profile expectations</a> to the Atlas testing
framework. An expectation is a bound on what a step of a test does to the database, and the test
fails when the step crosses it. The team writes them once, in a <code>.test.hcl</code> file:</p>
<div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">expect </span><span class="token string" style="color:rgb(195, 232, 141)">"profile"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod_safe"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Never rewrite a table.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  metric </span><span class="token string" style="color:rgb(195, 232, 141)">"db.table.rewrites"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    eq </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Nothing blocks reads or writes for more than a second.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  metric </span><span class="token string" style="color:rgb(195, 232, 141)">"db.lock.time"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    le </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"1s"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Cap the WAL a single migration writes.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  metric </span><span class="token string" style="color:rgb(195, 232, 141)">"db.log.written"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    le </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"2GB"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>A bound can cover rows read or changed, table rewrites and the disk their copies take, lock time, CPU,
memory, I/O, or log volume. The <a class="" href="https://atlasgo.io/testing/profile#metrics">metrics reference</a> lists every metric and
the labels that narrow it, such as a single table.</p>
<p>A test applies the bounds to the step it measures: a migration, a query, or a
<a class="" href="https://atlasgo.io/scripts">Data Script</a>. Each test below loads data first, and a step can add its own <code>metric</code> blocks
to the set:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Migration</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Query</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Data Script</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>The test migrates to the previous version, loads data, and then applies the agent's migration:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders_synthetic"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261118090000"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.synthetic.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261119120000"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    expect </span><span class="token string" style="color:rgb(195, 232, 141)">"profile"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">expect.profile.prod_safe</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The test runs a query over the loaded orders. Its own <code>db.rows</code> bound fails a query that reads the
whole table instead of the pending orders:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"pending_orders_synthetic"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261119120000"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.synthetic.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">exec</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">count</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">*</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> orders </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> status = </span><span class="token sql-attr sql-string string" style="color:rgb(195, 232, 141)">'pending'</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    expect </span><span class="token string" style="color:rgb(195, 232, 141)">"profile"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">expect.profile.prod_safe</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      metric </span><span class="token string" style="color:rgb(195, 232, 141)">"db.rows"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        table     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        operation </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> READ</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        le        </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The test runs the <code>cancel_pending</code> <a class="" href="https://atlasgo.io/scripts/testing#examples">Data Script</a>, which cancels the
pending orders:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"cancel_pending_synthetic"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261119120000"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.synthetic.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  script </span><span class="token string" style="color:rgb(195, 232, 141)">"exec"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    file </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"scripts.hcl"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    run  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"^cancel_pending$"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    expect </span><span class="token string" style="color:rgb(195, 232, 141)">"profile"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">expect.profile.prod_safe</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<p>Schema tests take the same block on the same steps, so the functions, procedures, and triggers an
agent writes get the same bounds. A bound Atlas can't verify fails the test too, so a pass means
every bound held.</p>
<p>The bounds live in the repo, so put the file that holds them under code owners. An agent can change
database code on its own. Loosening a bound takes a person.</p>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>Preview Feature</div><div class="admonitionContent_bl22"><p>Datasets, profiling, and profile expectations are in preview and open to a subset of Teams and
Enterprise customers. To get access, reach out through your Atlas support channel or
<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#">message us on Intercom</a>.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="same-limits-two-datasets">Same Limits, Two Datasets<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#same-limits-two-datasets" class="hash-link" aria-label="Direct link to Same Limits, Two Datasets" title="Direct link to Same Limits, Two Datasets" translate="no">​</a></h2>
<p>The bounds run twice before anything reaches production, each time on different data.</p>
<p><img decoding="async" loading="lazy" alt="The same bounds run twice before anything reaches production" src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMjQwIDQzMCIgcm9sZT0iaW1nIiBhcmlhLWxhYmVsbGVkYnk9ImJvdW5kcy10aXRsZSIgZm9udC1mYW1pbHk9InVpLW1vbm9zcGFjZSxTRk1vbm8tUmVndWxhcixNZW5sbyxDb25zb2xhcywnTGliZXJhdGlvbiBNb25vJyxtb25vc3BhY2UiPgogIDx0aXRsZSBpZD0iYm91bmRzLXRpdGxlIj5UaGUgc2FtZSBib3VuZHMgcnVuIHR3aWNlIGJlZm9yZSBhbnl0aGluZyByZWFjaGVzIHByb2R1Y3Rpb248L3RpdGxlPgogIDxkZWZzPgogICAgPG1hcmtlciBpZD0iYXJyMyIgdmlld0JveD0iMCAwIDEwIDEwIiByZWZYPSI3LjUiIHJlZlk9IjUiIG1hcmtlcldpZHRoPSI3IiBtYXJrZXJIZWlnaHQ9IjciIG9yaWVudD0iYXV0by1zdGFydC1yZXZlcnNlIj4KICAgICAgPHBhdGggZD0iTTAsMSBMOSw1IEwwLDkgTDIuMiw1IHoiIGZpbGw9IiM5N0ExQjAiLz4KICAgIDwvbWFya2VyPgogICAgPG1hcmtlciBpZD0iYXJyMy1mYWlsIiB2aWV3Qm94PSIwIDAgMTAgMTAiIHJlZlg9IjcuNSIgcmVmWT0iNSIgbWFya2VyV2lkdGg9IjciIG1hcmtlckhlaWdodD0iNyIgb3JpZW50PSJhdXRvLXN0YXJ0LXJldmVyc2UiPgogICAgICA8cGF0aCBkPSJNMCwxIEw5LDUgTDAsOSBMMi4yLDUgeiIgZmlsbD0iI0UyOEM4QyIvPgogICAgPC9tYXJrZXI+CiAgPC9kZWZzPgogIDxyZWN0IHg9IjEiIHk9IjEiIHdpZHRoPSIxMjM4IiBoZWlnaHQ9IjQyOCIgcng9IjE4IiBmaWxsPSIjRjZGOEZBIiBzdHJva2U9IiNFNUVBRjAiIHN0cm9rZS13aWR0aD0iMS41Ii8+CgogIDwhLS0gdGhlIGJvdW5kcywgd3JpdHRlbiBvbmNlIC0tPgogIDxyZWN0IHg9IjQzMCIgeT0iNDAiIHdpZHRoPSIzODAiIGhlaWdodD0iNzYiIHJ4PSIxMCIgZmlsbD0iIzM1NzhFNSIvPgogIDx0ZXh0IHg9IjQ0NiIgeT0iNjgiIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiNCRkQ3RkEiPkJPVU5EUyDCtyBXUklUVEVOIE9OQ0U8L3RleHQ+CiAgPHRleHQgeD0iNDQ2IiB5PSI5NCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+ZXhwZWN0ICJwcm9maWxlIiAicHJvZF9zYWZlIjwvdGV4dD4KCiAgPCEtLSBkb3R0ZWQgcm91dGVzIGZyb20gdGhlIGJvdW5kcyBpbnRvIGJvdGggdGVzdCBydW5zIC0tPgogIDxwYXRoIGQ9Ik00NjksMTIwIFYxNjAiIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzk3QTFCMCIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1kYXNoYXJyYXk9IjIgNiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBtYXJrZXItZW5kPSJ1cmwoI2FycjMpIi8+CiAgPHBhdGggZD0iTTc3MSwxMjAgVjE2MCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgc3Ryb2tlLWRhc2hhcnJheT0iMiA2IiBzdHJva2UtbGluZWNhcD0icm91bmQiIG1hcmtlci1lbmQ9InVybCgjYXJyMykiLz4KCiAgPCEtLSBzdGFnZSByb3cgLS0+CiAgPGc+CiAgICA8cmVjdCB4PSI1MiIgeT0iMTcwIiB3aWR0aD0iMjMwIiBoZWlnaHQ9Ijg4IiByeD0iMTAiIGZpbGw9IiMxMTE4MjciLz4KICAgIDx0ZXh0IHg9IjY4IiB5PSIyMDAiIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPkFHRU5UPC90ZXh0PgogICAgPHRleHQgeD0iNjgiIHk9IjIyMiIgZm9udC1zaXplPSIxNCIgZmlsbD0iI0ZGRkZGRiI+d3JpdGVzIG9yIGZpeGVzPC90ZXh0PgogICAgPHRleHQgeD0iNjgiIHk9IjI0MiIgZm9udC1zaXplPSIxNCIgZmlsbD0iI0ZGRkZGRiI+dGhlIG1pZ3JhdGlvbjwvdGV4dD4KCiAgICA8cmVjdCB4PSIzNTQiIHk9IjE3MCIgd2lkdGg9IjIzMCIgaGVpZ2h0PSI4OCIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSIzNzAiIHk9IjIwMCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+U0FOREJPWCBURVNUPC90ZXh0PgogICAgPHRleHQgeD0iMzcwIiB5PSIyMjIiIGZvbnQtc2l6ZT0iMTQiIGZpbGw9IiNGRkZGRkYiPnN5bnRoZXRpYyByb3dzLDwvdGV4dD4KICAgIDx0ZXh0IHg9IjM3MCIgeT0iMjQyIiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5jaGVja2VkIGF0IHByb2Qgc2l6ZTwvdGV4dD4KCiAgICA8cmVjdCB4PSI2NTYiIHk9IjE3MCIgd2lkdGg9IjIzMCIgaGVpZ2h0PSI4OCIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSI2NzIiIHk9IjIwMCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+Q0kgwrcgQkVGT1JFIERFUExPWTwvdGV4dD4KICAgIDx0ZXh0IHg9IjY3MiIgeT0iMjIyIiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5tYXNrZWQgcHJvZHVjdGlvbjwvdGV4dD4KICAgIDx0ZXh0IHg9IjY3MiIgeT0iMjQyIiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5zbmFwc2hvdDwvdGV4dD4KCiAgICA8cmVjdCB4PSI5NTgiIHk9IjE3MCIgd2lkdGg9IjIzMCIgaGVpZ2h0PSI4OCIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSI5NzQiIHk9IjIwMCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+REVQTE9ZPC90ZXh0PgogICAgPHRleHQgeD0iOTc0IiB5PSIyMjgiIGZvbnQtc2l6ZT0iMTQiIGZpbGw9IiNGRkZGRkYiPmV2ZXJ5IGJvdW5kIGhlbGQgPHRzcGFuIGZpbGw9IiM0QURFODAiPuKckzwvdHNwYW4+PC90ZXh0PgogIDwvZz4KCiAgPCEtLSBmb3J3YXJkIGFycm93cyAtLT4KICA8cGF0aCBkPSJNMjg1LDIxNCBIMzQ3IiBmaWxsPSJub25lIiBzdHJva2U9IiM5N0ExQjAiIHN0cm9rZS13aWR0aD0iMS41IiBtYXJrZXItZW5kPSJ1cmwoI2FycjMpIi8+CiAgPHBhdGggZD0iTTU4NywyMTQgSDY0OSIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgbWFya2VyLWVuZD0idXJsKCNhcnIzKSIvPgogIDx0ZXh0IHg9IjYyMCIgeT0iMjA0IiBmb250LXNpemU9IjEzIiBmaWxsPSIjNkI3Njg2IiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj5wYXNzPC90ZXh0PgogIDxwYXRoIGQ9Ik04ODksMjE0IEg5NTEiIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzk3QTFCMCIgc3Ryb2tlLXdpZHRoPSIxLjUiIG1hcmtlci1lbmQ9InVybCgjYXJyMykiLz4KICA8dGV4dCB4PSI5MjIiIHk9IjIwNCIgZm9udC1zaXplPSIxMyIgZmlsbD0iIzZCNzY4NiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+cGFzczwvdGV4dD4KCiAgPCEtLSBmYWlsdXJlcyBnbyBiYWNrIHRvIHRoZSBhZ2VudCAtLT4KICA8cGF0aCBkPSJNNDY5LDI2MiBWMzA0IFE0NjksMzE4IDQ1NSwzMTggSDIxMSBRMTk3LDMxOCAxOTcsMzA0IFYyNzAiCiAgICAgICAgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjRTI4QzhDIiBzdHJva2Utd2lkdGg9IjEuNSIgbWFya2VyLWVuZD0idXJsKCNhcnIzLWZhaWwpIi8+CiAgPHRleHQgeD0iMzMzIiB5PSIzMDYiIGZvbnQtc2l6ZT0iMTMiIGZpbGw9IiNDNjQ1NDUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPmZhaWxzIGF0IHByb2R1Y3Rpb24gc2l6ZTwvdGV4dD4KCiAgPHBhdGggZD0iTTc3MSwyNjIgVjM3NCBRNzcxLDM4OCA3NTcsMzg4IEgxNTEgUTEzNywzODggMTM3LDM3NCBWMjcwIgogICAgICAgIGZpbGw9Im5vbmUiIHN0cm9rZT0iI0UyOEM4QyIgc3Ryb2tlLXdpZHRoPSIxLjUiIG1hcmtlci1lbmQ9InVybCgjYXJyMy1mYWlsKSIvPgogIDx0ZXh0IHg9IjQ1NCIgeT0iMzc2IiBmb250LXNpemU9IjEzIiBmaWxsPSIjQzY0NTQ1IiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj5mYWlscyBvbiByZWFsIGRhdGE8L3RleHQ+Cjwvc3ZnPgo=" width="1240" height="430" class="img__Ss2"></p>
<p>A failed bound in either run goes back to the agent. Only a change that holds every bound on real
data deploys.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="in-the-agents-sandbox">In the Agent's Sandbox<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#in-the-agents-sandbox" class="hash-link" aria-label="Direct link to In the Agent's Sandbox" title="Direct link to In the Agent's Sandbox" translate="no">​</a></h3>
<p>The sandbox test loads <a class="" href="https://atlasgo.io/testing/datasets#generating-synthetic-data">synthetic data</a>. Atlas generates
rows from the schema, <code>total</code> sets how many rows the table holds in production, and a <code>column</code> block
sets the values a test depends on:</p>
<div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"synthetic"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    rows  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">100000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    total </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">50000000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    column </span><span class="token string" style="color:rgb(195, 232, 141)">"status"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      value </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> random::int</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1000</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"> ? </span><span class="token string" style="color:rgb(195, 232, 141)">"pending"</span><span class="token plain"> : </span><span class="token string" style="color:rgb(195, 232, 141)">"shipped"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    column </span><span class="token string" style="color:rgb(195, 232, 141)">"region"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      value </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> random::element</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"us"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"eu"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"apac"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Atlas generates 100,000 orders, about one in a thousand of them pending and each with a region, and
checks lock times and table copies at 50 million. A <code>column</code> value can read the row's index and its
other columns, call <code>random::</code> and HCL functions, or write <code>NULL</code>, as
<a class="" href="https://atlasgo.io/testing/datasets#setting-column-values">Setting column values</a> shows.</p>
<p>A statement whose cost grows with table size fails on the agent's machine, in seconds, with no
production access. Full-table scans under a lock, table rewrites, and large index builds all fail here.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="before-deploy">Before Deploy<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#before-deploy" class="hash-link" aria-label="Direct link to Before Deploy" title="Direct link to Before Deploy" translate="no">​</a></h3>
<p>CI runs the same bounds on a production snapshot:</p>
<div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"rds_snapshot"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  src </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"s3://backups/exports/prod-2026-10-13/appdb?region=us-east-1"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p><code>rds_snapshot</code> loads an Amazon RDS snapshot export in foreign-key order. <code>include</code> and <code>exclude</code> pick
the tables, a <a class="" href="https://atlasgo.io/testing/datasets#sampling">sampler</a> loads part of a table plus every row it
references, and <a class="" href="https://atlasgo.io/testing/datasets#masking">masks</a> hash or redact sensitive columns before any row
reaches the test database.</p>
<p>This run catches what scaling can't predict:</p>
<ul>
<li class="">Real rows that break the change, like a NULL under a new <code>NOT NULL</code> or a duplicate under a new
unique index.</li>
<li class="">Skew, like a backfill whose <code>WHERE</code> matches almost nothing in synthetic data and most of the real
table.</li>
<li class="">Limits that kick in past a size. SQL Server escalates row locks to a table lock once a statement
holds 5,000 of them, and a Postgres index build spills to disk once its sort outgrows memory.</li>
</ul>
<p>Synthetic data is only as messy as you make it. Production data will always be messier.</p>
<p>The snapshot tests repeat the synthetic ones with <code>use = dataset.rds_snapshot.prod</code> in their dataset
step, such as <code>orders_snapshot</code> for <code>orders_synthetic</code>. The agent runs the synthetic tests on every
change, CI runs the snapshot tests before deploy, and only CI needs the credentials to read the
export:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># In the agent's sandbox</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/18/dev"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> synthetic </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># In CI, before deploy</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/18/dev"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> snapshot </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">.</span><br></span></code></pre></div></div>
<p>Keep those credentials in a CI environment that only the default branch can use. A test file can run
programs, and a pull request can change it.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="one-ticket-no-reviewer">One Ticket, No Reviewer<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#one-ticket-no-reviewer" class="hash-link" aria-label="Direct link to One Ticket, No Reviewer" title="Direct link to One Ticket, No Reviewer" translate="no">​</a></h2>
<p>Say the ticket is "make <code>orders.region</code> required," and the database is Postgres. Here's the loop with
no human in it.</p>
<p><strong>Run 1.</strong> The agent writes the obvious migration:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20261119120000_orders_region_not_null.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> region </span><span class="token keyword" style="font-style:italic">SET</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>The sandbox test fails on <code>db.lock.time</code>:</p>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">-- FAIL: orders_synthetic (1.02s)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    migrate.test.hcl:23:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        Error: db.lock.time: public.orders (AccessExclusiveLock, blocks reads):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">               ~6.4s at 50,000,000 rows, expected less than or equal to 1s</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">               (20261119120000_orders_region_not_null.sql:1)</span><br></span></code></pre></div></div>
<p>Notice two things in the output:</p>
<ol>
<li class="">The test generated 100,000 rows and ran in about a second, but the lock time is for the 50,000,000
rows of production.</li>
<li class="">It names the lock and points at the statement that took it, line 1 of the migration file.</li>
</ol>
<p><code>SET NOT NULL</code> scans every row to prove there are no NULLs, and it holds an <code>ACCESS EXCLUSIVE</code> lock
while it does. Every read and write on <code>orders</code> waits.</p>
<p><strong>Run 2.</strong> The agent switches to the standard pattern: add the check as <code>NOT VALID</code>, validate it, then
set <code>NOT NULL</code>. Since Postgres 12, a valid check lets <code>SET NOT NULL</code> skip the scan.</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20261119120000_orders_region_not_null.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> orders_region_not_null </span><span class="token keyword" style="font-style:italic">CHECK</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">region </span><span class="token operator" style="color:rgb(137, 221, 255)">IS</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> VALID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders VALIDATE </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> orders_region_not_null</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> region </span><span class="token keyword" style="font-style:italic">SET</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> orders_region_not_null</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>It fails on the same bound. Atlas runs each migration file in one transaction, and Postgres holds
locks until the transaction ends. The <code>ACCESS EXCLUSIVE</code> lock from the first statement is still held
while the second one scans the table, and Atlas counts that time too. Plenty of reviewers would
approve this file.</p>
<p><strong>Run 3.</strong> The agent moves <code>ADD CONSTRAINT</code> into its own migration file. Validation now runs under a
lock that doesn't block reads or writes, and the sandbox test passes.</p>
<p><strong>Run 4.</strong> CI runs the snapshot test, and <code>VALIDATE CONSTRAINT</code> fails. Orders created before the
column existed have no region, and the agent's synthetic data had a region on every row. Without this
run, the deploy would have failed halfway, after the first file had already shipped.</p>
<p><strong>Run 5.</strong> The agent adds a backfill for those rows ahead of the validation, and the snapshot test
passes.</p>
<p>Nobody reviewed any of it. Each failure named the statement and what broke, which is what an agent
needs to fix its own work. With <code>--profile</code>, it also gets the full report, which measures every
statement and flags the risky ones with a safer way to write them.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-the-numbers-dont-tell-you">What the Numbers Don't Tell You<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#what-the-numbers-dont-tell-you" class="hash-link" aria-label="Direct link to What the Numbers Don't Tell You" title="Direct link to What the Numbers Don't Tell You" translate="no">​</a></h2>
<p>A test run measures the work your code does on your data, not the conditions it runs in. The work
carries over: rows, rewrites, copy size, and log volume depend on the data and the statements, as
long as the dev database runs your production version and settings. The conditions don't. A loaded
snapshot has no live traffic, and a lock that takes half a second on an idle copy can take longer
behind real queries, so leave headroom in time bounds.</p>
<p>CPU, memory, and I/O come from the Docker dev database, so they measure the machine that runs the
test, the agent's sandbox or the CI runner. Use them to compare one change with another, not as
production numbers.</p>
<p>The data has limits too. A sampled table can miss the one row that breaks a new constraint, so load
the full table for constraint changes. And the numbers at <code>total</code> assume synthetic rows behave like
real ones, which is what the snapshot run checks.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>The factory doesn't have to stop at the database. Start with two
<a class="" href="https://atlasgo.io/testing/profile#profile-expectations">expectations</a>, <code>db.table.rewrites</code> at zero and a
<code>db.lock.time</code> bound on your largest tables, and add more once you've seen your own numbers.
Expectations work on PostgreSQL, MySQL 8.0.28 and later, and SQL Server.</p>
<p>Profile expectations are in preview for a subset of Teams and Enterprise customers. To run them against
your own migrations, <a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="software-factory-blog">schedule a demo</a> or
<a href="https://atlasgo.io/blog/2026/11/19/software-factory-database#">message us on Intercom</a> for access.</p>]]></content:encoded>
            <category>ai agents</category>
            <category>software factory</category>
            <category>migrations</category>
            <category>testing</category>
            <category>profiler</category>
            <category>datasets</category>
            <category>postgres</category>
        </item>
        <item>
            <title><![CDATA[Atlas v1.4: Security Scanning, Database Profiler, Agent Skills, Drift Detection, and More]]></title>
            <link>https://atlasgo.io/blog/2026/11/17/atlas-v1-4</link>
            <guid>https://atlasgo.io/blog/2026/11/17/atlas-v1-4</guid>
            <pubDate>Tue, 17 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Atlas v1.4 introduces security scanning for databases: atlas security scan reports the CVEs affecting your database servers and extensions from the CLI, CI, or Kubernetes. The release also adds agent skills, a profiler for the Atlas testing framework that works on production-like data, and drift detection between deployments.]]></description>
            <content:encoded><![CDATA[<p>Hey everyone!</p>
<p>We're excited to announce <a href="https://github.com/ariga/atlas/releases/tag/v1.4.0" target="_blank" rel="noopener noreferrer" class="">Atlas v1.4</a>. This
release brings security scanning to your databases: the new <code>atlas security scan</code> command reports
the CVEs affecting your database servers and extensions, from the CLI, CI, or Kubernetes. It also
introduces agent skills, a profiler for the Atlas testing framework that works on production-like
data, and drift checks between deployments.</p>
<p>Here is what you can find in this release:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#security-scanning-for-databases">Security Scanning for Databases</a></strong> -
Vulnerability detection for your database servers and extensions with <code>atlas security scan</code>, from CI
to Kubernetes, and blast-radius checks for roles.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#atlas-agent-skills">Atlas Agent Skills</a></strong> - Teach Claude Code, Codex,
Cursor, and GitHub Copilot to plan, lint, and test schema changes with Atlas.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#profiler">Profiler for the Testing Framework</a></strong> - Measure the locks,
rewrites, and space of migrations, queries, and database code, over a masked Amazon RDS snapshot, CSV
files, or synthetic rows. In preview.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#drift-detection-between-deployments">Drift Detection Between Deployments</a></strong> -
<code>atlas migrate drift</code> reports every object that diverged from your migrations, for one database or
every tenant.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#self-hosted-schema-storage">Schema Repositories in Your Own Storage</a></strong> -
Store schema repositories in your own S3, GCS, or Azure Blob Storage bucket, or an OCI registry,
instead of Atlas Cloud.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#database-driver-improvements">Database Driver Improvements</a></strong> -
Snowflake governance policies, SQL Server linked servers and filegroups, PostgreSQL temporal keys,
Databricks metric views, Redshift datashares, and more.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#atlas-binaries-are-moving">Atlas Binaries Are Moving to atlasbinaries.com</a></strong> -
Starting December 2026, <code>release.ariga.io</code> redirects to <code>atlasbinaries.com</code>. Direct downloads only
need the new hostname.</li>
</ul>
<!-- -->
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">macOS + Linux</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Homebrew</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Docker</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Windows</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">CI</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Manual Installation</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>To download and install the latest release of the Atlas CLI, simply run the following in your terminal:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-sSf</span><span class="token plain"> https://atlasgo.sh </span><span class="token operator" style="color:rgb(137, 221, 255)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">sh</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Get the latest release with <a href="https://brew.sh/" target="_blank" rel="noopener noreferrer" class="">Homebrew</a>:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">brew </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> ariga/tap/atlas</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>To pull the Atlas image and run it as a Docker container:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> pull arigaio/atlas</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> arigaio/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--help</span><br></span></code></pre></div></div><p>If the container needs access to the host network or a local directory, use the <code>--net=host</code> flag and mount the desired
directory:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--net</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">host </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-v</span><span class="token plain"> </span><span class="token variable" style="color:rgb(191, 199, 213)">$(</span><span class="token variable builtin class-name" style="color:rgb(255, 203, 107)">pwd</span><span class="token variable" style="color:rgb(191, 199, 213)">)</span><span class="token plain">/migrations:/migrations </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arigaio/atlas migrate apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"mysql://root:pass@:3306/test"</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Download the <a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" target="_blank" rel="noopener noreferrer" class="">latest release</a> and
move the atlas binary to a file location on your system PATH.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><strong>GitHub Actions</strong></p><p>Use the <a href="https://github.com/marketplace/actions/setup-atlas" target="_blank" rel="noopener noreferrer" class="">setup-atlas</a> action to install Atlas in your GitHub Actions workflow:</p><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ariga/setup</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">atlas@v0</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">with</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">cloud-token</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> secrets.ATLAS_CLOUD_TOKEN </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p><strong>Other CI Platforms</strong></p><p>For other CI/CD platforms, use the installation script. See the <a class="" href="https://atlasgo.io/integrations#cicd-platforms">CI/CD integrations</a> for more details.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>If you want to manually install the Atlas CLI, pick one of the below builds suitable for your system.</p><div class="grid grid-cols-1 lg:grid-cols-3 auto-cols-fr gap-4 mt-4"><div class="flex flex-col gap-4"><h3>MacOS</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Linux</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Windows</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="security-scanning-for-databases">Security Scanning for Databases<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#security-scanning-for-databases" class="hash-link" aria-label="Direct link to Security Scanning for Databases" title="Direct link to Security Scanning for Databases" translate="no">​</a></h2>
<p>Which of your databases run a version with a published CVE? Answering that means querying every
database, across staging, production, and every region, for its server and extension versions, then
looking each one up in the advisories for its engine and extensions. And it is not a one-time check:
new CVEs are regularly published for versions that are already running.</p>
<p>The new <a class="" href="https://atlasgo.io/changelog/security-scan"><code>atlas security scan</code></a> command answers this question in one run.
It resolves the server version and the installed extensions of each database against the
<a class="" href="https://atlasgo.io/cloud/features/security-graph">Atlas Security Graph</a>, and reports every CVE that affects them, with
its severity and the release that fixes it:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@localhost:5432/app?sslmode=disable"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse://default:pass@localhost:9000"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@localhost:5433/reporting?sslmode=disable"</span><br></span></code></pre></div></div>
<div class="language-scanlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-scanlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Scanning 3 databases for security issues:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token header-dash header">  --</span><span class="token plain"> postgres://postgres:xxxxx@localhost:5432/app?sslmode=disable (postgres 18.6):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token critical-dash critical">    --</span><span class="token plain"> Extension "vector" version "0.8.5" is vulnerable to CVE-2026-103484 (HIGH): pgvector</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       buffer overflow in IVFFlat index build. Upgrade extension "vector" to version 0.8.7 or</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       later to resolve CVE-2026-103484</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token critical-dash critical">    --</span><span class="token plain"> Extension "vector" version "0.8.5" is vulnerable to CVE-2026-18022 (HIGH): pgvector</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       buffer overflow via integer wraparound in IVFFlat index build on 32-bit systems. Upgrade</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       extension "vector" to version 0.8.6 or later to resolve CVE-2026-18022</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token header-dash header">  --</span><span class="token plain"> clickhouse://default:xxxxx@localhost:9000 (clickhouse 23.10.5.20):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token elevated-dash elevated">    --</span><span class="token plain"> Engine "clickhouse" version "23.10.5.20" is vulnerable to CVE-2024-22412 (ELEVATED):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       ClickHouse's Role-based Access Control is bypassed when query caching is enabled. Upgrade</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       database engine "clickhouse" to version 23.12.6.19 or later to resolve CVE-2024-22412</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token critical-dash critical">    --</span><span class="token plain"> Engine "clickhouse" version "23.10.5.20" is vulnerable to CVE-2026-116366 (CRITICAL):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       Unauthenticated RCE vulnerability against ClickHouse Server. Upgrade database engine</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       "clickhouse" to version 26.3.62.3 or later to resolve CVE-2026-116366</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token header-dash header">  --</span><span class="token plain"> postgres://postgres:xxxxx@localhost:5433/reporting?sslmode=disable:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token error-dash error">    --</span><span class="token plain"> postgres: querying system variables: dial tcp [::1]:5433: connect: connection refused</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token divider">-------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token duration duration-dash">  --</span><span class="token duration"> 1.061387208s</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token error-dash error">  --</span><span class="token plain"> 1 database could not be scanned</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token count count-dash">  --</span><span class="token count"> 4 issues found: 1 </span><span class="token count critical">critical</span><span class="token count">, 2 </span><span class="token count critical">high</span><span class="token count">, 1 </span><span class="token count elevated">elevated</span><br></span></code></pre></div></div>
<p>A database that could not be reached is reported with the rest and fails the command, since its
state is unknown. For a recent example, see
<a class="" href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning">ClickHouse CVEs: Find Vulnerable Servers with Atlas</a>.</p>
<p>The same <a class="" href="https://atlasgo.io/changelog/cve-analyzer">vulnerability detection</a> runs before a change merges during
the lint check, together with an access check that flags roles whose
<a class="" href="https://atlasgo.io/changelog/grant-coverage">blast radius</a> covers a large share of the database.</p>
<p>Also new with the scan:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/security-scan-engine-cves">Engine-specific detection</a>: PostgreSQL, MySQL, MariaDB,
ClickHouse, and <a class="" href="https://atlasgo.io/changelog/security-scan-sqlserver">SQL Server</a>. On PostgreSQL, the installed
extensions are checked too.</li>
<li class=""><a class="" href="https://atlasgo.io/guides/security-scan#configuration">Gating and notifications</a>: findings fail the command only at
the <code>fail_on</code> severity level, and a <code>notify</code> block posts the result to Slack.</li>
<li class=""><a class="" href="https://atlasgo.io/guides/security-scan#running-on-a-schedule">On a schedule</a>: the <code>security/scan</code> GitHub Action,
and the <a class="" href="https://atlasgo.io/changelog/operator-security-scan"><code>AtlasSecurityScan</code></a> resource of the Kubernetes
Operator, whose <code>Compliant</code> condition works as a deployment gate.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/security-graph#security-dashboard">Security Dashboard</a>: every finding across your
repositories and monitored databases in one list.</li>
</ul>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/security-graph/security-issues-critical.png" alt="Security Issues page in Atlas Cloud filtered to critical issues" width="100%"><p style="font-size:12px">The Security Issues page, filtered to critical findings</p></div>
<p>Security scanning is part of Atlas Pro and requires the Security Graph in your plan. Run
<code>atlas login</code> to get started.</p>
<p>To learn more, see the <a class="" href="https://atlasgo.io/guides/security-scan">security scanning guide</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-agent-skills">Atlas Agent Skills<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#atlas-agent-skills" class="hash-link" aria-label="Direct link to Atlas Agent Skills" title="Direct link to Atlas Agent Skills" translate="no">​</a></h2>
<p>An agent can edit schema files the way it edits code. A migration is different: it needs the
dependency order of every object, it has to pass your lint policies, and the same change must
produce the same migration regardless of which model generated it.</p>
<p>For this reason, the <a class="" href="https://atlasgo.io/changelog/atlas-agent-skills">Atlas agent skills</a> do not teach agents to write
migrations. The agent edits the desired state, Atlas plans the migration, and the change is linted
and tested before the agent reports it done:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active"><span style="display:inline-flex;align-items:center;gap:0.5rem"><span style="display:inline-block;width:16px;height:16px;flex-shrink:0" aria-hidden="true"><svg viewBox="0 0 1200 1200" class="h-full w-full" width="100%" height="100%" fill="currentColor" aria-hidden="true"><path d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"></path></svg></span>Claude Code</span></li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP"><span style="display:inline-flex;align-items:center;gap:0.5rem"><span style="display:inline-block;width:16px;height:16px;flex-shrink:0" aria-hidden="true"><svg viewBox="0 0 24 24" class="h-full w-full" width="100%" height="100%" fill="currentColor" fill-rule="evenodd" aria-hidden="true"><path d="M21.55 10.004a5.416 5.416 0 00-.478-4.501c-1.217-2.09-3.662-3.166-6.05-2.66A5.59 5.59 0 0010.831 1C8.39.995 6.224 2.546 5.473 4.838A5.553 5.553 0 001.76 7.496a5.487 5.487 0 00.691 6.5 5.416 5.416 0 00.477 4.502c1.217 2.09 3.662 3.165 6.05 2.66A5.586 5.586 0 0013.168 23c2.443.006 4.61-1.546 5.361-3.84a5.553 5.553 0 003.715-2.66 5.488 5.488 0 00-.693-6.497v.001zm-8.381 11.558a4.199 4.199 0 01-2.675-.954c.034-.018.093-.05.132-.074l4.44-2.53a.71.71 0 00.364-.623v-6.176l1.877 1.069c.02.01.033.029.036.05v5.115c-.003 2.274-1.87 4.118-4.174 4.123zM4.192 17.78a4.059 4.059 0 01-.498-2.763c.032.02.09.055.131.078l4.44 2.53c.225.13.504.13.73 0l5.42-3.088v2.138a.068.068 0 01-.027.057L9.9 19.288c-1.999 1.136-4.552.46-5.707-1.51h-.001zM3.023 8.216A4.15 4.15 0 015.198 6.41l-.002.151v5.06a.711.711 0 00.364.624l5.42 3.087-1.876 1.07a.067.067 0 01-.063.005l-4.489-2.559c-1.995-1.14-2.679-3.658-1.53-5.63h.001zm15.417 3.54l-5.42-3.088L14.896 7.6a.067.067 0 01.063-.006l4.489 2.557c1.998 1.14 2.683 3.662 1.529 5.633a4.163 4.163 0 01-2.174 1.807V12.38a.71.71 0 00-.363-.623zm1.867-2.773a6.04 6.04 0 00-.132-.078l-4.44-2.53a.731.731 0 00-.729 0l-5.42 3.088V7.325a.068.068 0 01.027-.057L14.1 4.713c2-1.137 4.555-.46 5.707 1.513.487.833.664 1.809.499 2.757h.001zm-11.741 3.81l-1.877-1.068a.065.065 0 01-.036-.051V6.559c.001-2.277 1.873-4.122 4.181-4.12.976 0 1.92.338 2.671.954-.034.018-.092.05-.131.073l-4.44 2.53a.71.71 0 00-.365.623l-.003 6.173v.002zm1.02-2.168L12 9.25l2.414 1.375v2.75L12 14.75l-2.415-1.375v-2.75z"></path></svg></span>OpenAI Codex</span></li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP"><span style="display:inline-flex;align-items:center;gap:0.5rem"><span style="display:inline-block;width:16px;height:16px;flex-shrink:0" aria-hidden="true"><svg viewBox="0 0 24 24" class="h-full w-full" width="100%" height="100%" fill="none" aria-hidden="true"><path d="M11.925 0L1.5 6v12l10.425-6V0z" fill="currentColor" opacity="0.7"></path><path d="M22.35 18V6L11.925 0v12l10.425 6z" fill="currentColor" opacity="0.5"></path><path d="M11.925 24l10.425-6-10.425-6L1.5 18l10.425 6z" fill="currentColor" opacity="0.3"></path><path d="M22.35 6l-10.425 6L1.5 6h20.85z" fill="currentColor" opacity="0.9"></path></svg></span>Cursor</span></li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP"><span style="display:inline-flex;align-items:center;gap:0.5rem"><span style="display:inline-block;width:16px;height:16px;flex-shrink:0" aria-hidden="true"><svg viewBox="0 0 24 24" class="h-full w-full" width="100%" height="100%" fill="currentColor" aria-hidden="true"><rect x="2" y="6" width="20" height="12" rx="6" opacity="0.15"></rect><circle cx="8.5" cy="12" r="2"></circle><circle cx="15.5" cy="12" r="2"></circle></svg></span>GitHub Copilot</span></li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>Install the skills from a terminal. <!-- -->It installs the Atlas plugin, with all its skills, for every project on this machine.</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">claude plugin marketplace </span><span class="token function" style="color:rgb(130, 170, 255)">add</span><span class="token plain"> ariga/atlas</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">claude plugin </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> atlas@ariga</span><br></span></code></pre></div></div><p>Then start the onboarding skill in <!-- -->Claude Code<!-- -->. See<!-- --> <a href="https://atlasgo.io/guides/ai-tools/claude-code-instructions">Claude Code<!-- --> with Atlas</a> for the other ways to use the skills.</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">/atlas:atlas-onboard</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Install the skills from a terminal. <!-- -->Run it from the repository root. It installs every Atlas skill in .agents/skills/.</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">npx skills </span><span class="token function" style="color:rgb(130, 170, 255)">add</span><span class="token plain"> ariga/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-a</span><span class="token plain"> codex </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-y</span><br></span></code></pre></div></div><p>Then start the onboarding skill in <!-- -->OpenAI Codex<!-- -->. See<!-- --> <a href="https://atlasgo.io/guides/ai-tools/codex-instructions">OpenAI Codex<!-- --> with Atlas</a> for the other ways to use the skills.</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">$atlas-onboard</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Install the skills from a terminal. <!-- -->Run it from the repository root. It installs every Atlas skill in .agents/skills/.</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">npx skills </span><span class="token function" style="color:rgb(130, 170, 255)">add</span><span class="token plain"> ariga/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-a</span><span class="token plain"> cursor </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-y</span><br></span></code></pre></div></div><p>Then start the onboarding skill in <!-- -->Cursor<!-- -->. See<!-- --> <a href="https://atlasgo.io/guides/ai-tools/cursor-rules">Cursor<!-- --> with Atlas</a> for the other ways to use the skills.</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">/atlas-onboard</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Install the skills from a terminal. <!-- -->Run it from the repository root. It installs every Atlas skill in .agents/skills/.</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">npx skills </span><span class="token function" style="color:rgb(130, 170, 255)">add</span><span class="token plain"> ariga/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-a</span><span class="token plain"> github-copilot </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-y</span><br></span></code></pre></div></div><p>Then start the onboarding skill in <!-- -->GitHub Copilot<!-- -->. See<!-- --> <a href="https://atlasgo.io/guides/ai-tools/github-copilot-instructions">GitHub Copilot<!-- --> with Atlas</a> for the other ways to use the skills.</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">/atlas-onboard</span><br></span></code></pre></div></div></div></div></div>
<p>The installation includes:</p>
<ul>
<li class=""><code>atlas</code>: the core workflow, from inspect and plan to lint, test, and apply.</li>
<li class=""><code>atlas-onboard</code>: guided onboarding, from no Atlas setup to production. It never applies to
production: you run the first deployment.</li>
<li class="">Database skills for PostgreSQL, MySQL, SQL Server, ClickHouse, Snowflake, Databricks, Redshift,
Oracle, and Spanner.</li>
<li class=""><code>atlas-operator</code> for Kubernetes, and <code>atlas-action</code> for CI/CD.</li>
</ul>
<p>Checking a change before reporting it done is what Anthropic calls a
<a href="https://claude.com/resources/articles/building-verification-loops-in-claude-code-with-skills" target="_blank" rel="noopener noreferrer" class="">verification loop</a>,
and an example it notes of a check worth capturing is a migration rule: <em>"Reject any migration that
drops a column without a backfill step."</em></p>
<p>With Atlas, you don't need a prompt for this. Lint fails a migration that drops a column unless you
allow it explicitly, and the skills do not let an agent skip a lint error without your approval. You
can further define project-specific rules as <a class="" href="https://atlasgo.io/lint/rules">custom lint rules</a>, which Atlas enforces
just the same.</p>
<p>To learn more, see the <a class="" href="https://atlasgo.io/guides/ai-tools/agent-skills">agent skills documentation</a>, and
<a class="" href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database">The AI-Native SDLC Playbook Stops at the Database</a> for why
an agent should compute a migration plan and not generate one.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="profiler">Profiler for the Testing Framework<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#profiler" class="hash-link" aria-label="Direct link to Profiler for the Testing Framework" title="Direct link to Profiler for the Testing Framework" translate="no">​</a></h2>
<p>In the agentic SDLC that Anthropic lays out in its
<a href="https://claude.com/resources/articles/the-ai-native-sdlc-playbook" target="_blank" rel="noopener noreferrer" class="">AI-native SDLC playbook</a>, Stage 4
has the best rule: <em>"Always give Claude a way to verify its own work, whether tests, a build, or a
screenshot diff."</em> The agent iterates until the check passes, before a human sees anything.</p>
<p>What is that check for a database change? A test may pass in CI, but unless it runs over
production-like data, there is no way to measure the <em>impact</em> of the change.</p>
<p>As we wrote in our
<a class="" href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#the-feedback-loop-the-playbook-asks-for">post about the playbook</a>,
nearly every dangerous migration run on an empty dev database seems passable. Every lock is short, and
there is not much for a statement to scan or rewrite. The cost of a statement depends on the size of
the table it runs on, and reading the SQL rarely shows it.</p>
<p>As our initial response to that recommendation, this release adds
<a class="" href="https://atlasgo.io/changelog/testing-with-data-and-profiling">datasets and a profiler</a> to the Atlas testing framework:</p>
<ul>
<li class="">A <a class="" href="https://atlasgo.io/testing/datasets"><code>dataset</code></a> gives a test production-like rows: either loaded, sampled, and
masked from an Amazon RDS snapshot or CSV files, or generated from the schema.</li>
<li class="">The <a class="" href="https://atlasgo.io/testing/profile"><code>--profile</code></a> flag profiles every statement the tests run against that data,
in migrations, queries, functions, procedures, and triggers. For each statement, it reports the
locks it takes and how long it holds them, the tables it rewrites, and the disk, log, and temporary
space it uses.</li>
</ul>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span>Preview Feature</div><div class="admonitionContent_bl22"><p>The profiler and datasets are in preview and open to a subset of Teams and Enterprise customers. To
get access, reach out through your Atlas support channel or
<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#">message us on Intercom</a>.</p></div></div>
<p>For example, this migration adds a column to the <code>orders</code> table and fills it in one statement:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20261104093012_add_orders_digest.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> digest </span><span class="token keyword" style="font-style:italic">text</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">UPDATE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">SET</span><span class="token plain"> digest </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> md5</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">note</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>The test migrates to the version before it, generates 2,000,000 orders, and then applies the new
version over them:</p>
<div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"synthetic"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token string" style="color:rgb(195, 232, 141)">"public.orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    rows </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2000000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261104093012"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Migrate to one version before the profiled version.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261103101500"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Generate the rows.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.synthetic.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Apply the profiled version over the generated rows.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20261104093012"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Add <code>--profile</code> to the test command, and Atlas prints a profile after the result of each test case.
The output is abridged:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/18/dev"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--profile</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">.</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">migrate#3 20261104093012                9.84s</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  rows     public.orders                2,000,000 updated</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  read     public.orders                2,000,000 rows, 1 sequential scan</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  size     public.orders                185.3MB -&gt; 432.0MB (+246.7MB)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  log      721.3MB written, 721.3MB while the statements ran</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  ! lock public.orders: takes AccessExclusiveLock for 9.842s, 9.806s of it after the statement, blocking reads and writes (20261104093012_add_orders_digest.sql:1)</span><br></span></code></pre></div></div>
<p>Lines that start with <code>!</code> are findings: statements that would block or slow down production. Notice
two things here:</p>
<ol>
<li class="">It points at line 1, the <code>ALTER</code>, and not at the <code>UPDATE</code>.</li>
<li class="">Of the 9.842 seconds the lock is held, 9.806 come after that statement is done: PostgreSQL keeps
a lock until the transaction ends, so reads and writes on <code>orders</code> stay blocked while the
<code>UPDATE</code> fills 2,000,000 rows.</li>
</ol>
<p>In a diff, these are two statements that look harmless. In the full report, each finding is followed
by why it matters and a safer way to write the statement.</p>
<p>This is a verdict an agent can act on inside the session, the same way it acts on a failing test.
The <a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#atlas-agent-skills" class=""><code>atlas</code> skill</a> already asks for it: for a change that reads or writes a
large table, the agent seeds the test with a dataset, runs it with <code>--profile</code>, and fixes the
statements the report flags before it reports the change done.</p>
<p>The same flag works with <code>atlas schema test</code>, where it profiles the queries, functions, procedures,
and triggers the tests run:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/18/dev"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.hcl"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--profile</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">.</span><br></span></code></pre></div></div>
<p>Profiling is currently supported on PostgreSQL, MySQL, MariaDB, and SQL Server, and will expand to
more databases in upcoming releases.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="test-data">Test Data: Amazon RDS Snapshots, CSV Files, or Synthetic Rows<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#test-data" class="hash-link" aria-label="Direct link to Test Data: Amazon RDS Snapshots, CSV Files, or Synthetic Rows" title="Direct link to Test Data: Amazon RDS Snapshots, CSV Files, or Synthetic Rows" translate="no">​</a></h3>
<p>A profile measures the rows the test holds. A <code>dataset</code> block defines those rows, and a <code>dataset</code>
command in a test case loads them. Every migration and assertion after the command runs over them.</p>
<p>A dataset reads an Amazon RDS snapshot or a directory of CSV files, or generates rows from the
schema, as it did for the 2,000,000 orders above:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Amazon RDS Snapshot</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">CSV Files</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Synthetic Data</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>An <a class="" href="https://atlasgo.io/testing/datasets#defining-a-dataset"><code>rds_snapshot</code></a> dataset loads an Amazon RDS snapshot that
was exported to S3:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"rds_snapshot"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  src     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"s3://backups/exports/prod-2026-10-13/appdb?region=us-east-1"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  exclude </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"analytics.events*"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas reads the export with your AWS credentials and loads the tables in foreign-key order, keeping
their primary keys, so joins and new inserts behave as they do in production. The <code>exclude</code> pattern
skips the <code>events</code> log and its partitions.</p><p>A test rarely needs the whole export. A <a class="" href="https://atlasgo.io/testing/datasets#sampling"><code>sampler</code></a> loads part of each
table, plus every row that part references, so no foreign key is left dangling:</p><ul>
<li class=""><code>head</code> and <code>tail</code> load the first or last rows of each table.</li>
<li class=""><code>random</code> loads rows drawn at random.</li>
<li class=""><code>composite</code> picks a sampler per table.</li>
</ul><p>Here, the <code>events</code> table gets 10,000 random rows, <code>plans</code> loads in full, and every other table gets
its first 100 rows:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sampler </span><span class="token string" style="color:rgb(195, 232, 141)">"random"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"large"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  rows </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">10000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">sampler </span><span class="token string" style="color:rgb(195, 232, 141)">"head"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"first"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  rows </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">sampler </span><span class="token string" style="color:rgb(195, 232, 141)">"composite"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"analytics.events"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> sampler.random.large</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"billing.plans"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    all   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"*"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> sampler.head.first</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>The snapshot holds real customer data, but the test database runs on a CI runner or a laptop.
<a class="" href="https://atlasgo.io/testing/datasets#masking"><code>mask</code></a> blocks rewrite the columns you select before the dataset writes
them, so raw values never reach the test database. A dataset names the sampler and the masks it
applies:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">mask </span><span class="token string" style="color:rgb(195, 232, 141)">"names"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  columns </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"billing.users.full_name"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  method  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> HASH</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  salt    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> var.mask_salt</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">mask </span><span class="token string" style="color:rgb(195, 232, 141)">"customers"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  columns   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"billing.tenants.display_name"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  method    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> PARTIAL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  keep_left </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">mask </span><span class="token string" style="color:rgb(195, 232, 141)">"tickets"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  columns  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"billing.support_tickets.body"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  entities </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">ALL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">mask </span><span class="token string" style="color:rgb(195, 232, 141)">"pii"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">mask.names</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> mask.customers</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> mask.tickets</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"rds_snapshot"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"masked"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  src     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"s3://backups/exports/prod-2026-10-13/appdb?region=us-east-1"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  include </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"billing.*"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  sampler </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> sampler.composite.prod</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  masks   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">mask.pii</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><ul>
<li class=""><code>names</code> hashes with a salt, which gives a value the same digest in every table, so masked values
stay unique and joinable. The salt is a secret: the project file reads it from the environment and
passes it to the test file as an input variable.</li>
<li class=""><code>customers</code> keeps the first character of each display name and masks the rest.</li>
<li class=""><code>tickets</code> replaces the emails, phone numbers, card numbers, and IP addresses found in free text and
keeps the rest of the text.</li>
<li class=""><code>pii</code> groups the three, so the dataset applies them with one reference.</li>
</ul><p>With the <code>tickets</code> mask, a ticket that reads
<code>Login fails for ada.lovelace@globex-001.example.com since this morning.</code> is loaded as
<code>Login fails for &lt;EMAIL&gt; since this morning.</code></p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A <a class="" href="https://atlasgo.io/testing/datasets#csv-files"><code>csv</code></a> dataset loads a directory of CSV files, one per table, named
<code>&lt;table&gt;.csv</code>, <code>&lt;schema&gt;.&lt;table&gt;.csv</code>, or <code>&lt;database&gt;.&lt;schema&gt;.&lt;table&gt;.csv</code>. The first line of each
file names its columns:</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">fixtures/billing.tenants.csv</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">id,slug,display_name,tier</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">1000,qa-team,QA Team,enterprise</span><br></span></code></pre></div></div><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"csv"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"fixtures"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  src </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"fixtures"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">test</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"tenants"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.rds_snapshot.prod</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  dataset </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    use </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> dataset.csv.fixtures</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">exec</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">count</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">*</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> billing.tenants"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">output</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"251"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>This test loads the 250 tenants of the snapshot, then adds one tenant for the tests that the
snapshot does not hold.</p><p>Like a snapshot, a CSV dataset takes the same samplers and masks. It reads <code>src</code> from a local
directory, relative to the test file, or from a bucket (<code>s3://</code>, <code>gs://</code>, or <code>azblob://</code>).</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A <a class="" href="https://atlasgo.io/testing/datasets#generating-synthetic-data"><code>synthetic</code></a> dataset generates rows from the schema,
at any size. Primary keys and unique columns get distinct values, foreign keys reference generated
rows, and <code>column</code> blocks set the values a check or a query plan depends on:</p><div class="language-atlas-test codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-test codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">dataset </span><span class="token string" style="color:rgb(195, 232, 141)">"synthetic"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"invoices"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token string" style="color:rgb(195, 232, 141)">"billing.tenants"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    rows </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">50</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    column </span><span class="token string" style="color:rgb(195, 232, 141)">"slug"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      value </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> format</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"tenant-%d"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> row.index</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  table </span><span class="token string" style="color:rgb(195, 232, 141)">"billing.invoices"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    rows </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">200000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    column </span><span class="token string" style="color:rgb(195, 232, 141)">"due_on"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      value </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> random::time</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">row.issued_on</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"2026-12-31"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    column </span><span class="token string" style="color:rgb(195, 232, 141)">"state"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      value </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> random::int</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> &lt;</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token plain"> ? </span><span class="token string" style="color:rgb(195, 232, 141)">"open"</span><span class="token plain"> : </span><span class="token string" style="color:rgb(195, 232, 141)">"paid"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>In this dataset:</p><ul>
<li class=""><code>due_on</code> falls between the <code>issued_on</code> value of its row and the end of 2026.</li>
<li class=""><code>state</code> is <code>open</code> in about one invoice in twenty, as in production.</li>
</ul><p>Over these rows, a test can assert that the query for a tenant's open invoices reads them through a
new index. A hand-written seed cannot test this: on 10 invoices, PostgreSQL scans the table even
with the index.</p><p>A synthetic dataset reads no production data and needs no credentials, so the Atlas skills use it by
default. They load a snapshot only when you ask for production data and name the export.</p></div></div></div>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="which-one-to-use-a-snapshot-or-synthetic-rows">Which one to use, a snapshot or synthetic rows?<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#which-one-to-use-a-snapshot-or-synthetic-rows" class="hash-link" aria-label="Direct link to Which one to use, a snapshot or synthetic rows?" title="Direct link to Which one to use, a snapshot or synthetic rows?" translate="no">​</a></h4>
<p>When the cost depends on how many rows a statement touches, such as the time an index build or a
backfill holds a lock, generated rows at production scale measure it about as well as real ones. The
difference is in the values:</p>
<ul>
<li class="">A synthetic dataset holds the values you thought to write. It runs anywhere without production
access, and can hold cases production does not have yet.</li>
<li class="">A snapshot holds the values you did not think of: NULLs in a column a migration makes <code>NOT NULL</code>,
duplicates under a new unique index, the skew that decides a query plan, and the row widths that
decide how much a rewrite writes.</li>
</ul>
<p>The two work well together: synthetic data on every pull request, where the job holds no production
credentials, and a masked snapshot on a schedule or before a risky change.</p>
<div class="theme-admonition theme-admonition-note admonition_IZjC alert alert--secondary"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_bl22"><p>A sample is only part of the table. A profile over it measures only the rows it holds, and can miss
the one row that breaks a new constraint. When either matters, load the full table.</p></div></div>
<p>To learn more, see the <a class="" href="https://atlasgo.io/testing/profile">profiling</a> and <a class="" href="https://atlasgo.io/testing/datasets">testing with data</a>
documentation.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="drift-detection-between-deployments">Drift Detection Between Deployments<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#drift-detection-between-deployments" class="hash-link" aria-label="Direct link to Drift Detection Between Deployments" title="Direct link to Drift Detection Between Deployments" translate="no">​</a></h2>
<p>In v1.3, we added a check that blocks a deployment when the database has drifted from its migrations.
The new <a class="" href="https://atlasgo.io/changelog/migrate-drift"><code>atlas migrate drift</code></a> command runs the same comparison between
deployments, from a cron job or a CI pipeline, and reports every object that diverged:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate drift </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod</span><br></span></code></pre></div></div>
<div class="language-driftlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">Output</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-driftlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Drift Status: DRIFTED</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Current Version: 20260423120000</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Expected State:  atlas://my-app (registry)</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Pending Files:   0</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Changes:         3 (1 extra, 1 missing, 1 modified)</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Objects:         3 tables</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">Fingerprint:     28274a91e01d</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --- expected state (version 20260423120000)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  +++ actual state (postgres://localhost:5432/app)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token hunk">@@ -1,7 +1,8 @@</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">   CREATE TABLE "authors" (</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">     "id" integer NOT NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">     "name" text NOT NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">     "email" text NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token addition">  +  "nickname" text NULL,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">     PRIMARY KEY ("id")</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">   );</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token addition">  +CREATE INDEX "authors_name" ON "authors" ("name");</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">The database diverged from the expected state as if the following were executed:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">modified table "authors":</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">ALTER TABLE "authors" ADD COLUMN "nickname" text NULL;</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">CREATE INDEX "authors_name" ON "authors" ("name");</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">missing table "logs":</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">DROP TABLE "logs";</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">extra table "audit":</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">CREATE TABLE "audit" ("id" integer NOT NULL, PRIMARY KEY ("id"));</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token error">Error: database state does not match expected state at version 20260423120000</span><br></span></code></pre></div></div>
<p>The command never changes the database, and exits with status 1 when drift is found, so a scheduled
job fails on drift without parsing the output. The same check also runs:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/migrate-drift-multi-tenant">In one run</a> across an environment with many tenants, each
tenant at its own applied version.</li>
<li class="">As a <a class="" href="https://atlasgo.io/changelog/github-action-migrate-drift">GitHub Action</a>.</li>
<li class="">In the Kubernetes Operator, as <a class="" href="https://atlasgo.io/changelog/operator-drift-check"><code>AtlasDriftCheck</code></a> and
<a class="" href="https://atlasgo.io/changelog/operator-drift-policy"><code>policy.drift</code></a>.</li>
</ul>
<p>Anthropic's <a href="https://claude.com/resources/articles/the-ai-native-sdlc-playbook" target="_blank" rel="noopener noreferrer" class="">playbook</a> closes its
loop the same way: <em>"A deterministic script watches production and invokes Claude when a control band
is breached."</em> For the database, the metric is drift: the exit status of <code>atlas migrate drift</code> is the
breach, and its report is what the agent starts from.</p>
<p>Drift detection is part of Atlas Pro; run <code>atlas login</code> to get started. To learn more, see the
<a class="" href="https://atlasgo.io/versioned/drift-detection">drift detection documentation</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="self-hosted-schema-storage">Self-Hosted Schema Storage<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#self-hosted-schema-storage" class="hash-link" aria-label="Direct link to Self-Hosted Schema Storage" title="Direct link to Self-Hosted Schema Storage" translate="no">​</a></h2>
<p>Schema repositories in the <a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a> can now be
<a class="" href="https://atlasgo.io/changelog/schema-repo-url">stored outside Atlas Cloud</a>, in your own blob storage bucket or OCI
registry. Set <code>url</code> in the <code>repo</code> block of a schema, and Atlas pushes schema states and plans there
and resolves <code>atlas://</code> references against it:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"DATABASE_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">dev</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlite://dev?mode=memory"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.sql"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">repo</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"app"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">url</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"ATLAS_REGISTRY_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>The URL points to an AWS S3, Google Cloud Storage, or Azure Blob Storage bucket, or an OCI registry.
Buckets authenticate with the provider's standard credentials. An OCI URL carries its credentials, so
read it from an environment variable or a secret store, never as a literal in <code>atlas.hcl</code>:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema push </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">Output</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Schema: app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  -- Atlas URL: atlas://app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  -- Registry URL: oci://ghcr.io/org/atlas-registry</span><br></span></code></pre></div></div>
<p>The schema lands in the OCI registry, not in Atlas Cloud. <a class="" href="https://atlasgo.io/declarative/plan">Plans</a> and deployments
work as before: <code>atlas schema plan</code> writes plans to the URL, and <code>atlas schema apply --to atlas://app</code>
runs the approved plan it finds there.
<a class="" href="https://atlasgo.io/cloud/features/registry#backup-repositories">Backup repositories</a> work alongside the URL, and reads
fall back to them when the URL cannot serve them.</p>
<p>Commands that use the repository still require <code>atlas login</code>. To learn more, see
<a class="" href="https://atlasgo.io/cloud/features/registry#storing-schemas-outside-atlas-cloud">Storing Schemas Outside Atlas Cloud</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="database-driver-improvements">Database Driver Improvements<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#database-driver-improvements" class="hash-link" aria-label="Direct link to Database Driver Improvements" title="Direct link to Database Driver Improvements" translate="no">​</a></h2>
<p>Beyond the headline features, this release includes enhancements across the supported engines:</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="snowflake">Snowflake<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#snowflake" class="hash-link" aria-label="Direct link to Snowflake" title="Direct link to Snowflake" translate="no">​</a></h3>
<p>Snowflake had the busiest cycle. Coverage grew from tables and warehouses to the policies and
network objects that govern them:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Governance Policies</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Tag-Based Masking</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">External Access</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Interactive Tables</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/snowflake-policies">Masking, projection, aggregation, and join policies</a> join
<a class="" href="https://atlasgo.io/changelog/snowflake-row-access-policies">row access policies</a> as first-class resources:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sf.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">masking_policy </span><span class="token string" style="color:rgb(195, 232, 141)">"MP_SSN"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arg </span><span class="token string" style="color:rgb(195, 232, 141)">"VAL"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR(</span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">return</span><span class="token plain">                </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR(</span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">                    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"'***'"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">exempt_other_policies</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">projection_policy </span><span class="token string" style="color:rgb(195, 232, 141)">"PP"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"PROJECTION_CONSTRAINT(ALLOW =&gt; FALSE)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">aggregation_policy </span><span class="token string" style="color:rgb(195, 232, 141)">"AP"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"AGGREGATION_CONSTRAINT(MIN_GROUP_SIZE =&gt; 11)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">join_policy </span><span class="token string" style="color:rgb(195, 232, 141)">"JP"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"JOIN_CONSTRAINT(JOIN_REQUIRED =&gt; TRUE)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Attach them to a table or a column with a <code>policy</code> block labeled by kind. Atlas alters a policy in
place where Snowflake allows it, and recreates it where it does not.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>With <a class="" href="https://atlasgo.io/changelog/snowflake-tag-masking-policies">tag-based masking</a>, masking policies are set on a
tag, and every column that carries the tag is masked by the policy for its data type:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sf.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">schema </span><span class="token string" style="color:rgb(195, 232, 141)">"PUBLIC"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">masking_policy </span><span class="token string" style="color:rgb(195, 232, 141)">"MASK_SSN"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arg </span><span class="token string" style="color:rgb(195, 232, 141)">"VAL"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">return</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"'***'"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">tag </span><span class="token string" style="color:rgb(195, 232, 141)">"PII"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">           </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">masking_policies</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">masking_policy.MASK_SSN</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Swapping a policy for another of the same data type is planned as a single
<code>SET MASKING POLICY ... FORCE</code>, so tagged columns are never left unmasked.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/snowflake-network-rules">Network rules</a> and
<a class="" href="https://atlasgo.io/changelog/snowflake-external-access-integrations">external access integrations</a> declare which
hosts a UDF or procedure may reach, and with which <a class="" href="https://atlasgo.io/changelog/snowflake-secrets">secrets</a>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sf.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">network_rule </span><span class="token string" style="color:rgb(195, 232, 141)">"EGRESS_A"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> HOST_PORT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">mode</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> EGRESS</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">value_list</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"example.com:443"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">external_access_integration </span><span class="token string" style="color:rgb(195, 232, 141)">"GATEWAY"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">allowed_network_rules</span><span class="token plain">                   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">network_rule.EGRESS_A, </span><span class="token string" style="color:rgb(195, 232, 141)">"OTHER_DB.PUBLIC.ELSEWHERE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">allowed_authentication_secrets</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"PUBLIC.VENDOR_TOKEN"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">allowed_api_authentication_integrations</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"API_AUTH"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">enabled</span><span class="token plain">                                 </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">                                 </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"gateway"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Network rules and secrets are named by a reference or by a qualified string, so an object Atlas does
not manage can still be listed. Secret values are redacted from plans and inspection output.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/snowflake-interactive-tables">Interactive tables</a> are static, or refreshed on a
<code>target_lag</code>, and are served by the new
<a class="" href="https://atlasgo.io/changelog/snowflake-interactive-warehouses">interactive warehouses</a>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sf.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Dynamic interactive table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">interactive_table </span><span class="token string" style="color:rgb(195, 232, 141)">"DAILY_REVENUE_BY_REGION"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Daily revenue per region, refreshed every 5 minutes"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">cluster_by</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"REGION"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"ORDER_DATE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">target_lag</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"5 minutes"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">warehouse</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"DEMO_WH"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SELECT REGION, ORDER_DATE, SUM(AMOUNT) AS REVENUE, COUNT(*) AS ORDER_COUNT FROM ORDERS GROUP BY REGION, ORDER_DATE"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">depends_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">table.ORDERS</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"REGION"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">comment</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Sales region"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"ORDER_DATE"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"REVENUE"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"ORDER_COUNT"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">tag</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">ref</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> tag.DATA_DOMAIN</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sales"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Without <code>target_lag</code>, the table is a static snapshot of the query result.</p></div></div></div>
<p>Snowflake also gains:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-alerts">Alerts</a>.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-storage-lifecycle-policies">Storage lifecycle policies</a>.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-data-metric-functions">Data metric functions</a>.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-object-attributes">Wider attribute coverage</a> for warehouses, tables, stages,
and functions.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-allow-recreate"><code>allow_recreate</code></a> for column changes Snowflake cannot alter
in place.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="sql-server">SQL Server<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#sql-server" class="hash-link" aria-label="Direct link to SQL Server" title="Direct link to SQL Server" translate="no">​</a></h3>
<p>SQL Server gains the objects that sit around a database, and joins the lineage graph:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Linked Servers</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Filegroups</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Synonyms</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Lineage</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/sqlserver-linked-servers">Linked servers</a> and their login mappings are declared as
<code>linked_server</code> blocks. Objects that read through one are created after it and dropped before it:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ms.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">linked_server </span><span class="token string" style="color:rgb(195, 232, 141)">"warehouse"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">provider</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"MSOLEDBSQL"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">data_source</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"warehouse-db"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">catalog</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sales"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">login</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">use_self</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">view </span><span class="token string" style="color:rgb(195, 232, 141)">"order_ids"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SELECT [id] FROM OPENQUERY([warehouse], 'SELECT id FROM sales.dbo.orders') AS [q]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">depends_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">linked_server.warehouse</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">procedure </span><span class="token string" style="color:rgb(195, 232, 141)">"count_orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">lang</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> SQL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"EXECUTE ('SELECT COUNT(*) FROM sales.dbo.orders') AT [warehouse];"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">depends_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">linked_server.warehouse</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">synonym </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">object</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"[warehouse].[sales].[dbo].[orders]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>The remote password of a login mapping is write-only: Atlas plans it, but never inspects or
compares it.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/sqlserver-filegroups">Filegroups</a> and their files are declared as <code>filegroup</code> blocks,
and partition schemes, indexes, and constraints are placed on them:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ms.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">filegroup </span><span class="token string" style="color:rgb(195, 232, 141)">"FG_A"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">default</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  file </span><span class="token string" style="color:rgb(195, 232, 141)">"filegroup_a1"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">filename</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"/var/opt/mssql/data/filegroup_a1.ndf"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">size</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"8MB"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">maxsize</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"UNLIMITED"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">growth</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"64MB"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">filegroup </span><span class="token string" style="color:rgb(195, 232, 141)">"FG_R"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  file </span><span class="token string" style="color:rgb(195, 232, 141)">"filegroup_r1"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">filename</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"/var/opt/mssql/data/filegroup_r1.ndf"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">size</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"16MB"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">maxsize</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"1GB"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">growth</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"10%"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">partition_function </span><span class="token string" style="color:rgb(195, 232, 141)">"PF"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">input</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">range</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> RIGHT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">values</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"100"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">partition_scheme </span><span class="token string" style="color:rgb(195, 232, 141)">"PS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">partition</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> partition_function.PF</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">filegroups</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"PRIMARY"</span><span class="token plain">, filegroup.FG_R</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>A filegroup gets its files before it becomes the default, and is removed only after the objects
stored on it.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A <a class="" href="https://atlasgo.io/changelog/sqlserver-synonyms">synonym</a> names its base object: a table, view, function, or
procedure that Atlas manages, or a multi-part name for one it doesn't, such as a table on a linked
server:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ms.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">synonym </span><span class="token string" style="color:rgb(195, 232, 141)">"s_remote"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">object</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"[srv].[otherdb].[dbo].[t1]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">synonym </span><span class="token string" style="color:rgb(195, 232, 141)">"s_t1"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">object</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.t1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>SQL Server has no <code>ALTER SYNONYM</code>, so a new base object drops and re-creates the synonym and grants
its permissions again.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The <a class="" href="https://atlasgo.io/changelog/sqlserver-lineage-graph">lineage graph</a> now supports SQL Server. It traces each view
column through the T-SQL that defines it, including CTEs, <code>CROSS APPLY</code> and <code>OUTER APPLY</code>, and window
functions:</p><div style="text-align:center"><img src="https://atlasgo.io/u/mssql/images/lineage-graph/expression-pinned.png" alt="Atlas Cloud lineage graph showing column lineage with a pinned expression" width="100%"><p style="font-size:12px">Column lineage of a T-SQL view, with a pinned expression</p></div></div></div></div>
<p>SQL Server is also covered by the <a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#security-scanning-for-databases" class="">security scan</a> and the
<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#profiler" class="">profiler</a>. If you are moving a database to PostgreSQL, see the
<a class="" href="https://atlasgo.io/guides/sql-server-to-postgresql">SQL Server to PostgreSQL guide</a>.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql">PostgreSQL<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#postgresql" class="hash-link" aria-label="Direct link to PostgreSQL" title="Direct link to PostgreSQL" translate="no">​</a></h3>
<p>PostgreSQL gains temporal keys from version 18, and finer control over role memberships and default
privileges:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Temporal Keys</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Membership Options</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Default Privileges</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/postgres-temporal-constraints">Temporal keys</a> enforce uniqueness and referential
integrity over time ranges: <code>WITHOUT OVERLAPS</code> on primary keys and unique constraints, and <code>PERIOD</code>
on foreign keys:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.pg.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"parent"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"validity"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> tsrange</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.id, column.validity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">             </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> GIST</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">without_overlaps</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  unique </span><span class="token string" style="color:rgb(195, 232, 141)">"parent_key"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.id, column.validity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">             </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> GIST</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">without_overlaps</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"child"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"parent_id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"validity"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> tsrange</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  foreign_key </span><span class="token string" style="color:rgb(195, 232, 141)">"child_parent_fkey"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.parent_id, column.validity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">ref_columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">table.parent.column.id, table.parent.column.validity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">period</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>A temporal key is always backed by a GiST index, so <code>type = GIST</code> may be omitted when authoring.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A grant like <code>GRANT reader TO vault WITH ADMIN OPTION</code> used to be inspected as a plain membership. A
new <a class="" href="https://atlasgo.io/changelog/role-membership-options"><code>membership</code></a> block declares the options a membership is
granted with:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.pg.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"reader"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"writer"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">user </span><span class="token string" style="color:rgb(195, 232, 141)">"vault"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">member_of</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.reader</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">membership</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">role</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.writer</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">admin</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Grant role "reader" to "vault"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">GRANT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"reader"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TO</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"vault"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Grant role "writer" to "vault"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">GRANT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"writer"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TO</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"vault"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">WITH</span><span class="token plain"> ADMIN </span><span class="token keyword" style="font-style:italic">OPTION</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p><code>inherit</code> and <code>set</code> are supported on PostgreSQL 16 and above. <code>admin</code> is also supported on MySQL,
ClickHouse, Redshift, and Oracle.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>For schemas whose objects are created by another tool,
<a class="" href="https://atlasgo.io/changelog/postgres-default-privileges">default privileges</a> are declared as <code>default_permission</code>
blocks:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.pg.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">default_permission</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">owner</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> user.migrations</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">on</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> TABLES</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> user.app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">privileges</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">DELETE, INSERT, SELECT, UPDATE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas plans the <code>ALTER DEFAULT PRIVILEGES</code> statements that make the database match, and reports
drift on them.</p></div></div></div>
<p>Atlas also keeps an <a class="" href="https://atlasgo.io/changelog/postgres-index-operator-classes">explicit index operator class</a> that
PostgreSQL would not pick for the column on its own, such as <code>text_ops</code> on a <code>citext</code> column.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="databricks">Databricks<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#databricks" class="hash-link" aria-label="Direct link to Databricks" title="Direct link to Databricks" translate="no">​</a></h3>
<p>Databricks gains metric views and tags, and plans struct changes that used to fail:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Metric Views</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Tags</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Struct Columns</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>A <a class="" href="https://atlasgo.io/changelog/databricks-metric-views">metric view</a> is a <code>view</code> block with <code>metrics = true</code>, whose
<code>as</code> attribute holds the YAML definition:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">view </span><span class="token string" style="color:rgb(195, 232, 141)">"revenue_metrics"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.retail_analytics</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">metrics</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Revenue KPIs by region and day"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token heredoc string" style="color:rgb(195, 232, 141)">&lt;&lt;-SQL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  version: 0.1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  source: retail_analytics.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  dimensions:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">    - name: region</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">      expr: region</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">    - name: order_day</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">      expr: DATE(placed_on)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  measures:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">    - name: total_revenue</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">      expr: SUM(total_amount)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  SQL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">depends_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">table.orders</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Definition and comment changes are applied in place with <code>ALTER VIEW</code>, so the view keeps its grants.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/databricks-tags">Tags</a> are key/value pairs in the <code>tags</code> map of the object they label:
schemas, tables, views, materialized views, and their columns:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">schema </span><span class="token string" style="color:rgb(195, 232, 141)">"sales"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">tags</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">owner</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"crm"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"customers"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.sales</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"customer_id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> BIGINT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> STRING</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">tags</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">pii_type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">tags</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">data_classification</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"confidential"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>A tag is not an object of its own, so there is no <code>tag</code> block. Atlas sets the tags of an object
right after it creates it.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Databricks rejects a type change on a whole struct column, so Atlas now
<a class="" href="https://atlasgo.io/changelog/databricks-struct-column-changes">changes struct fields</a> one statement at a time, nested
and inside arrays included:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">column </span><span class="token string" style="color:rgb(195, 232, 141)">"payload"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"STRUCT&lt;a:INT, b:STRING, c:INT&gt;"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">column </span><span class="token string" style="color:rgb(195, 232, 141)">"items"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"ARRAY&lt;STRUCT&lt;x:INT, y:INT&gt;&gt;"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">retail_analytics</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">events</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">payload</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">c</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INT</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">retail_analytics</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">events</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">items</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">element</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">y</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INT</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div></div></div></div>
<p>Databricks also gains:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/databricks-object-attribute-coverage">Expanded attribute coverage</a> across tables,
views, functions, and procedures.</li>
<li class="">A <a class="" href="https://atlasgo.io/changelog/databricks-lakebase-token">token data source</a> for Lakebase, so the connection URL
carries no static password.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="redshift">Redshift<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#redshift" class="hash-link" aria-label="Direct link to Redshift" title="Direct link to Redshift" translate="no">​</a></h3>
<p>Redshift gains access control and data sharing as code:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Roles &amp; Permissions</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Datashares</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Column Rebuilds</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/redshift-roles-permissions">Roles, groups, users, and permissions</a> are now managed as
code, including the users Redshift creates for <a class="" href="https://atlasgo.io/changelog/redshift-iam-users">IAM identities</a>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.rs.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"app_readonly"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"app_writer"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">member_of</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.app_readonly</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// A group is a role carrying the group marker: Redshift keeps</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// CREATE GROUP apart from CREATE ROLE.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"app_analysts"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">group</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">user </span><span class="token string" style="color:rgb(195, 232, 141)">"app_api"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">conn_limit</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">member_of</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.app_writer, role.app_analysts</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas writes each grantee the way Redshift requires, and revokes privileges before it drops the role
or user that holds them.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A <a class="" href="https://atlasgo.io/changelog/redshift-datashares">datashare</a> declares the schemas and objects a cluster shares, and
the namespaces and accounts allowed to consume them:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.rs.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">datashare </span><span class="token string" style="color:rgb(195, 232, 141)">"sales_share"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Share a fixed set of objects from a schema.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">for</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.sales</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">objects</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">table.orders, view.summary</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Share everything in the schema, now and later.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">for</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.logs</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">include_new</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Share everything except the objects listed.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">for</span><span class="token plain">                </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.events</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">include_new_except</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">table.audit</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">namespaces</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"00000000-0000-0000-0000-000000000000"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Redshift applies <code>INCLUDENEW</code> only to objects created after it is set, so Atlas adds the existing
ones explicitly, and the share covers the whole schema from the first apply.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Redshift cannot change a column's <code>NULL</code> setting or default in place. Atlas now
<a class="" href="https://atlasgo.io/changelog/redshift-column-recreate-user-params">plans these changes</a> by dropping the column and
adding it back, once you allow it:</p><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain"># In a terminal, Atlas asks first:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">$ atlas migrate diff relax_user_agent --env prod</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">? Column "user_agent" nullability change requires recreating the column:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  ▸ Abort</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    Drop and recreate column "user_agent" (data loss)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"># In CI, there is nobody to ask, so it stops:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">$ atlas migrate diff relax_user_agent --env prod</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Error: Column "user_agent" nullability change requires recreating the column.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Set 'allow_recreate' in the 'modify_column' block of the diff policy to plan it</span><br></span></code></pre></div></div><p>The <code>user</code> block also takes a <code>params</code> map for the settings every session of that user starts with.</p></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="oracle">Oracle<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#oracle" class="hash-link" aria-label="Direct link to Oracle" title="Direct link to Oracle" translate="no">​</a></h3>
<p>Oracle gains tablespaces, deferrable keys, and column collations:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Tablespaces</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Deferrable Keys</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Collations</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/oracle-tablespace-physical-attributes">Tablespaces and physical attributes</a> are declared
in a <code>physical</code> block, on tables and on indexes:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"T3"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.APP</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"A"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"I_T3"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.A</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">physical</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">initrans</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">tablespace</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SYSAUX"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">physical</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">pctfree</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">tablespace</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SYSAUX"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">storage</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">buffer_pool</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> KEEP</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Relocations are planned with <code>ALTER TABLE ... MOVE ONLINE</code>, which keeps indexes usable, and a changed
index clause as <code>ALTER INDEX ... REBUILD</code>.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/oracle-deferrable-keys-constraint-state">Primary and unique keys</a> can be deferrable,
reuse an existing index, and carry constraint state:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">index </span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS_ID_IDX"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">unique</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">primary_key </span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS_PK"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">columns</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">index</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> index.PARCELS_ID_IDX  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># USING INDEX.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">deferrable</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> INITIALLY_DEFERRED    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># or INITIALLY_IMMEDIATE.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- create index "PARCELS_ID_IDX" to table: "PARCELS"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS_ID_IDX"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"APP"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"ID"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- modify "PARCELS" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"APP"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS_PK"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">PRIMARY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">KEY</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"ID"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">USING</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"PARCELS_ID_IDX"</span><span class="token plain"> DEFERRABLE INITIALLY DEFERRED</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Character columns take a <a class="" href="https://atlasgo.io/changelog/oracle-column-collations"><code>collate</code></a> attribute, and Atlas plans
the <code>MODIFY ... COLLATE</code> statements that add, change, or reset it:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"USERS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.APP</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"NAME"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR2(</span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">collate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"BINARY_CI"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"CODE"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR2(</span><span class="token number" style="color:rgb(247, 140, 108)">10</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="mysql-and-mariadb">MySQL and MariaDB<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#mysql-and-mariadb" class="hash-link" aria-label="Direct link to MySQL and MariaDB" title="Direct link to MySQL and MariaDB" translate="no">​</a></h3>
<p>Six new lint analyzers report <a class="" href="https://atlasgo.io/changelog/mysql-blocking-changes-checks">changes that copy or rebuild the table</a>,
block concurrent writes, or silently forfeit instant DDL. For example, adding a stored generated
column:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> total </span><span class="token keyword" style="font-style:italic">INT</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">price </span><span class="token operator" style="color:rgb(137, 221, 255)">*</span><span class="token plain"> qty</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> STORED </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">blocking table changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L1</span><span class="token plain">: Adding stored generated column </span><span class="token ident">"total"</span><span class="token plain"> on table </span><span class="token ident">"orders"</span><span class="token plain"> requires a table copy and</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         blocks concurrent DML https://atlasgo.io/lint/analyzers#MY140</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token plain">suggested fix:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      -&gt; Define the column as VIRTUAL to add it instantly, unless its value must be stored</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="clickhouse">ClickHouse<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#clickhouse" class="hash-link" aria-label="Direct link to ClickHouse" title="Direct link to ClickHouse" translate="no">​</a></h3>
<p>Some ClickHouse changes cannot keep the rows during a rebuild, such as an engine change on a
replicated table with a fixed ZooKeeper path.</p>
<p>A run without a terminal used to leave such a change out of the plan. It
<a class="" href="https://atlasgo.io/changelog/clickhouse-allow-recreate">now fails and names the table</a>, unless the diff policy allows
the rebuild:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  diff </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">modify_table</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">allow_recreate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="distributed-sql">Distributed SQL<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#distributed-sql" class="hash-link" aria-label="Direct link to Distributed SQL" title="Direct link to Distributed SQL" translate="no">​</a></h3>
<p>CockroachDB, YugabyteDB, Aurora DSQL, and Spanner each gain a missing piece:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">CockroachDB</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">YugabyteDB</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Aurora DSQL</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Spanner</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/cockroachdb-triggers-functions-procedures">Triggers, functions, and procedures</a> are
written like their PostgreSQL counterparts:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">function </span><span class="token string" style="color:rgb(195, 232, 141)">"audit_order"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">lang</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> PLpgSQL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">return</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> trigger</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">as</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token heredoc string" style="color:rgb(195, 232, 141)">&lt;&lt;-SQL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  BEGIN</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  RETURN new;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  END;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token heredoc string" style="color:rgb(195, 232, 141)">  SQL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">trigger </span><span class="token string" style="color:rgb(195, 232, 141)">"audit_orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">before</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">insert</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> ROW</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">when</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"((new).amount &gt; 100)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">execute</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">function</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> function.audit_order</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">args</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>CockroachDB rejects <code>DROP FUNCTION ... CASCADE</code>, so Atlas orders a trigger drop before the function
it executes.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Atlas manages the attributes that decide
<a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-declarative">how a table is distributed</a>: colocation, tablet
pre-splitting, and hash or range sharding:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// High-throughput table: range primary key, pre-split at known boundaries.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">colocation</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">split_at_values</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"1000000"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"2000000"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"3000000"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> bigint</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"customer_id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> bigint</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"placed_at"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> timestamptz</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">column</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> column.id</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sharding</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> RANGE   </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// range-sharded: required by split_at_values</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>These attributes are fixed when the object is created, so Atlas plans a recreate when one changes.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Atlas plans <a class="" href="https://atlasgo.io/changelog/dsql-constraints-identity-async-jobs">constraints on existing tables</a>,
identity columns, and columns added with a default, in the statement forms DSQL accepts:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Modify "projects" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects_name_check"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CHECK</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">name </span><span class="token operator" style="color:rgb(137, 221, 255)">&lt;&gt;</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">''</span><span class="token plain">::</span><span class="token keyword" style="font-style:italic">text</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> VALID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Validate constraint "projects_name_check"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> ASYNC </span><span class="token string" style="color:rgb(195, 232, 141)">"projects"</span><span class="token plain"> VALIDATE </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects_name_check"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Create index "projects_name_key" to table: "projects"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> ASYNC </span><span class="token string" style="color:rgb(195, 232, 141)">"projects_name_key"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"tenant_id"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"name"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Modify "projects" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects_name_key"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">USING</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"projects_name_key"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p>Atlas waits for each async job before it runs the next statement, so a failed index build or
validation fails the migration.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A column can declare its own <a class="" href="https://atlasgo.io/changelog/spanner-column-locality-groups">locality group</a>, overriding
its table's, so hot and cold data live on different storage inside one table:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">locality </span><span class="token string" style="color:rgb(195, 232, 141)">"hot"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">storage</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"ssd"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">locality </span><span class="token string" style="color:rgb(195, 232, 141)">"cold"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">storage</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"hdd"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"Singers"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.default</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">locality_group</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> locality.hot</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"SingerId"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> STRING(</span><span class="token number" style="color:rgb(247, 140, 108)">36</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"Bio"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> STRING(</span><span class="token number" style="color:rgb(247, 140, 108)">1024</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">options</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">locality_group</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> locality.cold</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.SingerId</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="also-in-this-release">Also in This Release<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#also-in-this-release" class="hash-link" aria-label="Direct link to Also in This Release" title="Direct link to Also in This Release" translate="no">​</a></h2>
<p>Atlas v1.3.5 and later are built with <a class="" href="https://atlasgo.io/changelog/emudhra-ca-compromise">Go 1.26.10</a>, which rejects
certificates issued under the compromised eMudhra intermediates.</p>
<p>This release also includes improvements to Atlas Scripts, lint, permissions, CI/CD, the Kubernetes
Operator, and Azure, and adds dark mode to Atlas Cloud:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Atlas Scripts</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Lint</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Permissions</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">CI/CD</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Kubernetes Operator</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Azure</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Dark Mode</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>The <code>atlas script</code> commands <a class="" href="https://atlasgo.io/changelog/script-multi-tenant">run on every target</a> of an environment
defined with <code>for_each</code>, such as a database or a schema per tenant, with each tenant's own URL and
variables:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">locals</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">tenants</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"tenant_1"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"tenant_2"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for_each</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> toset(local.tenants)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlite://</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation" style="color:rgb(195, 232, 141)">each</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation" style="color:rgb(195, 232, 141)">value</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)">.db"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">tenant</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> each.value</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">script</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://scripts"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas script query </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'^user_counts$'</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--quiet</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">tenant_1: 4 users, 2 on pro</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">tenant_2: 3 users, 1 on pro</span><br></span></code></pre></div></div><p>Scripts pushed with <code>atlas script push</code> also get a <a class="" href="https://atlasgo.io/changelog/script-registry">page in the Registry</a>,
and run from anywhere by name with an <code>atlas://</code> URL.</p><p>A <code>mask</code> block can also <a class="" href="https://atlasgo.io/changelog/data-scripts-entity-masks">mask entities in free text</a>, such as
emails and phone numbers, and keep the rest of the value.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Lint already reports table and column drops as destructive changes. It now also reports them as
<a class="" href="https://atlasgo.io/changelog/backward-incompatible-drop-checks">backward incompatible</a>, since even an empty column is
a breaking change for the code that selects it:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">2.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> users </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> pets</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">analyzing version 2</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">destructive changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L1</span><span class="token plain">: Dropping non-virtual column </span><span class="token ident">"name"</span><span class="token plain"> https://atlasgo.io/lint/analyzers#DS103</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L2</span><span class="token plain">: Dropping table </span><span class="token ident">"pets"</span><span class="token plain"> https://atlasgo.io/lint/analyzers#DS102</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">backward incompatible changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L1</span><span class="token plain">: Clients using column </span><span class="token ident">"users"</span><span class="token plain">.</span><span class="token ident">"name"</span><span class="token plain"> will fail https://atlasgo.io/lint/analyzers#BC104</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L2</span><span class="token plain">: Clients using table </span><span class="token ident">"pets"</span><span class="token plain"> will fail https://atlasgo.io/lint/analyzers#BC103</span><br></span></code></pre></div></div><p>A <a class="" href="https://atlasgo.io/changelog/routine-complexity-policy">complexity policy</a> sets limits for the functions,
procedures, and triggers a migration creates or changes, and lint reports the ones above them.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The HCL <code>permission</code> block can grant on schemas, tables, and views
<a class="" href="https://atlasgo.io/changelog/permission-external-refs">declared outside HCL</a>, such as in a SQL file:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">SCHEMA</span><span class="token plain"> analytics</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> analytics</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">events </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">id </span><span class="token keyword" style="font-style:italic">int</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">PRIMARY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">KEY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p>Its <code>for</code> attribute takes a <code>ref()</code> to the object:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"reader"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">permission</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.reader</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> ref(</span><span class="token string" style="color:rgb(195, 232, 141)">"schema.analytics"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">privileges</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">USAGE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">permission</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.reader</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> ref(</span><span class="token string" style="color:rgb(195, 232, 141)">"table.analytics.events"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">privileges</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">SELECT</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Both files are combined in a <a class="" href="https://atlasgo.io/atlas-schema/projects#data-source-composite_schema">composite schema</a>.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The <code>schema/plan</code> and <code>migrate/lint</code> GitHub Actions add a
<a class="" href="https://atlasgo.io/changelog/github-action-change-summary">change summary</a> to their pull request comments: one row for
each changed object, with its diff and the statements that change it.</p><p>The <a class="" href="https://atlasgo.io/changelog/install-script-checksum">install script</a> checks the binary it downloads against its
published SHA-256 checksum, and stops without installing anything if they don't match:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-sSf</span><span class="token plain"> https://atlasgo.sh </span><span class="token operator" style="color:rgb(137, 221, 255)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">sh</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">Output</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Checksum mismatch for 'atlas-linux-amd64-latest': expected &lt;published&gt;, got &lt;downloaded&gt;.</span><br></span></code></pre></div></div><p>The <a class="" href="https://atlasgo.io/changelog/gitlab-ci-verified-binaries">GitLab CI components</a> check their binary against a
SHA-256 checksum that ships with each component release, so pinning a component by commit SHA also
pins the binary it runs.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><code>AtlasSchema</code> and <code>AtlasMigration</code> accept a
<a class="" href="https://atlasgo.io/changelog/operator-dev-db-pod-metadata"><code>devDB.metadata</code></a> block that sets labels and annotations on
the dev database pod the Operator creates:</p><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasSchema</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> myapp</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">urlFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> myapp</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">db</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">devDB</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">labels</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">team</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> platform</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">annotations</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">example.com/purpose</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> schema</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">analysis</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">schema</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">sql</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">|</span><span class="token scalar string" style="color:rgb(195, 232, 141)"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">      create table users (</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">        id int not null,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">        primary key (id)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">      );</span><br></span></code></pre></div></div><p>See the <a class="" href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8">Operator v0.8 post</a> for the rest of the Operator's
updates.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The <a class="" href="https://atlasgo.io/changelog/azure-db-token"><code>azure_db_token</code></a> data source generates a short-lived Microsoft Entra
access token for Azure Database for PostgreSQL and MySQL from inside the project file, so the
connection URL no longer carries a static password:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">data </span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)">"azure_db_token"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"db"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"azure"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># The Entra user contains "@", so it must be URL-escaped</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># with urluserinfo (or urlescape) rather than interpolated.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> urluserinfo(</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://myserver.postgres.database.azure.com:5432/postgres?sslmode=require"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"app@contoso.onmicrosoft.com"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    data.azure_db_token.db,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  )</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Atlas Cloud has a <a class="" href="https://atlasgo.io/changelog/cloud-dark-mode">dark mode</a>. Switch to it from the user menu under your
avatar, or match your system's theme:</p><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/dark-mode/security-graph.webp" alt="The Atlas Cloud security graph in dark mode, showing extension CVEs and the issues panel" width="100%"><p style="font-size:12px">The security graph in dark mode</p></div></div></div></div>
<p>We ship improvements continuously between releases, so follow the <a class="" href="https://atlasgo.io/changelog">Atlas changelog</a> to
stay up to date.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-binaries-are-moving">Atlas Binaries Are Moving<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#atlas-binaries-are-moving" class="hash-link" aria-label="Direct link to Atlas Binaries Are Moving" title="Direct link to Atlas Binaries Are Moving" translate="no">​</a></h2>
<p>Starting December 2026, Atlas CLI binaries are served from <code>https://atlasbinaries.com</code>. Most setups
need no change.</p>
<p><code>release.ariga.io</code> will no longer serve public downloads directly, and requests to it will redirect
to the same file on <code>atlasbinaries.com</code>. File paths stay the same, and only the hostname changes:</p>
<div class="language-diff codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-diff codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token deleted-sign deleted prefix deleted" style="color:rgb(255, 85, 114)">-</span><span class="token deleted-sign deleted line" style="color:rgb(255, 85, 114)">https://release.ariga.io/atlas/atlas-linux-amd64-latest</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token deleted-sign deleted line" style="color:rgb(255, 85, 114)"></span><span class="token inserted-sign inserted prefix inserted" style="color:rgb(195, 232, 141)">+</span><span class="token inserted-sign inserted line" style="color:rgb(195, 232, 141)">https://atlasbinaries.com/atlas/atlas-linux-amd64-latest</span><br></span></code></pre></div></div>
<p>Here is what to check:</p>
<ul>
<li class="">If you use the official install script (<code>curl -sSf https://atlasgo.sh | sh</code>), there is nothing to
do.</li>
<li class="">If you download binaries directly, in CI pipelines, Dockerfiles, or scripts, replace
<code>release.ariga.io</code> with <code>atlasbinaries.com</code> in your URLs.</li>
<li class="">If your firewall or proxy restricts outbound traffic, allow <code>atlasbinaries.com</code>.</li>
<li class="">If your download command does not follow redirects, such as <code>curl</code> without <code>-L</code>, turn it on.
Otherwise, once the redirect is active, it saves the redirect response instead of the binary.</li>
</ul>
<p>Questions? <a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#">Message us on Intercom</a> or ask on our
<a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/11/17/atlas-v1-4#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>Atlas v1.4 brings security scanning to your databases, from a lint check in CI to scheduled scans of
production.</p>
<p>It also extends the feedback loop we described in
<a class="" href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database">The AI-Native SDLC Playbook Stops at the Database</a>. The
first example in that post is a migration that passes every test on a dev database with 40 rows, and
then holds a lock on the production table for 90 seconds.</p>
<p>Lint classifies such a change by how it breaks production, and the profiler now measures it over
production-like data, before the change merges. Together with the agent skills and the drift checks
between deployments, more of that loop now has the database inside it.</p>
<p>We'd love to hear your feedback! Join our <a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a> or
<a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content:encoded>
            <category>release</category>
            <category>atlas v1.4</category>
            <category>security scan</category>
            <category>cve</category>
            <category>agent skills</category>
            <category>profiler</category>
            <category>drift detection</category>
            <category>testing</category>
            <category>security</category>
            <category>postgres</category>
            <category>clickhouse</category>
            <category>snowflake</category>
        </item>
        <item>
            <title><![CDATA[Managing YugabyteDB Schemas with the Atlas Kubernetes Operator]]></title>
            <link>https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator</link>
            <guid>https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator</guid>
            <pubDate>Mon, 16 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Deploy YugabyteDB colocation, tablet pre-splitting, and index sharding as versioned migrations with the Atlas Kubernetes Operator.]]></description>
            <content:encoded><![CDATA[<p>Teams don't adopt YugabyteDB by accident. They choose it when a single relational database primary can no
longer keep up with their writes from payments, order processing, inventory, etc.</p>
<p>A distributed database carries more than just columns and types: every table and index records how data is
split across the cluster, and those choices determine how the database performs at scale. Many teams run
YugabyteDB next to their services on Kubernetes, where every other part of the system is versioned in a
repository, reviewed in a pull request, and deployed by changing a manifest. A change to how a table is split
deserves the same review as a change to its columns, and the same rollout to every cluster.</p>
<p>On YugabyteDB, Atlas models <a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned#colocated-tables">colocation</a>,
<a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned#pre-split-tablets">tablet pre-splitting</a>, and
<a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned#index-sharding">index sharding</a> as part of the schema, so the
distribution layout is versioned, diffed, and deployed with the rest of it, instead of living in handwritten
DDL that drifts between clusters. The <a class="" href="https://atlasgo.io/integrations/kubernetes">Atlas Kubernetes Operator</a> completes the
picture: it applies each version of the migration directory to the database from a Kubernetes resource, the
same way the cluster deploys a new image.</p>
<p>This post walks through how an application team can use Atlas and the Operator to declare, review, and evolve
their distributed YugabyteDB schema.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="distributed-postgresql-on-kubernetes">Distributed PostgreSQL on Kubernetes<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#distributed-postgresql-on-kubernetes" class="hash-link" aria-label="Direct link to Distributed PostgreSQL on Kubernetes" title="Direct link to Distributed PostgreSQL on Kubernetes" translate="no">​</a></h2>
<p>YugabyteDB is a distributed SQL database built on the PostgreSQL query layer, allowing teams to continue using
the SQL, drivers, tools, and ecosystem they already know. The underlying storage layer is distributed: data is
sharded across nodes and replicated via Raft consensus, so the database scales horizontally and remains
available through node, zone, or region failures. On Kubernetes, its nodes run as pods, spread across zones
like the services around them.</p>
<p>A traditional single-primary database routes every write through a single node, so the only way to add write
capacity is to use a larger server. YugabyteDB spreads writes across the cluster, so you can add capacity by
adding nodes, without sacrificing ACID transactions or strong consistency.</p>
<p>Take online retail orders, for example. During an event or flash sale, order volume can increase dramatically
within minutes, and Kubernetes scales out the checkout services to meet it. Each checkout writes to orders,
line items, payments, and inventory reservations, and all of those writes must commit together. YugabyteDB
spreads them across the cluster, distributed transactions prevent stock from being oversold, and replication
keeps a failed node or zone from stopping checkouts. Data can be placed in regions close to customers to
reduce latency or meet data residency requirements, while the application still sees a single
PostgreSQL-compatible database.</p>
<p>The only catch is that this performance depends on schema decisions a single-node database never asks you to
make, and those decisions have to ship to every cluster as reliably as the services that depend on them.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="distribution-is-part-of-the-schema">Distribution Is Part of the Schema<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#distribution-is-part-of-the-schema" class="hash-link" aria-label="Direct link to Distribution Is Part of the Schema" title="Direct link to Distribution Is Part of the Schema" translate="no">​</a></h2>
<p>In YugabyteDB, both tables and indexes are split into tablets. How each object is split across the cluster is
a schema design decision, on the same level as choosing columns and types. YugabyteDB exposes three of these
decisions in DDL, and Atlas, through its <a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned"><code>ysql://</code> driver</a>,
models each one as a schema attribute:</p>
<table><thead><tr><th>Decision</th><th>What it controls</th><th>DDL</th><th>Atlas attribute</th></tr></thead><tbody><tr><td>Hash or range sharding</td><td>Whether rows of a table, or entries of an index, are hash-distributed or kept in sorted order by key</td><td><code>PRIMARY KEY (id HASH)</code>, <code>ON orders (month_created ASC)</code></td><td><code>sharding = HASH</code> or <code>sharding = RANGE</code> on a primary key or index column</td></tr><tr><td>Pre-splitting</td><td>How many tablets a table starts with, or where their boundaries are</td><td><code>SPLIT INTO 100 TABLETS</code>, <code>SPLIT AT VALUES (...)</code></td><td><code>split_into</code> for hash-sharded tables, <code>split_at_values</code> for range-sharded tables</td></tr><tr><td>Colocation</td><td>Whether a small table shares one tablet with its neighbors or gets its own</td><td><code>WITH (colocation = false)</code></td><td><code>colocation = false</code> to opt a table out of a colocated database</td></tr></tbody></table>
<p>Most of these are fixed when the object is created. A hash-sharded index can't become range-sharded, and a
colocated table can't move to its own tablets, without dropping and recreating it.</p>
<p>A schema tool that models only tables, columns, and types either ignores these attributes, so a change to them
never shows up in a diff, or plans a migration that drops them. Atlas compares them when it diffs two schemas,
and writes them into the DDL of each migration file it generates.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-and-the-kubernetes-operator">Atlas and the Kubernetes Operator<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#atlas-and-the-kubernetes-operator" class="hash-link" aria-label="Direct link to Atlas and the Kubernetes Operator" title="Direct link to Atlas and the Kubernetes Operator" translate="no">​</a></h2>
<p>This post uses the <a class="" href="https://atlasgo.io/versioned/intro">versioned workflow</a>, where each change is a SQL migration file
committed to the repository. Some distribution settings only exist at creation time. <code>split_into</code> sets the
number of tablets a table starts with, and YugabyteDB splits tablets automatically as the table grows, so
Atlas doesn't read the count back from a live database, and automatic splitting never turns into drift or
into a change in the next migration. A migration file keeps the <code>SPLIT INTO</code> clause exactly as Atlas
generated it, and every cluster runs the same file, so every cluster creates the table with the same tablets.
The <a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned#using-schema-inspection">schema inspection section</a> of the
YugabyteDB guide lists which distribution attributes Atlas reads back from a live database.</p>
<p>The Atlas Kubernetes Operator brings this to the cluster. An
<a class="" href="https://atlasgo.io/integrations/kubernetes/versioned"><code>AtlasMigration</code></a> resource names a database and a migration directory in
the <a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a>. The Operator applies the migrations the database hasn't run
yet, and records each one in the database's revision history.</p>
<p>The flow for every change:</p>
<ol>
<li class="">An engineer edits the schema in a feature branch and runs <a class="" href="https://atlasgo.io/versioned/diff"><code>atlas migrate diff</code></a> to
generate a migration file.</li>
<li class="">CI <a class="" href="https://atlasgo.io/versioned/lint">lints</a> the new migration file and posts the results to the pull request.</li>
<li class="">Reviewers approve the migration and the code change together. On merge, CI pushes the migration directory
to the Atlas Registry, tagged with the commit.</li>
<li class="">The <code>AtlasMigration</code> manifest is updated to the new tag, and the Operator applies the pending migrations
to the database.</li>
</ol>
<p>The rest of this post follows a retail team through this flow.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="setting-up">Setting Up<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#setting-up" class="hash-link" aria-label="Direct link to Setting Up" title="Direct link to Setting Up" translate="no">​</a></h2>
<p>This post picks up where <a href="https://www.yugabyte.com/blog/managing-distributed-schemas-with-confidence-atlas-now-supports-yugabytedb/" target="_blank" rel="noopener noreferrer" class="">Managing Distributed Schemas with Confidence: Atlas Now Supports YugabyteDB</a>,
on the YugabyteDB blog, leaves off. That post defines the team's schema and tries it on a local cluster.
This one uses the same project:</p>
<ul>
<li class=""><code>shop</code> is a regular database. It holds <code>orders</code>, defined in <code>shop.hcl</code>, with a hash-sharded primary key.</li>
<li class=""><code>lookup</code> is colocated. It holds the small <code>currencies</code> and <code>promotions</code> tables, defined in <code>lookup.hcl</code>,
which share one tablet.</li>
<li class=""><code>atlas.hcl</code> defines the <code>shop_local</code> and <code>lookup_local</code> environments, each with a
<a class="" href="https://atlasgo.io/concepts/dev-database">dev database</a> that matches its target's colocation.</li>
</ul>
<p>The cluster runs in the <code>yugabyte</code> namespace behind the <code>yb-tservers</code> service. Both databases are owned by
<code>shop_admin</code>, and <code>lookup</code> is created <code>WITH COLOCATION = true</code>. Colocation is set when a database is created,
and Atlas works inside existing databases, so creating them is a one-time setup step outside the migration
workflow.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="installing-the-operator">Installing the Operator<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#installing-the-operator" class="hash-link" aria-label="Direct link to Installing the Operator" title="Direct link to Installing the Operator" translate="no">​</a></h3>
<p><a class="" href="https://atlasgo.io/integrations/kubernetes/install">Install the Operator</a> with Helm:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">helm </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> atlas-operator oci://ghcr.io/ariga/charts/atlas-operator</span><br></span></code></pre></div></div>
<p>In production, enable the chart's
<a class="" href="https://atlasgo.io/integrations/kubernetes/install#persisting-the-atlas-grant-cache"><code>persistence</code></a>
so the Operator keeps its cached Atlas Cloud grant across pod restarts.</p>
<p>The Operator authenticates with a <a class="" href="https://atlasgo.io/cloud/bots">bot token</a> from your Atlas Cloud organization rather than
your local session. Store the token and the database URLs in Secrets, in the namespace the <code>AtlasMigration</code>
resources run in:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl create secret generic atlas-token --from-literal</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">token</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token operator" style="color:rgb(137, 221, 255)">&lt;</span><span class="token plain">your bot token</span><span class="token operator" style="color:rgb(137, 221, 255)">&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl create secret generic shop-db </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --from-literal</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">url</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">'ysql://shop_admin:&lt;password&gt;@yb-tservers.yugabyte:5433/shop'</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl create secret generic lookup-db </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --from-literal</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">url</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">'ysql://shop_admin:&lt;password&gt;@yb-tservers.yugabyte:5433/lookup'</span><br></span></code></pre></div></div>
<p>Each URL <a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#schema-and-database-bound-urls">names a database and no schema</a>,
so Atlas manages every schema in it. The host is the namespace-qualified service name, since the Operator
connects from its own namespace. Atlas connects over TLS by default, so the URL assumes the cluster has
client-to-server encryption enabled.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="generating-the-migrations">Generating the Migrations<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#generating-the-migrations" class="hash-link" aria-label="Direct link to Generating the Migrations" title="Direct link to Generating the Migrations" translate="no">​</a></h3>
<p>Each database gets its own migration directory. Add a <code>migration</code> block to each local environment in
<code>atlas.hcl</code>. The large, write-heavy tables are held in <code>shop</code>, so its environment also gets a
<a class="" href="https://atlasgo.io/versioned/diff#diff-policy"><code>diff</code> policy</a> that makes Atlas build new indexes online, without blocking
writes to a table that already holds data:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"shop_local"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"ysql://yugabyte@localhost:5433/shop?sslmode=disable"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">dev</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://ysql/latest/dev"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://shop.hcl"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migration</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">dir</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://migrations/shop"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">diff</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">concurrent_index</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">create</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p><code>lookup_local</code> gets the same <code>migration</code> block, with <code>file://migrations/lookup</code> as its directory. Then
generate the first migration for each database:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> init </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> shop_local</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> init </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> lookup_local</span><br></span></code></pre></div></div>
<p>Atlas plans each schema on the environment's dev database and writes the result to the directory, with an
<code>atlas.sum</code> <a class="" href="https://atlasgo.io/concepts/migration-directory-integrity">checksum file</a> that protects it from accidental edits:</p>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">migrations/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── lookup/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">│   ├── 20260415093012_init.sql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">│   └── atlas.sum</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">└── shop/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    ├── 20260415093004_init.sql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    └── atlas.sum</span><br></span></code></pre></div></div>
<p>The distribution settings are in the DDL: <code>orders</code> gets a hash-sharded primary key, and the colocated tables
get range-sharded primary keys (<code>ASC</code>), since a single shared tablet has nothing to hash across.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="publishing-the-migrations">Publishing the Migrations<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#publishing-the-migrations" class="hash-link" aria-label="Direct link to Publishing the Migrations" title="Direct link to Publishing the Migrations" translate="no">​</a></h3>
<p>Push both directories to the Atlas Registry. The first push updates the directory's latest version, which the
Operator reads when it migrates a database down, and the second tags this exact state:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate push shop </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> shop_local</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate push shop:v1 </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> shop_local</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate push lookup </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> lookup_local</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate push lookup:v1 </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> lookup_local</span><br></span></code></pre></div></div>
<p>From here on, CI lints each new migration in the pull request and, on merge, pushes both directories with the
commit SHA as their tag, as the <a class="" href="https://atlasgo.io/guides/ci-platforms/github-versioned">GitHub Actions guide for versioned migrations</a>
sets up.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="a-colocated-dev-database-in-the-cluster">A Colocated Dev Database in the Cluster<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#a-colocated-dev-database-in-the-cluster" class="hash-link" aria-label="Direct link to A Colocated Dev Database in the Cluster" title="Direct link to A Colocated Dev Database in the Cluster" translate="no">​</a></h3>
<p>The Operator uses a dev database, too. It applies migration files as written, so the dev database doesn't
change what a deployment runs. Migrating down is different: when a resource allows it with
<a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#migrate-down"><code>protectedFlows.migrateDown</code></a>, the Operator itself plans
the SQL that reverts each version, on the dev database. Like the local ones, that database must match its
target's colocation. On a dev database that isn't colocated, the plan that reverts the drop of a
<code>colocation = false</code> table recreates it as a colocated table.</p>
<p>For <code>ysql://</code> targets, the Operator starts YugabyteDB in a pod and uses its default <code>yugabyte</code> database, which
is not colocated. That matches <code>shop</code>, so its resource needs no dev database settings. <code>lookup</code> is colocated
and needs a dev database that is, so the team gives its resource its own dev pod with
<a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#devdb"><code>devDB.spec</code></a>.</p>
<p>The pod runs <code>yugabyted</code>, and its startup probe creates a colocated <code>dev</code> database once the server is up:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">devURL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ysql</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain">//yugabyte@localhost</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain">5433/dev</span><span class="token punctuation" style="color:rgb(199, 146, 234)">?</span><span class="token plain">sslmode=disable</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">devDB</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">containers</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> yugabyte</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">dev</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">image</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> yugabytedb/yugabyte</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain">latest</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">command</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"bin/yugabyted"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"start"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"--background=false"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">env</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> HOME</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">            </span><span class="token key atrule">value</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> /tmp</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">securityContext</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">runAsUser</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">ports</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">containerPort</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">5433</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">            </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ysql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">startupProbe</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">exec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">            </span><span class="token key atrule">command</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">              </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> sh</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">              </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">ec</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">              </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">|</span><span class="token scalar string" style="color:rgb(195, 232, 141)"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">                bin/ysqlsh -h "$(hostname)" -U yugabyte -tAc "SELECT 1 FROM pg_database WHERE datname = 'dev'" | grep -q 1 ||</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">                  bin/ysqlsh -h "$(hostname)" -U yugabyte -c "CREATE DATABASE dev WITH COLOCATION = true"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">failureThreshold</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">30</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">periodSeconds</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">10</span><br></span></code></pre></div></div>
<p>The Operator waits for the probe to pass before it uses the pod, so Atlas never sees it before <code>dev</code> exists.
The <code>localhost</code> host in <code>devURL</code> is a placeholder: the Operator replaces it with the pod's address. Like the
target URL, <code>devURL</code> names a database and no schema, so the two have the same scope.</p>
<p>The <code>yugabyted</code> image runs as root, as in the dev pod the Operator creates for YugabyteDB on its own. A
namespace that enforces the <code>restricted</code> Pod Security level rejects it, so run the <code>AtlasMigration</code> in a
namespace that allows it. Pin <code>image</code> to the version your cluster runs, so the dev database behaves like the
database the migrations are applied to.</p>
<p>By default, the Operator keeps each dev database running between deployments, so the next one starts faster. A
<code>yugabyted</code> pod is a full database node, so a team with many resources may prefer <code>prewarmDevDB: false</code> on the
resource or in the chart's values, which starts the dev database only when there are migrations to apply and
stops it afterward.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="deploying-the-migrations">Deploying the Migrations<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#deploying-the-migrations" class="hash-link" aria-label="Direct link to Deploying the Migrations" title="Direct link to Deploying the Migrations" translate="no">​</a></h3>
<p>An <code>AtlasMigration</code> resource ties each database to its migration directory. The one for <code>shop</code>:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">shop-migration.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasMigration</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> shop</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">urlFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> shop</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">db</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">cloud</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">tokenFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">token</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> token</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">dir</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">remote</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> shop</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">tag</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> v1</span><br></span></code></pre></div></div>
<p><code>lookup-migration.yaml</code> is the same, with the name <code>lookup</code>, the <code>lookup-db</code> Secret, the <code>lookup</code> directory,
and the <code>devURL</code> and <code>devDB</code> from above.</p>
<p>Apply the manifests and wait for the resources to become ready:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl apply </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-f</span><span class="token plain"> shop-migration.yaml </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-f</span><span class="token plain"> lookup-migration.yaml</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl </span><span class="token function" style="color:rgb(130, 170, 255)">wait</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--for</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">condition</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">Ready atlasmigration/shop atlasmigration/lookup </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--timeout</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">5m</span><br></span></code></pre></div></div>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl get atlasmigration</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">NAME     READY   REASON</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">lookup   True    Applied</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">shop     True    Applied</span><br></span></code></pre></div></div>
<p>The Operator ran each <code>init</code> migration as written, and created the revision history table,
<code>atlas_schema_revisions</code>, in a schema of the same name. The resource reports the version the database is on:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl get atlasmigration shop </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-o</span><span class="token plain"> </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">jsonpath</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">'{.status.lastAppliedVersion}{"\n"}'</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">20260415093004</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="adding-a-range-sharded-index">Adding a Range-Sharded Index<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#adding-a-range-sharded-index" class="hash-link" aria-label="Direct link to Adding a Range-Sharded Index" title="Direct link to Adding a Range-Sharded Index" translate="no">​</a></h2>
<p>Months later, <code>orders</code> holds millions of rows, and most reporting and support queries are bounded by time:
orders from last month, or orders in a given quarter. <code>month_created</code> holds the first day of the month an
order was placed in, so the team needs an index on it.</p>
<p>How that index is sharded decides how those queries perform. A hash-sharded index scatters adjacent values
across all of its tablets, so a <code>WHERE month_created BETWEEN ...</code> query reads every one of them. A
range-sharded index keeps values in sorted order, so the same query reads only the tablets that hold those
months.</p>
<p>An engineer adds the index to <code>shop.hcl</code> in a feature branch, as in the YugabyteDB blog post, and sets
<code>sharding = RANGE</code> on its column:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">shop.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// ...</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"orders_month_created_idx"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">column</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> column.month_created</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sharding</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> RANGE</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Then they generate the migration:</p>
<div class="language-sh codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sh codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> add_orders_month_created_idx </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> shop_local</span><br></span></code></pre></div></div>
<p>Atlas replays the migration directory on the dev database, compares the result with <code>shop.hcl</code>, and writes
only the difference:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- atlas:txmode none</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Create index "orders_month_created_idx" to table: "orders"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> CONCURRENTLY </span><span class="token string" style="color:rgb(195, 232, 141)">"orders_month_created_idx"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"public"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"month_created"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ASC</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>The <code>concurrent_index</code> policy in <code>shop_local</code> makes Atlas build the index online, and the
<a class="" href="https://atlasgo.io/versioned/apply#transaction-configuration"><code>atlas:txmode none</code></a> header runs the file outside a transaction,
which YugabyteDB requires for an online build.</p>
<p>From this file alone, a reviewer can confirm the index is range-sharded: <code>ASC</code> on the leading column, where a
hash-sharded index would have none. What the file leaves out matters as much: the distribution settings
already in the directory match <code>shop.hcl</code>, so Atlas doesn't strip or rewrite them.</p>
<p>The engineer commits the file with <code>shop.hcl</code>, and CI lints it and posts the results to the pull request.
Without the policy, Atlas would generate a plain <code>CREATE INDEX</code> that runs inside a transaction, and the lint
would flag it, since YugabyteDB builds an index that way without online backfill. A wrong sharding choice
caught in the pull request costs a comment. Caught in production, it means dropping and rebuilding an index
over millions of rows.</p>
<p>After the merge, CI pushes the directory tagged with the merge commit's SHA. A commit can't name its own SHA,
so moving the manifest to the new tag is a follow-up change, typically one CI commits to the repository the
cluster deploys from:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">shop-migration.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">dir</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">remote</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> shop</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">tag</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> 3f9c2b1e7d4a6058c1e2f3a4b5c6d7e8f9a0b1c2</span><br></span></code></pre></div></div>
<p>The Operator acts on changes to the resource, not on pushes to the registry, so updating the tag is the
deployment step. The database is on <code>init</code>, so the Operator applies the one pending file.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="rolling-out-to-every-cluster">Rolling Out to Every Cluster<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#rolling-out-to-every-cluster" class="hash-link" aria-label="Direct link to Rolling Out to Every Cluster" title="Direct link to Rolling Out to Every Cluster" translate="no">​</a></h2>
<p>Each production cluster gets its own pair of <code>AtlasMigration</code> resources, with their own URL Secrets, pointing
at the same tags. A cluster that is behind gets only the files it is missing, and a cluster that is already up
to date has nothing to apply. A team with a staging cluster moves its manifests to a new tag first, and
production follows once staging reports <code>Ready=True</code>.</p>
<p>To stop a deployment to a cluster whose schema was changed outside the migration directory, enable the
<a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#drift">drift check</a> on the resource:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">policy</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">drift</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Before it applies pending migrations, the Operator compares the database with the schema the Atlas Registry
holds for the version the database is on. If they differ, it applies nothing, and the resource reports
<code>Ready=False</code> with the reason <code>DriftDetected</code>. Once the database matches again, for example after the manual
change is reverted, the next retry applies the pending migrations. To record drift without blocking the
deployment, set <code>onError: CONTINUE</code>, and to ignore objects managed outside Atlas, list them under <code>exclude</code>.</p>
<p>Order the rollout so the schema lands before the code that needs it: the <code>AtlasMigration</code> first, then the
application once the resource reports <code>Ready=True</code>. With Argo CD, put them in separate sync waves. This order
is for additive changes, like a new index or column. A change that removes something goes the other way: first
deploy the code that no longer uses the column, then the migration that drops it.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>On YugabyteDB, colocation, pre-splitting, and hash or range sharding decide how a write-intensive workload
performs, and most of them can't be changed once a table holds data. With Atlas and its Kubernetes Operator:</p>
<ul>
<li class="">The schema, including its distribution layout, is code in the application repository.</li>
<li class="">Every change to the layout is a migration file in the pull request, next to the code it belongs to.</li>
<li class="">The Operator deploys a migration directory the way Kubernetes deploys an image: by tag, from the manifest.</li>
<li class="">Every cluster runs the same files, so every cluster gets the same distribution layout.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="get-started">Get Started<a href="https://atlasgo.io/blog/2026/11/016/yugabytedb-kubernetes-operator#get-started" class="hash-link" aria-label="Direct link to Get Started" title="Direct link to Get Started" translate="no">​</a></h2>
<p>The <a class="" href="https://atlasgo.io/integrations/kubernetes/versioned-quickstart">Atlas Operator quickstart guide for versioned workflows</a>
uses a local cluster and deploys a migration directory in a few minutes. The
<a class="" href="https://atlasgo.io/guides/yugabyte/distributed-schema-versioned">versioned YugabyteDB guide</a> walks through colocation,
pre-splitting, and index sharding, and
<a class="" href="https://atlasgo.io/guides/yugabyte/automatic-migrations">automatic migrations for YugabyteDB</a> shows how to bring an existing
database under Atlas. To lint and push migrations from CI, follow the
<a class="" href="https://atlasgo.io/guides/ci-platforms/github-versioned">GitHub Actions guide for versioned migrations</a>.</p>
<p>Running YugabyteDB on Kubernetes and want to see how Atlas fits your clusters?
<a href="https://calendly.com/ariga-sales/atlas-demo" target="_blank" rel="noopener noreferrer" data-cta-placement="yugabyte-blog">Schedule a demo</a>
with our team.</p>]]></content:encoded>
            <category>yugabytedb</category>
            <category>kubernetes</category>
            <category>k8s operator</category>
            <category>schema-management</category>
            <category>distributed-sql</category>
        </item>
        <item>
            <title><![CDATA[PostgreSQL 19: Security Changes and Preparing with Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/11/12/postgres-19</link>
            <guid>https://atlasgo.io/blog/2026/11/12/postgres-19</guid>
            <pubDate>Thu, 12 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[PostgreSQL 19 ships November 19 and PostgreSQL 14 is end of life. What changes for security, and how Atlas scans your servers and moves schemas to version 19.]]></description>
            <content:encoded><![CDATA[<p>PostgreSQL 19 is scheduled for general availability on November 19, 2026, one week after PostgreSQL 14
reaches end of life on November 12. From then on, servers on PostgreSQL 14 get no more security fixes.
Versions 15 through 18 are still supported, but version 19 will be supported the longest, into late 2031.</p>
<p>This post covers what version 19 changes for security and the schema objects that block an upgrade to it,
and how to use the week before GA to prepare with Atlas: scan your servers for their versions and CVEs,
keep upgrade blockers out with schema rules, and apply the same schema, roles, and grants to the new
instance from code.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="support-windows">Support Windows<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#support-windows" class="hash-link" aria-label="Direct link to Support Windows" title="Direct link to Support Windows" translate="no">​</a></h2>
<p>The PostgreSQL project supports each major version for five years. Once version 19 is released, the
windows are:</p>
<table><thead><tr><th>Version</th><th>Final release</th></tr></thead><tbody><tr><td>14</td><td>November 12, 2026</td></tr><tr><td>15</td><td>November 11, 2027</td></tr><tr><td>16</td><td>November 9, 2028</td></tr><tr><td>17</td><td>November 8, 2029</td></tr><tr><td>18</td><td>November 14, 2030</td></tr><tr><td>19</td><td>Late 2031</td></tr></tbody></table>
<p>A server on PostgreSQL 14 is the urgent case: CVEs published from now on will not be fixed for it, and
standards such as PCI DSS and SOC 2 expect software that receives security updates. Servers on versions
15 through 18 keep getting fixes, so for them, the case for upgrading to version 19 is the security
hardening below and a longer runway before the next forced upgrade.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-postgresql-19-changes-for-security">What PostgreSQL 19 Changes for Security<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#what-postgresql-19-changes-for-security" class="hash-link" aria-label="Direct link to What PostgreSQL 19 Changes for Security" title="Direct link to What PostgreSQL 19 Changes for Security" translate="no">​</a></h2>
<ul>
<li class="">RADIUS authentication is removed. PostgreSQL only supported RADIUS over UDP, which the release notes call
"unfixably insecure". Move <code>radius</code> entries in <code>pg_hba.conf</code> to another method before upgrading.</li>
<li class="">MD5 passwords, deprecated in PostgreSQL 18, now log a warning after each successful MD5 login. The
<code>md5_password_warnings</code> setting turns it off, but the fix is to move roles to SCRAM-SHA-256.</li>
<li class="">The new <code>password_expiration_warning_threshold</code> setting warns a user whose password is about to expire.
The default is seven days.</li>
<li class="">Server-side SNI lets one server present a different certificate per hostname, configured in the new
<code>pg_hosts.conf</code> file.</li>
<li class="">Database, role, and tablespace names can no longer contain carriage returns or line feeds, a change made to
avoid security problems.</li>
<li class="">OAuth, added in PostgreSQL 18, gains custom <code>pg_hba.conf</code> options for validators, error details on
failed logins, and the <code>oauth_ca_file</code> connection setting in libpq for a custom certificate authority.</li>
<li class=""><code>log_lock_waits</code> is on by default.</li>
</ul>
<p>Outside security, PostgreSQL 19 adds <code>REPACK</code>, which replaces <code>VACUUM FULL</code> and <code>CLUSTER</code> and can rebuild a
table without blocking reads and writes with <code>REPACK (CONCURRENTLY)</code>. Logical replication can be enabled
without a restart when <code>wal_level</code> is <code>replica</code>, and now replicates sequence values. The new <code>WAIT</code>
command gives read-your-writes consistency on standbys.
<code>ALTER TABLE ... ALTER CONSTRAINT ... [NOT] ENFORCED</code> now works on <code>CHECK</code> constraints, not only foreign keys.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="where-atlas-fits">Where Atlas Fits<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#where-atlas-fits" class="hash-link" aria-label="Direct link to Where Atlas Fits" title="Direct link to Where Atlas Fits" translate="no">​</a></h2>
<p>Atlas manages database schemas as code. You define your target schema in <a class="" href="https://atlasgo.io/atlas-schema/hcl">HCL</a>,
<a class="" href="https://atlasgo.io/atlas-schema/sql">SQL</a>, or <a class="" href="https://atlasgo.io/atlas-schema/external">your ORM</a>, and Atlas plans the migration from the
database's current state. It applies the change <a class="" href="https://atlasgo.io/declarative/apply">declaratively</a>, like Terraform, or
generates <a class="" href="https://atlasgo.io/versioned/intro">versioned migration files</a> for you to review and commit. One definition serves
every environment, from local development through staging and production, and every database you configure.</p>
<p>On PostgreSQL, that schema spans tables, views, functions, triggers, row-level security policies, and more
(see <a class="" href="https://atlasgo.io/features#database-features">supported features</a> for the full list). It also covers who can reach them:
with <a class="" href="https://atlasgo.io/guides/security-as-code">security as code</a>, roles, users, and grants live in the same files and go
through the same review as the tables they protect. With the whole schema in one place, the
<a class="" href="https://atlasgo.io/guides/postgres/lineage-graph">lineage graph</a> traces each column through the tables and views that depend
on it.</p>
<p>The same tooling checks changes before and after they ship.
<a class="" href="https://atlasgo.io/versioned/lint"><code>atlas migrate lint</code></a> reports destructive and table-locking changes in CI,
<a class="" href="https://atlasgo.io/testing/schema"><code>atlas schema test</code></a> and <a class="" href="https://atlasgo.io/testing/migrate"><code>atlas migrate test</code></a> run tests against the
schema and its migrations, <a class="" href="https://atlasgo.io/versioned/drift-detection">drift detection</a> catches changes made outside the
pipeline, and <a class="" href="https://atlasgo.io/guides/security-scan"><code>atlas security scan</code></a> checks the running server for CVEs.</p>
<p>For a PostgreSQL upgrade, this means the schema the new version has to receive is already written down, and
the steps below use it.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="check-your-servers-versions-and-cves">Check Your Servers' Versions and CVEs<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#check-your-servers-versions-and-cves" class="hash-link" aria-label="Direct link to Check Your Servers' Versions and CVEs" title="Direct link to Check Your Servers' Versions and CVEs" translate="no">​</a></h2>
<p>Checking one server takes a query:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> version</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Across staging, production, and every region, that is one query per database.
<a class="" href="https://atlasgo.io/guides/security-scan"><code>atlas security scan</code></a> checks them in one run. Pass <code>--url</code> once per database:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@staging.example.com:5432/app?sslmode=require"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@prod.example.com:5432/app?sslmode=require"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --fail-on HIGH</span><br></span></code></pre></div></div>
<p>The report lists every database with its server version, so a server still on PostgreSQL 14 stands out. For
each one, Atlas matches the server version and installed extensions against the CVEs in the
<a class="" href="https://atlasgo.io/cloud/features/security-graph">Atlas Security Graph</a>, and reports every CVE that affects it along with
the version that fixes it. Run it with a read-only user.</p>
<div class="theme-admonition theme-admonition-note admonition_IZjC alert alert--secondary"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_bl22"><p>The scan reports published CVEs, not support status. A server on the final PostgreSQL 14 release with no
open CVEs reports no issues, so compare the versions in the report against the support windows above.</p></div></div>
<p>The CVE check is what keeps the scan useful after the upgrade. New CVEs are published for supported
versions too, and a server is reported until it runs a release that carries the fix. To catch them as they
are published, <a class="" href="https://atlasgo.io/guides/security-scan#running-on-a-schedule">run the scan on a schedule</a> from CI or the
<a class="" href="https://atlasgo.io/integrations/kubernetes/security-scan">Kubernetes Operator</a>.</p>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span><a class="" href="https://atlasgo.io/features#pro">Atlas Pro Feature</a></div><div class="admonitionContent_bl22"><p><code>atlas security scan</code> is available to <a class="" href="https://atlasgo.io/features#pro">Atlas Pro</a> users with the Security Graph enabled in
their plan. Run <code>atlas login</code> to get started with a free trial.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="check-for-upgrade-blockers">Check for Upgrade Blockers<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#check-for-upgrade-blockers" class="hash-link" aria-label="Direct link to Check for Upgrade Blockers" title="Direct link to Check for Upgrade Blockers" translate="no">​</a></h2>
<p>Upgrading to PostgreSQL 19 from any earlier major version takes <code>pg_upgrade</code>, a dump and restore, or
logical replication. On a self-managed server, <code>pg_upgrade --check</code> reports every blocker without changing
the cluster. On a managed service, the provider runs its own pre-checks. Three changes in version 19 live in
the schema, and the queries below run on the version you have today, so they can be cleared before
version 19 ships.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="btree_gist-indexes-on-inet-and-cidr">btree_gist indexes on inet and cidr<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#btree_gist-indexes-on-inet-and-cidr" class="hash-link" aria-label="Direct link to btree_gist indexes on inet and cidr" title="Direct link to btree_gist indexes on inet and cidr" translate="no">​</a></h3>
<p>The <code>btree_gist</code> operator classes for <code>inet</code> and <code>cidr</code> can exclude rows that a query should return. In
PostgreSQL 19, the default GiST operator class for these types is the built-in <code>inet_ops</code>, and <code>pg_upgrade</code>
rejects a cluster that has a <code>btree_gist</code> index on them. These indexes are common in exclusion constraints
on IP ranges. To find them:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> n</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">nspname </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">schema</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">relname </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">index</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> opc</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">opcname </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> opclass</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">FROM</span><span class="token plain"> pg_index i</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">JOIN</span><span class="token plain"> pg_class c </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">oid </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> i</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">indexrelid</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">JOIN</span><span class="token plain"> pg_namespace n </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> n</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">oid </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">relnamespace</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">JOIN</span><span class="token plain"> pg_opclass opc </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> opc</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">oid </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ANY</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">i</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">indclass::oid</span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">WHERE</span><span class="token plain"> opc</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">opcname </span><span class="token operator" style="color:rgb(137, 221, 255)">IN</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">'gist_inet_ops'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'gist_cidr_ops'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Rebuild each one with <code>inet_ops</code> before upgrading. If Atlas manages the schema, set the operator class on the
index and let Atlas plan the rebuild:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.pg.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"sessions"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"client_ip"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> inet</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"sessions_client_ip_idx"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> GIST</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">column</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> column.client_ip</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">ops</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> inet_ops</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Rebuilding an index on a large table blocks writes while it runs. Set <code>concurrent_index</code> in the
<a class="" href="https://atlasgo.io/declarative/diff#diff-policy">diff policy</a> and Atlas creates and drops the index with <code>CONCURRENTLY</code>. In
versioned migrations, <a class="" href="https://atlasgo.io/lint/analyzers#PG101">PG101</a> reports an index created without it.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="names-with-line-breaks">Names with line breaks<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#names-with-line-breaks" class="hash-link" aria-label="Direct link to Names with line breaks" title="Direct link to Names with line breaks" translate="no">​</a></h3>
<p>Database, role, and tablespace names that contain a carriage return or a line feed block <code>pg_upgrade</code>. Rename
them first:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'role'</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> rolname </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> name </span><span class="token keyword" style="font-style:italic">FROM</span><span class="token plain"> pg_roles </span><span class="token keyword" style="font-style:italic">WHERE</span><span class="token plain"> rolname </span><span class="token operator" style="color:rgb(137, 221, 255)">~</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'[\r\n]'</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">UNION</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ALL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'database'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> datname </span><span class="token keyword" style="font-style:italic">FROM</span><span class="token plain"> pg_database </span><span class="token keyword" style="font-style:italic">WHERE</span><span class="token plain"> datname </span><span class="token operator" style="color:rgb(137, 221, 255)">~</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'[\r\n]'</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">UNION</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ALL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'tablespace'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> spcname </span><span class="token keyword" style="font-style:italic">FROM</span><span class="token plain"> pg_tablespace </span><span class="token keyword" style="font-style:italic">WHERE</span><span class="token plain"> spcname </span><span class="token operator" style="color:rgb(137, 221, 255)">~</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'[\r\n]'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Rename a role with <code>ALTER ROLE ... RENAME TO</code>, and update its name in the schema file. To keep new ones out,
add a <a class="" href="https://atlasgo.io/lint/rules">schema rule</a> that checks the names of roles and users:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.rule.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">predicate </span><span class="token string" style="color:rgb(195, 232, 141)">"role"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"no_line_breaks"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"^[^\r\n]+$"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">predicate </span><span class="token string" style="color:rgb(195, 232, 141)">"user"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"no_line_breaks"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"^[^\r\n]+$"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rule </span><span class="token string" style="color:rgb(195, 232, 141)">"schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"role-names"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">description</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Role names must not contain line breaks"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">role</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">assert</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">predicate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> predicate.role.no_line_breaks</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">message</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"role </span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation keyword" style="color:rgb(195, 232, 141);font-style:italic">self</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation type variable" style="color:rgb(191, 199, 213)">name</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)"> must not contain a carriage return or line feed"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rule </span><span class="token string" style="color:rgb(195, 232, 141)">"schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"user-names"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">description</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"User names must not contain line breaks"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">user</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">assert</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">predicate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> predicate.user.no_line_breaks</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">message</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"user </span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation keyword" style="color:rgb(195, 232, 141);font-style:italic">self</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation type variable" style="color:rgb(191, 199, 213)">name</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)"> must not contain a carriage return or line feed"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Include the file in the <code>lint</code> block of <code>atlas.hcl</code>, and <code>atlas schema lint</code> and <code>atlas migrate lint</code> report
any role or user that breaks it, so the name is caught in review instead of at the next upgrade:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  rule </span><span class="token string" style="color:rgb(195, 232, 141)">"hcl"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"custom-rules"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"schema.rule.hcl"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>The rule covers role and user names only. Atlas does not manage databases or tablespaces, so the query
above is the only check for their names.</p>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span><a class="" href="https://atlasgo.io/features#pro">Atlas Pro Feature</a></div><div class="admonitionContent_bl22"><p>Schema rules are available to <a class="" href="https://atlasgo.io/features#pro">Atlas Pro</a> users. Run <code>atlas login</code> to get started with a free
trial.</p></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="dumps-and-encodings">Dumps and encodings<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#dumps-and-encodings" class="hash-link" aria-label="Direct link to Dumps and encodings" title="Direct link to Dumps and encodings" translate="no">​</a></h3>
<p><code>standard_conforming_strings</code> is always on in PostgreSQL 19. A dump taken by a <code>pg_dump</code> older than version
19 with the setting off does not load correctly, so take dumps with the version 19 client tools. The
<code>MULE_INTERNAL</code> encoding is removed, and a database that uses it has to be dumped and restored with
another encoding.</p>
<p>When Atlas applies the schema from code, as shown in the next section, the schema does not go through
<code>pg_dump</code> at all. The new instance gets its tables, roles, and grants from the same files as every other
environment, and only the data needs a dump or replication.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="prepare-the-schema-move-with-atlas">Prepare the Schema Move with Atlas<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#prepare-the-schema-move-with-atlas" class="hash-link" aria-label="Direct link to Prepare the Schema Move with Atlas" title="Direct link to Prepare the Schema Move with Atlas" translate="no">​</a></h2>
<p>An in-place upgrade keeps the schema where it is. Many upgrades instead build a new instance on PostgreSQL
19, copy the data over, and switch traffic: a blue-green deployment, a logical replication cutover,
or a managed service that does not upgrade major versions in place. Databricks Lakebase, for example,
upgrades to a new major version only through a new project.</p>
<p>On those paths, the schema has to exist on the new instance before any data arrives. Logical replication
copies rows, not DDL, so every table must already be on the subscriber, and roles and grants are not
copied either. When the schema is defined as code, one config describes both instances:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"pg18"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"PG18_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">dev</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/18/dev"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.pg.hcl"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mode</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">roles</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">permissions</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"pg19"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"PG19_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">dev</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/19/dev"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.pg.hcl"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mode</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">roles</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">permissions</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p><code>PG18_URL</code> and <code>PG19_URL</code> hold each instance's connection URL, such as
<code>postgres://user:pass@host:5432/app?sslmode=require</code>. Leave out <code>search_path</code> so the URL covers every
schema in the database, the same scope as the dev databases.</p>
<p>The dev database runs the same major version as its target, so Atlas plans and validates each change
on the version it will run on. Until version 19 is released, point the <code>pg19</code> environment at a staging
server running RC 2, and set its <code>dev</code> to an empty database on an RC 2 server, to rehearse the move this
week and repeat it on the GA release. Apply the schema to the new instance:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema apply </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> pg19</span><br></span></code></pre></div></div>
<p>With <code>roles</code> and <code>permissions</code> on, Atlas creates the roles, memberships, and grants along with the tables,
indexes, functions, and row-level security policies. Declare roles that Atlas must leave alone, such as the
provider's admin roles, with <code>external = true</code>, as described in
<a class="" href="https://atlasgo.io/guides/postgres/security-declarative">Managing Roles and Permissions</a>. On a managed service, the dev
database also needs the provider's roles, created with a <code>baseline</code> script as shown in
<a class="" href="https://atlasgo.io/guides/postgres/security-declarative#dev-database-for-cloud-environments">Dev Database for Cloud Environments</a>.
If the schema sets user passwords, add <code>sensitive = ALLOW</code> to the <code>mode</code> block.</p>
<p>Before switching traffic, check that both instances match the code:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> pg18 </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--from</span><span class="token plain"> env://url </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> env://schema.src</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> pg19 </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--from</span><span class="token plain"> env://url </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> env://schema.src</span><br></span></code></pre></div></div>
<p>Each prints <code>Schemas are synced, no changes to be made.</code> when the instance matches. A schema change merged
while replication runs is applied to both environments from the same file, so the two stay in step until
cutover. Teams using versioned migrations run <code>atlas migrate apply</code> against the new instance instead, and can
run <code>atlas migrate validate</code> with a version 19 dev database, which executes every migration file on
PostgreSQL 19 before the upgrade.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql-inside-the-data-platforms">PostgreSQL Inside the Data Platforms<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#postgresql-inside-the-data-platforms" class="hash-link" aria-label="Direct link to PostgreSQL Inside the Data Platforms" title="Direct link to PostgreSQL Inside the Data Platforms" translate="no">​</a></h2>
<p>PostgreSQL is no longer only a standalone service. The data platforms now run it next to their analytical
engines:</p>
<ul>
<li class="">Snowflake Postgres became generally available on February 24, 2026, with PostgreSQL instances created and
managed from Snowflake and mirrored into Snowflake tables.</li>
<li class="">Databricks Lakebase is a managed PostgreSQL service in a Databricks workspace, supporting PostgreSQL 16,
17, and 18.</li>
<li class="">ClickHouse Managed Postgres became generally available on AWS on November 9, 2026, with change data
capture into ClickHouse.</li>
</ul>
<p>Each platform decides when it offers PostgreSQL 19, but every one of them exposes a standard PostgreSQL
endpoint, so the upgrade steps above apply. A team on one of these platforms now runs two schemas side
by side: the PostgreSQL schema that the application writes to, and the warehouse schema that the data
lands in. A change to one often needs a change to the other.</p>
<p>Atlas manages both from the same project. It connects to the PostgreSQL service with a <code>postgres://</code> URL, and
to <a class="" href="https://atlasgo.io/guides/snowflake/automatic-migrations">Snowflake</a>, <a class="" href="https://atlasgo.io/guides/databricks/automatic-migrations">Databricks</a>,
and <a class="" href="https://atlasgo.io/guides/clickhouse">ClickHouse</a> with their own drivers. Both sides get the same workflow: schema as code,
migration linting in CI, drift detection, and security scanning. For Lakebase specifics such as OAuth tokens
and its managed functions, see the <a class="" href="https://atlasgo.io/guides/postgres/databricks-lakebase">Lakebase guide</a>. For other managed
services, see <a class="" href="https://atlasgo.io/guides/sql-server-to-postgresql#managed-postgresql">Managed PostgreSQL</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/11/12/postgres-19#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>PostgreSQL 19 is a week away, and its security changes make it worth the move, especially for servers
left on PostgreSQL 14. An upgrade goes smoothly when it holds no surprises: you know which servers run
which version, the blockers are cleared before the cutover window, and the new instance gets exactly the
schema the old one had.</p>
<p>Atlas covers that ground. With the schema, roles, and grants defined as code, it scans your servers for
CVEs, catches problem changes in review, and applies the same schema to every instance and version you
run, whether that is a standalone PostgreSQL server or one inside Snowflake, Databricks, or ClickHouse.</p>
<p>To manage your PostgreSQL schemas with Atlas, follow the
<a class="" href="https://atlasgo.io/guides/postgres/automatic-migrations">PostgreSQL guide</a>, or <a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content:encoded>
            <category>postgres</category>
            <category>postgresql 19</category>
            <category>postgres upgrade</category>
            <category>database security</category>
            <category>security scan</category>
            <category>schema as code</category>
            <category>snowflake</category>
            <category>databricks</category>
            <category>clickhouse</category>
            <category>atlas</category>
        </item>
        <item>
            <title><![CDATA[ClickHouse CVEs: Find Vulnerable Servers with Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning</link>
            <guid>https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning</guid>
            <pubDate>Tue, 03 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[atlas security scan now reports the CVEs affecting your ClickHouse servers, including the critical CVE-2026-116366, from the CLI, GitHub Actions, or Kubernetes.]]></description>
            <content:encoded><![CDATA[<p>On October 30, 2026, ClickHouse published CVE-2026-116366, an unauthenticated remote code execution
vulnerability in ClickHouse Server. Under certain conditions, a user with network access to the server can
run arbitrary code on it without logging in. ClickHouse rates it Critical, with a CVSS v4.0 score of 9.5.</p>
<p>ClickHouse Cloud and BYOC deployments are already patched. Self-managed servers are not, and finding every
one of them across your environments is the hard part. Atlas can do that for you: <code>atlas security scan</code> now
checks the server version of each ClickHouse server against the Atlas Security Graph, and reports every
published CVE that affects it, this one included, along with the release that fixes it.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-we-know">What We Know<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#what-we-know" class="hash-link" aria-label="Direct link to What We Know" title="Direct link to What We Know" translate="no">​</a></h2>
<p>The public record is short on purpose. ClickHouse has not described the conditions under which the attack
works, and the record classifies the weakness as an integer overflow (CWE-190). The pull request with the
fix is scheduled to become public after November 13, 2026. Once it is public, anyone can read the diff and
work out how to trigger the bug, so plan to finish the upgrade before that date.</p>
<p>ClickHouse reports no evidence of exploitation in ClickHouse Cloud. The same releases also fix
CVE-2026-111497, a flaw in the bundled Brotli decoder that lets a crafted compressed request crash the
server, as listed on the ClickHouse Trust Center.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="fixed-versions">Fixed Versions<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#fixed-versions" class="hash-link" aria-label="Direct link to Fixed Versions" title="Direct link to Fixed Versions" translate="no">​</a></h3>
<p>ClickHouse does not publish a workaround. The fix is to upgrade to a patched release:</p>
<table><thead><tr><th>Release line</th><th>Fixed in</th></tr></thead><tbody><tr><td>26.3 LTS</td><td><code>26.3.62.3-lts</code></td></tr><tr><td>26.8 LTS</td><td><code>26.8.36.3-lts</code></td></tr><tr><td>26.9</td><td><code>26.9.27.3-stable</code></td></tr><tr><td>26.10</td><td><code>26.10.3.7-stable</code></td></tr></tbody></table>
<p>A server on one of these lines below its fixed version is vulnerable. Older lines receive no patch, so a
server running one of them has to move to a supported line. Patched builds are available from the official
ClickHouse packages and Docker images.</p>
<p>To check a single server, ask it:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> version</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>That works for one server. It does not tell you which of the clusters across your staging, production, and
regional environments still need the upgrade, and it will not tell you about the next CVE either.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="scanning-clickhouse-with-atlas">Scanning ClickHouse with Atlas<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#scanning-clickhouse-with-atlas" class="hash-link" aria-label="Direct link to Scanning ClickHouse with Atlas" title="Direct link to Scanning ClickHouse with Atlas" translate="no">​</a></h2>
<p><a class="" href="https://atlasgo.io/guides/security-scan"><code>atlas security scan</code></a> connects to running databases and resolves what it finds
against the <a class="" href="https://atlasgo.io/cloud/features/security-graph">Atlas Security Graph</a>. On ClickHouse, it matches the server
version against the CVEs published for the engine, so a server is reported with each CVE that affects it,
its severity, and the version to upgrade to, until it runs a release that carries the fix:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse://root:pass@127.0.0.1:19000/"</span><br></span></code></pre></div></div>
<div class="language-scanlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-scanlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Scanning 1 database for security issues:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token header-dash header">  --</span><span class="token plain"> clickhouse://root:xxxxx@127.0.0.1:19000/ (clickhouse 23.10.4.25):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token critical-dash critical">    --</span><span class="token plain"> Engine "clickhouse" version "23.10.4.25" is vulnerable to CVE-2023-48704 (HIGH):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       Unauthenticated heap buffer overflow in Gorrila codec decompression. Upgrade database</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       engine "clickhouse" to version 23.10.5.20 or later to resolve CVE-2023-48704</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token elevated-dash elevated">    --</span><span class="token plain"> Engine "clickhouse" version "23.10.4.25" is vulnerable to CVE-2024-22412 (ELEVATED):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       ClickHouse's Role-based Access Control is bypassed when query caching is enabled. Upgrade</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       database engine "clickhouse" to version 23.12.6.19 or later to resolve CVE-2024-22412</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token critical-dash critical">    --</span><span class="token plain"> Engine "clickhouse" version "23.10.4.25" is vulnerable to CVE-2026-116366 (CRITICAL):</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       Unauthenticated RCE vulnerability against ClickHouse Server. Upgrade database engine</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       "clickhouse" to version 26.3.62.3 or later to resolve CVE-2026-116366</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token divider">-------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token duration duration-dash">  --</span><span class="token duration"> 1.02642825s</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token count count-dash">  --</span><span class="token count"> 3 issues found: 1 </span><span class="token count critical">critical</span><span class="token count">, 1 </span><span class="token count critical">high</span><span class="token count">, 1 </span><span class="token count elevated">elevated</span><br></span></code></pre></div></div>
<p>This server runs 23.10, a line with no patch for CVE-2026-116366, so the suggested upgrade is the oldest
fixed release, 26.3.62.3. The same report lists two older CVEs the server never picked up a fix for, so one
upgrade resolves all three. Once it is done, the server's line in the report reads
<code>no issues found in the server version</code>.</p>
<p>Credentials are redacted from the report, so it is safe to keep in CI logs. The scan reads the live server,
so it needs neither a dev database nor a migration directory. Run it with a read-only database user. To
match CVEs, Atlas sends the Security Graph the engine and its version.</p>
<p>To make findings fail the command, set the lowest severity that should break it:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse://root:pass@127.0.0.1:19000/"</span><span class="token plain"> --fail-on HIGH</span><br></span></code></pre></div></div>
<p>Gate at the lowest severity you want to hear about. The scan grades on the level the Security Graph
assigns, and a record the CVSS rated below <code>HIGH</code> is graded <code>ELEVATED</code>. CVE-2024-22412 above is rated <code>LOW</code>,
so a scan gated at <code>HIGH</code> reports it without failing.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="one-scan-for-a-mixed-fleet">One scan for a mixed fleet<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#one-scan-for-a-mixed-fleet" class="hash-link" aria-label="Direct link to One scan for a mixed fleet" title="Direct link to One scan for a mixed fleet" translate="no">​</a></h3>
<p>The check is not limited to ClickHouse. It matches the server version on PostgreSQL, MySQL, MariaDB, and
SQL Server too, and on PostgreSQL it checks the installed extensions as well. Pass <code>--url</code> more than once
to scan several servers in one run:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse://root:pass@127.0.0.1:19000/"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@localhost:5432/app?sslmode=disable"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"mysql://root:pass@localhost:3306"</span><br></span></code></pre></div></div>
<p>A server that could not be reached is reported with the rest instead of ending the scan, and fails the
command, since its state is unknown. On an engine the check does not cover, such as SQLite, the scan
succeeds and reports no issues, so the line <code>no issues found in the server version</code> there does not mean
the version was checked. See <a class="" href="https://atlasgo.io/guides/security-scan#engines-and-extensions">Engines and extensions</a> for
what is checked on each engine.</p>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span><a class="" href="https://atlasgo.io/features#pro">Atlas Pro Feature</a></div><div class="admonitionContent_bl22"><p><code>atlas security scan</code> is available to <a class="" href="https://atlasgo.io/features#pro">Atlas Pro</a> users with the Security Graph enabled in
their plan. Run <code>atlas login</code> to get started with a free trial.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="getting-alerted-next-time">Getting Alerted Next Time<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#getting-alerted-next-time" class="hash-link" aria-label="Direct link to Getting Alerted Next Time" title="Direct link to Getting Alerted Next Time" translate="no">​</a></h2>
<p>CVE-2026-116366 won't be the last vulnerability found, and a scan you run once only tells you about the
CVEs published up to that point. To keep your servers protected, run the scan on a schedule.</p>
<p>With Atlas, you can schedule scans where your pipelines or clusters already live, checked against a
consistently updated list of CVEs. This gives you the peace of mind that if a CVE is released today, you'll
know about it, and which of your servers it affects.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="github-actions">GitHub Actions<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#github-actions" class="hash-link" aria-label="Direct link to GitHub Actions" title="Direct link to GitHub Actions" translate="no">​</a></h3>
<p>The <code>security/scan</code> action runs the scan in a workflow. This one scans staging and production every
morning and fails on a <code>HIGH</code> finding. Each finding of the server version is added as a warning annotation
that names the engine, and listed in the job summary:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">.github/workflows/security-scan.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Database Security Scan</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">on</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">schedule</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">cron</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'0 6 * * *'</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">workflow_dispatch</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">jobs</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">scan</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">runs-on</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ubuntu</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">latest</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">environment</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> monitoring</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">steps</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ariga/setup</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">atlas@v0</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">with</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">cloud-token</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> secrets.ATLAS_CLOUD_TOKEN </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ariga/atlas</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">action/security/scan@v1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">with</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">urls</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">|</span><span class="token scalar string" style="color:rgb(195, 232, 141)"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">            ${{ secrets.STAGING_CLICKHOUSE_URL }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">            ${{ secrets.PROD_CLICKHOUSE_URL }}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">          </span><span class="token key atrule">fail-on</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> HIGH</span><br></span></code></pre></div></div>
<p>Keep the database URLs in an environment that only the default branch can use, so a pull request cannot
run with them.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="kubernetes-operator">Kubernetes Operator<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#kubernetes-operator" class="hash-link" aria-label="Direct link to Kubernetes Operator" title="Direct link to Kubernetes Operator" translate="no">​</a></h3>
<p>On a cluster running the <a class="" href="https://atlasgo.io/integrations/kubernetes">Atlas Kubernetes Operator</a>, the <code>AtlasSecurityScan</code>
resource scans on a schedule and grades the findings against a policy. Store the database URL and an
Atlas bot token in Secrets:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl create secret generic clickhouse-db </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --from-literal</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">url</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">'clickhouse://root:pass@clickhouse.app:9000'</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl create secret generic atlas-token --from-literal</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">ATLAS_TOKEN</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">"</span><span class="token string variable" style="color:rgb(191, 199, 213)">$ATLAS_TOKEN</span><span class="token string" style="color:rgb(195, 232, 141)">"</span><br></span></code></pre></div></div>
<p>Then create a scan that runs every morning and fails the policy on a <code>HIGH</code> finding:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">security-scan.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasSecurityScan</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> clickhouse</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">urlFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> clickhouse</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">db</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">cloud</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">tokenFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">token</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ATLAS_TOKEN</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">schedule</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"0 6 * * *"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">timeZone</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> UTC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">policy</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">minSeverity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ELEVATED</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">failOn</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> HIGH</span><br></span></code></pre></div></div>
<p>The first scan runs as soon as the resource is created. The verdict is exposed as Kubernetes conditions:
<code>Ready</code> says whether the scan ran, and <code>Compliant</code> whether the server is within the policy, so
<code>kubectl wait --for=condition=Compliant</code> works as a deployment gate.</p>
<p>The status of the scan holds only the number of findings and their levels. The server version and the CVE
identifiers are stored in an <code>AtlasSecurityReport</code>, which has its own RBAC role, so read access to the scan
does not reveal which CVEs a server is exposed to:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl get atlassecurityreport clickhouse </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-o</span><span class="token plain"> yaml</span><br></span></code></pre></div></div>
<p>For the server above, the report lists all three CVEs as findings of the engine. The last one reads:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">cvssSeverity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> CRITICAL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">description</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> An issue has been discovered in ClickHouse Server that</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> under certain</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      conditions</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> could allow an unauthenticated user with network access to execute</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      arbitrary code on the ClickHouse Server.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">engine</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> clickhouse</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">extension</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">""</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> CVE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">2026</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token number" style="color:rgb(247, 140, 108)">116366</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">level</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> CRITICAL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">suggestion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Upgrade database engine "clickhouse" to version 26.3.62.3 or later</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      to resolve CVE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">2026</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token number" style="color:rgb(247, 140, 108)">116366</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">title</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Unauthenticated RCE vulnerability against ClickHouse Server</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">version</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> 23.10.4.25</span><br></span></code></pre></div></div>
<p>Add <code>triggers</code> to scan again whenever an <code>AtlasSchema</code> or <code>AtlasMigration</code> applies a change. See
<a class="" href="https://atlasgo.io/integrations/kubernetes/security-scan">Security Scanning with the Operator</a> for waivers, triggers, and
failure handling.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="slack-notifications">Slack notifications<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#slack-notifications" class="hash-link" aria-label="Direct link to Slack notifications" title="Direct link to Slack notifications" translate="no">​</a></h3>
<p>A <code>notify</code> block in <code>atlas.hcl</code> posts the result to a webhook whenever the scan finds something or cannot
reach a server, and sends nothing when it is clean:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">variable</span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)"> "slack_webhook" </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> string</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"CLICKHOUSE_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">security</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">fail_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> HIGH</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">notify</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">FINDINGS, FAILURE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      http </span><span class="token string" style="color:rgb(195, 232, 141)">"slack"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token property">url</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> var.slack_webhook</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token property">headers</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">"Content-Type"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"application/json"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token property">body</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> jsonencode(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">text</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> scan.report </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>The notification is sent before the command picks its exit code, so a scan that fails on <code>fail_on</code> still
posts to Slack. See <a class="" href="https://atlasgo.io/guides/security-scan#notifications">Notifications</a> for the fields available to the
message.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>New CVEs don't wait for your next audit. With one command, <code>atlas security scan</code> reads the server version
of every ClickHouse server you point it at, matches it against the Atlas Security Graph, and names the
release that fixes each CVE it finds. Run it today to find the servers that need the CVE-2026-116366
upgrade before the fix goes public on November 13. Then put it on a schedule with GitHub Actions or the
Atlas Kubernetes Operator, and the next CVE published for your version shows up as a failed check or a
Slack message, not as a surprise.</p>
<p>The scan is part of Atlas Pro. Log in to start your free trial, and scan your first server:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas login</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas security scan </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"clickhouse://root:pass@127.0.0.1:19000/"</span><br></span></code></pre></div></div>
<p>To begin managing your ClickHouse databases with Atlas, follow the <a class="" href="https://atlasgo.io/guides/clickhouse">ClickHouse guide</a>,
or <a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a> to see how scanning and the
<a class="" href="https://atlasgo.io/cloud/features/security-graph">Security Graph</a> fit your ClickHouse fleet.</p>
<div class="docs-layout atlas-body"><div class="grid grid-cols-1 lg:grid-cols-2 auto-cols-fr auto-rows-fr gap-2 mb-12 mt-6"><a class="group flex flex-col items-center hover:no-underline rounded-lg border-lightGrey border hover:shadow-md dark:bg-transparent dark:hover:bg-white transition-all p-0" href="https://atlasgo.io/guides/security-scan"><div class="flex w-full flex-col p-4"><h3 class="!mb-2 flex items-center text-base font-bold text-black dark:text-white dark:group-hover:text-black"><img class="mr-2 brightness-0 dark:brightness-0 dark:invert group-hover:dark:invert-0" src="https://atlasgo.io/icons-docs/shield-check.svg" alt="">Security Scanning</h3><p class="mb-0 text-black dark:text-white dark:group-hover:text-black">Run atlas security scan from the CLI, gate a build on a severity, and configure the security block.</p></div></a><a class="group flex flex-col items-center hover:no-underline rounded-lg border-lightGrey border hover:shadow-md dark:bg-transparent dark:hover:bg-white transition-all p-0" href="https://atlasgo.io/integrations/kubernetes/security-scan"><div class="flex w-full flex-col p-4"><h3 class="!mb-2 flex items-center text-base font-bold text-black dark:text-white dark:group-hover:text-black"><img class="mr-2 brightness-0 dark:brightness-0 dark:invert group-hover:dark:invert-0" src="https://atlasgo.io/icons-docs/kubernetes-icon.svg" alt="">Security Scanning with the Operator</h3><p class="mb-0 text-black dark:text-white dark:group-hover:text-black">Scan databases from Kubernetes on a schedule and after a schema change, with findings graded against a policy.</p></div></a></div></div>]]></content:encoded>
            <category>clickhouse</category>
            <category>cve</category>
            <category>security</category>
            <category>security scan</category>
            <category>database security</category>
            <category>kubernetes</category>
            <category>github actions</category>
            <category>atlas pro</category>
        </item>
        <item>
            <title><![CDATA[Medallion Architecture on Snowflake with Atlas and dbt]]></title>
            <link>https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt</link>
            <guid>https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt</guid>
            <pubDate>Thu, 08 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[dbt owns silver and gold in a Snowflake medallion stack. Atlas manages the layer under them as code: schemas, the bronze landing zone, roles and grants.]]></description>
            <content:encoded><![CDATA[<p>In a Snowflake medallion architecture, raw data lands in Bronze, which dbt cleans into Silver and shapes
into Gold. dbt owns the two upper layers completely. Every <code>dbt run</code> recreates the tables and views its
models define, from code that is versioned, reviewed, and tested.</p>
<p>The bronze layer those models stand on has no such owner. This post is about that layer, and giving Bronze
a proper owner without disrupting your dbt project.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-layer-nobody-owns">The Layer Nobody Owns<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#the-layer-nobody-owns" class="hash-link" aria-label="Direct link to The Layer Nobody Owns" title="Direct link to The Layer Nobody Owns" translate="no">​</a></h2>
<p>What would happen if your Snowflake account disappeared tomorrow?</p>
<p>Silver and Gold could be rebuilt entirely from your dbt project, with version-controlled models, tests,
and a DAG.</p>
<p>Bronze is not so simple. The raw data arrives from ingestion, but the landing tables, file formats,
and schema beneath it were built by hand.</p>
<p>The layer beneath all three does not answer at all. Your schemas, role hierarchies, and access grants
exist because someone opened a worksheet a year ago and ran a few <code>CREATE</code> and <code>GRANT</code> statements.
There is no history, no code review, no diff, and no alarm when one of them changes.</p>
<p>That is the gap Atlas fills. Atlas brings schema-as-code to Snowflake: you declare the desired state of
the database in HCL or SQL, and it plans the changes, lints them, applies them, and checks afterwards that
nothing has drifted. dbt keeps Silver and Gold; Atlas brings the underlying infrastructure to the same
standard.</p>
<table><thead><tr><th>Layer</th><th>What it holds</th><th>Owner</th><th>How it's managed</th></tr></thead><tbody><tr><td>Platform</td><td>Schemas, roles, grants</td><td>Atlas</td><td>Roles and grants declaratively, schemas through planned migrations</td></tr><tr><td>Bronze</td><td>Landing tables, file formats</td><td>Atlas</td><td>Versioned migrations, with lint in review</td></tr><tr><td>Silver</td><td>Cleaned models</td><td>dbt</td><td>dbt materializations, which Atlas is configured to ignore</td></tr><tr><td>Gold</td><td>Business-ready models</td><td>dbt</td><td>The same</td></tr><tr><td>Cross-cutting</td><td>Migration history, linting, drift detection</td><td>Atlas</td><td>Runs across the layer both tools sit on</td></tr></tbody></table>
<p><img decoding="async" loading="lazy" alt="Bronze, silver and gold sit on a platform layer of schemas, roles and grants that Atlas manages as code. Atlas also owns bronze; dbt builds silver from bronze and gold from silver." src="data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIwIDAgOTYwIDM0MCIgd2lkdGg9Ijk2MCIgaGVpZ2h0PSIzNDAiIHJvbGU9ImltZyIgYXJpYS1sYWJlbGxlZGJ5PSJ0aXRsZSBkZXNjIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZvbnQtZmFtaWx5PSJIZWx2ZXRpY2EsIEFyaWFsLCBzYW5zLXNlcmlmIj4KICA8dGl0bGUgaWQ9InRpdGxlIj5NZWRhbGxpb24gbGF5ZXJzIG9uIFNub3dmbGFrZTogd2hvIG93bnMgd2hhdDwvdGl0bGU+CiAgPGRlc2MgaWQ9ImRlc2MiPkJyb256ZSwgc2lsdmVyIGFuZCBnb2xkIHNpdCBvbiBhIHBsYXRmb3JtIGxheWVyIG9mIHNjaGVtYXMsIHJvbGVzIGFuZCBncmFudHMgdGhhdCBBdGxhcyBtYW5hZ2VzIGFzIGNvZGUuIEF0bGFzIGFsc28gb3ducyBicm9uemU7IGRidCBydW4gYnVpbGRzIHNpbHZlciBmcm9tIGJyb256ZSBhbmQgZ29sZCBmcm9tIHNpbHZlci48L2Rlc2M+CiAgPGRlZnM+CiAgICA8bWFya2VyIGlkPSJhcnJvdyIgdmlld0JveD0iMCAwIDEwIDEwIiByZWZYPSI5IiByZWZZPSI1IiBtYXJrZXJXaWR0aD0iNyIgbWFya2VySGVpZ2h0PSI3IiBvcmllbnQ9ImF1dG8tc3RhcnQtcmV2ZXJzZSI+CiAgICAgIDxwYXRoIGQ9Ik0wIDAgTDEwIDUgTDAgMTAgeiIgZmlsbD0iIzBEMEUxNiIvPgogICAgPC9tYXJrZXI+CiAgPC9kZWZzPgogIDxyZWN0IHg9IjAiIHk9IjAiIHdpZHRoPSI5NjAiIGhlaWdodD0iMzQwIiBmaWxsPSIjRkZGRkZGIi8+CgogIDwhLS0gT3duZXJzLCBhcyBicmFjZXMgb3ZlciB0aGUgbGF5ZXJzIHRoZXkgb3duIC0tPgogIDxnIGZpbGw9Im5vbmUiIHN0cm9rZS13aWR0aD0iMS41Ij4KICAgIDxwYXRoIHN0cm9rZT0iIzZGQjNDNSIgZD0iTTYwIDY0IFE2MCA1MiA3MiA1MiBIMTY4IFExODAgNTIgMTgwIDQwIFExODAgNTIgMTkyIDUyIEgyODggUTMwMCA1MiAzMDAgNjQiLz4KICAgIDxwYXRoIHN0cm9rZT0iI0UyQTA2QSIgZD0iTTM2MCA2NCBRMzYwIDUyIDM3MiA1MiBINjE4IFE2MzAgNTIgNjMwIDQwIFE2MzAgNTIgNjQyIDUyIEg4ODggUTkwMCA1MiA5MDAgNjQiLz4KICA8L2c+CiAgPGcgZm9udC1zaXplPSIxNiIgZmlsbD0iIzBEMEUxNiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+CiAgICA8dGV4dCB4PSIxODAiIHk9IjMwIj5BdGxhczwvdGV4dD4KICAgIDx0ZXh0IHg9IjYzMCIgeT0iMzAiPmRidDwvdGV4dD4KICA8L2c+CgogIDwhLS0gTGF5ZXJzIC0tPgogIDxyZWN0IHg9IjYwIiB5PSI4MCIgd2lkdGg9IjI0MCIgaGVpZ2h0PSI5MCIgcng9IjEwIiBmaWxsPSIjRTFGMkY2IiBzdHJva2U9IiMwRDBFMTYiIHN0cm9rZS13aWR0aD0iMS41Ii8+CiAgPGcgZmlsbD0iI0ZGRTlEOSIgc3Ryb2tlPSIjMEQwRTE2IiBzdHJva2Utd2lkdGg9IjEuNSI+CiAgICA8cmVjdCB4PSIzNjAiIHk9IjgwIiB3aWR0aD0iMjQwIiBoZWlnaHQ9IjkwIiByeD0iMTAiLz4KICAgIDxyZWN0IHg9IjY2MCIgeT0iODAiIHdpZHRoPSIyNDAiIGhlaWdodD0iOTAiIHJ4PSIxMCIvPgogIDwvZz4KICA8ZyB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSIjMEQwRTE2Ij4KICAgIDx0ZXh0IHg9IjE4MCIgeT0iMTE3IiBmb250LXNpemU9IjE4IiBmb250LXdlaWdodD0iNjAwIj5Ccm9uemU8L3RleHQ+CiAgICA8dGV4dCB4PSIxODAiIHk9IjE0MyIgZm9udC1zaXplPSIxNCIgZmlsbD0iIzNENDI1MCI+bGFuZGluZyB0YWJsZXMsIGZpbGUgZm9ybWF0czwvdGV4dD4KICAgIDx0ZXh0IHg9IjQ4MCIgeT0iMTE3IiBmb250LXNpemU9IjE4IiBmb250LXdlaWdodD0iNjAwIj5TaWx2ZXI8L3RleHQ+CiAgICA8dGV4dCB4PSI0ODAiIHk9IjE0MyIgZm9udC1zaXplPSIxNCIgZmlsbD0iIzNENDI1MCI+Y2xlYW5lZCBtb2RlbHM8L3RleHQ+CiAgICA8dGV4dCB4PSI3ODAiIHk9IjExNyIgZm9udC1zaXplPSIxOCIgZm9udC13ZWlnaHQ9IjYwMCI+R29sZDwvdGV4dD4KICAgIDx0ZXh0IHg9Ijc4MCIgeT0iMTQzIiBmb250LXNpemU9IjE0IiBmaWxsPSIjM0Q0MjUwIj5idXNpbmVzcy1yZWFkeSBtb2RlbHM8L3RleHQ+CiAgPC9nPgoKICA8IS0tIGRidCBydW4gLS0+CiAgPGcgc3Ryb2tlPSIjMEQwRTE2IiBzdHJva2Utd2lkdGg9IjEuNSIgZmlsbD0ibm9uZSI+CiAgICA8cGF0aCBkPSJNMzAwIDEyNSBIMzU2IiBtYXJrZXItZW5kPSJ1cmwoI2Fycm93KSIvPgogICAgPHBhdGggZD0iTTYwMCAxMjUgSDY1NiIgbWFya2VyLWVuZD0idXJsKCNhcnJvdykiLz4KICA8L2c+CiAgPGcgZm9udC1zaXplPSIxMyIgZmlsbD0iIzBEMEUxNiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+CiAgICA8dGV4dCB4PSIzMjkiIHk9IjExNCI+ZGJ0IHJ1bjwvdGV4dD4KICAgIDx0ZXh0IHg9IjYyOSIgeT0iMTE0Ij5kYnQgcnVuPC90ZXh0PgogIDwvZz4KCiAgPCEtLSBFYWNoIHNjaGVtYSBhbmQgaXRzIGdyYW50cyBjb21lIGZyb20gdGhlIHBsYXRmb3JtIC0tPgogIDxnIHN0cm9rZT0iIzZGQjNDNSIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1kYXNoYXJyYXk9IjUgNCIgZmlsbD0ibm9uZSI+CiAgICA8cGF0aCBkPSJNMTgwIDIzMCBWMTcyIi8+CiAgICA8cGF0aCBkPSJNNDgwIDIzMCBWMTcyIi8+CiAgICA8cGF0aCBkPSJNNzgwIDIzMCBWMTcyIi8+CiAgPC9nPgogIDx0ZXh0IHg9IjQ5MCIgeT0iMjA1IiBmb250LXNpemU9IjEyIiBmaWxsPSIjM0Q0MjUwIj5zY2hlbWEgKyBncmFudHM8L3RleHQ+CgogIDwhLS0gUGxhdGZvcm0gLS0+CiAgPHJlY3QgeD0iNjAiIHk9IjIzMCIgd2lkdGg9Ijg0MCIgaGVpZ2h0PSI4MCIgcng9IjEwIiBmaWxsPSIjQTREOEU0IiBzdHJva2U9IiMwRDBFMTYiIHN0cm9rZS13aWR0aD0iMS41Ii8+CiAgPGcgdGV4dC1hbmNob3I9Im1pZGRsZSIgZmlsbD0iIzBEMEUxNiI+CiAgICA8dGV4dCB4PSI0ODAiIHk9IjI2NCIgZm9udC1zaXplPSIxOCIgZm9udC13ZWlnaHQ9IjYwMCI+UGxhdGZvcm06IHNjaGVtYXMsIHJvbGVzIGFuZCBncmFudHM8L3RleHQ+CiAgICA8dGV4dCB4PSI0ODAiIHk9IjI5MCIgZm9udC1zaXplPSIxNCIgZmlsbD0iIzNENDI1MCI+bWFuYWdlZCBieSBBdGxhcyBhcyBjb2RlLCB3aXRoIG1pZ3JhdGlvbiBoaXN0b3J5LCBsaW50IGFuZCBkcmlmdCBkZXRlY3Rpb248L3RleHQ+CiAgPC9nPgo8L3N2Zz4K" width="960" height="340" class="img__Ss2"></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="lets-see-it-in-practice">Let's See It in Practice<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#lets-see-it-in-practice" class="hash-link" aria-label="Direct link to Let's See It in Practice" title="Direct link to Let's See It in Practice" translate="no">​</a></h2>
<p>Everything below runs against a Snowflake Standard-edition account, and is written up step by step in
<a class="" href="https://atlasgo.io/guides/dbt/snowflake">Snowflake and dbt: Managing the Schema Layer</a>. It uses the versioned workflow
with <a class="" href="https://atlasgo.io/atlas-schema/hcl">HCL</a> as the schema format. The same layer can also be described in
<a class="" href="https://atlasgo.io/atlas-schema/sql">SQL</a> or applied with the declarative workflow.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="a-bronze-table-is-a-migration">A Bronze Table is a Migration<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#a-bronze-table-is-a-migration" class="hash-link" aria-label="Direct link to A Bronze Table is a Migration" title="Direct link to A Bronze Table is a Migration" translate="no">​</a></h3>
<p>The landing table and the file format that describes incoming files are declared in one file. The
file format, for instance:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.layer.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">file_format </span><span class="token string" style="color:rgb(195, 232, 141)">"CSV_FORMAT"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.BRONZE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> CSV</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">options</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">FIELD_DELIMITER</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">","</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">SKIP_HEADER</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>From that file, Atlas plans the DDL for the file format and the landing table together:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> bronze_landing </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod</span><br></span></code></pre></div></div>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20261008032251_bronze_landing.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Create file format "CSV_FORMAT"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">FILE</span><span class="token plain"> FORMAT </span><span class="token string" style="color:rgb(195, 232, 141)">"BRONZE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"CSV_FORMAT"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TYPE</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> CSV SKIP_HEADER </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"> ESCAPE_UNENCLOSED_FIELD </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'\\'</span><span class="token plain"> NULL_IF </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">'\\N'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Create "EVENTS" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"BRONZE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"EVENTS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token string" style="color:rgb(195, 232, 141)">"EVENT_ID"</span><span class="token plain"> NUMBER </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token string" style="color:rgb(195, 232, 141)">"USER_ID"</span><span class="token plain"> NUMBER </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token string" style="color:rgb(195, 232, 141)">"EVENT_TYPE"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">VARCHAR</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">64</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token string" style="color:rgb(195, 232, 141)">"OCCURRED_AT"</span><span class="token plain"> TIMESTAMP_NTZ </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> DATA_RETENTION_TIME_IN_DAYS </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>That file goes through review and <code>atlas migrate lint</code> like any other change. Lint reports
<a class="" href="https://atlasgo.io/lint/analyzers#TX101">TX101</a> for it: the two statements cannot run in a single transaction, so a
failure between them would leave the database between versions.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="dbt-maintains-its-models">dbt Maintains its Models<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#dbt-maintains-its-models" class="hash-link" aria-label="Direct link to dbt Maintains its Models" title="Direct link to dbt Maintains its Models" translate="no">​</a></h3>
<p>Two <code>exclude</code> patterns in <code>atlas.hcl</code> draw the line between the tools:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">locals</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">exclude</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"SILVER.*"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"GOLD.*"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>When <code>dbt run</code> builds the <code>SILVER.STG_EVENTS</code> table and the <code>GOLD.DAILY_ACTIVE_USERS</code> view, Atlas does
not see them, and comparing the account against the schema files finds nothing within its scope to
change:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--from</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"env://url"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"env://schema.src"</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Schemas are synced, no changes to be made.</span><br></span></code></pre></div></div>
<p>The schemas stay under Atlas because it creates them and holds their grants. What dbt builds inside them
is dbt's, and neither tool plans changes to the other's objects.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="manual-changes-to-bronze">Manual Changes to Bronze<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#manual-changes-to-bronze" class="hash-link" aria-label="Direct link to Manual Changes to Bronze" title="Direct link to Manual Changes to Bronze" translate="no">​</a></h3>
<p>Let's say someone adds a column directly in the account:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> ANALYTICS</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">BRONZE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">EVENTS </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> SOURCE_SYSTEM </span><span class="token keyword" style="font-style:italic">VARCHAR</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">32</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>The same command that stayed quiet about dbt's models reports this one:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> prod </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--from</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"env://url"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"env://schema.src"</span><br></span></code></pre></div></div>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Modify "EVENTS" table to drop "SOURCE_SYSTEM" column</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"BRONZE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string" style="color:rgb(195, 232, 141)">"EVENTS"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SOURCE_SYSTEM"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="two-environments-for-snowflake-objects">Two Environments for Snowflake Objects<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#two-environments-for-snowflake-objects" class="hash-link" aria-label="Direct link to Two Environments for Snowflake Objects" title="Direct link to Two Environments for Snowflake Objects" translate="no">​</a></h2>
<p>Snowflake nests most of what you create: an account holds databases, a database holds schemas, and a
schema holds the tables and file formats above. Roles, warehouses, and users sit outside that
nesting, on the account itself.</p>
<p>The difference shows up at planning time. Atlas plans by materializing the desired state in a dev
database. In this setup, the dev database lives in the same account as the target. Anything inside a
database gets a clean dev copy to plan against. An account-level object does not, because there is only
one in the account.</p>
<p>Therefore, the project splits in two. Schemas and Bronze objects stay versioned for reviewed migration
files and lint in CI, while roles and grants go declarative, where the file is the access model and Atlas
diffs it against the account whenever you ask.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="drift-as-a-deployment-gate">Drift as a Deployment Gate<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#drift-as-a-deployment-gate" class="hash-link" aria-label="Direct link to Drift as a Deployment Gate" title="Direct link to Drift as a Deployment Gate" translate="no">​</a></h2>
<p><code>atlas schema diff</code> is the ad-hoc check. For deployment, use <a class="" href="https://atlasgo.io/versioned/drift-detection">pre-apply drift detection</a>:
a <code>check "migrate_apply"</code> block in <code>atlas.hcl</code> that runs at the start of every <code>atlas migrate apply</code>,
compares the target against the expected state for the latest applied revision, and aborts before
any migration file runs when they differ. The expected state comes from the
<a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a>, so the migration directory is pushed there with
<code>atlas migrate push</code> in CI. Start with <code>on_error = CONTINUE</code> to see existing drift without failing a
release, then switch to <code>FAIL</code>. This post's example stops short of the gate; the
<a class="" href="https://atlasgo.io/guides/dbt/drift-detection">warehouse drift guide</a> covers its configuration, its registry
prerequisite, and its own <code>exclude</code> list.</p>
<p>Between deployments, <a class="" href="https://atlasgo.io/monitoring/drift-detection">schema monitoring</a> runs the comparison on a
schedule. The
<a class="" href="https://atlasgo.io/integrations/github-actions#arigaatlas-actionmonitorschema"><code>ariga/atlas-action/monitor/schema</code></a>
GitHub Action syncs the schema on a cron with the same <code>exclude</code> patterns, so dbt's schemas stay out
of it. Without Atlas Cloud, <code>atlas schema diff</code> runs from any scheduler; it exits 0 whether or not it
finds drift, so the job itself has to decide what to do with the output.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="where-atlas-stops">Where Atlas Stops<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#where-atlas-stops" class="hash-link" aria-label="Direct link to Where Atlas Stops" title="Direct link to Where Atlas Stops" translate="no">​</a></h2>
<p>Atlas and dbt draw a sharp line between platform and transformation.</p>
<p>Atlas manages the database structure, leaving table materializations, ref() lineages, and model execution
entirely to dbt. It doesn't read dbt's manifest or trigger dbt build; your orchestrator still controls
the DAG, and dbt still runs your transformations. Even testing remains cleanly divided. dbt tests validate
the data inside your models, while Atlas tests validate the schema objects and migration safety underneath them.</p>
<p>The two tools don't overlap because they don't fight for ownership. dbt owns transformation logic; Atlas
owns the platform it runs on.</p>
<div class="theme-admonition theme-admonition-note admonition_IZjC alert alert--secondary"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span><a class="" href="https://atlasgo.io/features#pro">Atlas Pro Feature</a></div><div class="admonitionContent_bl22"><p>Snowflake support, including roles and permissions, is available to Pro users and during a trial. The
driver ships in the extended build, so install it with <code>ATLAS_FLAVOR=snowflake</code> and run <code>atlas login</code>.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p><a class="" href="https://atlasgo.io/guides/dbt/snowflake">Snowflake and dbt: Managing the Schema Layer</a> provides the full walkthrough:
migrations and their output, roles and grants, the two environments Snowflake's object model calls
for, the drift check, and what the example account could not exercise.</p>
<p>If you are choosing a Snowflake schema tool rather than integrating one with dbt,
<a class="" href="https://atlasgo.io/blog/2025/08/25/snowflake-cicd-atlas-vs-schemachange-snowddl">Atlas vs schemachange vs SnowDDL</a>
compares the options.</p>]]></content:encoded>
            <category>snowflake</category>
            <category>dbt</category>
            <category>medallion</category>
            <category>data engineering</category>
            <category>schema as code</category>
            <category>grants</category>
        </item>
        <item>
            <title><![CDATA[Atlas Kubernetes Operator v0.8: Drift Detection, Security Scanning, and Per-Resource Dev Databases]]></title>
            <link>https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8</link>
            <guid>https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8</guid>
            <pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Atlas Kubernetes Operator v0.8 adds pre-apply and scheduled drift detection, CVE scanning with AtlasSecurityScan, and a per-resource prewarmDevDB override.]]></description>
            <content:encoded><![CDATA[<p>Hey everyone!</p>
<p>We just released <a href="https://github.com/ariga/atlas-operator/releases/tag/v0.8.0" target="_blank" rel="noopener noreferrer" class="">Atlas Kubernetes Operator v0.8</a>,
which adds drift detection before and between deployments, security scanning for deployed databases, and a
setting for controlling dev databases per resource:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#pre-apply-drift-check">Pre-Apply Drift Check</a></strong>: <code>policy.drift</code> on
an <code>AtlasMigration</code> checks the database for drift before pending migrations are applied, and can block the
deployment.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#scheduled-drift-checks">Scheduled Drift Checks</a></strong>: <code>AtlasDriftCheck</code>
checks the database of an <code>AtlasMigration</code> for drift on an interval and reports the result through
conditions and Kubernetes events.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#security-scanning">Security Scanning</a></strong>: <code>AtlasSecurityScan</code> scans a
database for extensions affected by published CVEs, on a schedule or after a schema change, and grades the
findings against a policy.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#per-resource">Per-Resource Dev Database Prewarming</a></strong>:
<code>AtlasSchema</code> and <code>AtlasMigration</code> accept <code>prewarmDevDB</code>, overriding the operator-wide default.</li>
</ul>
<!-- -->
<p>To upgrade an existing installation:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">helm upgrade atlas-operator oci://ghcr.io/ariga/charts/atlas-operator </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--version</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0.8</span><span class="token plain">.0</span><br></span></code></pre></div></div>
<p>To install the operator for the first time, see <a class="" href="https://atlasgo.io/integrations/kubernetes/install">Installation</a>.</p>
<div class="theme-admonition theme-admonition-info admonition_IZjC alert alert--info"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M7 2.3c3.14 0 5.7 2.56 5.7 5.7s-2.56 5.7-5.7 5.7A5.71 5.71 0 0 1 1.3 8c0-3.14 2.56-5.7 5.7-5.7zM7 1C3.14 1 0 4.14 0 8s3.14 7 7 7 7-3.14 7-7-3.14-7-7-7zm1 3H6v5h2V4zm0 6H6v2h2v-2z"></path></svg></span><a class="" href="https://atlasgo.io/features#pro">Atlas Pro Feature</a></div><div class="admonitionContent_bl22"><p><code>policy.drift</code>, <code>AtlasDriftCheck</code>, and <code>AtlasSecurityScan</code> are available to <a class="" href="https://atlasgo.io/features#pro">Atlas Pro</a> users.
The operator authenticates with a <a class="" href="https://atlasgo.io/cloud/bots">bot token</a> from your Atlas Cloud organization. To start a
trial, run <code>atlas login</code>.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="drift-detection">Drift Detection<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#drift-detection" class="hash-link" aria-label="Direct link to Drift Detection" title="Direct link to Drift Detection" translate="no">​</a></h2>
<p>Drift is any change made to a database outside its migration directory. The operator now detects it in two
places: right before a deployment applies pending migrations, and on a schedule between deployments.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="pre-apply-drift-check">Pre-Apply Drift Check<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#pre-apply-drift-check" class="hash-link" aria-label="Direct link to Pre-Apply Drift Check" title="Direct link to Pre-Apply Drift Check" translate="no">​</a></h3>
<p>The <code>policy.drift</code> block on an <code>AtlasMigration</code> enables the
<a class="" href="https://atlasgo.io/versioned/drift-detection#pre-apply-check">pre-apply drift check</a>. Before applying pending migrations, Atlas
compares the target database with the latest applied version stored in the
<a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a>:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">dir</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">remote</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"atlas"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">tag</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"commit-id"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">cloud</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">tokenFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> token</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">credentials</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">policy</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">drift</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">onError</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> FAIL </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># FAIL (default) or CONTINUE</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">exclude</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"public.audit_*"</span><br></span></code></pre></div></div>
<p>With <code>onError: FAIL</code>, a drifted database blocks the deployment before any migration file runs. The <code>Ready</code>
condition turns <code>False</code> with the reason <code>DriftDetected</code>, and the operator retries until <code>backoffLimit</code> is
reached:</p>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">$ kubectl get atlasmigrations</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">NAME   READY   REASON</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">app    False   DriftDetected</span><br></span></code></pre></div></div>
<p>With <code>onError: CONTINUE</code>, the drift is logged and the migrations are applied. <code>exclude</code> takes glob patterns
for objects that intentionally live outside the migration directory. The check requires a registry
directory (<code>dir.remote</code>), since the expected state is read from the registry.</p>
<p>See <a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#drift"><code>policy.drift</code></a> for the full reference, including how to
recover from a blocked deployment.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="scheduled-drift-checks">Scheduled Drift Checks<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#scheduled-drift-checks" class="hash-link" aria-label="Direct link to Scheduled Drift Checks" title="Direct link to Scheduled Drift Checks" translate="no">​</a></h3>
<p>The pre-apply check runs only when a deployment has pending migrations, so a database that drifts while
nothing is pending is not reported until the next deployment. <code>AtlasDriftCheck</code> runs
<a class="" href="https://atlasgo.io/versioned/drift-detection#migrate-drift"><code>atlas migrate drift</code></a> on an interval, so a change made between
deployments is reported when it happens. The check never modifies the database.</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas-drift-check.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasDriftCheck</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> myapp</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">drift</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">targetRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> myapp </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># An AtlasMigration in the same namespace.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">interval</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> 5m</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">onDrift</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Report </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Report (default) or Fail</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">exclude</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"public.audit_*"</span><br></span></code></pre></div></div>
<p>The check compares the database with the schema the migration directory defines at the applied version.
When the target uses a registry directory, that state is read from the <a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a>.
When it uses a <code>ConfigMap</code> or an inline directory, Atlas replays the migrations on the target's dev database.</p>
<p>The result is stored in the <code>Drifted</code> condition, which counts the drifted objects by kind:</p>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Drifted=True   DriftDetected: 2 drifted objects (extra 1, modified 1) at version 20250901000000: table 2</span><br></span></code></pre></div></div>
<p>With <code>onDrift: Report</code>, the resource stays <code>Ready</code> and drift shows up only in <code>Drifted</code>. With <code>onDrift: Fail</code>,
drift also sets <code>Ready=False</code>, so GitOps tools that track readiness report the resource as unhealthy.</p>
<p>The check emits <code>DriftDetected</code>, <code>DriftChanged</code>, and <code>DriftResolved</code> events only when the result changes. A
database that stays drifted across many checks produces a single event, so events can feed alerts directly:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl get events --field-selector </span><span class="token assign-left variable" style="color:rgb(191, 199, 213)">involvedObject.kind</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">AtlasDriftCheck</span><br></span></code></pre></div></div>
<p>See <a class="" href="https://atlasgo.io/integrations/kubernetes/versioned#drift-detection">Drift Detection</a> for the full field reference.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="security-scanning">Security Scanning<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#security-scanning" class="hash-link" aria-label="Direct link to Security Scanning" title="Direct link to Security Scanning" translate="no">​</a></h2>
<p><code>AtlasSecurityScan</code> runs <a class="" href="https://atlasgo.io/guides/security-scan"><code>atlas security scan</code></a> from the operator. It reports the
extensions installed in the database that are affected by a published CVE, resolved against the
<a class="" href="https://atlasgo.io/cloud/features/security-graph">Security Graph</a>.</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">security-scan.yaml</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasSecurityScan</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">urlFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> app</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">db</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">cloud</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">tokenFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">token</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ATLAS_TOKEN</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">schedule</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"0 6 * * *"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">timeZone</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> UTC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">triggers</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasMigration</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> app</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">migrations</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">policy</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">minSeverity</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ELEVATED</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">failOn</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> HIGH</span><br></span></code></pre></div></div>
<p>This scan runs once when the resource is created, every day at 06:00 UTC, and again each time the
<code>app-migrations</code> resource applies a new version. A scan can also be requested on demand with the
<code>db.atlasgo.io/scan-requested-at</code> annotation.</p>
<p>The result is split across two conditions. <code>Ready</code> says whether the scan ran. <code>Compliant</code> says whether
the database is within the policy: it turns <code>False</code> when a finding at or above <code>failOn</code> is found. Use
<code>kubectl wait --for=condition=Compliant</code> as a deployment gate:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl get atlassecurityscans</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">NAME   READY   REASON    COMPLIANT   FINDINGS   HIGHEST   LAST SCAN   NEXT SCAN              AGE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">app    True    Scanned   False       3          HIGH      0s          2026-10-01T06:00:00Z   6s</span><br></span></code></pre></div></div>
<p>To accept a known finding, add a waiver under <code>policy.ignore</code> with a reason and an optional expiration time.
A waived finding stays in the report but no longer counts toward the verdict, and the scan runs again
when the waiver expires:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">policy</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">failOn</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> HIGH</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">ignore</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> CVE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">2026</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token number" style="color:rgb(247, 140, 108)">14678</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">reason</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"pg_trgm is not reachable from the application role; SEC-1234"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">expirationTime</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"2026-12-31T00:00:00Z"</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="reports-and-access">Reports and Access<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#reports-and-access" class="hash-link" aria-label="Direct link to Reports and Access" title="Direct link to Reports and Access" translate="no">​</a></h3>
<p>The scan status holds only a summary: counts per severity level, with no extension names or CVE
identifiers. The findings are stored in an <code>AtlasSecurityReport</code> with the same name, which lists each
extension, its version, the CVEs affecting it, and a suggested fix.</p>
<p>Since the report shows which extensions are vulnerable, it is excluded from the built-in <code>view</code> and <code>edit</code>
roles. The Helm chart ships a dedicated <code>securityreport-viewer</code> ClusterRole, aggregated into <code>admin</code> by
default and configurable with <code>rbac.securityReports</code>.</p>
<p>See <a class="" href="https://atlasgo.io/integrations/kubernetes/security-scan">Security Scanning with the Kubernetes Operator</a> for the complete guide.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="per-resource">Per-Resource Dev Database<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#per-resource" class="hash-link" aria-label="Direct link to Per-Resource Dev Database" title="Direct link to Per-Resource Dev Database" translate="no">​</a></h2>
<p>The operator keeps the <a class="" href="https://atlasgo.io/concepts/dev-database">dev database</a> it manages for each resource running between
reconciliations, controlled by the operator-wide <code>prewarmDevDB</code> Helm value. <code>AtlasSchema</code> and
<code>AtlasMigration</code> now accept <code>spec.prewarmDevDB</code>, which overrides that default for a single resource:</p>
<div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token key atrule">apiVersion</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db.atlasgo.io/v1alpha1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">kind</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasMigration</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">metadata</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> myapp</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">spec</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">prewarmDevDB</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token boolean important" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">urlFrom</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">secretKeyRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> db</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">credentials</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">dir</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">configMapRef</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token key atrule">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> migrations</span><br></span></code></pre></div></div>
<p>With <code>false</code>, the operator scales the dev database down to zero after the resource is reconciled. With
<code>true</code>, it stays running. When the field is unset, the Helm value applies.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>Operator v0.8 checks a deployed database for drift both before and between deployments, scans it for
extensions affected by published CVEs, and lets each <code>AtlasSchema</code> and <code>AtlasMigration</code> decide whether its
dev database stays running. For the full changelog, see the
<a href="https://github.com/ariga/atlas-operator/releases/tag/v0.8.0" target="_blank" rel="noopener noreferrer" class="">v0.8.0 release on GitHub</a>.</p>
<p>We'd love to hear your feedback! Join our <a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a> or
<a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content:encoded>
            <category>release</category>
            <category>kubernetes</category>
            <category>k8s operator</category>
            <category>drift detection</category>
            <category>security</category>
            <category>cve</category>
        </item>
        <item>
            <title><![CDATA[Case Study: How Deriv Automates Schema Migrations with Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/09/30/case-study-deriv</link>
            <guid>https://atlasgo.io/blog/2026/09/30/case-study-deriv</guid>
            <pubDate>Wed, 30 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Deriv replaced homegrown tooling, hand-written SQL, and a single-DBA bottleneck with a declarative Atlas workflow, letting developers own schema changes.]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><em>"Managing schema as code was the mindset we were looking for, and it was a perfect match with Atlas.
It's able to support our database and others, which gives us flexibility going forward."</em></p>
<p>– Raunak Kathuria, VP of Engineering, Deriv</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background">Company Background<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#company-background" class="hash-link" aria-label="Direct link to Company Background" title="Direct link to Company Background" translate="no">​</a></h3>
<p><a href="https://deriv.com/" target="_blank" rel="noopener noreferrer" class="">Deriv</a> is one of the world's largest online brokers, and was recently named Best
Fintech Broker (Global) at the 2026 Global Forex Awards. They offer CFDs and other derivatives on forex,
stocks and indices, cryptocurrencies, commodities, and Derived Indices to millions of registered users
across the globe.</p>
<p>The company runs on PostgreSQL across many schemas and databases, including multi-tenant setups, and relies
on advanced features like views, functions, triggers, stored procedures, and row-level security. All of it
operates under compliance requirements, including SOC 2, HIPAA, and PCI, that demand full audit trails on
every change. Deriv's engineering teams also actively use AI agents in their development work.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="a-single-dba-as-the-bottleneck">A Single DBA as the Bottleneck<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#a-single-dba-as-the-bottleneck" class="hash-link" aria-label="Direct link to A Single DBA as the Bottleneck" title="Direct link to A Single DBA as the Bottleneck" translate="no">​</a></h3>
<p>Before Atlas, Deriv managed schema changes with homegrown tooling and SQL migration scripts that engineers
and DBAs wrote by hand. Every change still had to pass through one DBA or lead engineer, which made that
person a bottleneck as deploy volume grew. Engineers grew cautious about touching the schema at all, and
enforcing consistent policies and standards across so many schemas and databases became a manual,
error-prone job.</p>
<p><em>"Manually writing migration scripts made our development and code reviews slower, increased the risk of
deployment errors, and made it much harder to consistently enforce our database standards across the team,"</em>
said Mario Bryan Tan, Data Engineer Tech Lead at Deriv.</p>
<p>The manual process was also a security gap. With no automated linting or best-practice checks, the only
thing standing between a destructive change, like a dropped column, and production was a reviewer catching
it. As Raunak put it, <em>"We were only storing our schema as code, not managing it."</em></p>
<p>The old scripts worked, but they demanded constant maintenance and manual effort from the DBA team just
to keep up. <em>"We wanted to automate the current process and automatically generate the schema changes,"</em>
Raunak said.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="evaluating-the-alternatives">Evaluating the Alternatives<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#evaluating-the-alternatives" class="hash-link" aria-label="Direct link to Evaluating the Alternatives" title="Direct link to Evaluating the Alternatives" translate="no">​</a></h3>
<p>The opening came with a larger project: Deriv was rebuilding its legacy infrastructure from the ground up,
and the team used this opportunity to evaluate migration tools. Given Deriv's compliance obligations, the
must-haves were non-negotiable:</p>
<ul>
<li class="">A declarative workflow combined with versioned migrations</li>
<li class="">GitHub integration and CI/CD automation</li>
<li class="">Linting and destructive-change prevention that stop unsafe changes before they ship</li>
<li class="">Every change auditable and version-controlled end-to-end</li>
<li class="">Minimal infrastructure to run, and a vendor that provides real support</li>
</ul>
<p>Flyway, Liquibase, Sqitch, and Supabase migrations each fell short on at least one of these areas, and none
could handle the full complexity of Deriv's database setup. For some, licensing costs and complexity counted
against them as well.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="choosing-atlas">Choosing Atlas<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#choosing-atlas" class="hash-link" aria-label="Direct link to Choosing Atlas" title="Direct link to Choosing Atlas" translate="no">​</a></h3>
<p>Atlas's schema-as-code model was the click for Raunak. It matched the mindset the team was already looking
for, and its support for PostgreSQL alongside other databases gave Deriv room to grow into new engines
without switching platforms again.</p>
<p>For Mario, the decision came down to a working end-to-end test. <em>"We were able to edit the declarative
schema, use <code>migrate diff</code> to automatically generate versioned migration files, and leverage built-in
linting to catch potential errors early,"</em> he said. <em>"Integrating all of this directly into our GitHub
Actions deployment pipeline clearly demonstrated Atlas's practical value for our team."</em></p>
<p>Integrating Atlas into the existing CI/CD pipeline was straightforward. Getting a platform of Deriv's size
fully into production took more effort, and support is where the Atlas team stood out. <em>"The support provided
from the first day was amazing, and any bugs or issues we ran into were addressed immediately,"</em> Raunak said.
Mario agreed: <em>"During our onboarding phase, the Atlas team provided excellent support for our technical
inquiries. They not only resolved our immediate issues but also helped us use the product more effectively,
which solidified our decision to proceed with Atlas."</em></p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="one-pipeline-for-every-schema-change">One Pipeline for Every Schema Change<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#one-pipeline-for-every-schema-change" class="hash-link" aria-label="Direct link to One Pipeline for Every Schema Change" title="Direct link to One Pipeline for Every Schema Change" translate="no">​</a></h3>
<p>Today, developers at Deriv use Atlas's versioned migrations for every schema change. On every pull request,
GitHub Actions runs Atlas's linting and safety checks, so destructive and risky changes get caught in CI
before they reach production. <em>"It flagged adding a foreign key without <code>NOT VALID</code> as risky,"</em> Raunak noted.
If not caught, the team would have risked locking a live production table to perform a full table scan,
causing an outage.</p>
<p>For a regulated broker, that pipeline doubles as security control. Every schema change is version-controlled,
reviewed in a pull request, checked against destructive and risky patterns, and recorded for audit, without
depending on one person to enforce it.</p>
<p>After deployment, Atlas Cloud's Schema Monitoring tracks the state of each environment, and the team uses
its ERDs and visual diffs to see exactly what changed between migration versions.</p>
<p>Deriv's AI agents work through the same pipeline. <em>"AI agents are able to work well with Atlas because they
can read the declarative schemas to gain a complete, accurate picture of our database state,"</em> Mario said.
From there, an agent generates the migration with <code>migrate diff</code>, runs the built-in linting and safety
checks, and tests the result by deploying it to development and staging databases, so its changes pass the
same checks as any engineer's.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome">The Outcome<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#the-outcome" class="hash-link" aria-label="Direct link to The Outcome" title="Direct link to The Outcome" translate="no">​</a></h3>
<p>Atlas took schema migrations off the DBA team's plate entirely and put safe, auditable change-making directly
in developers' hands.</p>
<ul>
<li class=""><strong>Developers own schema changes.</strong> What Raunak calls the biggest win: developers no longer route every
schema change through a single gatekeeper, nor do they avoid touching the schema out of fear of breaking
something.</li>
<li class=""><strong>No more hand-written migrations or tooling upkeep.</strong> Atlas generates the versioned migration files,
and the homegrown scripts that used to demand constant upkeep are gone. <em>"We have not spent any time
working on maintaining our schema migration tooling. It's all taken care of by Atlas,"</em> Raunak said.</li>
<li class=""><strong>Destructive changes get caught before production.</strong> Atlas's linting flags risky changes, like an
unguarded foreign key addition, before they ship.</li>
<li class=""><strong>Standards are enforced automatically.</strong> Configurable checks and policies apply Deriv's database standards
to every change, instead of relying on reviewers to remember them.</li>
<li class=""><strong>Faster reviews and deployments.</strong> Schema review used to mean waiting on the DBA team. Now the linter
verifies migration safety up front, more engineers ship changes without a bottleneck, and incidents traced
back to migrations have become rare.</li>
<li class=""><strong>Every change is visible after it ships.</strong> ERDs and visual diffs in Atlas Cloud make it straightforward
to audit exactly what changed between migrations, across environments.</li>
<li class=""><strong>A workflow ready for AI agents.</strong> Agents handle schema changes end-to-end inside the same guardrails as
the rest of the team. <em>"Considering the workflows are properly set up and the tooling documentation is
well-defined, AI agents can easily pick it up and start working with no major work required,"</em> Raunak said.</li>
</ul>
<p><em>"Schema changes are now defined declaratively, and Atlas auto-generates and applies migration scripts,
catching destructive changes before they land,"</em> Raunak said. <em>"It's now the standardized migration product
across teams, reliable enough that we've standardized it for our new architecture setup, with a good
security posture."</em></p>
<p><em>"Atlas delivers what teams need to safely automate database deployments,"</em> Mario added. <em>"As a company,
their exceptional responsiveness and hands-on support gave us complete confidence in our decision to partner
with them."</em></p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started">Getting Started<a href="https://atlasgo.io/blog/2026/09/30/case-study-deriv#getting-started" class="hash-link" aria-label="Direct link to Getting Started" title="Direct link to Getting Started" translate="no">​</a></h3>
<p>Deriv replaced a single-DBA bottleneck and hand-written scripts with one pipeline where every schema change,
from a developer or an AI agent, is generated, linted, reviewed, and recorded for audit. If your schema
changes still wait on one person, or you need an auditable record of every change for SOC 2, HIPAA, or PCI,
you can set up the same workflow:</p>
<ul>
<li class="">Follow the <a class="" href="https://atlasgo.io/getting-started">getting started guide</a> to define your schema as code and generate your first
migration.</li>
<li class="">Add <a class="" href="https://atlasgo.io/integrations/github-actions">Atlas to GitHub Actions</a> to lint every schema change in pull requests.</li>
<li class=""><a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" class="">Schedule a demo</a> to see how Atlas fits your databases and compliance
requirements.</li>
</ul>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[DACPAC for PostgreSQL: Where Atlas Fills the Gap]]></title>
            <link>https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres</link>
            <guid>https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres</guid>
            <pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[DACPAC is SQL Server only. Here's how Atlas is the solution for teams who migrate from SQL Server to PostgreSQL and need a similar schema management tool.]]></description>
            <content:encoded><![CDATA[<p>If you've searched for "DACPAC for PostgreSQL," you already know the answer: there isn't one. DACPAC is a
Microsoft file format, built into SQL Server Data Tools and deployed with <code>SqlPackage</code>, and it has no
equivalent outside the SQL Server ecosystem. What you're actually looking for isn't the file format, it's
the workflow: define the schema once, let the tool diff it against a live database, and deploy the result
without hand-written migration scripts. Atlas gives you that workflow for PostgreSQL.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-gap-in-postgresql">The Gap in PostgreSQL<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#the-gap-in-postgresql" class="hash-link" aria-label="Direct link to The Gap in PostgreSQL" title="Direct link to The Gap in PostgreSQL" translate="no">​</a></h2>
<p>Teams that move from SQL Server to PostgreSQL, or run both, hit this quickly. There's no Database Project,
no DACPAC, and no <code>SqlPackage</code>. The common PostgreSQL tools, like Flyway and Liquibase, are migration runners.
They apply scripts in order, but someone still writes every <code>ALTER TABLE</code> by hand and hopes it matches
what's actually in production.</p>
<p>DACPAC let SQL Server teams skip that step. Without it, schema changes go back to being manual: write the
migration, review it, keep it in sync with the ORM models, and find out about drift when a deploy fails.</p>
<p>The hard part isn't the simple <code>ADD COLUMN</code>, it's the changes that ripple through dependencies. In PostgreSQL,
you can't change the type of a column that a view uses, and <code>CREATE OR REPLACE VIEW</code> can't drop or retype
columns. A one-line change to a base table or view can mean dropping every downstream view, materialized
view, and function that depends on it, applying the change, and recreating the whole chain in the right
order. Doing that by hand means tracing the dependency graph yourself, and missing one object means a
failed deploy or a silently broken view.</p>
<p>A good planner handles this for you, and it's where most of the real work in a schema diff happens.
<code>SqlPackage</code> does it for SQL Server. PostgreSQL teams have had to do it themselves.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="enter-atlas">Enter: Atlas<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#enter-atlas" class="hash-link" aria-label="Direct link to Enter: Atlas" title="Direct link to Enter: Atlas" translate="no">​</a></h2>
<p>Atlas brings declarative PostgreSQL schema migration to the table. You define the desired schema, Atlas
inspects the target database, computes the diff, including working out the dependency order above, and
plans the migration. It's the same build-diff-deploy loop run by <code>SqlPackage</code>, without Visual Studio or
a compiled package.</p>
<p>That loop, on the SQL Server side, looks like this. A DACPAC (Data-tier Application Package) is the
compiled output of a SQL Server Database Project built in Visual Studio: a zip file containing a model
of every table, view, and procedure in the project, plus any pre-deployment and post-deployment scripts
a developer bolted on for logic the model can't express, like backfills. You never hand-write a
migration; instead you point <code>SqlPackage</code> at the DACPAC and a target database, and it computes the diff
for you:</p>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sqlpackage /Action:Publish </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  /SourceFile:MyDatabase.dacpac </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  /TargetConnectionString:</span><span class="token string" style="color:rgb(195, 232, 141)">"Server=prod;Database=app;User Id=sa;Password=***;"</span><br></span></code></pre></div></div>
<p><code>SqlPackage</code> inspects the target, compares it to the model baked into the DACPAC, and generates a
deployment script on the fly. Nobody sits down and writes <code>ALTER TABLE ... ADD COLUMN</code>, rather the
tool derives it from the difference between two states. Swap <code>/Action:Publish</code> for <code>/Action:Script</code>
and <code>SqlPackage</code> writes that generated script to a <code>.sql</code> file instead of running it right away,
giving you the chance to first read and review it.</p>
<p>Atlas runs that same loop against PostgreSQL, MySQL, SQL Server, <a class="" href="https://atlasgo.io/databases">and more databases</a>,
starting from schema as code you write yourself, in SQL, Atlas HCL, or your ORM models, and it's not
tied to Visual Studio or Windows to do it.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="see-it-in-practice">See It in Practice<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#see-it-in-practice" class="hash-link" aria-label="Direct link to See It in Practice" title="Direct link to See It in Practice" translate="no">​</a></h2>
<p>Atlas works from the same premise as <code>SqlPackage</code>: you define your desired schema and Atlas computes
the SQL needed to get a real database there. The difference is that instead of a Visual Studio project
compiled into a binary artifact, the desired state is defined in code you can read, diff, and review in
a pull request:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">bigint</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"name"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">character</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">varying</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"balance"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">integer</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"legacy_id"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">bigint</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">PRIMARY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">KEY</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Instead of <code>SqlPackage /Action:Publish</code>, you run <a class="" href="https://atlasgo.io/declarative/apply"><code>atlas schema apply</code></a>, pointing
<code>--to</code> at that file and <code>-u</code> at the database you want to converge:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-u</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres://postgres:pass@:5432/myapp?search_path=public&amp;sslmode=disable"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.sql"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/16/dev?search_path=public"</span><br></span></code></pre></div></div>
<p>Atlas inspects <code>myapp</code>, diffs it against <code>schema.sql</code>, and shows you the plan before touching anything:</p>
<div class="language-applylog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-applylog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Planning migration statements (1 in total):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">create "users" table:</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">CREATE TABLE "users" (</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         "id" bigint NOT NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         "name" character varying NOT NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         "balance" integer NOT NULL DEFAULT 0,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         "legacy_id" bigint,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         PRIMARY KEY ("id")</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       );</span><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2">-------------------------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">? Approve or abort the plan:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  ▸ Approve and apply</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    Abort</span><br></span></code></pre></div></div>
<p>In the end, you get the same result: a generated plan, derived from a real diff, that a human approves
before it runs. The <code>--dev-url</code> flag points at an <a class="" href="https://atlasgo.io/concepts/dev-database">ephemeral dev database</a> that
Atlas runs the generated SQL against before it ever touches <code>myapp</code>, so a statement that's malformed or
invalid for this schema fails on the throwaway copy, not on the target, something <code>SqlPackage</code> doesn't
do on its own.</p>
<p>Where <code>SqlPackage</code>'s script action is an opt-in extra step, plan review is the default in Atlas:
<code>schema apply</code> stops and waits for approval unless you pass <code>--auto-approve</code>. Even then, the plan
run is the one printed to your terminal or CI log, not something reconstructed after the fact from
a separate script file.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-brings-more-to-the-table">Atlas Brings More to the Table<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#atlas-brings-more-to-the-table" class="hash-link" aria-label="Direct link to Atlas Brings More to the Table" title="Direct link to Atlas Brings More to the Table" translate="no">​</a></h2>
<p>The workflow above, define a schema, get a plan, approve it, is the baseline. Everything beyond it,
migration analyzers, data migration tests, drift monitoring, is what a DACPAC pipeline has no equivalent
for at all.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="ensuring-safe-migrations">Ensuring safe migrations<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#ensuring-safe-migrations" class="hash-link" aria-label="Direct link to Ensuring safe migrations" title="Direct link to Ensuring safe migrations" translate="no">​</a></h3>
<p>A DACPAC diff tells you <em>what</em> changed. It doesn't tell you whether that change is safe to run against a
database with rows in it. Say a team decides to remove a deprecated column:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">bigint</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"name"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">character</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">varying</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token string" style="color:rgb(195, 232, 141)">"balance"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">integer</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">--  "legacy_id" bigint,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">PRIMARY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">KEY</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Both <code>SqlPackage</code> and Atlas will happily generate <code>ALTER TABLE "users" DROP COLUMN "legacy_id";</code> and hand
it to you as part of the plan. <code>SqlPackage</code> prints the statement and stops there. Atlas has a linting pass
that runs the same statement against its <a class="" href="https://atlasgo.io/lint/analyzers">built-in analyzers</a> before reaching your database:</p>
<div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate lint </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">local</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--latest</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Analyzing changes from version </span><span class="token version">20260915093000</span><span class="token plain"> to </span><span class="token version">20260917103011</span><span class="token plain"> (1 migration in total):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">analyzing version </span><span class="token version">20260917103011</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">destructive changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L1</span><span class="token plain">: Dropping non-virtual column </span><span class="token ident">"legacy_id"</span><span class="token plain"> https://atlasgo.io/lint/analyzers#DS103</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">ok (4.238ms)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  -------------------------</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">8.211ms</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">1 version with errors</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">1 schema change</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">1 diagnostic</span><br></span></code></pre></div></div>
<p>Teams that want a harder gate turn this into a CI failure by adding a few lines in <code>atlas.hcl</code>:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">destructive</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>That gate isn't limited to CI. Configure a <a class="" href="https://atlasgo.io/declarative/apply#review-policy">review policy</a> of <code>ERROR</code>
and the same check runs at apply time: <code>atlas schema apply</code> auto-approves a plan only when linting
passes, and falls back to the manual approval prompt from the previous section the moment a destructive
change like this one shows up, even if you ran it with <code>--auto-approve</code>.</p>
<p><a class="" href="https://atlasgo.io/lint/analyzers#destructive-changes">Destructive changes</a> are one of several dozen analyzers Atlas ships
with. Renaming a column doesn't drop any data, so <code>destructive</code> won't flag it, but it still breaks any
application instance still running the previous schema version during a rolling deploy:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">RENAME</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"email_address"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TO</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">analyzing version </span><span class="token version">20260917113242</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">backward incompatible changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L2</span><span class="token plain">: Renaming column </span><span class="token ident">"email_address"</span><span class="token plain"> to </span><span class="token ident">"email"</span><span class="token plain"> https://atlasgo.io/lint/analyzers#BC102</span><br></span></code></pre></div></div>
<p>PostgreSQL has its own class of problems that show up only once the statement hits a table with rows in it.
<code>SqlPackage</code> hands you the type change and lets the database sort out the cost. Atlas flags the ones that
rewrite the table, which blocks reads and writes for as long as the rewrite takes:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"balance"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TYPE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">numeric</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">12</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">analyzing version </span><span class="token version">20260917114203</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">blocking table changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token plain">L5: Changing column type from </span><span class="token ident">"integer"</span><span class="token plain"> to </span><span class="token ident">"numeric(12,2)"</span><span class="token plain"> requires table rewrite with ACCESS EXCLUSIVE lock https://atlasgo.io/lint/analyzers#PG301</span><br></span></code></pre></div></div>
<p>A third class fails depending on data that doesn't exist yet when you write the migration. Adding a
unique constraint passes cleanly against an empty dev database and then fails in production the moment
two existing rows share a value:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"orders_name_key"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">"name"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">analyzing version </span><span class="token version">20260917114732</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token category">data dependent changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token severity">L1</span><span class="token plain">: Adding a unique index </span><span class="token ident">"orders_name_key"</span><span class="token plain"> might fail in case column </span><span class="token ident">"name"</span><span class="token plain"> contains duplicate entries https://atlasgo.io/lint/analyzers#MF101</span><br></span></code></pre></div></div>
<p><code>SqlPackage</code> would generate all three of these statements exactly the same way it generates any other
<code>ALTER TABLE</code>, since nothing in a DACPAC model distinguishes a safe change from a risky one.</p>
<p>See <a class="" href="https://atlasgo.io/lint/analyzers">Migration Analyzers</a> for the full set of checks, including those specific to
PostgreSQL and MySQL.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="build-artifact-vs-file-directory">Build artifact vs. file directory<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#build-artifact-vs-file-directory" class="hash-link" aria-label="Direct link to Build artifact vs. file directory" title="Direct link to Build artifact vs. file directory" translate="no">​</a></h3>
<p>A DACPAC is a single, opaque snapshot. It doesn't tell you what changed between last week's deployment and
today's; you'd need to diff two DACPACs to find out, and even then you're diffing binary output, not
intent. If you want PostgreSQL schema history that lives in git and reads like a changelog,
<a class="" href="https://atlasgo.io/versioned/intro">Atlas's versioned workflow</a> gives you that as files, not a build artifact:</p>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> add_legacy_id_drop </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://schema.sql"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/16/dev?search_path=public"</span><br></span></code></pre></div></div>
<div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">migrations/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── 20260910091200_create_users.sql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">├── 20260917103011_add_legacy_id_drop.sql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">└── atlas.sum</span><br></span></code></pre></div></div>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20260917103011_add_legacy_id_drop.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- modify "users" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"legacy_id"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Each file is a real diff you can read in a code review, checksummed in
<a class="" href="https://atlasgo.io/concepts/migration-directory-integrity"><code>atlas.sum</code></a> to prevent migration conflicts.
<a class="" href="https://atlasgo.io/versioned/apply"><code>atlas migrate apply</code></a> walks the directory in order, applying only the migration
files that have yet to be applied to the target database.</p>
<p>There's no equivalent artifact to inspect in a DACPAC-based pipeline, because the DACPAC doesn't
keep history, it only contains the current model.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="testing-migrations">Testing migrations<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#testing-migrations" class="hash-link" aria-label="Direct link to Testing migrations" title="Direct link to Testing migrations" translate="no">​</a></h3>
<p>Linting catches statements that are unsafe in general. It won't tell you whether a data migration is
correct for your specific data, and that's what <a class="" href="https://atlasgo.io/testing/migrate"><code>atlas migrate test</code></a> covers: HCL
test files that seed the dev database at one version, migrate forward, and assert on the result.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrate.test.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">test </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"backfill_users"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20260910091200"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">exec</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"INSERT INTO users (id, name, legacy_id) VALUES (1, 'Ada', 42)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migrate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">to</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"20260917103011"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">assert</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SELECT NOT EXISTS (SELECT 1 FROM users WHERE legacy_id IS NOT NULL)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">test</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/16/dev?search_path=public"</span><br></span></code></pre></div></div>
<p>The <code>exec</code> block isn't the only assertion available: <a class="" href="https://atlasgo.io/testing/migrate#catch-command"><code>catch</code></a> expects
a statement to fail and can match the error message, and <a class="" href="https://atlasgo.io/testing/migrate#assert-command"><code>assert</code></a>
expects a query to return true, so a single test case can seed data, migrate, and check several
conditions in sequence before Atlas tears the dev database down for the next case.</p>
<p>A sibling command, <a class="" href="https://atlasgo.io/testing/schema"><code>atlas schema test</code></a>, asserts on schema behavior directly, useful
for check constraints, generated columns, or views, without stepping through migration versions at all.</p>
<p><code>SqlPackage</code> has no notion of a test for a deployment script; it generates the diff and trusts it.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="watching-the-database-after-the-deployment-ends">Watching the Database After the Deployment Ends<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#watching-the-database-after-the-deployment-ends" class="hash-link" aria-label="Direct link to Watching the Database After the Deployment Ends" title="Direct link to Watching the Database After the Deployment Ends" translate="no">​</a></h2>
<p>A DACPAC is a snapshot. Once <code>SqlPackage</code> finishes, nothing keeps watching the target, so if someone
opens a database console and adds a column, changes a constraint, or drops an index by hand, that change
sits invisible until the next deployment's diff turns up something nobody expected.</p>
<p>Atlas Cloud keeps watching after the deployment ends:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/registry">Schema registry</a>: every version of your schemas and migration directories,
with ERD diffs between versions and the CI runs that produced them.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/schema-docs">Schema docs</a>: generated documentation for every table, column, and
relationship, updated with each push.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/lineage-graph">Lineage graph</a>: how tables, columns, and other resources depend on
one another across the schema.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/security-graph">Security graph</a>: roles, permissions, and grants in one view, with
findings for misconfigurations and known CVEs.</li>
<li class=""><a class="" href="https://atlasgo.io/monitoring/drift-detection">Drift detection</a>: continuous comparison of each live database against
its expected state, with a Slack alert when they diverge.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/deployment">Deployment history</a>: which version ran against which database and when, including
per-tenant status across a fleet.</li>
<li class=""><a class="" href="https://atlasgo.io/cloud/features/troubleshooting">Troubleshooting</a>: a report for every failed deployment with the
SQL error, the files that were applied, and which tenant database caused the failure.</li>
</ul>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs docs-tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Schema Registry</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Schema Docs</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Lineage Graph</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Security Graph</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Drift Detection</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Deployments</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Troubleshooting</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/images/dir-overview-v1.webp" alt="atlas migrate push" width="3456" height="1916" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Migration Directory created with <code>atlas migrate push</code></p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/schema-docs.webp" alt="Generated schema documentation in Atlas Cloud" width="3680" height="2206" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Generated schema documentation in Atlas Cloud</p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/lineage-graph/pin-selected-column.png" alt="Pinning a selected column in the Atlas Cloud lineage graph" width="2934" height="1544" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Pinning a selected column in the Atlas Cloud lineage graph</p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/security-graph/overview-tab.webp" alt="Atlas Cloud overview page with the Security tab selected" width="3680" height="2206" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Atlas Cloud overview page with the Security tab selected</p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/monitoring/diff-sql.webp" alt="SQL diff view for a detected drift" width="3456" height="1344" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">SQL diff view for a detected drift</p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/images/deployment-2.png" alt="Single deployment report in Atlas Cloud, showing migration status, duration, and applied files" width="1759" height="930" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Single deployment report in Atlas Cloud, showing migration status, duration, and applied files</p></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div style="text-align:center"><img src="https://atlasgo.io/u/cloud/images/gh-failed-deployment.png" alt="Failed deployment report in Atlas Cloud, showing the SQL error and the migration files that were applied" width="1748" height="890" style="width:100%;height:auto" loading="lazy"><p style="font-size:12px">Failed deployment report in Atlas Cloud, showing the SQL error and the migration files that were applied</p></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="coming-from-sql-server-entirely">Coming from SQL Server Entirely<a href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres#coming-from-sql-server-entirely" class="hash-link" aria-label="Direct link to Coming from SQL Server Entirely" title="Direct link to Coming from SQL Server Entirely" translate="no">​</a></h2>
<p>Everything above works whether your target is <a class="" href="https://atlasgo.io/guides/postgres/automatic-migrations">PostgreSQL</a>,
<a class="" href="https://atlasgo.io/guides/mysql/mysql-automatic-migrations">MySQL</a>, <a class="" href="https://atlasgo.io/guides/mssql">SQL Server</a>, or a handful of other
engines Atlas supports, since the workflow doesn't change per database. If you're not just missing DACPAC
on PostgreSQL but considering moving your whole SSDT setup over, the deeper comparison, including rollback,
multi-tenant deployments, and drift detection, is in <a class="" href="https://atlasgo.io/guides/atlas-vs-ssdt">Atlas vs SSDT</a>. For the
move itself, <a class="" href="https://atlasgo.io/guides/sql-server-to-postgresql">SQL Server to PostgreSQL</a> maps each SqlPackage action to an
Atlas command and manages both engines from one project.</p>]]></content:encoded>
            <category>postgres</category>
            <category>dacpac</category>
            <category>ssdt</category>
            <category>sql server</category>
            <category>migration tools</category>
        </item>
        <item>
            <title><![CDATA[The AI-Native SDLC Playbook Stops at the Database]]></title>
            <link>https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database</link>
            <guid>https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database</guid>
            <pubDate>Mon, 31 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Anthropic's AI-Native SDLC playbook turns delivery into a loop of committed artifacts. The loop does not close at the database: why revert-shaped controls fail for schema changes, and the gates that work.]]></description>
            <content:encoded><![CDATA[<p>Anthropic recently published <a href="https://claude.com/blog/the-ai-native-sdlc-playbook" target="_blank" rel="noopener noreferrer" class="">The AI-Native SDLC playbook</a>, and
it's the most concrete writeup I've seen discussing the effects of cheaper code generation on a delivery process,
written by a company where <a href="https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle" target="_blank" rel="noopener noreferrer" class="">AI authors 80% of merged code</a>.
If you run engineering at any scale, I suggest you read it.</p>
<p>It consists of six stages from <em>Plan</em> to <em>Maintain</em> that work in a loop rather than a linear chain of handoffs. Each
stage commits an artifact that the next stage reads. The chain of commits is the audit trail. Humans stop reading
every line and start judging intent and risk.</p>
<p><a href="https://about.gitlab.com/blog/when-code-is-abundant/" target="_blank" rel="noopener noreferrer" class="">GitLab's CEO</a> responded with the line that will likely outlive
the playbook itself: <em>"when implementation becomes abundant, trust becomes scarce."</em></p>
<p>Code is abundant now. Your data is not. An agent can regenerate your code in an afternoon, but it cannot regenerate the
production state your company accumulated over years. The playbook's recovery model quietly assumes otherwise, which
leads to our claim: <strong>the loop does not close at the database</strong>.</p>
<p>The database is the one stateful component in your infrastructure. It's where the history lives, and you cannot roll
back history by redeploying an older version of it.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="where-databases-differ">Where Databases Differ<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#where-databases-differ" class="hash-link" aria-label="Direct link to Where Databases Differ" title="Direct link to Where Databases Differ" translate="no">​</a></h2>
<p>To better explain why databases need to be considered differently than the rest of your codebase, I'll describe two
common scenarios that often break production in real applications.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="a-session-that-does-everything-right">A Session That "Does Everything Right"<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#a-session-that-does-everything-right" class="hash-link" aria-label="Direct link to A Session That &quot;Does Everything Right&quot;" title="Direct link to A Session That &quot;Does Everything Right&quot;" translate="no">​</a></h3>
<p>A support ticket comes in stating that users are creating duplicate accounts with the same email. Someone brainstorms
with Claude and commits an <code>intent.md</code> to stop new duplicates at the source. The <code>spec.md</code> pass runs with the org's
security and compliance skills loaded, finding no new exposure. In plan mode, Claude writes a <code>plan.md</code> for the
PostgreSQL database:</p>
<div class="language-markdown codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-markdown codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token title important punctuation" style="color:rgb(199, 146, 234)">#</span><span class="token title important"> Plan: enforce unique emails (from intent.md 2026-08-24)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token title important punctuation" style="color:rgb(199, 146, 234)">##</span><span class="token title important"> Files that change</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">db/schema.sql, api/users/create.go, api/users/create_test.go</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token title important punctuation" style="color:rgb(199, 146, 234)">##</span><span class="token title important"> Order of work</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token list punctuation" style="color:rgb(199, 146, 234)">1.</span><span class="token plain"> Add a unique constraint on users.email.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token list punctuation" style="color:rgb(199, 146, 234)">2.</span><span class="token plain"> Return 409 on the duplicate path instead of 500.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token title important punctuation" style="color:rgb(199, 146, 234)">##</span><span class="token title important"> Proof</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">create_test.go covers the duplicate case.</span><br></span></code></pre></div></div>
<p>The engineer reads and accepts it. Claude implements. The migration is one statement:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> users </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> users_email_key </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">email</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Tests pass against a development database with 40 rows in <code>users</code>. The review passes find nothing, because there is
nothing to find: the diff is three lines and does exactly what the plan says. A code owner approves, it merges, and
the pipeline ships it.</p>
<p>Say the ops team already cleaned up the old duplicates, so the constraint is valid. PostgreSQL still takes an
<code>ACCESS EXCLUSIVE</code> lock on <code>users</code> and scans the table to build the index behind the constraint. On the production
table, that scan runs for 90 seconds, and every new read and write on <code>users</code> queues behind it.</p>
<p>Logins hang, the connection pool drains, the incident spreads to services that never even touched this table.</p>
<p><img decoding="async" loading="lazy" alt="Every gate fires, and none of them faces the database" src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMjQwIDQ3MCIgZm9udC1mYW1pbHk9InVpLW1vbm9zcGFjZSxTRk1vbm8tUmVndWxhcixNZW5sbyxDb25zb2xhcywnTGliZXJhdGlvbiBNb25vJyxtb25vc3BhY2UiPgogIDxkZWZzPgogICAgPG1hcmtlciBpZD0iYXJyIiB2aWV3Qm94PSIwIDAgMTAgMTAiIHJlZlg9IjcuNSIgcmVmWT0iNSIgbWFya2VyV2lkdGg9IjciIG1hcmtlckhlaWdodD0iNyIgb3JpZW50PSJhdXRvLXN0YXJ0LXJldmVyc2UiPgogICAgICA8cGF0aCBkPSJNMCwxIEw5LDUgTDAsOSBMMi4yLDUgeiIgZmlsbD0iIzk3QTFCMCIvPgogICAgPC9tYXJrZXI+CiAgPC9kZWZzPgogIDxyZWN0IHg9IjEiIHk9IjEiIHdpZHRoPSIxMjM4IiBoZWlnaHQ9IjQ2OCIgcng9IjE4IiBmaWxsPSIjRjZGOEZBIiBzdHJva2U9IiNFNUVBRjAiIHN0cm9rZS13aWR0aD0iMS41Ii8+CgogIDx0ZXh0IHg9IjM0IiB5PSI0OCIgZm9udC1zaXplPSIxMiIgbGV0dGVyLXNwYWNpbmc9IjMiIGZpbGw9IiM5QUE1QjQiPjEgwrcgRVZFUlkgR0FURSBGSVJFUzwvdGV4dD4KCiAgPCEtLSBnYXRlIHJvdyAtLT4KICA8Zz4KICAgIDxyZWN0IHg9IjMxIiAgIHk9IjcwIiB3aWR0aD0iMTc4IiBoZWlnaHQ9Ijc2IiByeD0iMTAiIGZpbGw9IiMxMTE4MjciLz4KICAgIDx0ZXh0IHg9IjQ3IiAgIHk9Ijk4IiAgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+UExBTjwvdGV4dD4KICAgIDx0ZXh0IHg9IjQ3IiAgIHk9IjEyNCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+aW50ZW50Lm1kIDx0c3BhbiBmaWxsPSIjNEFERTgwIj7inJM8L3RzcGFuPjwvdGV4dD4KCiAgICA8cmVjdCB4PSIyMzEiICB5PSI3MCIgd2lkdGg9IjE3OCIgaGVpZ2h0PSI3NiIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSIyNDciICB5PSI5OCIgIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPkRFU0lHTjwvdGV4dD4KICAgIDx0ZXh0IHg9IjI0NyIgIHk9IjEyNCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+c3BlYy5tZCA8dHNwYW4gZmlsbD0iIzRBREU4MCI+4pyTPC90c3Bhbj48L3RleHQ+CgogICAgPHJlY3QgeD0iNDMxIiAgeT0iNzAiIHdpZHRoPSIxNzgiIGhlaWdodD0iNzYiIHJ4PSIxMCIgZmlsbD0iIzExMTgyNyIvPgogICAgPHRleHQgeD0iNDQ3IiAgeT0iOTgiICBmb250LXNpemU9IjExIiBsZXR0ZXItc3BhY2luZz0iMi41IiBmaWxsPSIjOEI5NkE1Ij5CVUlMRDwvdGV4dD4KICAgIDx0ZXh0IHg9IjQ0NyIgIHk9IjEyNCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+cGxhbi5tZCA8dHNwYW4gZmlsbD0iIzRBREU4MCI+4pyTPC90c3Bhbj48L3RleHQ+CgogICAgPHJlY3QgeD0iNjMxIiAgeT0iNzAiIHdpZHRoPSIxNzgiIGhlaWdodD0iNzYiIHJ4PSIxMCIgZmlsbD0iIzExMTgyNyIvPgogICAgPHRleHQgeD0iNjQ3IiAgeT0iOTgiICBmb250LXNpemU9IjExIiBsZXR0ZXItc3BhY2luZz0iMi41IiBmaWxsPSIjOEI5NkE1Ij5URVNUPC90ZXh0PgogICAgPHRleHQgeD0iNjQ3IiAgeT0iMTI0IiBmb250LXNpemU9IjE1IiBmaWxsPSIjRkZGRkZGIj50ZXN0cyBwYXNzIDx0c3BhbiBmaWxsPSIjNEFERTgwIj7inJM8L3RzcGFuPjwvdGV4dD4KCiAgICA8cmVjdCB4PSI4MzEiICB5PSI3MCIgd2lkdGg9IjE3OCIgaGVpZ2h0PSI3NiIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSI4NDciICB5PSI5OCIgIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPlJFVklFVzwvdGV4dD4KICAgIDx0ZXh0IHg9Ijg0NyIgIHk9IjEyNCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+YXBwcm92ZWQgPHRzcGFuIGZpbGw9IiM0QURFODAiPuKckzwvdHNwYW4+PC90ZXh0PgoKICAgIDxyZWN0IHg9IjEwMzEiIHk9IjcwIiB3aWR0aD0iMTc4IiBoZWlnaHQ9Ijc2IiByeD0iMTAiIGZpbGw9IiMxMTE4MjciLz4KICAgIDx0ZXh0IHg9IjEwNDciIHk9Ijk4IiAgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+REVQTE9ZPC90ZXh0PgogICAgPHRleHQgeD0iMTA0NyIgeT0iMTI0IiBmb250LXNpemU9IjE1IiBmaWxsPSIjRkZGRkZGIj5zaGlwcGVkIDx0c3BhbiBmaWxsPSIjNEFERTgwIj7inJM8L3RzcGFuPjwvdGV4dD4KICA8L2c+CgogIDwhLS0gZmlyc3QgY29udGFjdCByb3V0ZSAtLT4KICA8cGF0aCBkPSJNMTEyMCwxNTAgVjIyNiBRMTEyMCwyNDIgMTEwNCwyNDIgSDQ5NiBRNDgwLDI0MiA0ODAsMjU4IFYzMTYiCiAgICAgICAgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgbWFya2VyLWVuZD0idXJsKCNhcnIpIi8+CiAgPHRleHQgeD0iODAwIiB5PSIyMzAiIGZvbnQtc2l6ZT0iMTMiIGZpbGw9IiM2Qjc2ODYiIHRleHQtYW5jaG9yPSJtaWRkbGUiPmZpcnN0IGNvbnRhY3Qgd2l0aCB0aGUgdGFyZ2V0PC90ZXh0PgoKICA8dGV4dCB4PSIzNCIgeT0iMzAzIiBmb250LXNpemU9IjEyIiBsZXR0ZXItc3BhY2luZz0iMyIgZmlsbD0iIzlBQTVCNCI+MiDCtyBXSEVSRSBOT1RISU5HIExPT0tFRDwvdGV4dD4KCiAgPCEtLSB0YXJnZXQgYW5kIGluY2lkZW50IC0tPgogIDxyZWN0IHg9IjMzMCIgeT0iMzMwIiB3aWR0aD0iMzAwIiBoZWlnaHQ9Ijc2IiByeD0iMTAiIGZpbGw9IiMzNTc4RTUiLz4KICA8dGV4dCB4PSIzNDYiIHk9IjM1OCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iI0JGRDdGQSI+VEFSR0VUPC90ZXh0PgogIDx0ZXh0IHg9IjM0NiIgeT0iMzg0IiBmb250LXNpemU9IjE1IiBmaWxsPSIjRkZGRkZGIj5wcm9kdWN0aW9uIGRhdGFiYXNlPC90ZXh0PgoKICA8cGF0aCBkPSJNNjM0LDM2OCBINzAyIiBmaWxsPSJub25lIiBzdHJva2U9IiM5N0ExQjAiIHN0cm9rZS13aWR0aD0iMS41IiBtYXJrZXItZW5kPSJ1cmwoI2FycikiLz4KCiAgPHJlY3QgeD0iNzEwIiB5PSIzMzAiIHdpZHRoPSIzMDAiIGhlaWdodD0iNzYiIHJ4PSIxMCIgZmlsbD0iI0RDNEM0QyIvPgogIDx0ZXh0IHg9IjcyNiIgeT0iMzU4IiBmb250LXNpemU9IjExIiBsZXR0ZXItc3BhY2luZz0iMi41IiBmaWxsPSIjRjhDQUNBIj5JTkNJREVOVDwvdGV4dD4KICA8dGV4dCB4PSI3MjYiIHk9IjM4NCIgZm9udC1zaXplPSIxNSIgZmlsbD0iI0ZGRkZGRiI+OTBzIGxvY2sgwrcgZnVsbCB2b2x1bWU8L3RleHQ+Cjwvc3ZnPgo=" width="1240" height="470" class="img__Ss2"></p>
<p>That is the loud version. Here is the quiet one.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="a-second-run-on-mysql">A Second Run, on MySQL<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#a-second-run-on-mysql" class="hash-link" aria-label="Direct link to A Second Run, on MySQL" title="Direct link to A Second Run, on MySQL" translate="no">​</a></h3>
<p>A product change adds an <code>on_hold</code> state to <code>orders</code>. This change must account for MySQL's behavior of comparing enum
values by their position in the list, so that queries like <code>WHERE status &lt; 'shipped'</code> return the proper value.
So the <code>spec.md</code> asks to keep the values in lifecycle order, with <code>on_hold</code> between <code>paid</code> and <code>shipped</code>. Claude does
exactly that:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> orders </span><span class="token keyword" style="font-style:italic">MODIFY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">status</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">ENUM</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">'pending'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token string" style="color:rgb(195, 232, 141)">'paid'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token string" style="color:rgb(195, 232, 141)">'on_hold'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token string" style="color:rgb(195, 232, 141)">'shipped'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token string" style="color:rgb(195, 232, 141)">'delivered'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token string" style="color:rgb(195, 232, 141)">'cancelled'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">NOT</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Tests pass, the review sees a one-line enum edit, it merges.</p>
<p>While appending at the end of the enum list would have been a metadata-only change, inserting in the middle changes
what every stored row means. No <code>ALGORITHM=INPLACE</code> or <code>INSTANT</code> exists for this change, necessitating a rewrite for
every row.</p>
<p>The statement silently falls back to <code>ALGORITHM=COPY</code>, creating a full second copy of <code>orders</code> and blocking writes.
<code>orders</code> is 600 GB on a 1 TB volume. An hour in, the volume fills, the copy aborts, and a MySQL server that cannot
write to its data volume stops accepting writes altogether.</p>
<p>Appending <code>on_hold</code> at the end would have been instant, with only the comparison queries needing to change. This was
a trade-off nobody in the chain knew was being made.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="takeaways">Takeaways<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#takeaways" class="hash-link" aria-label="Direct link to Takeaways" title="Direct link to Takeaways" translate="no">​</a></h3>
<p>These are just two common incidents: a lock held longer than the application can tolerate and a rewrite the storage
cannot absorb. In both, every gate fired, every artifact was committed, and nobody made a mistake. Both changes still
became incidents because nothing in the chain ever looked at the target database.</p>
<p>So for the database, the check cannot live after the merge. It has to run before the statement executes. Disciplined
expand/contract migrations keep changes reversible, and that discipline is exactly what an agent will not apply
unless something forces it. This is what we will cover in the following sections.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-recovery-model-is-revert-shaped">The Recovery Model Is Revert-Shaped<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#the-recovery-model-is-revert-shaped" class="hash-link" aria-label="Direct link to The Recovery Model Is Revert-Shaped" title="Direct link to The Recovery Model Is Revert-Shaped" translate="no">​</a></h2>
<p>In the playbook, rollback is called <em>"the most rehearsed path in the pipeline"</em>: a single command, exercised regularly
in staging, that even the agent is allowed to run. Branch protection, <code>REVIEW.md</code>, and tiered autonomy per environment,
all calibrated on the idea that when a bad change slips through, you redeploy the previous image to get back where you
started. Catching problems after the merge is acceptable because the cost of being wrong is a revert.</p>
<p>The two most-read postmortems of the last decade are both database incidents:</p>
<ol>
<li class=""><a href="https://github.blog/news-insights/company-news/oct21-post-incident-analysis/" target="_blank" rel="noopener noreferrer" class="">GitHub's 2018 outage</a>: 24 hours of
untangling a MySQL failover that had accepted writes on two primaries.</li>
<li class=""><a href="https://about.gitlab.com/blog/postmortem-of-database-outage-of-january-31/" target="_blank" rel="noopener noreferrer" class="">GitLab's 2017 outage</a>: one command meant
for the secondary ran on the primary, followed by the discovery that none of their five backup methods had worked.</li>
</ol>
<p>Neither was a code problem. Neither had a revert. Because databases don't work this way.</p>
<p><code>DROP COLUMN</code> has no lossless inverse. A backfill that ran for forty minutes does not un-run. We have written before
about <a class="" href="https://atlasgo.io/blog/2024/04/01/migrate-down">why down migrations do not deliver on their promise</a>. Once production traffic has
written data under the new schema, the down file no longer describes a state you can return to.</p>
<p>They are also the exact inverse of GitOps. Rolling back means deploying an earlier commit, and the earlier commit doesn't
carry the down files for migrations that came after it. The two things a bad schema change actually costs you – downtime
and data loss – are the two things no rollback can undo.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="plans-should-be-computed-not-generated">Plans Should Be Computed, Not Generated<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#plans-should-be-computed-not-generated" class="hash-link" aria-label="Direct link to Plans Should Be Computed, Not Generated" title="Direct link to Plans Should Be Computed, Not Generated" translate="no">​</a></h2>
<p><code>plan.md</code> works for code because the plan and its target both live in the repo. A schema change runs against a database,
and whether it is safe depends on what's there. The repo records how the schema got here, but it doesn't know how
production currently looks.</p>
<p>An agent writing DDL freehand is guessing at that state, so don't have it write migrations at all. Instead, have it
change the schema code in your repo.</p>
<p>Using Atlas, your schema <em>is</em> code, whether written as <a class="" href="https://atlasgo.io/orms">ORM models</a>, SQL files, or <a class="" href="https://atlasgo.io/hcl/docs">HCL</a>:</p>
<div class="language-diff codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">git diff db/schema.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-diff codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token unchanged prefix unchanged"> </span><span class="token unchanged line">CREATE TABLE users (</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token unchanged line"></span><span class="token unchanged prefix unchanged"> </span><span class="token unchanged line">  id    bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token unchanged line"></span><span class="token deleted-sign deleted prefix deleted" style="color:rgb(255, 85, 114)">-</span><span class="token deleted-sign deleted line" style="color:rgb(255, 85, 114)">  email text NOT NULL,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token deleted-sign deleted line" style="color:rgb(255, 85, 114)"></span><span class="token inserted-sign inserted prefix inserted" style="color:rgb(195, 232, 141)">+</span><span class="token inserted-sign inserted line" style="color:rgb(195, 232, 141)">  email text NOT NULL UNIQUE,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token inserted-sign inserted line" style="color:rgb(195, 232, 141)"></span><span class="token unchanged prefix unchanged"> </span><span class="token unchanged line">  name  text</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token unchanged line"></span><span class="token unchanged prefix unchanged"> </span><span class="token unchanged line">);</span><br></span></code></pre></div></div>
<p>Then, let Atlas compute the migration from it:</p>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate </span><span class="token function" style="color:rgb(130, 170, 255)">diff</span><span class="token plain"> add_unique_email </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">local</span><br></span></code></pre></div></div>
<p>Every change to the schema code becomes a revision in the schema history: a migration file in the <a class="" href="https://atlasgo.io/versioned/intro">versioned
workflow</a>, or a plan in the <a class="" href="https://atlasgo.io/declarative/apply">declarative</a> one. The schema at version X is the
result of replaying all files up to X, and Atlas verifies that this result matches the schema code at that commit. The
history and code cannot drift apart, and the plan produced is approved by a human, not a model.</p>
<p>How a change becomes a migration is a <a class="" href="https://atlasgo.io/atlas-schema/projects#configure-diff-policy">diff policy</a> you set once. The
same schema change can be achieved by different migrations, as long as the database ends in the same state. For example,
making a column <code>NOT NULL</code> can be one blocking <code>ALTER</code>, or a <a class="" href="https://atlasgo.io/guides/lock-safe-not-null">lock-safe sequence</a> with a
pre-migration check. The policy decides which one Atlas plans. Backfills and data migrations are still written by hand
(or by agent) and pass through the same gates below.</p>
<p>The playbook also recommends running several Claude Code sessions in parallel worktrees. Git merges their code, but
migration directories don't merge because they are a linear history. Two sessions can add a migration on the same
base and both look fine in their individual branches, but the merged directory registers the inconsistency. Atlas
<a class="" href="https://atlasgo.io/concepts/migration-directory-integrity">verifies the directory's integrity</a> in CI, so the last branch to merge fails
until it rebases. This is why many teams go declarative: the schema code merges like any other code.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-feedback-loop-the-playbook-asks-for">The Feedback Loop the Playbook Asks For<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#the-feedback-loop-the-playbook-asks-for" class="hash-link" aria-label="Direct link to The Feedback Loop the Playbook Asks For" title="Direct link to The Feedback Loop the Playbook Asks For" translate="no">​</a></h2>
<p>Stage 4 has the best rule in the playbook: the agent always gets a way to verify its own work (tests, a build, a
screenshot diff) and iterates until the check passes, before a human sees anything.</p>
<p>Agreed. But traditional testing is unaware of the database. A test suite checks what the application does, but says
nothing about what a migration does to the target it runs against. That is why the tests passed in both runs above:
on an empty development database, nearly every dangerous migration looks fine, because the danger lives in data
volume, lock behavior, and what a specific engine does with a specific <code>ALTER</code>. The agent knows the safe patterns
and ships the locking <code>ALTER</code> anyway.</p>
<p>Knowledge was never the gap. Enforcement is.</p>
<p>So the feedback signal has to come from database-aware tooling. Atlas validates the semantics of the change by
replaying it on the dev database, introspecting the result, and classifying what it finds by how it breaks production:</p>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate lint </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> ci </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--latest</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><br></span></code></pre></div></div>
<div class="language-lintlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-lintlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">-- analyzing version </span><span class="token version">20260824093214</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token category">data dependent changes detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token severity">L1</span><span class="token plain">: Adding a unique index </span><span class="token ident">"users_email_key"</span><span class="token plain"> on table </span><span class="token ident">"users"</span><span class="token plain"> might fail</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">           in case column </span><span class="token ident">"email"</span><span class="token plain"> contains duplicate entries</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token category">concurrent index violations detected:</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token severity">L1</span><span class="token plain">: Adding a UNIQUE constraint </span><span class="token ident">"users_email_key"</span><span class="token plain"> acquires an ACCESS EXCLUSIVE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">           lock on table </span><span class="token ident">"users"</span><span class="token plain">, blocking all access during the operation</span><br></span></code></pre></div></div>
<p>That is a verdict the agent can act on inside the session with no human in the loop. Give it that signal and it
fixes its own migration by building the index concurrently, then attaching the constraint as a brief, metadata-only
operation:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- atlas:txmode none</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> CONCURRENTLY users_email_key </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> users </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">email</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> users </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">CONSTRAINT</span><span class="token plain"> users_email_key </span><span class="token keyword" style="font-style:italic">UNIQUE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">USING</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> users_email_key</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p><a class="" href="https://atlasgo.io/testing/migrate"><code>atlas migrate test</code></a> extends the same signal to behavior. If a migration carries backfill or
data-migration logic, a test case exercises it on an ephemeral database: seed data, migrate forward, assert on the
result. The same red/green loop the agent already iterates against, for the statements whose correctness depends on
what the data contains.</p>
<p>With Atlas, several analyzers warn by default. A warning is advice, and agents route around advice. <code>error = true</code>
turns the linter into a gate:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">destructive</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">data_depend</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">concurrent_index</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">non_linear</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Enum insert that copies the table.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  check </span><span class="token string" style="color:rgb(195, 232, 141)">"MY112"</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Wire this into CI the way the playbook wires evals, and the agent stops shipping these changes that look fine
in a diff and to a reviewer. The catalog behind it is engine-specific by design: which PostgreSQL operations take
an <code>ACCESS EXCLUSIVE</code> lock, which MySQL operations fall back to a table copy, where an enum edit turns from instant
into hours-long. The knowledge senior DBAs carry around is encoded as checks an agent has to pass.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="a-hook-in-the-agent-is-a-preference-not-a-boundary">A Hook in the Agent Is a Preference, Not a Boundary<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#a-hook-in-the-agent-is-a-preference-not-a-boundary" class="hash-link" aria-label="Direct link to A Hook in the Agent Is a Preference, Not a Boundary" title="Direct link to A Hook in the Agent Is a Preference, Not a Boundary" translate="no">​</a></h2>
<p>The playbook is not naive about enforcement: permission rules, <code>PreToolUse</code> hooks, sandboxing, scoped credentials,
managed settings engineers cannot override. All of them govern the actor. None of them can see whether the database is
in the state the migration assumed, or what this DDL costs on this table at this size. A hook can stop Claude from
running <code>psql</code>, but it can't know that the <code>ALTER</code> it just permitted holds an exclusive lock for 90 seconds, or that
the target has drifted since the plan was computed.</p>
<p>And the database has a route to production via a connection string, which never passes through a merge. Any process
that can open a connection can change the schema, and you cannot block every tool an agent might use to open one.</p>
<p>So the gate moves to the write path, and the write path gets narrowed until it is actually singular:</p>
<ul>
<li class="">No standing DDL credentials for engineers, agents, or application services. Application roles are DML-only.</li>
<li class="">One deployment identity, held by the migration runner, can change schema, and it executes only approved artifacts.</li>
<li class="">Every plan is computed against an assumed state: the database is at revision X, the data satisfies Y. Before
executing, the assumption must hold. Atlas enforces it with a pre-deployment drift check and
<a class="" href="https://atlasgo.io/versioned/checks">pre-migration checks</a>, assertions evaluated on the live database in the same connection; if
either fails, nothing executes and the deployment stops until the drift is resolved.</li>
<li class="">Break-glass DDL still exists, because production. It is audited, and it surfaces as drift the moment it happens.</li>
</ul>
<p>The playbook draws a sharp line between skills and hooks: skills make violations rare, hooks make them close to
impossible. Same line, one layer down. Instructions and lint make bad migrations rare. A single governed identity
with checks on the connection makes ungoverned ones close to impossible, for humans, pipelines, and agents alike.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="drift-closes-the-loop">Drift Closes the Loop<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#drift-closes-the-loop" class="hash-link" aria-label="Direct link to Drift Closes the Loop" title="Direct link to Drift Closes the Loop" translate="no">​</a></h2>
<p>Stage 6 closes the playbook's loop: a script watches a metric, invokes Claude on a breach, and the diagnosis re-enters
Stage 1 as a new <code>intent.md</code>. For the database, the metric is drift. Drift means something wrote outside the governed
path, so the deployed schema no longer matches the declared one. Atlas <a class="" href="https://atlasgo.io/monitoring">monitors for it continuously</a> and
checks for it right before an apply, so a migration planned against a stale picture of production fails loudly instead
of guessing. CI checks the code, and CD checks production.</p>
<p>But drift needs something to compare against, and that is where git's role ends. Git is the system of record for
declared intent, not for the deployed state, because a database's state is a fact about the world, not the repo. Git
cannot tell you which schema revision <code>eu-west-1</code> is on, whether it matches <code>us-east-1</code>, or which of the last forty
agent-authored migrations actually applied.</p>
<p>That is the job of the <a class="" href="https://atlasgo.io/cloud/features/registry">schema registry</a>: the versioned source of truth used for detecting
drift and computing plans. It's also where an auditor looks when they ask who changed that column, under which approval,
deployed when. The playbook's audit trail, extended to the one system that outlives every deploy.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-databases-chapter-of-the-playbook">The Database's Chapter of the Playbook<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#the-databases-chapter-of-the-playbook" class="hash-link" aria-label="Direct link to The Database's Chapter of the Playbook" title="Direct link to The Database's Chapter of the Playbook" translate="no">​</a></h2>
<p>Nothing structural changes. The six stages are correct, the artifact chain is correct. The database just needs its own
artifact and its own gate at each stage, a chapter we have been writing since long before agents could write DDL:</p>
<div class="playbook-table"><table><thead><tr><th>Playbook control</th><th>Database equivalent</th></tr></thead><tbody><tr><td><code>spec.md</code>, reviewed by the product owner</td><td>Schema as code in the repo, reviewed the same way</td></tr><tr><td><code>plan.md</code>, written in plan mode</td><td>Migration computed from authoritative state</td></tr><tr><td>Tests as the agent's feedback loop</td><td>Migration safeguards and testing, in the session and in CI</td></tr><tr><td><code>PreToolUse</code> hooks inside the agent</td><td>A governed identity with checks on the connection</td></tr><tr><td>Control bands on production metrics</td><td>Drift detection against the registry</td></tr><tr><td>Git as the audit trail</td><td>Schema registry as the system of record</td></tr></tbody></table></div>
<p>Wired together, the loop closes the same way the playbook's does:</p>
<p><img decoding="async" loading="lazy" alt="The six-stage loop with the database&amp;#39;s gates, revolving around the schema registry" src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMjQwIDQ3MCIgZm9udC1mYW1pbHk9InVpLW1vbm9zcGFjZSxTRk1vbm8tUmVndWxhcixNZW5sbyxDb25zb2xhcywnTGliZXJhdGlvbiBNb25vJyxtb25vc3BhY2UiPgogIDxkZWZzPgogICAgPG1hcmtlciBpZD0iYXJyMiIgdmlld0JveD0iMCAwIDEwIDEwIiByZWZYPSI3LjUiIHJlZlk9IjUiIG1hcmtlcldpZHRoPSI3IiBtYXJrZXJIZWlnaHQ9IjciIG9yaWVudD0iYXV0by1zdGFydC1yZXZlcnNlIj4KICAgICAgPHBhdGggZD0iTTAsMSBMOSw1IEwwLDkgTDIuMiw1IHoiIGZpbGw9IiM5N0ExQjAiLz4KICAgIDwvbWFya2VyPgogIDwvZGVmcz4KICA8cmVjdCB4PSIxIiB5PSIxIiB3aWR0aD0iMTIzOCIgaGVpZ2h0PSI0NjgiIHJ4PSIxOCIgZmlsbD0iI0Y2RjhGQSIgc3Ryb2tlPSIjRTVFQUYwIiBzdHJva2Utd2lkdGg9IjEuNSIvPgoKICA8IS0tIGxvb3AgYmFjayBlZGdlIC0tPgogIDxwYXRoIGQ9Ik0xMDc2LDEwMiBWNjggUTEwNzYsNTIgMTA2MCw1MiBIMTgwIFExNjQsNTIgMTY0LDY4IFY5OCIKICAgICAgICBmaWxsPSJub25lIiBzdHJva2U9IiM5N0ExQjAiIHN0cm9rZS13aWR0aD0iMS41IiBtYXJrZXItZW5kPSJ1cmwoI2FycjIpIi8+CiAgPHRleHQgeD0iNjIwIiB5PSI0MiIgZm9udC1zaXplPSIxMyIgZmlsbD0iIzZCNzY4NiIgdGV4dC1hbmNob3I9Im1pZGRsZSI+ZHJpZnQgYmVjb21lcyBhIG5ldyBpbnRlbnQubWQ8L3RleHQ+CgogIDwhLS0gc3RhZ2Ugcm93IC0tPgogIDxnPgogICAgPHJlY3QgeD0iNjIiICB5PSIxMTAiIHdpZHRoPSIyMDQiIGhlaWdodD0iODgiIHJ4PSIxMCIgZmlsbD0iIzExMTgyNyIvPgogICAgPHRleHQgeD0iNzgiICB5PSIxNDAiIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPlBMQU4gwrcgREVTSUdOPC90ZXh0PgogICAgPHRleHQgeD0iNzgiICB5PSIxNjgiIGZvbnQtc2l6ZT0iMTQiIGZpbGw9IiNGRkZGRkYiPnNjaGVtYSBhcyBjb2RlPC90ZXh0PgoKICAgIDxyZWN0IHg9IjI5MCIgeT0iMTEwIiB3aWR0aD0iMjA0IiBoZWlnaHQ9Ijg4IiByeD0iMTAiIGZpbGw9IiMxMTE4MjciLz4KICAgIDx0ZXh0IHg9IjMwNiIgeT0iMTQwIiBmb250LXNpemU9IjExIiBsZXR0ZXItc3BhY2luZz0iMi41IiBmaWxsPSIjOEI5NkE1Ij5CVUlMRDwvdGV4dD4KICAgIDx0ZXh0IHg9IjMwNiIgeT0iMTY4IiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5jb21wdXRlZCBtaWdyYXRpb248L3RleHQ+CgogICAgPHJlY3QgeD0iNTE4IiB5PSIxMTAiIHdpZHRoPSIyMDQiIGhlaWdodD0iODgiIHJ4PSIxMCIgZmlsbD0iIzExMTgyNyIvPgogICAgPHRleHQgeD0iNTM0IiB5PSIxNDAiIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPlRFU1Q8L3RleHQ+CiAgICA8dGV4dCB4PSI1MzQiIHk9IjE2OCIgZm9udC1zaXplPSIxNCIgZmlsbD0iI0ZGRkZGRiI+bWlncmF0aW9uIHNhZmVndWFyZHM8L3RleHQ+CgogICAgPHJlY3QgeD0iNzQ2IiB5PSIxMTAiIHdpZHRoPSIyMDQiIGhlaWdodD0iODgiIHJ4PSIxMCIgZmlsbD0iIzExMTgyNyIvPgogICAgPHRleHQgeD0iNzYyIiB5PSIxNDAiIGZvbnQtc2l6ZT0iMTEiIGxldHRlci1zcGFjaW5nPSIyLjUiIGZpbGw9IiM4Qjk2QTUiPkRFUExPWTwvdGV4dD4KICAgIDx0ZXh0IHg9Ijc2MiIgeT0iMTYyIiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5nb3Zlcm5lZCBpZGVudGl0eTwvdGV4dD4KICAgIDx0ZXh0IHg9Ijc2MiIgeT0iMTgyIiBmb250LXNpemU9IjE0IiBmaWxsPSIjRkZGRkZGIj5wcmUtbWlncmF0aW9uIGNoZWNrczwvdGV4dD4KCiAgICA8cmVjdCB4PSI5NzQiIHk9IjExMCIgd2lkdGg9IjIwNCIgaGVpZ2h0PSI4OCIgcng9IjEwIiBmaWxsPSIjMTExODI3Ii8+CiAgICA8dGV4dCB4PSI5OTAiIHk9IjE0MCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iIzhCOTZBNSI+TUFJTlRBSU48L3RleHQ+CiAgICA8dGV4dCB4PSI5OTAiIHk9IjE2OCIgZm9udC1zaXplPSIxNCIgZmlsbD0iI0ZGRkZGRiI+ZHJpZnQgZGV0ZWN0aW9uPC90ZXh0PgogIDwvZz4KCiAgPCEtLSBzdGFnZS10by1zdGFnZSBhcnJvd3MgLS0+CiAgPHBhdGggZD0iTTI2OCwxNTQgSDI4MyIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgbWFya2VyLWVuZD0idXJsKCNhcnIyKSIvPgogIDxwYXRoIGQ9Ik00OTYsMTU0IEg1MTEiIGZpbGw9Im5vbmUiIHN0cm9rZT0iIzk3QTFCMCIgc3Ryb2tlLXdpZHRoPSIxLjUiIG1hcmtlci1lbmQ9InVybCgjYXJyMikiLz4KICA8cGF0aCBkPSJNNzI0LDE1NCBINzM5IiBmaWxsPSJub25lIiBzdHJva2U9IiM5N0ExQjAiIHN0cm9rZS13aWR0aD0iMS41IiBtYXJrZXItZW5kPSJ1cmwoI2FycjIpIi8+CiAgPHBhdGggZD0iTTk1MiwxNTQgSDk2NyIgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgbWFya2VyLWVuZD0idXJsKCNhcnIyKSIvPgoKICA8IS0tIHJlZ2lzdHJ5IC0tPgogIDxyZWN0IHg9IjQ3MCIgeT0iMzQwIiB3aWR0aD0iMzAwIiBoZWlnaHQ9Ijc2IiByeD0iMTAiIGZpbGw9IiMzNTc4RTUiLz4KICA8dGV4dCB4PSI0ODYiIHk9IjM2OCIgZm9udC1zaXplPSIxMSIgbGV0dGVyLXNwYWNpbmc9IjIuNSIgZmlsbD0iI0JGRDdGQSI+UkVHSVNUUlk8L3RleHQ+CiAgPHRleHQgeD0iNDg2IiB5PSIzOTQiIGZvbnQtc2l6ZT0iMTUiIGZpbGw9IiNGRkZGRkYiPnN5c3RlbSBvZiByZWNvcmQ8L3RleHQ+CgogIDwhLS0gZG90dGVkIHJvdXRlcyB0byByZWdpc3RyeSAtLT4KICA8cGF0aCBkPSJNMzkyLDIwMiBWMjg2IFEzOTIsMzAwIDQwNiwzMDAgSDUyNiBRNTQwLDMwMCA1NDAsMzE0IFYzMzIiCiAgICAgICAgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgc3Ryb2tlLWRhc2hhcnJheT0iMiA2IiBzdHJva2UtbGluZWNhcD0icm91bmQiIG1hcmtlci1lbmQ9InVybCgjYXJyMikiLz4KICA8cGF0aCBkPSJNODQ4LDIwMiBWMjg2IFE4NDgsMzAwIDgzNCwzMDAgSDcxNCBRNzAwLDMwMCA3MDAsMzE0IFYzMzIiCiAgICAgICAgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjOTdBMUIwIiBzdHJva2Utd2lkdGg9IjEuNSIgc3Ryb2tlLWRhc2hhcnJheT0iMiA2IiBzdHJva2UtbGluZWNhcD0icm91bmQiIG1hcmtlci1lbmQ9InVybCgjYXJyMikiLz4KICA8cGF0aCBkPSJNMTA3NiwyMDIgVjM2NCBRMTA3NiwzNzggMTA2MiwzNzggSDc4MCIKICAgICAgICBmaWxsPSJub25lIiBzdHJva2U9IiM5N0ExQjAiIHN0cm9rZS13aWR0aD0iMS41IiBzdHJva2UtZGFzaGFycmF5PSIyIDYiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIgbWFya2VyLWVuZD0idXJsKCNhcnIyKSIvPgo8L3N2Zz4K" width="1240" height="470" class="img__Ss2"></p>
<p>If you are implementing the playbook, sequence matters. Schema-as-code plus lint in CI is a day of setup for your
first service and removes the largest class of agent-caused database incidents. The governed write path comes second,
parallel sessions third: gates before throughput, the ordering the playbook itself uses. None of this is speculative.</p>
<p>It is how our customers like
<a class="" href="https://atlasgo.io/blog/2024/12/11/unico-case-study-platform-engineering-devops-database-gap-solve-with-atlas">Unico</a> and
<a class="" href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai">EliseAI</a> already run schema changes: through one pipeline that doesn't care
whether the author was a human or an agent.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-gets-harder-from-here">What Gets Harder from Here<a href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database#what-gets-harder-from-here" class="hash-link" aria-label="Direct link to What Gets Harder from Here" title="Direct link to What Gets Harder from Here" translate="no">​</a></h2>
<p>Everything above ships today. Two questions remain: <em>"Is this change destructive?" and "Is anything still reading this column?"</em></p>
<p>The former is answerable from the change itself, but the latter is not. Atlas's
<a class="" href="https://atlasgo.io/lint/analyzers#backward-incompatible-changes">backward-compatibility checks</a> warn on changes that can break deployed
clients, but the full answer lives in runtime traffic and deployed application versions, and that contract needs
stricter enforcement than a warning. It is the answer an agent needs before it drops anything.</p>
<p>And once many agents change shared state concurrently, rebase ordering stops being enough. The system has to know
which changes commute, which depend on each other, and which conflict. Git merges text; it will not do this.</p>
<p>That is the direction we are building Atlas toward: not agents that write better SQL, but a system that makes
autonomous database evolution safe enough for enterprises to allow.</p>
<p>The playbook signs off with the loop running and human judgment above it. Just make sure your database is inside the
loop. It is the one part of your system an agent can change and cannot un-change.</p>]]></content:encoded>
            <category>ai agents</category>
            <category>sdlc</category>
            <category>migrations</category>
            <category>schema-as-code</category>
            <category>drift detection</category>
            <category>claude code</category>
        </item>
        <item>
            <title><![CDATA[Case Study: How Health in Tech Maintains Databases and Security Compliance with Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech</link>
            <guid>https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech</guid>
            <pubDate>Tue, 11 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Learn how Health in Tech replaced manual, error-prone schema migrations with Atlas's declarative model to eliminate outages, enforce guardrails, and meet compliance requirements in a regulated industry.]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><em>"Everybody should be using Atlas. If anyone is still trying to manage their database objects in some
more traditional way, they really need to get on board and start using Atlas."</em></p>
<p>– Kevin Hochhalter, VP of IT Operations, Health in Tech</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background">Company Background<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#company-background" class="hash-link" aria-label="Direct link to Company Background" title="Direct link to Company Background" translate="no">​</a></h3>
<p><a href="https://healthintech.com/" target="_blank" rel="noopener noreferrer" class="">Health in Tech</a> (Nasdaq: HIT) is an AI-driven insurtech company that automates
and streamlines self-funded health insurance plans for small and medium-sized businesses. Through integrated
platforms like its eDIYBS quoting engine and HI Card claims system, Health in Tech reduces administrative
friction across underwriting, risk management, and network pricing workflows, letting brokers, carriers, and
third-party administrators design, price, and bind customized health plans within minutes.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="managing-migrations-manually">Managing Migrations Manually<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#managing-migrations-manually" class="hash-link" aria-label="Direct link to Managing Migrations Manually" title="Direct link to Managing Migrations Manually" translate="no">​</a></h3>
<p>Before Atlas, Health in Tech managed schema changes the way many teams still do: by hand. Migrations were
scripted and applied manually, following a traditional DBA workflow that dated back to the mid-90s. That
kind of process can work well enough at a small scale, but it depends on every change, environment, and
dependency being tracked correctly across the board. That gets harder to guarantee as the number of
environments and the pace of change grow.</p>
<p>Eventually, the gaps that model leaves open showed up in practice with a batch of changes that had to be
rolled back due to tracking errors, causing a full 20-minute outage. Separately, a database constraint that
was present in other environments failed to propagate to production, corrupting data and costing hours of
manual work to track down and fix. Underlying both incidents was the same root problem: manual processes
make it extremely difficult to see how schemas differ across environments, and to manage those differences
as things scale.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="looking-for-a-terraform-for-databases">Looking for a Terraform for Databases<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#looking-for-a-terraform-for-databases" class="hash-link" aria-label="Direct link to Looking for a Terraform for Databases" title="Direct link to Looking for a Terraform for Databases" translate="no">​</a></h3>
<p>When Kevin Hochhalter, VP of IT Operations, took over database management at Health in Tech, he brought a
clear idea of what a fix should look like. The team already trusted Terraform and Ansible to manage its
compute infrastructure declaratively, and Kevin wanted the same model for its databases: describe the
desired state, and let the tool calculate how to get there.</p>
<p>That search led the team to Atlas roughly two years ago, and they began rolling it out to manage schemas
across their growing set of environments.</p>
<p>Today, Health in Tech runs a more conservative but far more reliable process: developers submit tickets
describing the change they need, the database team validates the request, and Atlas applies it through a
CI/ CD pipeline that enforces structural integrity before anything reaches production.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="declarative-migrations-and-built-in-guardrails">Declarative Migrations and Built-In Guardrails<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#declarative-migrations-and-built-in-guardrails" class="hash-link" aria-label="Direct link to Declarative Migrations and Built-In Guardrails" title="Direct link to Declarative Migrations and Built-In Guardrails" translate="no">​</a></h3>
<p>For Kevin, the core value of Atlas comes down to the same declarative model that won the team over to
Terraform in the first place. <em>"Where Atlas really shines is in its declarative migrations. It gives me
the ability to examine the current state of the infrastructure and calculate how I can move to the desired
state. It’s brilliant."</em></p>
<p>Instead of tracking by memory whether a change has shipped to a given environment, the team gives Atlas a
schema definition and trusts it to compute the exact SQL required to get there, idempotently, every time.
That confidence extends to release day. <em>"We don't spend 45 minutes backing up the database before we do a
commercial release because Atlas has earned our trust,"</em> Kevin said. Atlas's dry-run capability lets the
team preview exactly what a migration will do before it runs, removing the uncertainty that made those
backups necessary.</p>
<p>Health in Tech also uses custom linting policies to keep guardrails in place around that trust. Policies
block the accidental dropping of tables or schemas outright, and exclude specific partitions, such as those
managed by <code>pg_partman</code>, from Atlas's management entirely, so the tool never touches objects it shouldn't.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="meeting-audit-requirements-with-atlas-cloud">Meeting Audit Requirements With Atlas Cloud<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#meeting-audit-requirements-with-atlas-cloud" class="hash-link" aria-label="Direct link to Meeting Audit Requirements With Atlas Cloud" title="Direct link to Meeting Audit Requirements With Atlas Cloud" translate="no">​</a></h3>
<p>As a company operating in a heavily regulated industry, compliance isn't optional, and Atlas Cloud has become
the team's source of truth for proving it. <em>"There are many compliance measures that I have to keep track of,"</em>
Kevin said. <em>"Atlas Cloud is a great resource. It's always available and up-to-date. It satisfies my compliance
requirements and I absolutely love that."</em></p>
<p>Atlas Cloud's record of who applied which migration, to which database, and what SQL was actually generated
gives Kevin the evidence he needs for security audits on demand. <em>"I had to provide evidence about how we
manage these things, and I could easily go into Atlas Cloud and pull them out,"</em> he said. Atlas Cloud also
serves as the team's central hub for Entity Relationship Diagrams (ERDs), giving everyone a current, shared
picture of the schema without anyone maintaining diagrams by hand.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome">The Outcome<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#the-outcome" class="hash-link" aria-label="Direct link to The Outcome" title="Direct link to The Outcome" translate="no">​</a></h3>
<p>Two years in, Atlas has become the team's default answer for schema management. <em>"Atlas is our go-to schema
management product. It has been integral in managing database schemas while expanding our products and
environments,"</em> Kevin said. What used to be a human-led process prone to outages and silent data integrity
failures is now a controlled, auditable pipeline:</p>
<ul>
<li class=""><strong>Fewer late nights fighting fires:</strong> With outages and data corruption no longer traced back to tracking
errors, Kevin's team spends its time on database strategy instead of post-incident cleanup.</li>
<li class=""><strong>Audits that take hours, not weeks:</strong> What used to mean digging through logs and memory to reconstruct a
change history now means pulling a report from Atlas Cloud, freeing Kevin up ahead of audit season.</li>
<li class=""><strong>Changes don’t go rogue:</strong> With destructive changes blocked automatically, the team can move faster on
routine schema requests without a second set of human eyes on every single one.</li>
<li class=""><strong>Capital freed up for the business:</strong> Cutting the pre-release backup ritual isn't just a time save, it's
one less recurring cost standing between the team and shipping commercial releases on schedule.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started">Getting Started<a href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech#getting-started" class="hash-link" aria-label="Direct link to Getting Started" title="Direct link to Getting Started" translate="no">​</a></h3>
<p>If your team is still managing schema changes through manual scripts or tribal knowledge, the risks Health
in Tech faced (such as unpredictable outages, silent data integrity failures, and audit evidence nobody can
easily produce) tend to compound as the system grows.</p>
<p>If you already trust a declarative model like Terraform for your infrastructure and want the same guarantees
for your databases, or you operate in a regulated industry that needs a clear, auditable record of every
schema change, Atlas could be the solution for you.</p>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[Atlas v1.3: Security Graph for Databases, Atlas Scripts, the atlas cloud Command, and More]]></title>
            <link>https://atlasgo.io/blog/2026/07/30/atlas-v1-3</link>
            <guid>https://atlasgo.io/blog/2026/07/30/atlas-v1-3</guid>
            <pubDate>Thu, 30 Jul 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Atlas v1.3 introduces the security graph for permissions, misconfigurations, and CVEs across your databases, Atlas Scripts for running data operations as code, the atlas cloud command group for managing the Registry from the terminal, lock-safe NOT NULL migrations, and 8x-10x faster schema tests.]]></description>
            <content:encoded><![CDATA[<p>Hey everyone!</p>
<p>We're excited to announce <a href="https://github.com/ariga/atlas/releases/tag/v1.3.0" target="_blank" rel="noopener noreferrer" class="">Atlas v1.3</a>. This
release delivers on a promise we made in v1.2: the security graph is now live in Atlas Cloud,
mapping your entire database attack surface. It also introduces Atlas Scripts for running
data operations as code, safer and faster migrations, and a new command group for working with the
Atlas Registry from the CLI.</p>
<p>Here is what you can find in this release:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#security-graph-for-databases">Security Graph for Databases</a></strong> - Map your entire database attack surface: permissions, misconfigurations, and CVEs across every object, with severity tiers and blast-radius tracing.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#atlas-scripts-dataops-as-code">Atlas Scripts: DataOps as Code</a></strong> - Backfills, GDPR purges, and reports declared as code: transactional mutations, masked queries, and batched loops, reviewed and tested in CI.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#atlas-cloud-manage-registry-resources-from-the-cli"><code>atlas cloud</code>: Manage Registry Resources from the CLI</a></strong> - Repositories, databases, and deployment history from the terminal, with JSON output for scripts, CI gates, and AI agents, plus security graph and lineage graph exports.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#schema-annotations">Schema Annotations</a></strong> - Attach type-safe metadata to schema resources and render GraphQL, OpenAPI, or any other format from it with templates.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#pre-apply-drift-detection">Pre-Apply Drift Detection</a></strong> - Block a deployment when the database drifted from the expected state, with the diff printed before any statement runs.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#database-driver-improvements">Database Driver Improvements</a></strong> - Lock-safe NOT NULL and 8x-10x faster schema tests on PostgreSQL, Oracle roles and storage, Snowflake Iceberg tables, ClickHouse row policies, and more.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#simpler-licensing-and-no-ai-training">Simpler Licensing and No AI Training</a></strong> - One agreement replaces the separate EULA and SaaS terms, with a written commitment that we never train AI models on your data.</li>
</ul>
<!-- -->
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">macOS + Linux</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Homebrew</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Docker</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Windows</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">CI</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Manual Installation</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>To download and install the latest release of the Atlas CLI, simply run the following in your terminal:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-sSf</span><span class="token plain"> https://atlasgo.sh </span><span class="token operator" style="color:rgb(137, 221, 255)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">sh</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Get the latest release with <a href="https://brew.sh/" target="_blank" rel="noopener noreferrer" class="">Homebrew</a>:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">brew </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> ariga/tap/atlas</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>To pull the Atlas image and run it as a Docker container:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> pull arigaio/atlas</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> arigaio/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--help</span><br></span></code></pre></div></div><p>If the container needs access to the host network or a local directory, use the <code>--net=host</code> flag and mount the desired
directory:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--net</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">host </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-v</span><span class="token plain"> </span><span class="token variable" style="color:rgb(191, 199, 213)">$(</span><span class="token variable builtin class-name" style="color:rgb(255, 203, 107)">pwd</span><span class="token variable" style="color:rgb(191, 199, 213)">)</span><span class="token plain">/migrations:/migrations </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arigaio/atlas migrate apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"mysql://root:pass@:3306/test"</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Download the <a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" target="_blank" rel="noopener noreferrer" class="">latest release</a> and
move the atlas binary to a file location on your system PATH.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><strong>GitHub Actions</strong></p><p>Use the <a href="https://github.com/marketplace/actions/setup-atlas" target="_blank" rel="noopener noreferrer" class="">setup-atlas</a> action to install Atlas in your GitHub Actions workflow:</p><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ariga/setup</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">atlas@v0</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">with</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">cloud-token</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> secrets.ATLAS_CLOUD_TOKEN </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p><strong>Other CI Platforms</strong></p><p>For other CI/CD platforms, use the installation script. See the <a class="" href="https://atlasgo.io/integrations#cicd-platforms">CI/CD integrations</a> for more details.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>If you want to manually install the Atlas CLI, pick one of the below builds suitable for your system.</p><div class="grid grid-cols-1 lg:grid-cols-3 auto-cols-fr gap-4 mt-4"><div class="flex flex-col gap-4"><h3>MacOS</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Linux</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Windows</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="security-graph-for-databases">Security Graph for Databases<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#security-graph-for-databases" class="hash-link" aria-label="Direct link to Security Graph for Databases" title="Direct link to Security Graph for Databases" translate="no">​</a></h2>
<p>Who can access what, and why? Answering that usually means cross-referencing <code>GRANT</code> statements
and role memberships scattered across dozens of migration files, and access does not stop at
tables: functions, triggers, views, and extensions carry privileges of their own. The security
graph replaces that manual audit by mapping your entire database attack surface:</p>
<ul>
<li class="">Trace full access paths across users, roles, and schema objects.</li>
<li class="">Map every function, trigger, view, and extension along with their privileges.</li>
<li class="">Identify extension CVEs, unmaintained code, and direct usage.</li>
<li class="">Surface missing RLS, <code>PUBLIC</code> grants, and excessive privileges.</li>
</ul>
<p>Every object in your code or your database is plotted on one graph, with grant and inheritance
relationships as edges. Analyzers run on every push and color each object by its highest-severity finding, from CVEs
scored by CVSS to privilege-escalation paths such as <code>SECURITY DEFINER</code> functions. Selecting an
object highlights its blast radius: everything it affects or is affected by, traced transitively
through grants and inheritance.</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/security-graph/blast-radius.png" alt="Atlas Cloud Security Graph highlighting the blast radius of a selected role" width="100%"><p style="font-size:12px">Selecting a role highlights everything it can reach</p></div>
<p>The graph works for schema repositories, migration directories, and monitored databases, so it
reflects what a change is about to introduce, not just what is already live in production. It is also
available from the CLI as a nodes and edges JSON graph, ready for a CI gate or an AI agent's context:</p>
<div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas cloud repo secgraph </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--slug</span><span class="token plain"> my-repo </span><span class="token operator" style="color:rgb(137, 221, 255)">|</span><span class="token plain"> jq </span><span class="token string" style="color:rgb(195, 232, 141)">'.nodes[] | select(.reports[]?.level == "critical")'</span><br></span></code></pre></div></div>
<p>To learn more, see the <a class="" href="https://atlasgo.io/cloud/features/security-graph">security graph documentation</a> and the
<a class="" href="https://atlasgo.io/guides/security-as-code">Security as Code guides</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-scripts-dataops-as-code">Atlas Scripts: DataOps as Code<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#atlas-scripts-dataops-as-code" class="hash-link" aria-label="Direct link to Atlas Scripts: DataOps as Code" title="Direct link to Atlas Scripts: DataOps as Code" translate="no">​</a></h2>
<p>Schema migrations change the shape of your database. Atlas Scripts, introduced in this release,
change or read the data. A migration is applied once per database, in order, and recorded in the
migration history. A script runs whenever invoked and leaves no trace in that history. For this
reason, it carries its own guards: condition gates, assertions, and batch bounds. Atlas Scripts are
similar to Terraform Actions, but for your database: the Day 2 work that comes after the schema is
in place.</p>
<p>Scripts come in three kinds, each with its own command: <code>atlas script loop</code> runs batched work with
pacing and back-pressure controls, <code>atlas script query</code> runs reads with output masking, and <code>atlas script exec</code> runs transactional mutations. Each run streams a per-step report of everything it did,
and <code>--quiet</code> prints only the script's output:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Batched Deletion</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Masked Report</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Backfill</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">purge.script.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"loop"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"purge_inactive"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  iterator </span><span class="token class-name" style="color:rgb(255, 203, 107)">"keyset"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">cursor</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      id </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token builtin" style="color:rgb(130, 170, 255)">int</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">init</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sql</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> active = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">0</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">ORDER</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">BY</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">LIMIT</span><span class="token sql-attr"> </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">500</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">next</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sql</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> active = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">0</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">AND</span><span class="token sql-attr"> id &gt; ? </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">ORDER</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">BY</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">LIMIT</span><span class="token sql-attr"> </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">500</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">args</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token variable" style="color:rgb(191, 199, 213)">cursor.id]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Runs once per page, each iteration in its own transaction.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">do</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">exec</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sql</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">DELETE</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">IN</span><span class="token sql-attr"> </span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> value </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> </span><span class="token sql-attr sql-function function" style="color:rgb(130, 170, 255)">json_each</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">?</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">args</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token function" style="color:rgb(130, 170, 255)">jsonencode</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">iterator.keyset.batch[*].id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><details class="details_B4FW alert alert--info details_SZgV example-execution" data-collapsed="true"><summary>Example execution</summary><div><div class="collapsibleContent_VYua"><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas script loop </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlite://purge.db"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--file</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://purge.script.hcl"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> purge_inactive</span><br></span></code></pre></div></div><p>Atlas streams a per-step report as the loop runs, grouping each iteration under its own header. Each
iteration opens its own transaction, the default <code>PER_ITERATION</code> mode, so a failure rolls back one
batch rather than the whole run. Reading the table back shows the inactive users gone and the active
ones untouched:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sqlite3 purge.db </span><span class="token string" style="color:rgb(195, 232, 141)">"SELECT count(*) FROM users WHERE active = 0; SELECT count(*) FROM users"</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">0</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">3</span><br></span></code></pre></div></div></div></div></details></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">export.script.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"customer_export"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"rows"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> email</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> card </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> customers </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">ORDER</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">BY</span><span class="token sql-attr"> id"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">HASH</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">salt</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod-secret"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"card"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">PARTIAL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">keep_right</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><details class="details_B4FW alert alert--info details_SZgV example-execution" data-collapsed="true"><summary>Example execution</summary><div><div class="collapsibleContent_VYua"><p><code>--quiet</code> drops the per-step report and prints only the script's product, the masked CSV:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas script query </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"</span><span class="token string variable" style="color:rgb(191, 199, 213)">$URL</span><span class="token string" style="color:rgb(195, 232, 141)">"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--file</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://export.script.hcl"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'^customer_export$'</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--quiet</span><br></span></code></pre></div></div><div class="language-csv codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-csv codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,71f2179ddbb6c48f28aca29b80efe46b136ce9568dd75041a98ad482be6ca2fc,************1111</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">2,30afa44bf93ac9486cf6d5c225bd57bd2ac5a4c7175ae1b31fadc3859daeb300,************2222</span><br></span></code></pre></div></div><p>The hash is salted and stable, so exports remain joinable across runs without carrying the email
itself. The card keeps its last four digits.</p></div></div></details></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">archive.script.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"exec"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"archive_dormant"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Stop cleanly if there is nothing to archive.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  condition </span><span class="token string" style="color:rgb(195, 232, 141)">"have_dormant"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> </span><span class="token sql-attr sql-function function" style="color:rgb(130, 170, 255)">count</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">*</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr"> &gt; </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">0</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> accounts </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> last_seen &lt; </span><span class="token sql-attr sql-string string" style="color:rgb(195, 232, 141)">'2020-01-01'</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Read the dormant rows once and bind them for the writes below.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"dormant"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> accounts </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> last_seen &lt; </span><span class="token sql-attr sql-string string" style="color:rgb(195, 232, 141)">'2020-01-01'</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">ORDER</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">BY</span><span class="token sql-attr"> id"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">rows</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> id </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token builtin" style="color:rgb(130, 170, 255)">int</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Copy to the archive, then delete, each keyed off the same captured ids, and</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># each asserting it touched exactly the rows the read found.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  exec </span><span class="token string" style="color:rgb(195, 232, 141)">"snapshot"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-heredoc">&lt;&lt;-SQL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token sql-heredoc">      </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">INSERT</span><span class="token sql-heredoc"> </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">INTO</span><span class="token sql-heredoc"> archive </span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-heredoc">id</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-heredoc"> email</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-heredoc"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token sql-heredoc">      </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-heredoc"> id</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-heredoc"> email </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-heredoc"> accounts</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token sql-heredoc">      </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-heredoc"> id </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">IN</span><span class="token sql-heredoc"> </span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-heredoc"> value </span><span class="token sql-heredoc sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-heredoc"> </span><span class="token sql-heredoc sql-function function" style="color:rgb(130, 170, 255)">json_each</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-heredoc">?</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-heredoc sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-heredoc"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token sql-heredoc">    SQL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">args</span><span class="token plain">        </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token function" style="color:rgb(130, 170, 255)">jsonencode</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">query.dormant.rows[*].id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">expect_rows</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">length</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">query.dormant.rows</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  exec </span><span class="token string" style="color:rgb(195, 232, 141)">"purge"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">         </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">DELETE</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> accounts </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">IN</span><span class="token sql-attr"> </span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> value </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> </span><span class="token sql-attr sql-function function" style="color:rgb(130, 170, 255)">json_each</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">?</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">args</span><span class="token plain">        </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token function" style="color:rgb(130, 170, 255)">jsonencode</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">query.dormant.rows[*].id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">expect_rows</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">length</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">query.dormant.rows</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">output</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">message</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"archived </span><span class="token string interpolation variable" style="color:rgb(191, 199, 213)">${length(query.dormant.rows)}</span><span class="token string" style="color:rgb(195, 232, 141)"> dormant accounts"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><details class="details_B4FW alert alert--info details_SZgV example-execution" data-collapsed="true"><summary>Example execution</summary><div><div class="collapsibleContent_VYua"><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas script </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">exec</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlite://archive.db"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--file</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://archive.script.hcl"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> archive_dormant</span><br></span></code></pre></div></div><div class="language-applylog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-applylog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Executing script "archive_dormant" (archive</span><span class="token duration">.s</span><span class="token plain">cript.hcl:1):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">tx open</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">condition "have_dormant" ok (archive</span><span class="token duration">.s</span><span class="token plain">cript.hcl:3)</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">exec "snapshot" (archive</span><span class="token duration">.s</span><span class="token plain">cript.hcl:15)</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">INSERT INTO archive (id, email)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       SELECT id, email FROM accounts</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">       WHERE id IN (SELECT value FROM json_each(?))</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">ok (</span><span class="token duration">400.584µs</span><span class="token plain">) | 3 rows affected</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">exec "purge" (archive</span><span class="token duration">.s</span><span class="token plain">cript.hcl:24)</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">DELETE FROM accounts WHERE id IN (SELECT value FROM json_each(?))</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">ok (</span><span class="token duration">48.791µs</span><span class="token plain">) | 3 rows affected</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">output (archive</span><span class="token duration">.s</span><span class="token plain">cript.hcl:30): archived 3 dormant accounts</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">tx commit</span><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2">  -------------------------</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token duration">815.708µs</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">2 statements</span><br></span></code></pre></div></div></div></div></details></div></div></div>
<p>Because scripts are code, they are versioned, reviewed, and tested in CI before touching
production data. The testing framework runs
them on a real dev database and verifies both the result a script produces and the privileges it
runs with, using the <code>as</code> block to execute under a reduced role.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="masking-sensitive-output">Masking Sensitive Output<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#masking-sensitive-output" class="hash-link" aria-label="Direct link to Masking Sensitive Output" title="Direct link to Masking Sensitive Output" translate="no">​</a></h3>
<p>The result of a query may contain columns that must not appear in a report, an export, or an
agent's context: <code>email</code>, <code>ssn</code>, <code>phone</code>, or a <code>*_enc</code> column. A <a class="" href="https://atlasgo.io/scripts/masking"><code>mask</code></a> block
redacts those columns before the result leaves Atlas, with four methods. Each tab below masks one
column of the row <code>(1, 'ada@example.com', '123-45-6789', '4111111111111111', '555-0100')</code>:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Redact</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Partial Mask</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Keyed Hash</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Regex Replace</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Mask Library</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><code>REDACT</code> replaces the whole value with a fixed token (<code>***</code> by default):</p><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> email</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> ssn </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">1</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">REDACT</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,***,123-45-6789</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><code>PARTIAL</code> keeps characters at the start and end and masks the rest:</p><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> card </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">1</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"card"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">PARTIAL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">keep_right</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,************1111</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><code>HASH</code> replaces the value with a keyed digest. The digest is deterministic, so equal inputs mask
to equal tokens and masked columns stay joinable across queries, runs, and files:</p><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> email </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">1</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">HASH</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">salt</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod-secret"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,71f2179ddbb6c48f28aca29b80efe46b136ce9568dd75041a98ad482be6ca2fc</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><code>REPLACE</code> applies a regular-expression substitution (<code>match</code> is the pattern, <code>with</code> the
replacement):</p><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"u"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> phone </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">1</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"phone"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">REPLACE</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain">   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"[0-9]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">with</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"#"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,###-####</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Masks can also be named, defined once, and applied with <code>use</code>, so one mask library serves every
report:</p><div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">export.script.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Reusable, named mask: hash identity columns with a fixed salt so tokens stay</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># joinable across reports (define once, apply with `use`).</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">mask </span><span class="token string" style="color:rgb(195, 232, 141)">"identity"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"ssn"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">HASH</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">salt</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"prod-secret"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"query"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"customer_export"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  query </span><span class="token string" style="color:rgb(195, 232, 141)">"rows"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> id</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> name</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> email</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> ssn</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> card</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token sql-attr"> phone </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> customers </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">ORDER</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">BY</span><span class="token sql-attr"> id"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">format</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">CSV</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Apply the reusable identity mask...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">use</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token variable" style="color:rgb(191, 199, 213)">mask.identity]</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># ...plus per-column masks: keep the card's last 4, star the phone digits.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"card"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">     </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">PARTIAL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">keep_right</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">mask</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">columns</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"phone"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">REPLACE</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain">   </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"[0-9]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">with</span><span class="token plain">    </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"#"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><details class="details_B4FW alert alert--info details_SZgV example-execution" data-collapsed="true"><summary>Example execution</summary><div><div class="collapsibleContent_VYua"><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas script query </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlite://export.db"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--file</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://export.script.hcl"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--run</span><span class="token plain"> customer_export </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--quiet</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1,Ada Lovelace,71f2179ddbb6c48f28aca29b80efe46b136ce9568dd75041a98ad482be6ca2fc,f63009387803b2964829857acedf2a92374d7fe00c942020180b129a4f3c646e,************1111,###-####</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">2,Bob Stone,30afa44bf93ac9486cf6d5c225bd57bd2ac5a4c7175ae1b31fadc3859daeb300,239d31c6bcb443ca87fa5a32702bdf112421223126cbe3c24a77ecb8889c0f4e,************2222,###-####</span><br></span></code></pre></div></div><p>The reusable <code>identity</code> mask turns <code>email</code> and <code>ssn</code> into keyed HMAC-SHA256 tokens. Because the
salt is fixed, the same value hashes identically everywhere, so masked columns stay joinable. The
inline <code>PARTIAL</code> keeps the card's last four, and the inline <code>REPLACE</code> stars every phone digit while
leaving the dash. <code>id</code> and <code>name</code> match no mask, so they pass through. Masks apply in declaration
order, and the first match wins.</p></div></div></details></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="http-operations">HTTP Operations<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#http-operations" class="hash-link" aria-label="Direct link to HTTP Operations" title="Direct link to HTTP Operations" translate="no">​</a></h3>
<p>Deleting data is rarely one <code>DELETE</code> statement. A user's rows have copies beyond the database: a
document in the search index, an object in blob storage, a record in a downstream service, and the
deletion is complete only when every copy is gone. Meta built an entire framework,
<a href="https://engineering.fb.com/2020/08/12/security/delf/" target="_blank" rel="noopener noreferrer" class="">DELF</a>, around this problem: developers
reliably identify what must be deleted, and reliably miss where the copies live. Scripts express
the cascade as a loop: page through the deleted rows, call each service that holds a copy, and mark
progress only after it confirms:</p>
<div class="language-atlas-script codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">purge_deleted.script.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-atlas-script codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">script </span><span class="token class-name" style="color:rgb(255, 203, 107)">"loop"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"purge_deleted"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  iterator </span><span class="token class-name" style="color:rgb(255, 203, 107)">"keyset"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># ... pages through rows marked deleted, as in the batched deletion above.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">do</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Drop the batch from the search index first.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    http </span><span class="token string" style="color:rgb(195, 232, 141)">"search"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">url</span><span class="token plain">           </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"https://search.internal/documents/delete"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">method</span><span class="token plain">        </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token constant" style="color:rgb(130, 170, 255)">POST</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">body</span><span class="token plain">          </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">jsonencode</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> ids </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token variable" style="color:rgb(191, 199, 213)">iterator.keyset.batch[*].id</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">expect_status</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">200</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Mark the rows purged only after the call succeeds.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">exec</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">sql</span><span class="token plain">  </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token sql-attr">"</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">UPDATE</span><span class="token sql-attr"> users </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SET</span><span class="token sql-attr"> purged = </span><span class="token sql-attr sql-number number" style="color:rgb(247, 140, 108)">1</span><span class="token sql-attr"> </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">WHERE</span><span class="token sql-attr"> id </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">IN</span><span class="token sql-attr"> </span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">SELECT</span><span class="token sql-attr"> value </span><span class="token sql-attr sql-keyword keyword" style="font-style:italic">FROM</span><span class="token sql-attr"> </span><span class="token sql-attr sql-function function" style="color:rgb(130, 170, 255)">json_each</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token sql-attr">?</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr sql-punctuation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token sql-attr">"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">args</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token function" style="color:rgb(130, 170, 255)">jsonencode</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token variable" style="color:rgb(191, 199, 213)">iterator.keyset.batch[*].id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>To learn more, see the <a class="" href="https://atlasgo.io/scripts">Atlas Scripts documentation</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="atlas-cloud-manage-registry-resources-from-the-cli"><code>atlas cloud</code>: Manage Registry Resources from the CLI<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#atlas-cloud-manage-registry-resources-from-the-cli" class="hash-link" aria-label="Direct link to atlas-cloud-manage-registry-resources-from-the-cli" title="Direct link to atlas-cloud-manage-registry-resources-from-the-cli" translate="no">​</a></h2>
<p>The Atlas Registry already knows which repositories exist, which version every database runs, whether
it is in sync, and how each deployment ended. Until this release, all of it lived behind the Atlas
Cloud UI, which is built for a person looking at a screen. Ask "is prod on the latest version?" from a
CI job or a coding agent, and there was nothing to read.</p>
<p>The new <code>atlas cloud</code> command group answers from the terminal. It is the same Registry state the UI
renders, exposed as commands: <code>atlas cloud repo</code> lists, describes, and creates repositories,
<code>atlas cloud database</code> shows deployment targets, and <code>atlas cloud migration</code> inspects deployment
events.</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Databases</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Deployments</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Graph Exports</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>A database is a deployment target with a current version and a sync status: <code>SYNCED</code>, <code>PENDING</code>, or
<code>FAILED</code>. List them, optionally filtering by environment:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas cloud database list</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ID   NAME                 ENV         STATUS   CURRENT VERSION</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">1    prod                 production  SYNCED   20260514083000</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">2    prod-eu              production  PENDING  20260512141500</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">3    staging              staging     FAILED   20260515093000</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">--------------------------------</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Page: 1  Page Size: 3  Total: 18</span><br></span></code></pre></div></div><p>That is a fleet check in one line: <code>prod-eu</code> is behind, and <code>staging</code> failed its last deployment. To
drill into one target and see when it was last deployed, use <code>atlas cloud database describe --id 1</code>.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Every <code>migrate apply</code> and <code>schema apply</code> reported to the Registry is recorded as a deployment event,
with a status of <code>PASSED</code>, <code>FAILED</code>, <code>NO_ACTION</code>, or <code>DRY_RUN</code>. Filter them by repository, status,
environment, or database name:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas cloud migration list </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--repo</span><span class="token plain"> payments </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--status</span><span class="token plain"> PASSED</span><br></span></code></pre></div></div><div class="language-text codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-text codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ID   REPO       TYPE                 ENV         DATABASE    TARGETS  VERSION         STATUS</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">101  payments   MIGRATION_DIRECTORY  production  prod        -        20260514083000  PASSED</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">102  payments   MIGRATION_DIRECTORY  production  (multiple)  8/8      20260514083000  PASSED</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">--------------------------------</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Page: 1  Page Size: 2  Total: 42</span><br></span></code></pre></div></div><p>Notice the second row. Events that fan out to many databases, such as multi-tenant deployments, report
<code>(multiple)</code> and a <code>succeeded/total</code> ratio, so a single line tells you all 8 tenants got the
migration.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>The group is also where the graphs leave the browser. <code>atlas cloud repo secgraph</code> prints the
<a class="" href="https://atlasgo.io/cloud/features/security-graph">security graph</a> shown above, and <code>atlas cloud repo lingraph</code>
<a class="" href="https://atlasgo.io/changelog/lineage-cli-export">prints the lineage graph</a>, either as a node and edge graph or as
<a href="https://openlineage.io/" target="_blank" rel="noopener noreferrer" class="">OpenLineage</a> events for catalogs like Marquez and DataHub:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas cloud repo lingraph </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--slug</span><span class="token plain"> my-repo --open-lineage</span><br></span></code></pre></div></div><p>The same graph the browser renders is now readable by catalogs and agents.</p></div></div></div>
<p>Every command prints a table for a person by default, and JSON for a script, a CI gate, or an
agent that asks for it. List commands are paginated and filterable.</p>
<p>The <a class="" href="https://atlasgo.io/cloud/features/lineage-graph">lineage graph</a> grew this cycle, as well:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/guides/redshift/lineage-graph">Redshift</a> joins PostgreSQL, MySQL, ClickHouse, CockroachDB, and
Snowflake as a supported engine.</li>
<li class="">Nodes expose <a class="" href="https://atlasgo.io/changelog/lineage-graph-visualization-improvements">quick actions</a> for expanding,
collapsing, and toggling columns across related nodes.</li>
<li class="">ClickHouse nodes <a class="" href="https://atlasgo.io/changelog/clickhouse-erd-lineage-metadata">display engine metadata</a> such as
table engine, projections, and ordering keys.</li>
</ul>
<p>To learn more, see the documentation for <a class="" href="https://atlasgo.io/cloud/deployment#inspecting-deployments-from-the-cli">deployments</a>,
the <a class="" href="https://atlasgo.io/cloud/features/security-graph">security graph</a>, and the <a class="" href="https://atlasgo.io/cloud/features/lineage-graph">lineage graph</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="schema-annotations">Schema Annotations<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#schema-annotations" class="hash-link" aria-label="Direct link to Schema Annotations" title="Direct link to Schema Annotations" translate="no">​</a></h2>
<p>External tools rarely consume database schemas directly: a GraphQL server wants SDL, a REST
gateway wants OpenAPI, a data catalog wants its own ingest format. Maintaining each spec alongside
the schema means two sources of truth that drift apart the moment a column is renamed.
<a class="" href="https://atlasgo.io/changelog/template-exporter">Schema annotations</a> collapse that by attaching type-safe metadata to
tables, columns, or any schema resource, and rendering whichever format the consuming tool expects:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Annotate</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Template</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Export</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>Declare the annotation shape once on the schema's data source:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">data </span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)">"hcl_schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"app"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">path</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"schema.hcl"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  annotation </span><span class="token string" style="color:rgb(195, 232, 141)">"table"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    attr </span><span class="token string" style="color:rgb(195, 232, 141)">"type_name"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> string</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    attr </span><span class="token string" style="color:rgb(195, 232, 141)">"description"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> string</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Resources then attach concrete values, and the same type-checker that validates the schema
validates them on every load:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">annotation</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type_name</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"User"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">description</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"A registered user"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">annotation</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">graphql_type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"ID!"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// ...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>A <code>template</code> block wires a Go template into the exporter, and <code>on "table"</code> runs it once per table:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">exporter </span><span class="token string" style="color:rgb(195, 232, 141)">"template"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"graphql"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">template</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"templates/type.graphql.tmpl"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    on </span><span class="token string" style="color:rgb(195, 232, 141)">"table"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"out/types/{{ .Name }}.graphql"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"local"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> data.hcl_schema.app.url</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">export</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">inspect</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> exporter.template.graphql</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Inside the template, <code>attr</code> pulls annotations off any object and renders the target format, here
GraphQL SDL:</p><div class="language-gotemplate codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">templates/type.graphql.tmpl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-gotemplate codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">with</span><span class="token plain"> $ann </span><span class="token operator" style="color:rgb(137, 221, 255)">:=</span><span class="token plain"> attr .Object </span><span class="token string" style="color:rgb(195, 232, 141)">"annotation"</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain">}}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token string" style="color:rgb(195, 232, 141)">""</span><span class="token plain">"</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{ $ann.Attr </span><span class="token string" style="color:rgb(195, 232, 141)">"description"</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token string" style="color:rgb(195, 232, 141)">""</span><span class="token plain">"</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">type</span><span class="token plain"> {{ $ann.Attr </span><span class="token string" style="color:rgb(195, 232, 141)">"type_name"</span><span class="token plain"> }} {</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">range</span><span class="token plain"> $c </span><span class="token operator" style="color:rgb(137, 221, 255)">:=</span><span class="token plain"> $.Object.Columns }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">with</span><span class="token plain"> $cann </span><span class="token operator" style="color:rgb(137, 221, 255)">:=</span><span class="token plain"> attr $c </span><span class="token string" style="color:rgb(195, 232, 141)">"annotation"</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  {{ $c.Name }}: {{ $cann.Attr </span><span class="token string" style="color:rgb(195, 232, 141)">"graphql_type"</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">with</span><span class="token plain"> $cann.Attr </span><span class="token string" style="color:rgb(195, 232, 141)">"deprecated"</span><span class="token plain"> }} @deprecated(reason: </span><span class="token string" style="color:rgb(195, 232, 141)">"{{ . }}"</span><span class="token plain">){{ </span><span class="token keyword" style="font-style:italic">end</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">end</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">end</span><span class="token plain"> }}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">}</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">{{</span><span class="token operator" style="color:rgb(137, 221, 255)">-</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">end</span><span class="token plain"> }}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Run an inspect with <code>--export</code> and the specs are rendered from the schema:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema inspect </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--env</span><span class="token plain"> </span><span class="token builtin class-name" style="color:rgb(255, 203, 107)">local</span><span class="token plain"> --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/15"</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--export</span><br></span></code></pre></div></div><div class="language-graphql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">out/types/users.graphql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-graphql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token description string" style="color:rgb(195, 232, 141)">"""</span><span class="token description string language-markdown" style="color:rgb(195, 232, 141)"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token description string language-markdown" style="color:rgb(195, 232, 141)">A registered user</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token description string language-markdown" style="color:rgb(195, 232, 141)"></span><span class="token description string" style="color:rgb(195, 232, 141)">"""</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">type</span><span class="token plain"> </span><span class="token class-name" style="color:rgb(255, 203, 107)">User</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token attr-name" style="color:rgb(255, 203, 107)">id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token scalar">ID</span><span class="token operator" style="color:rgb(137, 221, 255)">!</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token attr-name" style="color:rgb(255, 203, 107)">name</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token scalar">String</span><span class="token operator" style="color:rgb(137, 221, 255)">!</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token attr-name" style="color:rgb(255, 203, 107)">nickname</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token scalar">String</span><span class="token plain"> </span><span class="token directive function" style="color:rgb(130, 170, 255)">@deprecated</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token attr-name" style="color:rgb(255, 203, 107)">reason</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Use name instead"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="pre-apply-drift-detection">Pre-Apply Drift Detection<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#pre-apply-drift-detection" class="hash-link" aria-label="Direct link to Pre-Apply Drift Detection" title="Direct link to Pre-Apply Drift Detection" translate="no">​</a></h2>
<p>Versioned migrations rely on deterministic execution: each migration file is written, reviewed,
and tested against the exact state the migration history says the database is in. A manual hotfix breaks that
silently, and the next deployment fails or makes things worse.
<a class="" href="https://atlasgo.io/changelog/pre-apply-drift-detection">Pre-apply drift detection</a> verifies the guarantee inside
the deployment itself.</p>
<p>Add a <code>check "migrate_apply"</code> block to the environment; before any statement runs, Atlas verifies
the database matches the expected state at the latest applied revision:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> env(</span><span class="token string" style="color:rgb(195, 232, 141)">"DATABASE_URL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migration</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">dir</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"atlas://my-app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  check </span><span class="token string" style="color:rgb(195, 232, 141)">"migrate_apply"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">drift</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">on_error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> FAIL</span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Drift detected</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">No drift</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>When the target database differs from the expected state at the latest revision, the apply is
aborted before any migration file runs:</p><div class="language-driftlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">Output</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-driftlog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Executing pre-execution check (1 check in total):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">check at atlas.hcl:10 (</span><span class="token parens-kind">drift</span><span class="token plain">):</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">check drift against version 20260423120000</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        --- expected state</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        +++ actual state</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token hunk">@@ -0,0 +1,3 @@</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token addition">        +CREATE TABLE "audit_log" (</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token addition">        +  "id" integer NULL</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token addition">        +);</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token error">Error: database state does not match expected state at version "20260423120000"</span><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2">-------------------------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">database state does not match expected state at version "20260423120000"</span><br></span></code></pre></div></div><p>The diff is rendered in the apply transcript so the operator can see exactly which objects
drifted. The migration files themselves are never executed.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>When the database matches the expected state, the check passes and the migration proceeds:</p><div class="language-applylog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">Output</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-applylog codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Executing pre-execution check (1 check in total):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">check at atlas.hcl:10 (drift):</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">check drift against version </span><span class="token version">20260423120000</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token plain">passed</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">ok (</span><span class="token duration">12.4ms</span><span class="token plain">)</span><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action2">-------------------------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Migrating to version </span><span class="token version">20260423130000</span><span class="token plain"> from </span><span class="token version">20260423120000</span><span class="token plain"> (1 migrations in total):</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">migrating version </span><span class="token version">20260423130000</span><span class="token action3"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action3">    -&gt; </span><span class="token plain">ALTER TABLE users ADD COLUMN email text;</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">ok (</span><span class="token duration">4.2ms</span><span class="token plain">)</span><br></span></code></pre></div></div></div></div></div>
<p>Declarative migrations get the same gate with
<a class="" href="https://atlasgo.io/changelog/declarative-pre-execution-checks">pre-execution checks</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="database-driver-improvements">Database Driver Improvements<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#database-driver-improvements" class="hash-link" aria-label="Direct link to Database Driver Improvements" title="Direct link to Database Driver Improvements" translate="no">​</a></h2>
<p>Beyond the headline features, this release includes enhancements across the supported engines:</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql">PostgreSQL<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#postgresql" class="hash-link" aria-label="Direct link to PostgreSQL" title="Direct link to PostgreSQL" translate="no">​</a></h3>
<p>We improved two common pain points: <code>NOT NULL</code> migrations that lock or fail, and schema tests that
slow down as the schema grows:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Lock-Safe NOT NULL</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Template Databases</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>Adding a <code>NOT NULL</code> constraint to an existing column carries two risks: the migration fails if the
column still holds <code>NULL</code>s, and <code>SET NOT NULL</code> takes an <code>ACCESS EXCLUSIVE</code> lock while it scans the
table. The new <a class="" href="https://atlasgo.io/guides/lock-safe-not-null"><code>not_null</code> diff policy</a> removes both:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">diff </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">not_null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">check</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">lock_safe</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p><code>check</code> adds a pre-migration check that stops the deployment while the column holds <code>NULL</code>s, and
<code>lock_safe</code> plans the change so it never holds an <code>ACCESS EXCLUSIVE</code> lock for a table scan: the
constraint is added <code>NOT VALID</code> and validated under a lock that does not block reads or writes.
Pre-migration <code>NOT NULL</code> checks are also available on
<a class="" href="https://atlasgo.io/lint/analyzers#MF104">MySQL and SQL Server</a>. The <code>not_null</code> policy is part of Atlas Pro; run
<code>atlas login</code> to get started.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><code>atlas schema test</code> can now run every test group on a fresh copy of the dev database using
<a class="" href="https://atlasgo.io/changelog/schema-test-template-databases">template databases</a>. Copying a template is a server-side
bulk file copy with near-constant cost, so test runs become 8x-10x faster end to end, and dozens of
times faster on large schemas:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">docker </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"dev"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">image</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"postgres:18"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">template</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Template databases are part of Atlas Pro, like <code>schema test</code> itself; run <code>atlas login</code> to get
started.</p></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="oracle">Oracle<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#oracle" class="hash-link" aria-label="Direct link to Oracle" title="Direct link to Oracle" translate="no">​</a></h3>
<p>Oracle coverage deepened this cycle, from access control down to physical storage:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Roles &amp; Permissions</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Sequences &amp; More</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Physical Attributes</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Domain Indexes</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/guides/oracle/security-declarative">Roles and grants</a> can now be defined as code next to the
tables they protect. Role hierarchies use <code>member_of</code>, and <code>permission</code> blocks grant privileges at
the table or column level:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"APP_READONLY"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"APP_WRITER"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">member_of</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.APP_READONLY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"APP_PAYROLL"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Writer: full DML on EMPLOYEES</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">permission</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.APP_WRITER</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.EMPLOYEES</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">privileges</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"INSERT"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"UPDATE"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"DELETE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Payroll: may update ONLY the SALARY column</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">permission</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.APP_PAYROLL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">for</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.EMPLOYEES.column.SALARY</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">privileges</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"UPDATE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas diffs the live database against this state and plans the exact <code>GRANT</code> and <code>REVOKE</code>
statements, including column-scoped grants like <code>UPDATE ("SALARY")</code>.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/oracle-v13-features">Sequences, global temporary tables, database links, synonyms, and CHECK constraints</a>
get full lifecycle support. For example, a sequence backing a column default, plus a synonym for it:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sequence </span><span class="token string" style="color:rgb(195, 232, 141)">"my_seq"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">start</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">increment</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">cache</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">cycle</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">default</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"\"my_seq\".NEXTVAL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Synonym pointing to a local sequence</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">synonym </span><span class="token string" style="color:rgb(195, 232, 141)">"seq_syn"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">object</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sequence.my_seq</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas plans <code>CREATE SEQUENCE</code> and <code>CREATE SYNONYM</code> in dependency order and handles inspect, diff,
and migrate for all of them.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Atlas now inspects, diffs, and migrates the
<a class="" href="https://atlasgo.io/changelog/oracle-physical-attributes-storage">physical attributes and storage clause</a> of Oracle
tables. Add a <code>physical</code> block to a table, with a nested <code>storage</code> block for the segment:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">physical</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">pctfree</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">initrans</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">storage</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">initial</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">131072</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">buffer_pool</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> KEEP</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas emits the matching <code>PCTFREE</code>, <code>INITRANS</code>, and <code>STORAGE</code> clauses in <code>CREATE TABLE</code>, plans
<code>ALTER TABLE</code> for in-place changes (<code>INITIAL</code> and <code>MINEXTENTS</code> changes recreate the table), and
skips values that match Oracle or tablespace defaults.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/oracle-operators-indextypes-domain-indexes">Operators, index types, and domain indexes</a>
are now first-class resources. Setting <code>domain</code> on an index builds it through an indextype, here
Oracle Text, with <code>parameters</code> passed to the indextype verbatim:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"DOCUMENTS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.app</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"ID"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER(</span><span class="token number" style="color:rgb(247, 140, 108)">10</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"TITLE"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR2(</span><span class="token number" style="color:rgb(247, 140, 108)">255</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"CTX_TITLE_IDX"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.TITLE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">domain</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"\"CTXSYS\".\"CONTEXT\""</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">parameters</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SYNC (ON COMMIT)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="snowflake">Snowflake<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#snowflake" class="hash-link" aria-label="Direct link to Snowflake" title="Direct link to Snowflake" translate="no">​</a></h3>
<p>Snowflake coverage grew past tables to the objects around them, from account-level warehouses and
volumes to tags and sequences:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Iceberg Tables</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Warehouses &amp; Monitors</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Tags</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Sequences</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/snowflake-iceberg-tables">Iceberg tables</a> and
<a class="" href="https://atlasgo.io/changelog/snowflake-external-volume">external volumes</a> are now first-class objects. Declare the
storage location once, reference it from the table, and Atlas creates the volume before the table and
drops it after:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">external_volume </span><span class="token string" style="color:rgb(195, 232, 141)">"my_s3_vol"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  storage_location </span><span class="token string" style="color:rgb(195, 232, 141)">"S3"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"s3_us_east"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">storage_base_url</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"s3://my-bucket/iceberg/"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">storage_aws_role_arn</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"arn:aws:iam::123456789012:role/snowflake-role"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">allow_writes</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">iceberg_table </span><span class="token string" style="color:rgb(195, 232, 141)">"events"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.PUBLIC</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">external_volume</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> external_volume.my_s3_vol</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">catalog</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"SNOWFLAKE"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">base_location</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"events/"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER(</span><span class="token number" style="color:rgb(247, 140, 108)">10</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/snowflake-warehouses-resource-monitors">Warehouses and resource monitors</a> are now
first-class resources. Define a credit budget with its triggers, then attach it to a warehouse via
the <code>resource_monitor</code> attribute:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">resource_monitor </span><span class="token string" style="color:rgb(195, 232, 141)">"analytics_rm"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">credit_quota</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">frequency</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> MONTHLY</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">notify_users</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"alice"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"bob"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">trigger</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">threshold</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">80</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">action</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NOTIFY</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">trigger</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">threshold</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">action</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> SUSPEND</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">warehouse </span><span class="token string" style="color:rgb(195, 232, 141)">"analytics_wh"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">size</span><span class="token plain">             </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> XSMALL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">type</span><span class="token plain">             </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> STANDARD</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">auto_suspend</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">300</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">auto_resume</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">resource_monitor</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> resource_monitor.analytics_rm</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Analytics workloads"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas creates the monitor before the warehouse that points at it, and plans <code>CREATE</code>, <code>ALTER</code>, and
<code>DROP</code> statements from the diff.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/snowflake-tags">Tags</a> are now managed declaratively. Define a tag once, then assign it
to an object with a nested <code>tag</code> block that sets <code>ref</code> and <code>value</code>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">tag </span><span class="token string" style="color:rgb(195, 232, 141)">"USER_DOMAIN"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.SALES</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">allowed_values</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"customer"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"employee"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"data domain tag"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"USERS"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.SALES</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"CUSTOMER_ID"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER(</span><span class="token number" style="color:rgb(247, 140, 108)">38</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"NAME"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR(</span><span class="token number" style="color:rgb(247, 140, 108)">16777216</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">tag</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">ref</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> tag.USER_DOMAIN</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"customer"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas plans the <code>CREATE TAG</code> statement and the assignment for schemas, tables, columns, views,
warehouses, and other objects.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/snowflake-sequences">Sequences</a> are now first-class schema objects. Declare one in HCL,
use its <code>NEXTVAL</code> as a column default, and add <code>depends_on</code> so the sequence is created before the
table:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sequence </span><span class="token string" style="color:rgb(195, 232, 141)">"customer_id_seq"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.sales</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">start</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">increment</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">comment</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"Surrogate key for customer records"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"customers"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.sales</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NUMBER</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">default</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"customer_id_seq.NEXTVAL"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> VARCHAR(</span><span class="token number" style="color:rgb(247, 140, 108)">255</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">depends_on</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">sequence.customer_id_seq</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas plans <code>CREATE</code>, <code>ALTER</code>, and <code>DROP SEQUENCE</code> from the diff; changes to <code>start</code> recreate the
sequence since Snowflake cannot alter it in place.</p></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="clickhouse">ClickHouse<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#clickhouse" class="hash-link" aria-label="Direct link to ClickHouse" title="Direct link to ClickHouse" translate="no">​</a></h3>
<p>ClickHouse gains governance controls, from row-level reads to query limits and credentials, plus
user-defined functions compiled to WASM:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Row Policies</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">WASM UDFs</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Settings Profiles</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Named Collections</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Merged ALTERs</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/clickhouse-row-policies-and-text-index">Row policies and full-text search indexes</a> are
now first-class resources. A <code>policy</code> block filters which rows a role or user can read, and the
<code>text</code> index type tokenizes string columns for search. Three policies on one table, one scoped to a
role and a user, one restrictive and applied to everyone, and one that covers every role except
<code>intern</code>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ch.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">policy </span><span class="token string" style="color:rgb(195, 232, 141)">"analysts_only"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">on</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">using</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"region = 'us'"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.analyst, user.report_user</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">policy </span><span class="token string" style="color:rgb(195, 232, 141)">"exclude_deleted"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">on</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">restrictive</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">using</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"is_deleted = 0"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to_all</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">policy </span><span class="token string" style="color:rgb(195, 232, 141)">"hide_pii"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">on</span><span class="token plain">            </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.orders</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">using</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sensitivity &lt; 3"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to_all_except</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.intern</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/clickhouse-wasm">WASM modules and WASM user-defined functions</a> are now first-class
resources. A <code>wasm_module</code> holds the compiled binary and its hash, and a <code>function</code> with
<code>lang = WASM</code> points at a module and names the export to call:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ch.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">wasm_</span><span class="token keyword" style="font-style:italic">module</span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)"> "math_module" </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">code</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"unhex('0061736d0100000001070160027f7f017f030201000707010373756200000a09010700200020016b0b')"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">hash</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"reinterpretAsUInt256(unhex('a957fcb890da31e0e4a72bbdb0e04c50ba7ff5cb6946b21d674f9dcb6e7cd488'))"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">function </span><span class="token string" style="color:rgb(195, 232, 141)">"wasm_numbers"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">lang</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> WASM</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">returns</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> UInt32</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">module</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> wasm_module.math_module</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">source</span><span class="token plain">        </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sub"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">abi</span><span class="token plain">           </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> ROW_DIRECT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">deterministic</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arg </span><span class="token string" style="color:rgb(195, 232, 141)">"a"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> UInt32</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arg </span><span class="token string" style="color:rgb(195, 232, 141)">"b"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> UInt32</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Atlas plans the module insert and the <code>CREATE FUNCTION ... LANGUAGE WASM</code> statement, and populates
the function's module SHA-256 hash when omitted. Enable it with <code>wasm_modules = true</code> on the
<code>mode "clickhouse"</code> block.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/clickhouse-settings-profiles">Settings profiles</a> are now first-class resources. Named
profiles define query constraints with optional bounds and writability, inherit from other
profiles, and attach to roles or users:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ch.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">role </span><span class="token string" style="color:rgb(195, 232, 141)">"analyst"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">settings_profile </span><span class="token string" style="color:rgb(195, 232, 141)">"base_limits"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  setting </span><span class="token string" style="color:rgb(195, 232, 141)">"max_memory_usage"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">10000000000</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  setting </span><span class="token string" style="color:rgb(195, 232, 141)">"max_threads"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">4</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">min</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">max</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">8</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">settings_profile </span><span class="token string" style="color:rgb(195, 232, 141)">"analyst_limits"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">inherit</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">settings_profile.base_limits</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">to</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">role.analyst</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  setting </span><span class="token string" style="color:rgb(195, 232, 141)">"readonly"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">writability</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> CONST</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Management is opt-in: set <code>settings_profiles = true</code> in the <code>mode "clickhouse"</code> block of
<code>atlas.hcl</code>.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/clickhouse-named-collections">Named collections</a> centralize credentials and integration
settings so tables and table functions reference them by name:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ch.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">named_collection </span><span class="token string" style="color:rgb(195, 232, 141)">"s3_data"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  item </span><span class="token string" style="color:rgb(195, 232, 141)">"access_key_id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"AWS_ACCESS_KEY_ID"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  item </span><span class="token string" style="color:rgb(195, 232, 141)">"secret_access_key"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">value</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> getenv(</span><span class="token string" style="color:rgb(195, 232, 141)">"AWS_SECRET_ACCESS_KEY"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>In the versioned workflow, <code>atlas migrate diff</code> generates statements for the collection and its keys
but omits the values, keeping secrets out of version control:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20260525120000_add_named_collection.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Create named collection "s3_data"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">CREATE</span><span class="token plain"> NAMED COLLECTION </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">s3_data</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">access_key_id</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">''</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">secret_access_key</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">''</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p>You populate the values separately, manually or from a secrets manager; the declarative workflow
with <code>sensitive = ALLOW</code> manages value rotation.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Atlas now <a class="" href="https://atlasgo.io/changelog/clickhouse-merged-alter-statements">merges compatible ALTER TABLE operations</a>
on the same table into a single statement, so the set of changes succeeds or fails together:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- 4 separate statements (before)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">orders</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">discount</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">Decimal</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0.00</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">orders</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">MODIFY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">total</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">Decimal</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">12</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0.00</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">orders</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">idx_status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">orders</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">idx_status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TYPE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">set</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- 1 merged statement (after)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">orders</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">discount</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">Decimal</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">5</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0.00</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">MODIFY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">total</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">Decimal</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">12</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">2</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">DEFAULT</span><span class="token plain"> </span><span class="token number" style="color:rgb(247, 140, 108)">0.00</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">DROP</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">idx_status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">ADD</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INDEX</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">idx_status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">status</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TYPE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">set</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">100</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div><p><code>MODIFY SETTING</code>, <code>RESET SETTING</code>, and column recreations still get their own statements.</p></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="redshift">Redshift<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#redshift" class="hash-link" aria-label="Direct link to Redshift" title="Direct link to Redshift" translate="no">​</a></h3>
<p>Atlas inspects, diffs, and migrates
<a class="" href="https://atlasgo.io/changelog/redshift-external-schema">external schemas</a> across all four source types: the AWS Glue
Data Catalog (Spectrum), Kafka, Kinesis, and federated PostgreSQL. Declare an <code>external</code> block inside
a <code>schema</code> block with the connection and IAM options for that source:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">schema </span><span class="token string" style="color:rgb(195, 232, 141)">"es_catalog"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  external </span><span class="token string" style="color:rgb(195, 232, 141)">"data_catalog"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">database</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"spectrumdb"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">iam_role</span><span class="token plain">     </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"arn:aws:iam::123456789012:role/spectrum"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">region</span><span class="token plain">       </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"us-east-1"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">catalog_role</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"arn:aws:iam::123456789012:role/catalog"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">schema </span><span class="token string" style="color:rgb(195, 232, 141)">"es_kafka"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  external </span><span class="token string" style="color:rgb(195, 232, 141)">"kafka"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">uri</span><span class="token plain">            </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"b-1.kafka.example.internal:9092"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">authentication</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> NONE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>A schema's source cannot be changed in place, so switching an <code>external</code> block's source is planned
as a drop and re-create.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="mysql--mariadb">MySQL &amp; MariaDB<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#mysql--mariadb" class="hash-link" aria-label="Direct link to MySQL &amp; MariaDB" title="Direct link to MySQL &amp; MariaDB" translate="no">​</a></h3>
<p>MySQL gains partitioned tables in HCL, and both MySQL and MariaDB get invisible columns:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Partitions</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Invisible Columns</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/mysql-partitions">Partitioned tables</a> are declared in HCL for MySQL: RANGE, LIST, HASH,
and KEY, including the COLUMNS and LINEAR variants. Partitions live in a table-level <code>partition</code>
block, where expression-based types use <code>by { expr = ... }</code> and column-based types use
<code>columns = [...]</code>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.my.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"range_orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.public</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">partition</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> RANGE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">by</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">expr</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"(`id` + 1)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    partition </span><span class="token string" style="color:rgb(195, 232, 141)">"p0"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">values_less_than</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"101"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">comment</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"first range"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    partition </span><span class="token string" style="color:rgb(195, 232, 141)">"pmax"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">values_less_than</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"MAXVALUE"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">comment</span><span class="token plain">          </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"catch all range"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/mysql-invisible-columns">Invisible columns</a> are supported across inspect, diff, and
migrate on both MySQL and MariaDB. Mark a column with <code>invisible = true</code>:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.my.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"users"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.example</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"id"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"email"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> varchar(</span><span class="token number" style="color:rgb(247, 140, 108)">255</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"legacy_token"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">type</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> varchar(</span><span class="token number" style="color:rgb(247, 140, 108)">255</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">null</span><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">invisible</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>Flipping a column's visibility is planned as a single column modification rather than a drop and
recreate:</p><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">migrations/20260531120000_hide_legacy_token.sql</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Modify "users" table</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">ALTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">TABLE</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">users</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">MODIFY</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">COLUMN</span><span class="token plain"> </span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token identifier">legacy_token</span><span class="token identifier punctuation" style="color:rgb(199, 146, 234)">`</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">varchar</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">255</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">NULL</span><span class="token plain"> INVISIBLE</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div></div></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="sql-server">SQL Server<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#sql-server" class="hash-link" aria-label="Direct link to SQL Server" title="Direct link to SQL Server" translate="no">​</a></h3>
<p><a class="" href="https://atlasgo.io/changelog/sql-server-partitions">Table partitioning</a> adds three constructs: <code>partition_function</code>,
<code>partition_scheme</code>, and a <code>partition</code> block inside <code>table</code>. This is what Atlas inspects back from an
<code>Orders</code> table partitioned on <code>OrderDate</code> across three boundary values:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.ms.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">partition_function </span><span class="token string" style="color:rgb(195, 232, 141)">"PF1"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">input</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">values</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"100"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"200"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"300"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">partition_scheme </span><span class="token string" style="color:rgb(195, 232, 141)">"PS1"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">partition</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> partition_function.PF1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">filegroups</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"PRIMARY"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"PRIMARY"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"PRIMARY"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"PRIMARY"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">table </span><span class="token string" style="color:rgb(195, 232, 141)">"Orders"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">schema</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> schema.dbo</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"OrderID"</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain">, </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"OrderDate"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain">, </span><span class="token property">type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> int </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">primary_key</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">columns</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain">column.OrderID, column.OrderDate</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">partition</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">scheme</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> partition_scheme.PS1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">column</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> column.OrderDate</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Changing only the boundary values is diffed into in-place <code>SPLIT RANGE</code> and <code>MERGE RANGE</code> operations
rather than a drop and recreate, and both are reversible with <code>migrate down</code>.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="new-databases">New Databases<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#new-databases" class="hash-link" aria-label="Direct link to New Databases" title="Direct link to New Databases" translate="no">​</a></h3>
<p>Azure HorizonDB joins the driver list, YugabyteDB graduates from beta to GA, and Aurora DSQL gains
IAM token generation in <code>atlas.hcl</code>:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">Azure HorizonDB</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">YugabyteDB</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Aurora DSQL</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p><a class="" href="https://atlasgo.io/changelog/horizondb-support">Azure HorizonDB</a>, Microsoft's distributed PostgreSQL-compatible
database, is supported through the <code>horizondb://</code> driver across schema inspect, declarative apply,
and versioned migrations. HorizonDB requires SSL, so include <code>sslmode=require</code> in the URL:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-u</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"horizondb://user:pass@host:5432/app?sslmode=require"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> file://schema.hcl </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://postgres/17/dev"</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/yugabytedb-ga">YugabyteDB is now GA</a>: the <code>ysql://</code> driver is supported across the CLI
and the Kubernetes Operator, including automatic dev-database provisioning:</p><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas schema apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-u</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"ysql://yugabyte@localhost:5433/yugabyte?search_path=public&amp;sslmode=disable"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--to</span><span class="token plain"> file://schema.hcl </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  --dev-url </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://ysql/latest"</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><a class="" href="https://atlasgo.io/changelog/aws-dsql-token">Aurora DSQL</a> has no static database password, so the <code>aws_dsql_token</code>
data source signs a fresh IAM auth token on every command from the AWS credentials Atlas already
has:</p><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">locals</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">endpoint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"cluster-id.dsql.us-east-1.on.aws"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">data </span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)">"aws_dsql_token"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"db"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">endpoint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> local.endpoint</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">region</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"us-east-1"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">admin</span><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"dsql"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">url</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"dsql://admin:</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation function" style="color:rgb(130, 170, 255)">urlescape</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string interpolation keyword" style="color:rgb(195, 232, 141);font-style:italic">data</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation type variable" style="color:rgb(191, 199, 213)">aws_dsql_token</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation" style="color:rgb(195, 232, 141)">db</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)">@</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation keyword" style="color:rgb(195, 232, 141);font-style:italic">local</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation type variable" style="color:rgb(191, 199, 213)">endpoint</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)">:5432/postgres?sslmode=require"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">dev</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"docker://dsql/16/dev"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p>There is no long-lived secret to store or rotate.</p></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="simpler-licensing-and-no-ai-training">Simpler Licensing and No AI Training<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#simpler-licensing-and-no-ai-training" class="hash-link" aria-label="Direct link to Simpler Licensing and No AI Training" title="Direct link to Simpler Licensing and No AI Training" translate="no">​</a></h2>
<p>Atlas is now licensed under a single
<a href="https://ariga.io/legal/msa" target="_blank" rel="noopener noreferrer" class="">Master License and Services Agreement</a> covering both the software
(Atlas) and Atlas Cloud, replacing the separate EULA and SaaS agreements. New and free users are
governed by the MSA; existing customers stay on their current agreements. It also puts our AI
data-handling policy in writing: we do not train AI models on your data, and neither do our model
providers, answering a concern that comes up in nearly every security review.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="whats-next">What's Next<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#whats-next" class="hash-link" aria-label="Direct link to What's Next" title="Direct link to What's Next" translate="no">​</a></h2>
<p>This release also ships:</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/declarative-schema-backups">Declarative schema backups</a>,
extending the Registry backups introduced in v1.2 to the declarative workflow.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/config-validate">atlas config validate</a> for static validation of <code>atlas.hcl</code> in CI
and AI authoring loops.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/declarative-schema-renames">Declarative renames</a> with <code>renamed_from</code>; and an
<a class="" href="https://atlasgo.io/versioned/diff#diff-policy">IF NOT EXISTS diff policy</a>.</li>
</ul>
<p>We ship improvements continuously between releases, so follow the <a class="" href="https://atlasgo.io/changelog">Atlas changelog</a> to
stay up to date.</p>
<p>Here is what we are working on next:</p>
<ul>
<li class="">Continued investment in database security, shifting detection further left into CI and
pre-merge checks: more analyzers and broader engine coverage for the security graph.</li>
<li class="">More control over Day 2 data operations, building on Atlas Scripts.</li>
<li class="">Expanded database support, including NoSQL databases: MongoDB, Amazon DocumentDB, DynamoDB, and
others.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>Atlas v1.3 delivers what we promised in v1.2: the security graph for your databases, and backup
storage that now covers the declarative workflow. It is also a first step into data operations:
with Atlas Scripts, the Day 2 work that follows a schema change is versioned, reviewed, and tested
like the migrations before it.</p>
<p>We'd love to hear your feedback! Join our <a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a> or
<a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content:encoded>
            <category>release</category>
            <category>atlas v1.3</category>
            <category>security graph</category>
            <category>atlas scripts</category>
            <category>dataops</category>
            <category>security</category>
            <category>postgres</category>
            <category>oracle</category>
            <category>snowflake</category>
            <category>clickhouse</category>
        </item>
        <item>
            <title><![CDATA[Case Study: Scaling Aryon Security’s Database Deployments with the Atlas Kubernetes Operator]]></title>
            <link>https://atlasgo.io/blog/2026/07/21/case-study-aryon-security</link>
            <guid>https://atlasgo.io/blog/2026/07/21/case-study-aryon-security</guid>
            <pubDate>Tue, 21 Jul 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Learn how Aryon Security adopted the Atlas Kubernetes Operator from its earliest days to automate schema migrations across five environments and three engineering teams.]]></description>
            <content:encoded><![CDATA[<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background">Company Background<a href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security#company-background" class="hash-link" aria-label="Direct link to Company Background" title="Direct link to Company Background" translate="no">​</a></h3>
<p><a href="https://www.aryon.security/" target="_blank" rel="noopener noreferrer" class="">Aryon Security</a> is a preventative cloud security platform that enforces security
policies at the point of deployment, stopping misconfigurations before they ever reach production rather than
flagging them after the fact. Acting as a source-agnostic gatekeeper across AWS, Azure, and GCP, Aryon applies
the same protection whether infrastructure is provisioned through IaC, ClickOps, or third-party providers,
letting security and platform teams define a policy once and ensure only compliant infrastructure is ever
deployed.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-ahead-of-migration-struggles">Getting Ahead of Migration Struggles<a href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security#getting-ahead-of-migration-struggles" class="hash-link" aria-label="Direct link to Getting Ahead of Migration Struggles" title="Direct link to Getting Ahead of Migration Struggles" translate="no">​</a></h3>
<p>Omri Tcherner joined Aryon when it was little more than a handful of employees and an idea. He came in having
experienced the pain schema migrations can cause from a previous role and made an important decision. <em>"I had
very bad experiences with schema migrations, so my goal for us was to do them correctly from day one,"</em> Omri
said. Rather than let schema management become a pain point once the company scaled, they treated it as something
to get right from the very start.</p>
<p>Atlas was one of the first tools Omri researched while setting up Aryon's stack. It was easy to onboard and
worked for their planned setup, so Aryon adopted it before it even had a single production workload to migrate.
18 months later, it's still the only tool the company has used for the job. <em>"We never thought about looking
elsewhere because it's done exactly what we need it to do since the beginning,"</em> Omri said.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="rolling-the-kubernetes-operator-out-to-five-environments">Rolling the Kubernetes Operator Out to Five Environments<a href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security#rolling-the-kubernetes-operator-out-to-five-environments" class="hash-link" aria-label="Direct link to Rolling the Kubernetes Operator Out to Five Environments" title="Direct link to Rolling the Kubernetes Operator Out to Five Environments" translate="no">​</a></h3>
<p>While the core tool met all of Aryon's initial needs, their workflow scaled further when they moved from basic
Helm charts to a more declarative architecture. <em>"We used Helm charts for deployment in our original setup, but
when Atlas’s Kubernetes Operator came out, we were one of the first to jump on the chance to use it,"</em> Omri said.
The <a class="" href="https://atlasgo.io/integrations/kubernetes">Kubernetes Operator</a> opens the door to managing your database schemas with Atlas
from within your Kubernetes cluster. This allows developers to focus on the desired state of their cluster and
let Kubernetes handle the complexities of how to get there. As early adopters running a multi-environment setup,
Omri and the team worked closely with Atlas, sharing real-world feedback to help catch edge cases in the newly
released feature.</p>
<p>Today, that workflow is woven directly into Aryon's engineering pipeline. Day to day, engineers define their
schema in their application code, and Atlas generates versioned migration files directly from it. Before any code
is merged to dev, Atlas's CI checks catch non-linear migration histories before they can compromise the database.</p>
<p>Once a pull request is approved, the Operator takes over for deployment. Aryon runs a separate instance of the
Operator across five distinct environments: dev, staging, an integration testing cluster, and two production
regions. The Operator treats database migrations like any other declarative Kubernetes resource, applying them
automatically during deployment without a single engineer needing to run anything by hand.</p>
<p>This workflow extends all the way down to local machines. Aryon's backend and research teams spin up local
Kubernetes clusters managed by the same Operator setup. For the research team writing Aryon's security policies,
that consistency matters: to validate a new policy, they deploy Aryon's full stack locally, let the Operator
migrate the database, and test their work against live cloud sandboxes.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome">The Outcome<a href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security#the-outcome" class="hash-link" aria-label="Direct link to The Outcome" title="Direct link to The Outcome" translate="no">​</a></h3>
<p>Now, the Kubernetes Operator has become invisible infrastructure for Aryon. Schema changes just ship as part of
every deployment, in every environment, without engineers thinking about them.</p>
<ul>
<li class=""><strong>A Frictionless Developer Experience.</strong> Schema management stays out of the engineers' way entirely. With their
internal setup, new engineers run a single command that generates protobufs and Atlas migrations together. <em>"It
connects to our models and people don't even have to think about migrations, they just happen,"</em> Omri said.</li>
<li class=""><strong>Consistency Across Teams and Environments.</strong> The same migration workflow scales across the whole
organization. Two backend teams and a research team all follow the same process, while the Kubernetes Operator
applies it uniformly across five environments as well as local development.</li>
<li class=""><strong>Layered Testing and Guardrails.</strong> Atlas's checks run in CI to catch nonlinear migration history before it
merges, and Aryon also uses Atlas to run randomized migrations inside its unit tests, adding another layer of
confidence before schema changes ship.</li>
<li class=""><strong>Responsive Support When It Matters.</strong> When a CI misconfiguration once pushed a bad migration toward
production, Omri worked through the fix directly with the Atlas team over Slack. <em>"Every time we need anyone
from the team, they're always available to help,"</em> he said.</li>
</ul>
<p>Looking ahead, Aryon is continuing its track record as an early adopter by serving as one of the frontrunners for
Atlas's new ad-hoc data migration feature. <em>"That’s something we’re really looking forward to,"</em> says Omri. <em>"It
will give us another layer of interaction with the product that will further improve our workflow."</em></p>
<p>At the same time, Aryon is preparing to expand beyond its lean PostgreSQL setup by adding ClickHouse to its
architecture. Atlas’s native support for ClickHouse means the team can seamlessly bring another database engine
under the exact same automated Operator workflow without adding operational complexity or breaking stride.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started">Getting Started<a href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security#getting-started" class="hash-link" aria-label="Direct link to Getting Started" title="Direct link to Getting Started" translate="no">​</a></h3>
<p>If you're running Kubernetes across multiple environments and want schema migrations to deploy automatically and
safely as part of your existing rollout process, the <a class="" href="https://atlasgo.io/integrations/kubernetes">Atlas Kubernetes Operator</a>
can fold database changes into the same pipeline you already use to ship everything else.</p>
<p>If your team is trying to build good migration habits before schema management becomes a bottleneck, or needs one
consistent workflow across dev, staging, and multiple production regions, Atlas is the solution for you.</p>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[Case Study: Automating Gumloop's Database Management with Atlas's Schema-as-Code Tooling]]></title>
            <link>https://atlasgo.io/blog/2026/07/06/case-study-gumloop</link>
            <guid>https://atlasgo.io/blog/2026/07/06/case-study-gumloop</guid>
            <pubDate>Mon, 06 Jul 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Learn how Gumloop extended its Terraform-based IaC approach to database schemas, chose Atlas over Liquibase and Flyway, and wired schema validation into an AI-assisted development workflow.]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><em>"The biggest win of any tool is when you don't need to look at it ever again and it just works."</em></p>
<p>– Wai Ho Choy, Infrastructure Lead, Gumloop</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background">Company Background<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#company-background" class="hash-link" aria-label="Direct link to Company Background" title="Direct link to Company Background" translate="no">​</a></h3>
<p><a href="https://www.gumloop.com/" target="_blank" rel="noopener noreferrer" class="">Gumloop</a> is a collaborative platform that empowers anyone in a company to build AI agents
using their preferred models and integrations, while giving IT enterprise-grade visibility and control. Whether these
agents are deployed in Gumloop's secure environment or within your own infrastructure, your data always stays entirely
in your systems.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="managing-schemas-like-terraform">Managing Schemas Like Terraform<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#managing-schemas-like-terraform" class="hash-link" aria-label="Direct link to Managing Schemas Like Terraform" title="Direct link to Managing Schemas Like Terraform" translate="no">​</a></h3>
<p>When Wai Ho Choy joined Gumloop in late 2025, the engineering team had just migrated its infrastructure to Terraform.
Declarative, reproducible deployments were the new organizational standard. Kubernetes worked that way; GCP resources
worked that way. Databases, however, did not.</p>
<p>Schema changes were still applied manually, with SQL operations executed one at a time via Google Cloud commands.
Managing multiple database copies across client environments made it impossible to answer basic questions reliably:
<em>Was a change actually applied? In what order? Did it stay in sync with the application code?</em></p>
<p><em>"Those are the basic problems of maintaining a database without infrastructure-as-code,"</em> Wai Ho said.</p>
<p>The natural next step was to manage schemas the same way Gumloop managed everything else: define the desired state in
code, let the platform reconcile the system to match, and trust the process to be entirely repeatable.</p>
<p>The team initially turned to Terraform for Google Cloud Spanner schema definitions, but Spanner support proved too
limited. Operations failed, sequences broke, and index changes conflicted. Ultimately, the Terraform operator rollout
did not survive contact with production.</p>
<p>Gumloop needed a true infrastructure-as-code (IaC) equivalent for databases that was declarative by design,
deterministic during migrations, and seamlessly compatible with the rest of their toolchain.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="searching-for-a-solution">Searching for a Solution<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#searching-for-a-solution" class="hash-link" aria-label="Direct link to Searching for a Solution" title="Direct link to Searching for a Solution" translate="no">​</a></h3>
<p>With Terraform ruled out for day-to-day schema management, Gumloop turned to the conventional options. Liquibase was
the default recommendation, and Flyway was another contender.</p>
<p>Operating under a tight deadline, Wai Ho evaluated both. Gumloop's manual processes were already fracturing as
dedicated customer deployments multiplied. There was no time for a lengthy evaluation or a heavy rollout. The team
needed a tool that could bridge two worlds: the declarative model promised by Terraform and the explicit sequencing of
versioned migrations.</p>
<p>Neither legacy option fit the bill.</p>
<p><em>"Liquibase felt overly verbose and generally outdated,"</em> Wai Ho said. Flyway and other alternatives required
extensive boilerplate setup before Gumloop could manage a single database. Neither felt like a natural extension of
the IaC culture the team had just established with Terraform.</p>
<p>Furthermore, a unique requirement shaped their search. Since Gumloop builds heavily with AI coding agents, any schema
tooling had to seamlessly integrate into a programmatic, terminal-first workflow. <em>"I want to see linting output in
GitHub Actions. I want my AI to be able to see it, concisely, in one scroll at most,"</em> Wai Ho explained.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="choosing-atlas">Choosing Atlas<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#choosing-atlas" class="hash-link" aria-label="Direct link to Choosing Atlas" title="Direct link to Choosing Atlas" translate="no">​</a></h3>
<p>Atlas was not initially on the list, but once Wai Ho evaluated it alongside Liquibase and Flyway, the contrast was
stark: Atlas shipped as a single binary and natively supported both declarative and versioned workflows out of the box.</p>
<p><em>"When I looked at the documentation, I thought, 'This is what developers actually want to use,'"</em> Wai Ho recalled.
<em>"The guides for every integration I could ever need were right there and incredibly well-documented, whether for
GitHub Actions, the Kubernetes operator, the Terraform provider, or declarative and versioned migrations."</em></p>
<p>Atlas supports both declarative and versioned migration models without forcing the team to adopt a second tool or a
conflicting mental model, allowing Gumloop to achieve a working integration faster than with any other option on the
table. <em>"I fought for Atlas,"</em> Wai Ho said. <em>"If I'm going to maintain multiple databases, this is the tool I'm
choosing."</em></p>
<p>Today, Atlas serves as the schema management layer across Gumloop's multi-tenant environments spanning Google Cloud
Spanner, Amazon Aurora PostgreSQL, and ClickHouse, and integrates seamlessly into their automated CI/CD pipeline. On
every pull request, a GitHub Action spins up the Atlas CLI to validate changes by performing a precise three-way
comparison against staging and production.</p>
<p>To top it off, the team configured their AI agents to use Atlas's documentation for context awareness when interacting
with Atlas's CLI outputs. This allows them to interpret real-time linting results, generate accurate schema changes,
and handle integration syntax completely on their own.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome">The Outcome<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#the-outcome" class="hash-link" aria-label="Direct link to The Outcome" title="Direct link to The Outcome" translate="no">​</a></h3>
<p>Choosing Atlas gave Gumloop a schema workflow that perfectly mirrors how the team thinks about infrastructure and how
they build with AI.</p>
<p>Today, when a schema change is needed, an AI agent often drafts the migration, a human reviews it, and CI takes over.
If a migration fails, the feedback loop is instantaneous.</p>
<p><em>"The linter may pass visually, but when you run the development database against it, it cracks,"</em> Wai Ho described.
<em>"That is where Atlas helps. It answers: 'If you were to deploy this today for a new tenant, would it work?'"</em> When a
failure occurs, the Atlas CLI output is specific enough that the AI agent can parse the error and automatically fix it.</p>
<p>Months after adoption, Atlas runs quietly in the background, delivering several core benefits to the Gumloop team:</p>
<ul>
<li class="">
<p><strong>True IaC for Databases:</strong> Gumloop maintained the declarative mindset they used for Kubernetes and GCP while
gaining deterministic, versioned migrations. <em>"Once I started using Terraform, I couldn't go back to anything that
wasn't like it,"</em> Wai Ho said.</p>
</li>
<li class="">
<p><strong>Multi-Cloud Consistency:</strong> Atlas acts as the unified schema layer across Google Cloud Spanner, Amazon Aurora
PostgreSQL, and ClickHouse. When an AWS expansion required switching from versioned migrations to a declarative
model, the team executed the pivot seamlessly without any additional tooling.</p>
</li>
<li class="">
<p><strong>Automated Drift Detection:</strong> By running three-way comparisons between pull requests, staging, and production on
every PR, Atlas catches manual hotfixes instantly and gives developers complete context before deployment.</p>
</li>
<li class="">
<p><strong>AI-Native Workflows:</strong> The terminal-first, concise CLI output allows AI coding agents to independently debug,
reorder files, and resolve migration issues without human engineers getting bogged down in long debugging loops.</p>
</li>
<li class="">
<p><strong>Zero Overhead:</strong> Atlas successfully handles thousands of lines of schema code without demanding ongoing
maintenance. As Wai Ho concluded, <em>"The goal of any infrastructure engineer is to build a bridge that stays up. If I
have to go back in, the tool has failed. With Atlas, it's been months since I've had to touch anything."</em></p>
</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started">Getting Started<a href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop#getting-started" class="hash-link" aria-label="Direct link to Getting Started" title="Direct link to Getting Started" translate="no">​</a></h3>
<p>By treating database schemas with the same infrastructure-as-code discipline as the rest of the stack, Gumloop
eliminated the manual bottlenecks that threaten scaling engineering teams. Integrating Atlas into their CI/CD pipeline
didn't just automate their migrations, it created a deterministic, visible, and AI-ready workflow without adding
operational overhead.</p>
<p>If your team already manages infrastructure with Terraform and wants the same approach for database schemas, or needs
schema checks that fit an AI-assisted development workflow, Atlas could be the solution for you.</p>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[Case Study: How EliseAI Democratized Schema Management Across 50 Databases]]></title>
            <link>https://atlasgo.io/blog/2026/06/25/case-study-eliseai</link>
            <guid>https://atlasgo.io/blog/2026/06/25/case-study-eliseai</guid>
            <pubDate>Thu, 25 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Learn how EliseAI moved from a four-person schema gatekeeper model to letting 50+ engineers safely manage migrations with Atlas.]]></description>
            <content:encoded><![CDATA[<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background"><strong>Company Background</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#company-background" class="hash-link" aria-label="Direct link to company-background" title="Direct link to company-background" translate="no">​</a></h3>
<p><a href="https://www.eliseai.com/" target="_blank" rel="noopener noreferrer" class="">EliseAI</a> transforms complex housing and healthcare systems, helping property managers
and healthcare providers handle leasing, maintenance, and resident engagement. By deeply integrating into workflows
and automating operations, it cuts costs for all parties. EliseAI powers 1 in 6 rental apartment units in the U.S.,
processing hundreds of thousands of messages and thousands of voice calls per day.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="four-admins-for-fifty-databases"><strong>Four Admins for Fifty Databases</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#four-admins-for-fifty-databases" class="hash-link" aria-label="Direct link to four-admins-for-fifty-databases" title="Direct link to four-admins-for-fifty-databases" translate="no">​</a></h3>
<p>A service at this scale is sure to result in vast amounts of data. Ken Koch, Director of Engineering,
explained that their team organizes it all by function. <em>"At this point we probably have 50 different databases
that we vertically sharded to handle specific purposes,"</em> Ken said. Each database is tied to the microservice that
owns it — CRM, maintenance scheduling, resident charges, and more — with event-driven functions running on AWS.</p>
<p>Schema changes did not keep pace with that architecture. Following industry standards, production database access
was limited to a handful of administrators to minimize human error and ensure compliance. While this "gatekeeper
model" reduced the risk of conflicting or careless changes, it quickly became a persistent bottleneck as the
organization scaled.</p>
<p><em>“Four of us had admin-level schema access, and if anyone wanted to make any schema changes, they would send those
through to us. It doesn't scale very well,"</em> Ken said. Every structural change competed for the same small pool of
people, so when an engineer needed a column added or an index created, they simply had to send the request and wait
for an admin to execute it by hand.</p>
<p>A newer pressure compounded the problem. As the team leaned into AI-assisted development, coding tools needed an
accurate, up-to-date view of the schema to generate useful changes. A workflow that kept schema changes in the hands
of four administrators, or let production drift out of sync with the codebase, worked directly against that goal.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="searching-for-a-solution"><strong>Searching for a Solution</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#searching-for-a-solution" class="hash-link" aria-label="Direct link to searching-for-a-solution" title="Direct link to searching-for-a-solution" translate="no">​</a></h3>
<p>The team turned to existing tools, such as Alembic, to introduce more structure into the schema management process.
<em>"We introduced Alembic as a solution and ran into versioning issues or conflicts constantly, which added a lot of
friction to the workflow,"</em> Ken explained. Engineers who should have been iterating on the product were instead
untangling migration history.</p>
<p>They began looking for a solution that would give engineers more agency over schema changes, but versioned workflows
that required maintaining parallel migration histories across dozens of databases were not enough.</p>
<p>Several requirements shaped what they were looking for. <em>"Admins should be able to make manual database changes when
needed. They cannot be blocked by a tool if there are critical issues,"</em> Ken said. They also needed an additive
workflow where the declared schema drove what got created or extended without automatically reverting manual production
adjustments.</p>
<p>Additionally, with the team investing in AI-assisted development, they needed the schema to live in version control
where both engineers and tooling could read it. <em>"I want the AI agents to be schema aware. It should be able to propose
updates to our database schema and know exactly what's going on so that we can make the best changes,"</em> Ken said.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="choosing-atlas"><strong>Choosing Atlas</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#choosing-atlas" class="hash-link" aria-label="Direct link to choosing-atlas" title="Direct link to choosing-atlas" translate="no">​</a></h3>
<p>After evaluating several options, Ken's team came across Atlas, a database schema-as-code tool that treats the
desired schema state as the source of truth and plans the minimal set of changes to reach it.</p>
<p><em>"I wanted something where I define what my schema should look like,"</em> Ken said. Atlas offered that declarative model
— a source of truth in code that describes the desired end state, with the tool planning the diff.</p>
<p>The team also wanted their schema workflow to fit naturally into GitHub, where the rest of their development process
already lived. They used Atlas-Action to tailor their schema workflow to the sequence they already follow: propose a
schema change, validate and apply it in the appropriate environment, and only then merge. <em>"It felt collaborative,"</em>
Ken said of working with the Atlas team. <em>"I really appreciate all the effort and help you all provided us on it, too."</em></p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome"><strong>The Outcome</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#the-outcome" class="hash-link" aria-label="Direct link to the-outcome" title="Direct link to the-outcome" translate="no">​</a></h3>
<p>Choosing Atlas gave EliseAI a declarative way to manage schema across its sharded database fleet and a direct path
out of the gatekeeper bottleneck.</p>
<p>To make schema changes, an engineer creates a branch, updates the schema files, and opens a pull request. Atlas
Actions generate the migration, lint the proposed changes, and report results on the PR. Engineers receive feedback
on potential risks and can iterate without waiting for an administrator to run statements by hand. The team also
added checksum validation in GitHub Actions to catch race conditions when multiple schema pull requests are open
at once.</p>
<p>In addition to unblocking the workflow, Ken noted other benefits of using Atlas:</p>
<ul>
<li class=""><strong>Democratized Database Changes.</strong> Before Atlas, four administrators owned every structural change across the
database fleet. Today, between 50 and 60 engineers contribute schema changes through the same pull request workflow
used for application code. <em>"Everyone is adding database changes and making data changes now,"</em> Ken said.</li>
<li class=""><strong>Safety and Stability.</strong> Since Atlas went into production use, the team has not hit the locking or migration
failures that previously made engineers hesitate to propose changes. <em>"We haven't had any database locking or
migration issues since we've rolled out Atlas,"</em> he added.</li>
<li class=""><strong>Self-Service Conflict Resolution.</strong> With an additive, declarative workflow, engineers gained the confidence
to manage their own changes rather than escalating every collision. <em>"Once they understand what Atlas is doing,
they're able to easily fix schema conflicts that other people have introduced, rebase, and unblock themselves,"</em>
Ken explained.</li>
<li class=""><strong>Stronger Testing Practices.</strong> EliseAI moved toward integration-level testing with real database schemas spun
up for each run, rather than relying on unit tests alone to catch structural mismatches.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started"><strong>Getting Started</strong><a href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai#getting-started" class="hash-link" aria-label="Direct link to getting-started" title="Direct link to getting-started" translate="no">​</a></h3>
<p>By managing your schema as code and configuring Atlas-Actions in CI/CD, you can automate migration creation and
review so schema changes no longer depend on a handful of people with admin-level schema access.</p>
<p>If your team is struggling with a gatekeeper model for schema changes, or if versioned migration tools keep stalling
your workflow the way they did for EliseAI, Atlas could be the solution for you.</p>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[Case Study: How Wenrix Made Schema Migrations Reliable with Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/06/16/case-study-wenrix</link>
            <guid>https://atlasgo.io/blog/2026/06/16/case-study-wenrix</guid>
            <pubDate>Tue, 16 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Learn how Wenrix replaced manual migration workflows with Atlas to gate deployments, prevent drift-related downtime, and make schema changes effortless across their AWS and Kubernetes stack.]]></description>
            <content:encoded><![CDATA[<blockquote>
<p><em>"Atlas just works behind the scenes. We don't need to pay attention to it – we can trust that it's getting the job done."</em></p>
<p>– Armon Avrahamy, CTO and Co-Founder, Wenrix</p>
</blockquote>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="company-background">Company Background<a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#company-background" class="hash-link" aria-label="Direct link to Company Background" title="Direct link to Company Background" translate="no">​</a></h3>
<p><a href="https://www.wenrix.com/" target="_blank" rel="noopener noreferrer" class="">Wenrix</a> is the AI infrastructure for profitable growth in air. Since 2018, leading
travel agencies have relied on Wenrix to help them grow revenue, protect margin, and scale more efficiently
in an increasingly complex and competitive air retail landscape.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="keeping-up-with-a-growing-stack">Keeping Up With a Growing Stack<a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#keeping-up-with-a-growing-stack" class="hash-link" aria-label="Direct link to Keeping Up With a Growing Stack" title="Direct link to Keeping Up With a Growing Stack" translate="no">​</a></h3>
<p>As Wenrix grew in its beginning stages, so did the surface area for schema changes. The team runs multiple PostgreSQL
databases segmented by function and product, deploys on Kubernetes, and ships multiple deployments per day. Keeping
application code and the database state aligned at this pace became a difficult operational problem, and the migration
workflow in place was not built for it. As Wenrix expanded its platform and accelerated release velocity, database
schema management became an increasingly important part of maintaining engineering efficiency.</p>
<p>In the early years, migrations were entirely manual. While the team eventually integrated tools like go-migrate with
custom CI scripts, the operational complexity of managing schema changes across multiple services continued to grow.
<em>“We deployed two to three times a day and needed a more scalable way to manage schema changes across environments,”</em>
said Armon Avrahamy, CTO and co-founder. Coordinating manual steps such as timing, verification, and validation of
schema safety became a significant bottleneck as the team scaled.</p>
<p>Manual coordination became increasingly difficult to sustain at the company's deployment velocity. Managing data at
this scale required moving past manual processes toward an automated approach. Ultimately, Wenrix needed a migration
workflow that could keep pace with how the company actually operated.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="searching-for-a-solution">Searching for a Solution<a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#searching-for-a-solution" class="hash-link" aria-label="Direct link to Searching for a Solution" title="Direct link to Searching for a Solution" translate="no">​</a></h3>
<p>Armon began evaluating migration tools that could impose more structure without compromising on efficiency.
Python-specific options like SQLAlchemy were an early consideration, but not every service in Wenrix's stack used
the same ORM, and tying schema management to a single application framework would have meant different migration
paths for different parts of the system. That inconsistency was exactly what they were trying to avoid.</p>
<p>They also looked at established SQL migration tools such as Flyway, but found the fit wrong for a different reason.
<em>"Other solutions seemed too complicated for our specific use case,"</em> Armon said. Wenrix did not need a heavyweight,
Java-centric workflow layered on top of a Python and Kubernetes environment. They needed something that could sit
alongside their existing deployment pipeline and treat schema changes the same way everywhere.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="choosing-atlas">Choosing Atlas<a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#choosing-atlas" class="hash-link" aria-label="Direct link to Choosing Atlas" title="Direct link to Choosing Atlas" translate="no">​</a></h3>
<p>In 2024, Wenrix turned to Atlas. Its architecture matched how Armon wanted to think about schema changes.
<em>"I was drawn to the similar concept to Terraform,"</em> Armon said, describing a declarative model where the desired
state is defined in code and the tool plans what needs to happen to get there.</p>
<p>With guidance from the Atlas team, Wenrix moved from a purely declarative workflow to versioned migration files
generated with a pre-commit script, paired with the <a href="http://integrations/kubernetes/versioned" target="_blank" rel="noopener noreferrer" class="">Atlas Kubernetes Operator</a>
to apply changes as part of their deployment pipeline. That combination gave them explicit, reviewable SQL migrations
and automated enforcement at deploy time.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="the-outcome">The Outcome<a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#the-outcome" class="hash-link" aria-label="Direct link to The Outcome" title="Direct link to The Outcome" translate="no">​</a></h3>
<p>Choosing Atlas gave Wenrix a migration workflow built for the pace at which they actually ship. Armon pointed
to several benefits:</p>
<ul>
<li class=""><strong>Deployment Gating.</strong> If a migration is unsafe, the system automatically prevents the deployment. This
ensures that only validated schema changes reach production, maintaining environment consistency without
manual intervention.</li>
<li class=""><strong>Minimal Overhead.</strong> Beyond reliability, the workflow faded into the background. <em>"Atlas just works behind
the scenes,"</em> Armon said, requiring very little ongoing attention from developers.</li>
<li class=""><strong>Low-Friction Schema Changes.</strong> Versioned migration files generated at commit time mean engineers change
one file and the rest of the pipeline handles planning, review, and apply. <em>"Running the migration is much
easier to do now. You just edit one file, start the pipeline, and it's done,"</em> he added.</li>
<li class=""><strong>Healthier Data Modeling.</strong> When schema changes require significant effort, teams naturally become more
conservative about structural changes. Now that migrations are seamless, teams can prioritize clean, structured
data models that evolve alongside the application code.</li>
<li class=""><strong>Operational Scalability.</strong> Schema changes run automatically through the Kubernetes operator as part of every
deployment, removing the operational complexity of managing manual coordination across multiple services.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started"><strong>Getting Started</strong><a href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix#getting-started" class="hash-link" aria-label="Direct link to getting-started" title="Direct link to getting-started" translate="no">​</a></h3>
<p>By managing your schema as code and integrating Atlas into your CI/CD or Kubernetes deployment pipeline, you can
automate migration generation and block unsafe changes before they reach production.</p>
<p>If your team ships frequently and relies on manual migration steps, or if managing the alignment between application
code and database schema has become an operational bottleneck, Atlas can help streamline your delivery pipeline.</p>]]></content:encoded>
            <category>case study</category>
        </item>
        <item>
            <title><![CDATA[Testing PostgreSQL Schemas with pgTAP and Atlas]]></title>
            <link>https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas</link>
            <guid>https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas</guid>
            <pubDate>Thu, 11 Jun 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Compare pgTAP and Atlas for PostgreSQL schema testing, learn when to reach for lint rules instead, and find out how to combine both tools with TAP-formatted diagnostics in CI.]]></description>
            <content:encoded><![CDATA[<p>Testing your database schema shouldn't be an afterthought. Automating checks on your objects, constraints,
and functions is critical to catching breaking changes before they hit production.</p>
<p>Enter pgTAP—which relies on traditional runtime assertions in an ephemeral database—and Atlas—which leverages
a modern, declarative approach. This post breaks down how both tools handle schema testing and explains when
you should swap out heavy runtime assertions for Atlas's lightweight lint rules.</p>
<!-- -->
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-tap">What is TAP?<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#what-is-tap" class="hash-link" aria-label="Direct link to What is TAP?" title="Direct link to What is TAP?" translate="no">​</a></h3>
<p><a href="https://testanything.org/" target="_blank" rel="noopener noreferrer" class="">TAP</a> (Test Anything Protocol) is a text-based interface used to communicate the
results of unit tests to a test harness. It standardizes test outputs into a stream of sequential, readable
lines that denote whether a test passed or failed, along with the test count and optional diagnostics. This
protocol decouples the execution of a database's test logic from the reporting tool, allowing developers to
use familiar TAP-compliant harnesses (like Perl's <code>prove</code>) to aggregate and analyze test results.</p>
<p>A typical TAP stream looks like this:</p>
<div class="language-testoutput codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-testoutput codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">1..3</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ok 1 - users table should exist</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">ok 2 - email should not be null</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">not ok 3 - name should not be null</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"># Failed test 3: "name should not be null"</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">#     Column public.users.name may be null</span><br></span></code></pre></div></div>
<p>The first line declares how many tests ran (<code>1..3</code>). Each <code>ok</code> or <code>not ok</code> line reports one result. Lines starting
with <code>#</code> carry optional diagnostics when a test fails.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-pgtap">What is pgTAP?<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#what-is-pgtap" class="hash-link" aria-label="Direct link to What is pgTAP?" title="Direct link to What is pgTAP?" translate="no">​</a></h3>
<p><a href="https://pgtap.org/" target="_blank" rel="noopener noreferrer" class="">pgTAP</a> is a PostgreSQL extension that wraps schema checks in SQL-callable assertion functions
for structures, permissions, and business logic, and reports results using the TAP format.</p>
<p>For example:</p>
<div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">plan</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token number" style="color:rgb(247, 140, 108)">1</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> has_table</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token string" style="color:rgb(195, 232, 141)">'public'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'users'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">'users table should exist'</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> </span><span class="token operator" style="color:rgb(137, 221, 255)">*</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">FROM</span><span class="token plain"> finish</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<p>Running this against a database with a <code>users</code> table prints:</p>
<div class="language-testoutput codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-testoutput codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">ok 1 - users table should exist</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-atlas">What is Atlas?<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#what-is-atlas" class="hash-link" aria-label="Direct link to What is Atlas?" title="Direct link to What is Atlas?" translate="no">​</a></h3>
<p><a class="" href="https://atlasgo.io/docs">Atlas</a> treats your database schema as code. Its testing framework uses <code>.test.hcl</code> files to manage test suites,
allowing you to write assertions in plain SQL while using the <a class="" href="https://atlasgo.io/atlas-schema/hcl">Atlas DDL (HCL)</a> to handle seed
data, cleanup, parallelism, and table-driven runs.</p>
<p>For example:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">test </span><span class="token string" style="color:rgb(195, 232, 141)">"schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"users_email"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">catch</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">sql</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"INSERT INTO users (email) VALUES (NULL)"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"null value in column \"email\""</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Running <code>atlas schema test --env local</code> reports <code>PASS</code> or <code>FAIL</code> for each case:</p>
<div class="language-testoutput codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-testoutput codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token dash2">--</span><span class="token pass"> PASS</span><span class="token plain">: users_email (12ms)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">PASS</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="how-pgtap-and-atlas-compare">How pgTAP and Atlas Compare<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#how-pgtap-and-atlas-compare" class="hash-link" aria-label="Direct link to How pgTAP and Atlas Compare" title="Direct link to How pgTAP and Atlas Compare" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="test-environment-and-scope">Test Environment and Scope<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#test-environment-and-scope" class="hash-link" aria-label="Direct link to Test Environment and Scope" title="Direct link to Test Environment and Scope" translate="no">​</a></h3>
<p>pgTAP runs assertions inside the database session you connect to. By default, tests execute inside a transaction that
rolls back when finished, so your real data is never modified. You are responsible for making sure the connected
database reflects the schema you want to test, typically by spinning up a Docker container or restoring from a dump.</p>
<p>Atlas takes a different starting point. Before each test case, it provisions a fresh schema on a dev database, applies
the declared schema source (an HCL or SQL schema file, a migration directory, or a composite of sources), runs the
assertions, and cleans up afterward. This means Atlas tests are always tied to a specific schema definition, not just
whatever happens to be in a running instance.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="writing-and-organizing-tests">Writing and Organizing Tests<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#writing-and-organizing-tests" class="hash-link" aria-label="Direct link to Writing and Organizing Tests" title="Direct link to Writing and Organizing Tests" translate="no">​</a></h3>
<p>pgTAP's strength is its library of pre-written assertion functions. Checking that a table exists, a column has the
right type, or a query throws the expected error requires only a single function call rather than hand-written catalog
queries.</p>
<p>Atlas tests use familiar SQL for the assertions themselves, but the structure around them (test cases, seed data,
cleanup, parallelism, and table-driven patterns) is defined in HCL. This is to support the use of Atlas for testing
business logic, such as validating migration behavior, asserting function and trigger output, and verifying views
and queries return expected results. Atlas supports <a class="" href="https://atlasgo.io/testing/schema#table-driven-tests"><code>for_each</code></a>
for table-driven cases, <a class="" href="https://atlasgo.io/testing/schema#the-test-schema-block"><code>parallel</code></a> execution for independent tests, and an
<a class="" href="https://atlasgo.io/testing/schema#external-command"><code>external</code></a> command to invoke programs outside the database when SQL alone is not
enough.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="shared-capabilities">Shared Capabilities<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#shared-capabilities" class="hash-link" aria-label="Direct link to Shared Capabilities" title="Direct link to Shared Capabilities" translate="no">​</a></h3>
<p>Despite their different architectures, pgTAP and Atlas cover much of the same ground:</p>
<table><thead><tr><th>Area</th><th>What you can verify</th></tr></thead><tbody><tr><td><strong>Values and data</strong></td><td>Queries return expected values, match regular expressions, or compare numbers</td></tr><tr><td><strong>Errors</strong></td><td>A statement fails with a specific error message or code, and queries run without crashing</td></tr><tr><td><strong>Query results</strong></td><td>Two result sets match, a query is empty, or a specific row exists in a larger dataset</td></tr><tr><td><strong>Database structure</strong></td><td>Tables, schemas, views, and indexes exist; columns have the expected types, defaults, and nullability</td></tr><tr><td><strong>Constraints and keys</strong></td><td>Primary keys, foreign keys, unique constraints, and check constraints behave correctly</td></tr><tr><td><strong>Security</strong></td><td>Ownership, grants, RLS policies, and function behavior under different roles</td></tr></tbody></table>
<p>Where they diverge is less about what you can assert and more about how you set up the environment, organize tests, and
integrate with schema-as-code and migration workflows.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="when-to-reach-for-lint-rules-instead">When to Reach for Lint Rules Instead<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#when-to-reach-for-lint-rules-instead" class="hash-link" aria-label="Direct link to When to Reach for Lint Rules Instead" title="Direct link to When to Reach for Lint Rules Instead" translate="no">​</a></h3>
<p>pgTAP and Atlas lint rules can assert many of the same things, but they operate at different layers. Lint rules are
static analysis: Atlas reads your schema source defined in HCL, SQL, or migration files, and evaluates it against
policies you define in <code>.rule.hcl</code> files. pgTAP is runtime verification: assertions run inside a live PostgreSQL
session after the schema has been applied to a database.</p>
<p>That distinction matters for day-to-day workflow. A lint check does not need the pgTAP extension or Docker. It runs
in milliseconds and fits naturally into <code>atlas schema lint</code> during local development and <code>atlas migrate lint</code> in CI,
where it can flag violations introduced by a specific migration without re-scanning the entire schema history.</p>
<table><thead><tr><th>Check</th><th>pgTAP function</th><th>Lint rule alternative</th></tr></thead><tbody><tr><td>Table exists</td><td><code>has_table()</code></td><td>Assert on <code>table</code> objects in a <code>rule</code> block</td></tr><tr><td>Primary key</td><td><code>has_pk()</code></td><td>Assert on <code>primary_key</code> blocks in your schema</td></tr><tr><td>Column type and nullability</td><td><code>col_type_is()</code>, <code>col_not_null()</code></td><td>Assert on <code>column</code> attributes</td></tr><tr><td>Role properties</td><td><code>role_ok()</code></td><td>Assert on <code>role</code> attributes (e.g., <code>superuser</code>, <code>login</code>)</td></tr><tr><td>Table grants</td><td><code>table_privs_are()</code></td><td>Assert on <code>permission</code> blocks declared in your schema</td></tr><tr><td>Grantable privileges</td><td><code>table_privs_are()</code> with grant option checks</td><td><code>permission.grantable</code> predicates</td></tr></tbody></table>
<p>For policy-style checks—"every table must have a primary key," "identifier columns must be not null"—lint rules are the
better default. For example, instead of provisioning a database and calling <code>col_not_null()</code>, you can express the
constraint in a rule:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.rule.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">predicate </span><span class="token string" style="color:rgb(195, 232, 141)">"column"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"not_null_or_have_default"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">or</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">default</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">ne</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> null</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">null</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">eq</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rule </span><span class="token string" style="color:rgb(195, 232, 141)">"schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"column-notnull"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">description</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"require columns to be not null or have a default value"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">table</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">column</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token keyword" style="font-style:italic">assert</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token property">predicate</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> predicate.column.not_null_or_have_default</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token property">message</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"column </span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">$</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token string interpolation keyword" style="color:rgb(195, 232, 141);font-style:italic">self</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token string interpolation type variable" style="color:rgb(191, 199, 213)">name</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)"> must be not null or have a default value"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Reach for pgTAP in Atlas schema tests when you need to verify post-apply behavior, want
TAP-formatted diagnostics in CI, or the check is easier to express as SQL than as a declarative rule.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="conclusion">Conclusion<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#conclusion" class="hash-link" aria-label="Direct link to Conclusion" title="Direct link to Conclusion" translate="no">​</a></h2>
<p>pgTAP and Atlas both help you test PostgreSQL schemas, but they solve different parts of the problem.</p>
<p>pgTAP excels at SQL-native assertions with rich TAP diagnostics. Functions like <code>table_privs_are()</code> make privilege
checks concise, and TAP output shows exactly which grant is missing when a test fails.</p>
<p>Atlas excels at tying tests to a declared schema. It provisions isolated environments, orchestrates test cases in HCL,
and fits naturally into schema-as-code and CI/CD workflows. For many structural checks, Atlas lint rules are the better
fit; pgTAP in schema tests is useful when you want TAP-formatted runtime verification on a provisioned database.</p>
<p>Using them together, you can run pgTAP assertions directly from Atlas schema tests without a separate test runner.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="try-it-yourself">Try It Yourself<a href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas#try-it-yourself" class="hash-link" aria-label="Direct link to Try It Yourself" title="Direct link to Try It Yourself" translate="no">​</a></h3>
<p>Our <a class="" href="https://atlasgo.io/guides/postgres/pgtap-with-atlas">pgTAP with Atlas guide</a> walks through a complete project setup: declaring
the pgTAP extension, configuring a dev database with the extension installed, writing <code>exec</code> blocks that call pgTAP
functions like <code>table_privs_are()</code>, and catching privilege regressions in CI with TAP-formatted failure output.</p>]]></content:encoded>
            <category>postgres</category>
            <category>testing</category>
            <category>pgtap</category>
            <category>schema testing</category>
        </item>
        <item>
            <title><![CDATA[MySQL 8.0 End of Life: Plan Your Move Before Support Runs Out]]></title>
            <link>https://atlasgo.io/blog/2026/05/05/mysql-8-eol</link>
            <guid>https://atlasgo.io/blog/2026/05/05/mysql-8-eol</guid>
            <pubDate>Tue, 05 May 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[April 2026 ends ongoing security maintenance for MySQL 8.0 under the community edition, leaving CVE exposure and audit  pressure for teams still on the old model. The article explains why 8.0 no longer fits Oracle’s dual-track lifecycle, what  AWS RDS Extended Support, Cloud SQL, and OCI HeatWave timelines imply for cost and forced upgrades, and how to choose between  MySQL 8.4 LTS and Innovation releases. It finishes with a practical blue-green upgrade: snapshot and provision 8.4, binlog  replication, smoke tests, schema diff with Atlas, authentication caveats, traffic cutover, and cleanup to exit extended-support  pricing.]]></description>
            <content:encoded><![CDATA[<p>As of April 2026, MySQL 8.0 has reached End of Life (EOL), marking a critical security and operational milestone. When a
database reaches EOL, the safety net is pulled away. Oracle will no longer release security patches, bug fixes, or
performance improvements for the community edition. If a vulnerability is discovered tomorrow, your 8.0 instances will
remain exposed.</p>
<p>In this post, we’ll explore what this means and how cloud platforms are responding to it.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-does-eol-mean">What does EOL mean?<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#what-does-eol-mean" class="hash-link" aria-label="Direct link to What does EOL mean?" title="Direct link to What does EOL mean?" translate="no">​</a></h2>
<p>MySQL 8.0 was first released in 2018 under the traditional "Continuous Delivery" model where new features are added in
minor releases alongside any bug fixes or security patches. This has amounted to 46 minor releases in the last 8 years.</p>
<p>In 2023, MySQL began the shift to a dual-track release cycle:</p>
<ul>
<li class=""><strong>LTS (Long-Term Support):</strong> Focused on stability and security.</li>
<li class=""><strong>Innovation Releases:</strong> Focused on rapid feature delivery.</li>
</ul>
<p>MySQL 8.0 doesn't fit into this new architecture, and its retirement is necessary to clear the technical debt of the old
release model. By retiring 8.0 and declaring it "End of Life", there will be no more security patches or bug fixes for
this version, and all users should upgrade to a supported version to avoid the inherent risks:</p>
<ol>
<li class=""><strong>Security Risk:</strong> No more patches for CVEs. A single Zero-Day vulnerability could expose your entire dataset.</li>
<li class=""><strong>Compliance Failure:</strong> Standards like PCI-DSS, HIPAA, and SOC2 generally mandate that you run software receiving active security updates.</li>
<li class=""><strong>The "Cloud Tax":</strong> Most cloud providers will now charge you significantly more to keep 8.0 running.</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="how-the-cloud-providers-are-responding">How the Cloud Providers are Responding<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#how-the-cloud-providers-are-responding" class="hash-link" aria-label="Direct link to How the Cloud Providers are Responding" title="Direct link to How the Cloud Providers are Responding" translate="no">​</a></h2>
<p>Cloud providers know you might not be ready to upgrade or may have missed the deadline, so they’ve added safety nets.</p>
<p><strong>AWS</strong> moves 8.0 into RDS Extended Support and will officially end support for 8.0 by the end of July 2026. Starting in
August 2026, those continuing to run MySQL 8.0 will be auto-enrolled into a paid support tier with an additional fee per
vCPU-hour.</p>
<p><strong>Google Cloud</strong> has advertised a longer timeline, with paid extended support beginning in January 2027 and a mandatory
auto-upgrade to MySQL 8.4 LTS by July 2029.</p>
<p><strong>Oracle Cloud</strong> has extended 8.0 support in HeatWave until April 2027. After that, all remaining instances will be
force-upgraded to 8.4 LTS.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="checking-your-version">Checking Your Version<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#checking-your-version" class="hash-link" aria-label="Direct link to Checking Your Version" title="Direct link to Checking Your Version" translate="no">​</a></h2>
<p>You can check if you're running MySQL 8.0 via the CLI or a simple SQL query:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">CLI</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">SQL</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><div class="language-bash codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-bash codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">mysql </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--version</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div class="language-sql codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-sql codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">-- Check your current version and architecture</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">SELECT</span><span class="token plain"> VERSION</span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token punctuation" style="color:rgb(199, 146, 234)">)</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> @</span><span class="token variable" style="color:rgb(191, 199, 213)">@version_comment</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> @</span><span class="token variable" style="color:rgb(191, 199, 213)">@version_compile_os</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div></div></div></div>
<p>If the result starts with <code>8.0.x</code>, then we have some work to do.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="long-term-support-vs-innovation-releases">Long-Term Support vs. Innovation Releases<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#long-term-support-vs-innovation-releases" class="hash-link" aria-label="Direct link to Long-Term Support vs. Innovation Releases" title="Direct link to Long-Term Support vs. Innovation Releases" translate="no">​</a></h2>
<p>From version 8.0, you can choose to upgrade to the next LTS release or the next Innovation release depending on your needs.</p>
<p><strong>LTS</strong> suits operators who want predictable upgrades. Within an LTS line, minor releases emphasize fixes and security
hardening rather than new features, so you spend less time guessing whether a patch will change how you work.</p>
<p><strong>Innovation</strong> suits teams that prioritize access to new capabilities on a shorter cycle. New work lands in Innovation
releases first, so you do not wait years for the next LTS to experiment. You accept a faster upgrade rhythm and stronger
automation around testing.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="general-comparison">General Comparison<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#general-comparison" class="hash-link" aria-label="Direct link to General Comparison" title="Direct link to General Comparison" translate="no">​</a></h3>
<table><thead><tr><th></th><th>LTS</th><th>Innovation</th></tr></thead><tbody><tr><td><strong>Focus</strong></td><td>Stability &amp; Longevity</td><td>New Features &amp; Fast Iteration</td></tr><tr><td><strong>Updates</strong></td><td>Security and bug fixes only</td><td>Features, security, and bugs</td></tr><tr><td><strong>Support</strong></td><td>5 years Premier + 3 years Extended</td><td>Until the next release (~3 months)</td></tr><tr><td><strong>Best For</strong></td><td>Enterprise Production</td><td>Developers / Early Adopters</td></tr></tbody></table>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="upgrading-your-environment">Upgrading Your Environment<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#upgrading-your-environment" class="hash-link" aria-label="Direct link to Upgrading Your Environment" title="Direct link to Upgrading Your Environment" translate="no">​</a></h2>
<p>Upgrading your environment can be a complex process when considering the risks of application downtime during the transition
and incompatibility with the new version.</p>
<p>To minimize these risks, follow the blue-green deployment process.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="blue-green-deployment">Blue-Green Deployment<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#blue-green-deployment" class="hash-link" aria-label="Direct link to Blue-Green Deployment" title="Direct link to Blue-Green Deployment" translate="no">​</a></h3>
<p>Blue-green deployment is a technique that allows you to deploy a new version of your application while keeping the old
version running. This is done by creating two environments, one with the new version and one with the old version. Once
it is confirmed that the application can successfully run on the new version, you can upgrade the original environment
and slowly redirect traffic back to it.</p>
<p>This process maintains the original environment as a backup in case of any issues with the new version.</p>
<p>Let's break it down into steps, specifically for upgrading to MySQL 8.4 LTS on AWS. For other cloud providers, the process
will be similar, but follow their guides for platform-specific solutions.</p>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="step-0-pre-requisites">Step 0: Pre-requisites<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#step-0-pre-requisites" class="hash-link" aria-label="Direct link to Step 0: Pre-requisites" title="Direct link to Step 0: Pre-requisites" translate="no">​</a></h4>
<p>Before you begin, ensure your Blue (Production) instance meets these criteria:</p>
<ul>
<li class="">Automated backups are enabled (this is required for RDS to create the staging environment).</li>
<li class="">The instance must be a standalone primary or Multi-AZ cluster; it cannot be an existing Read Replica.</li>
<li class="">Associate the cluster with a custom DB cluster parameter group that has binary logging enabled and a <code>binlog_format</code>
set. While any binlog format works, AWS recommends <code>ROW</code> to reduce the risk of replication inconsistencies.</li>
<li class="">After enabling binary logging, reboot the DB cluster so the writer is in sync with the cluster parameter group.</li>
<li class="">Set a binary log retention period to something other than <code>NULL</code> so binlog files aren’t purged during the provisioning/sync window.</li>
<li class="">If you use Amazon RDS Proxy, the Blue cluster must already be a target of the proxy <strong>before</strong> you create the blue/green deployment.</li>
</ul>
<div class="theme-admonition theme-admonition-note admonition_IZjC alert alert--secondary"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>Changing <code>binlog_format</code> to <code>ROW</code></div><div class="admonitionContent_bl22"><p>If you are switching <code>binlog_format</code> from <code>STATEMENT</code> or <code>MIXED</code> to <code>ROW</code>, MySQL does not rewrite old binlog files. Events
already written keep their original format; only new events written after the change takes effect are logged as <code>ROW</code>.</p><p>Since <code>binlog_format</code> is set via the cluster parameter group, AWS will roll the change out across the cluster, but it may
require a restart depending on how the parameter is applied. Plan a short rollout window and reconnect your applications as
part of that window.</p><p>After switching to <code>ROW</code>, watch replication lag and binlog/disk growth. <code>ROW</code> logging is often larger than statement-based
formats for the same workload.</p></div></div>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="step-1-environment-preparation">Step 1: Environment Preparation<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#step-1-environment-preparation" class="hash-link" aria-label="Direct link to Step 1: Environment Preparation" title="Direct link to Step 1: Environment Preparation" translate="no">​</a></h4>
<p>Create a Green environment that is a mirror of your Blue environment, but running the new engine version.</p>
<p>In the AWS Console, navigate to your RDS database and select <strong>Actions &gt; Create Blue/Green Deployment</strong>.</p>
<ul>
<li class=""><strong>Identifier:</strong> Give the deployment a name like 'upgrade-mysql-8-to-8-4'</li>
<li class=""><strong>Engine Version:</strong> Select the same engine version as the Blue environment.</li>
<li class=""><strong>Parameter Group:</strong> You can choose to use a new parameter group for the Green environment to test different performance settings.</li>
<li class=""><strong>Creation:</strong> AWS will now:<!-- -->
<ul>
<li class="">Copy the Blue environment’s topology and configured features into a staging area</li>
<li class="">Take a snapshot and create the new Green environment from it</li>
<li class="">Configure replication from Blue to Green (and if Blue has read replicas, copy them as replicas of Green)</li>
</ul>
</li>
<li class="">Once the Green environment is created, upgrade it to the new engine version.</li>
</ul>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="step-2-smoke-testing--performance-validation">Step 2: Smoke Testing &amp; Performance Validation<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#step-2-smoke-testing--performance-validation" class="hash-link" aria-label="Direct link to Step 2: Smoke Testing &amp; Performance Validation" title="Direct link to Step 2: Smoke Testing &amp; Performance Validation" translate="no">​</a></h4>
<p>Using the Green endpoint and a test version of your application, run regression tests to ensure the application is working
as expected. Then, prepare for switchover using AWS’s recommendations and guardrails.</p>
<ol>
<li class="">
<p><strong>Test the Green environment thoroughly</strong></p>
<ul>
<li class="">Run your application test suite against the Green endpoint.</li>
<li class="">Validate authentication: MySQL 8.4 disables the legacy <code>mysql_native_password</code> plugin by default, so confirm your
drivers and connection settings work with the new defaults.</li>
<li class="">Check performance: run <code>EXPLAIN</code> (or your normal profiling workflow) for your most expensive queries and confirm plans
and indexes are reasonable on 8.4.</li>
</ul>
</li>
<li class="">
<p><strong>Verify readiness for switchover</strong></p>
<ul>
<li class="">Green must be healthy, replicating, and have no active writes.</li>
<li class="">Blue must not have long-running active writes or long-running DDL, because they can increase replica lag.</li>
</ul>
</li>
<li class="">
<p><strong>Monitor replica lag and connection pressure</strong></p>
<ul>
<li class="">For Aurora MySQL, AWS recommends watching the <code>AuroraBinlogReplicaLag</code> CloudWatch metric in the Green environment and
keeping lag close to zero to reduce downtime.</li>
<li class="">Check CloudWatch <code>DatabaseConnections</code> (and <code>DBLoad</code> in Performance Insights if enabled). If you run very high connection
counts, consider reducing them before switchover to shorten the cutover window.</li>
</ul>
</li>
<li class="">
<p><strong>Validate schema drift and cutover assumptions</strong></p>
<ul>
<li class="">Use <a class="" href="https://atlasgo.io/declarative/diff">Atlas</a> to diff Blue and Green schemas so you don’t discover last-minute drift during cutover.</li>
<li class="">Make sure your client and network configuration doesn’t extend DNS cache TTL beyond 5 seconds (Aurora’s default),
so your app doesn’t keep sending traffic to the old writer after switchover.</li>
</ul>
</li>
</ol>
<div class="theme-admonition theme-admonition-note admonition_IZjC alert alert--secondary"><div class="admonitionHeading_uVvU"><span class="admonitionIcon_HiR3"><svg viewBox="0 0 14 16"><path fill-rule="evenodd" d="M6.3 5.69a.942.942 0 0 1-.28-.7c0-.28.09-.52.28-.7.19-.18.42-.28.7-.28.28 0 .52.09.7.28.18.19.28.42.28.7 0 .28-.09.52-.28.7a1 1 0 0 1-.7.3c-.28 0-.52-.11-.7-.3zM8 7.99c-.02-.25-.11-.48-.31-.69-.2-.19-.42-.3-.69-.31H6c-.27.02-.48.13-.69.31-.2.2-.3.44-.31.69h1v3c.02.27.11.5.31.69.2.2.42.31.69.31h1c.27 0 .48-.11.69-.31.2-.19.3-.42.31-.69H8V7.98v.01zM7 2.3c-3.14 0-5.7 2.54-5.7 5.68 0 3.14 2.56 5.7 5.7 5.7s5.7-2.55 5.7-5.7c0-3.15-2.56-5.69-5.7-5.69v.01zM7 .98c3.86 0 7 3.14 7 7s-3.14 7-7 7-7-3.12-7-7 3.14-7 7-7z"></path></svg></span>note</div><div class="admonitionContent_bl22"><p>Switchover runs guardrail checks (replication health, replica lag, and write activity) and will block or roll back if
conditions aren’t met.</p></div></div>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="step-3-re-route-traffic">Step 3: Re-route Traffic<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#step-3-re-route-traffic" class="hash-link" aria-label="Direct link to Step 3: Re-route Traffic" title="Direct link to Step 3: Re-route Traffic" translate="no">​</a></h4>
<p>When you are ready to make 8.4 your new production version, select the deployment and choose <strong>Actions &gt; Switch over</strong>.</p>
<ul>
<li class="">Set Timeout: Specify a timeout (e.g., 300 seconds). If the switchover takes longer than this (usually due to high replication
lag), AWS will abort and keep your Blue instance as the primary.</li>
<li class="">The Cutover Process:<!-- -->
<ol>
<li class="">AWS stops writes on the Blue instance.</li>
<li class="">It waits for the Green instance to finish applying any remaining logs from Blue.</li>
<li class="">AWS renames the endpoints. The old Blue endpoint now points to the Green instance, and vice versa.</li>
</ol>
</li>
<li class="">Downtime: Your application may experience a brief connection drop (usually 2–5 seconds) while the DNS records update, but it
should be virtually unnoticeable.</li>
</ul>
<h4 class="anchor anchorTargetStickyNavbar_SAay" id="step-4-post-migration-monitoring--cleanup">Step 4: Post-Migration Monitoring &amp; Cleanup<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#step-4-post-migration-monitoring--cleanup" class="hash-link" aria-label="Direct link to Step 4: Post-Migration Monitoring &amp; Cleanup" title="Direct link to Step 4: Post-Migration Monitoring &amp; Cleanup" translate="no">​</a></h4>
<p>After the switchover is complete, the environment labels swap:</p>
<ul>
<li class=""><strong>Green is now Production:</strong> It has the original production DNS endpoint.</li>
<li class=""><strong>Blue is now "Old":</strong> It is renamed (e.g., db-instance-old-1) and is still running, but no longer receives traffic.</li>
</ul>
<p>Important Actions:</p>
<ul>
<li class="">Verify traffic: Monitor your application logs to ensure successful connections to the 8.4 instance.</li>
<li class="">Delete the Blue instance: Once you are 100% satisfied, manually delete the old 8.0 instance to prevent incurring costs and
"RDS Extended Support" fees. You can also keep this database instance running for future use or as a backup.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="conclusion">Conclusion<a href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol#conclusion" class="hash-link" aria-label="Direct link to Conclusion" title="Direct link to Conclusion" translate="no">​</a></h2>
<p>MySQL 8.0 is EOL, meaning no security or bug fixes will be released for this version and cloud providers will slowly stop
supporting it.</p>
<p>Cloud providers can sell you time or force the upgrade for you, but they can’t validate your app. If you want control, move on
your schedule. Choose a supported track and cut over with a proven workflow like blue/green so the upgrade is a planned event,
not an emergency.</p>]]></content:encoded>
            <category>mysql</category>
            <category>mysql 8</category>
            <category>migration</category>
            <category>schema as code</category>
            <category>database security</category>
            <category>atlas</category>
            <category>ci-cd</category>
        </item>
        <item>
            <title><![CDATA[Policy as Code for Database Migrations]]></title>
            <link>https://atlasgo.io/blog/2026/04/29/policy-as-code</link>
            <guid>https://atlasgo.io/blog/2026/04/29/policy-as-code</guid>
            <pubDate>Wed, 29 Apr 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Codify naming conventions, destructive-change rules, and review gates as executable policy using lint and CI, aligned with governance-focused migration tooling but grounded in Atlas's declarative workflow and migration linting.]]></description>
            <content:encoded><![CDATA[<p>As AI agents become staples in modern development workflows, automating everything from code reviews to complex schema
migrations, the industry is hitting a critical inflection point. While the productivity gains are undeniable, the risks
have become equally prominent. We are now seeing a recurring cycle of horror stories where unchecked agents inadvertently
<a href="https://x.com/jasonlk/status/1946069562723897802" target="_blank" rel="noopener noreferrer" class="">wipe production databases</a> or trigger catastrophic outages.</p>
<p>The momentum of AI integration isn't slowing down, but the margin for error has vanished. To keep pace without compromising
integrity, engineering teams must move beyond blind trust and implement robust safeguards to defend their infrastructure
against "rogue" AI behavior.</p>
<p>To truly neutralize the risk of rogue AI, teams must pivot to <strong>Policy as Code</strong>. By codifying your governance directly into
CI/CD pipelines, you shift from hoping for compliance to guaranteeing it, ensuring that every schema change is programmatically
validated before it ever touches production.</p>
<p><img decoding="async" loading="lazy" alt="X posts about destructive changes made by AI agents" src="https://atlasgo.io/assets/images/ai-destructive-changes-afb9f564f614cae9b4a6564a31db06c7.png" width="2024" height="1304" class="img__Ss2"></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="the-limits-of-manual-governance">The Limits of Manual Governance<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#the-limits-of-manual-governance" class="hash-link" aria-label="Direct link to The Limits of Manual Governance" title="Direct link to The Limits of Manual Governance" translate="no">​</a></h2>
<p>In a traditional schema change, the safety of your data hinges on a manual review process: a developer reads the migration,
mentally scans an informal checklist, and hopes to catch that one risky <code>ALTER</code> or stray <code>DROP</code> before it hits production.
This requires engineers to either memorize shifting standards or hunt down documentation that may already be out of date.</p>
<p>While this may suffice for small teams, it fails to scale for two primary reasons:</p>
<ol>
<li class="">
<p><strong>Complexity Creep:</strong> As infrastructure grows, rule sets expand faster than developers can internalize them. For a new
hire, the sheer volume of unwritten rules can be an overwhelming barrier to shipping code safely.</p>
</li>
<li class="">
<p><strong>The Friction Cycle:</strong> Manually auditing every rule against every schema change is inherently tedious. When a safety
checklist feels like a bottleneck, it creates friction. Friction invites shortcuts, and shortcuts inevitably invite incidents.</p>
</li>
</ol>
<p>When correctness depends on humans repeating the same manual steps under the pressure of a release cycle, variance is the
only certainty. Policy as Code transforms that human variance into programmatic consistency.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="what-is-policy-as-code">What is Policy as Code?<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#what-is-policy-as-code" class="hash-link" aria-label="Direct link to What is Policy as Code?" title="Direct link to What is Policy as Code?" translate="no">​</a></h2>
<p>When you add guidelines to a cursorrules file or an AI agent’s skills list, you are providing plaintext instructions that
an agent may or may not follow. This practice is a suggestion, not a guardrail. Developers have seen time and time
again how <a href="https://x.com/lifeof_jer/status/2048103471019434248" target="_blank" rel="noopener noreferrer" class="">AI agents actively ignore direct instructions</a> and cause
major incidents.</p>
<p>True Policy as Code means defining your standards in a machine-readable format that a deterministic tool consumes and
enforces. Unlike an AI agent, a CI pipeline cannot be distracted. By codifying your governance, you move from a trust-based
model to a programmatic guarantee: if a change violates the code, it simply cannot pass.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="automating-database-governance">Automating Database Governance<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#automating-database-governance" class="hash-link" aria-label="Direct link to Automating Database Governance" title="Direct link to Automating Database Governance" translate="no">​</a></h2>
<p>Atlas provides a comprehensive suite of <a class="" href="https://atlasgo.io/lint/analyzers">built-in analyzers</a> designed to validate your schema definitions,
migration files, and migration plans both on local machines and within CI/CD pipelines. These checks specifically target the
usual suspects behind production failures, including <a class="" href="https://atlasgo.io/declarative/apply#diff-policy">destructive changes</a> and
<a class="" href="https://atlasgo.io/lint/analyzers#backward-incompatible-changes">backward-incompatible changes</a>.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="destructive-changes">Destructive Changes<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#destructive-changes" class="hash-link" aria-label="Direct link to Destructive Changes" title="Direct link to Destructive Changes" translate="no">​</a></h3>
<p>Certain migrations are inherently irreversible. Dropping a column, for example, erases data instantly with no option of an
"undo" button. While these actions are sometimes necessary for deprecating legacy features or post-migration cleanup, they
should never occur by accident.</p>
<p>Effective policy is about making these high-stakes operations visible and gateable. In more rigorous environments, Atlas can
be configured to enforce destructive change checks even if a <code>nolint</code> directive is present, ensuring no one bypasses safety protocols.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">destructive</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">force</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>Conversely, for teams that use a soft-delete strategy, such as renaming objects to a "pending delete" namespace, Atlas allows
you to define allowlisted patterns. This ensures that intentional, staged deletions can proceed smoothly without compromising
your safeguards.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">destructive</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Allow dropping tables when the name starts with "drop_"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">allow_table</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"drop_.+"</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>By leveraging diff policy, you can instruct Atlas to automatically skip destructive changes, enforce concurrent index
creation, and mandate specific execution patterns. Defining your policy as code allows you to build a governance framework
tailored to your team’s specific requirements.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="backward-incompatible-changes">Backward Incompatible Changes<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#backward-incompatible-changes" class="hash-link" aria-label="Direct link to Backward Incompatible Changes" title="Direct link to Backward Incompatible Changes" translate="no">​</a></h3>
<p>Even a seemingly trivial change, such as renaming a column from <code>email_address</code> to <code>email</code>, can trigger a massive outage
if active services are still running code that references the old identifier. The moment the migration executes, production
traffic hits queries that can no longer resolve the column. The schema and the application have diverged, turning a routine
deployment into a high-stakes failure.</p>
<p>By encoding this risk into your policy, you ensure that these shifts are flagged the moment the contract is violated and
long before a customer encounters an error.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">incompatible</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">true</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="naming-conventions">Naming Conventions<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#naming-conventions" class="hash-link" aria-label="Direct link to Naming Conventions" title="Direct link to Naming Conventions" translate="no">​</a></h3>
<p>Over time, informal naming turns into a museum of styles: <code>UserId</code> in one table, <code>user_id</code> in another, indexes called
<code>idx1</code> next to indexes that follow a strict prefix rule. Even with agreed-upon naming conventions, it's not unreasonable
or uncommon for a developer to miss a spot.</p>
<p>Beyond the built-in safety checks, Atlas allows you to codify your internal standards into <a class="" href="https://atlasgo.io/lint/rules#examples">custom rules</a>.
By defining specific patterns for indexes, foreign keys, tables, and columns, you can ensure that every new schema change
aligns with your team’s naming standards. These rules are automatically enforced by Atlas’s naming analyzer, transforming
your style guide from a static document into a living, programmatic gatekeeper.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">naming</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">match</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"^[a-z]+$"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">message</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"must be lowercase"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">index</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"^[a-z]+_idx$"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">message</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"must be lowercase and end with _idx"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// schema, table, column, foreign_key and checks are also supported</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="approval-policy">Approval Policy<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#approval-policy" class="hash-link" aria-label="Direct link to Approval Policy" title="Direct link to Approval Policy" translate="no">​</a></h3>
<p>Policy as Code isn't just for defining schema changes, it can also be used to govern the transition from <a class="" href="https://atlasgo.io/declarative/apply#approval-policy">development to production</a>.</p>
<p>In a declarative workflow, Atlas pre-plans your migrations during the CI phase. Atlas generates a concrete execution plan,
stores it in the Atlas Registry, and comments it directly on your Pull Request. This makes the underlying SQL transparent
and reviewable. Once the PR is merged, the change is marked "approved" and applied automatically.</p>
<p>However, real-world environments aren't always perfect. Databases can "drift" due to manual hotfixes, or an environment might
miss a release, leaving the schema in an unexpected state. In these scenarios, the pre-approved plan in the registry may no
longer match the reality of the database.</p>
<p>This is where apply-time policy acts as your final safety net. By default, <code>atlas schema apply</code> waits for a human to verify
the SQL before execution. For teams pursuing full automation, Atlas can delegate this decision to a review policy:</p>
<ul>
<li class=""><strong>Error-Only:</strong> Automated application proceeds unless the analyzers report errors or high-risk events.</li>
<li class=""><strong>Warning-Sensitive:</strong> If any warnings or risks are detected, the process pauses and mandates explicit approval.</li>
<li class=""><strong>Strict:</strong> Every change requires a manual sign-off unless it exactly matches a pre-planned and approved CI artifact.</li>
</ul>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line theme-code-block-highlighted-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">review</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> ERROR </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// ERROR | WARNING | ALWAYS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">destructive</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token boolean" style="color:rgb(255, 88, 116)">false</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="beyond-the-schema">Beyond the Schema<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#beyond-the-schema" class="hash-link" aria-label="Direct link to Beyond the Schema" title="Direct link to Beyond the Schema" translate="no">​</a></h2>
<p>With the recent introduction of Database Security as Code, Atlas extends its governance capabilities to users, roles, and
permissions. By moving access control into declarative schema files, security configurations are transformed into reviewable
artifacts that are gated and validated within your CI/CD pipeline.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="database-ownership-policy">Database Ownership Policy<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#database-ownership-policy" class="hash-link" aria-label="Direct link to Database Ownership Policy" title="Direct link to Database Ownership Policy" translate="no">​</a></h3>
<p>For GitHub users, Atlas allows you to enforce <a class="" href="https://atlasgo.io/guides/schema-ownership">ownership policies</a>, bringing repository-style
authorization directly to your database objects.</p>
<p>While traditional file-level controls like <code>CODEOWNERS</code> on GitHub protect source code, they are blind to the nuances of a
database schema. Ownership policy closes this gap by treating the schema objects themselves as the units of authorization.</p>
<p>By defining allow and deny rules for specific resources, you can map database permissions directly to GitHub users or teams.
When Atlas plans or lints a change, it programmatically verifies if the author is permitted to modify every affected object.
If the change violates these boundaries, the CI pipeline fails immediately.</p>
<p>In practice, this functions as <code>CODEOWNERS</code> for your database. This is an essential safeguard for modern workflows where a
helper script or AI assistant might generate a schema diff that accidentally touches a sensitive core table.</p>
<p><img decoding="async" loading="lazy" alt="Ownership policy violation reported as a GitHub PR comment" src="https://atlasgo.io/assets/images/ownership-policy-gh-comment-bf002bb3a27e56167ecabc5fb828b9d4.png" width="1998" height="946" class="img__Ss2"></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="final-thoughts">Final Thoughts<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#final-thoughts" class="hash-link" aria-label="Direct link to Final Thoughts" title="Direct link to Final Thoughts" translate="no">​</a></h2>
<p>Governance tooling is only useful when it integrates seamlessly with your team's actual delivery cycle. Adopting <strong>Policy as Code</strong>
for your schema is a practical way to make safe and consistent schema changes operational rather than aspirational.</p>
<p>As your product and data infrastructure scale, you will find yourself wanting to enforce more and more policies. Atlas ensures that
you can do so without adding more friction to the migration review process. You don’t have to choose between moving fast and remaining
secure. With the right automated guardrails, you can finally do both.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="get-started">Get Started<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#get-started" class="hash-link" aria-label="Direct link to Get Started" title="Direct link to Get Started" translate="no">​</a></h3>
<p><a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" class="">Schedule a demo</a> to learn more about how you can use Atlas to automate database
governance at scale with Policy as Code.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="further-reading">Further Reading<a href="https://atlasgo.io/blog/2026/04/29/policy-as-code#further-reading" class="hash-link" aria-label="Direct link to Further Reading" title="Direct link to Further Reading" translate="no">​</a></h3>
<ul>
<li class=""><a class="" href="https://atlasgo.io/guides/reviewed-approved-migrations">Enforcing Reviewed and Approved Schema Migrations</a></li>
<li class=""><a class="" href="https://atlasgo.io/versioned/lint">Verifying Migration Safety</a></li>
<li class=""><a class="" href="https://atlasgo.io/lint/analyzers">Migration Analyzers</a></li>
<li class=""><a class="" href="https://atlasgo.io/lint/rules">Custom Schema Policy</a></li>
<li class=""><a class="" href="https://atlasgo.io/guides/schema-ownership">Schema Ownership Policy: Control Who Can Modify Database Objects</a></li>
</ul>]]></content:encoded>
            <category>policy</category>
            <category>linting</category>
            <category>ci</category>
            <category>governance</category>
            <category>declarative migrations</category>
            <category>database devops</category>
        </item>
        <item>
            <title><![CDATA[Atlas v1.2: Column-Level Lineage, Registry Backup Storage, Schema Ownership Policy, and More]]></title>
            <link>https://atlasgo.io/blog/2026/04/09/atlas-v1-2</link>
            <guid>https://atlasgo.io/blog/2026/04/09/atlas-v1-2</guid>
            <pubDate>Thu, 09 Apr 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Atlas v1.2 introduces schema ownership policies for access control in CI, column-level data lineage in Atlas Cloud, offline access for Atlas Pro, PostgreSQL default privilege management, Oracle UDTs, and expanded Snowflake support.]]></description>
            <content:encoded><![CDATA[<p>Hey everyone!</p>
<p>We're excited to announce <a href="https://github.com/ariga/atlas/releases/tag/v1.2.0" target="_blank" rel="noopener noreferrer" class="">Atlas v1.2</a>. This release
brings column-level data lineage to Atlas Cloud, registry backups to your own cloud storage, a schema
ownership policy for CI, and expanded database coverage.</p>
<p>Here is what you can find in this release:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#column-level-data-lineage">Column-Level Data Lineage</a></strong> - Trace how columns are derived from upstream sources across tables, views, and datasets in Atlas Cloud.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#offline-access--registry-backups">Offline Access &amp; Registry Backups</a></strong> - Back up Atlas Registry repositories to S3, GCS, or Azure Blob Storage. Atlas Pro license grants are cached in CI/CD environments, so your pipeline never has a single point of failure.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#schema-ownership-policy">Schema Ownership Policy</a></strong> - Enforce which GitHub users and teams can modify specific schema objects, closing the gap between CODEOWNERS and DDL access control.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#database-driver-improvements">Database Driver Improvements</a></strong> - PostgreSQL routine permissions, user-mapping, and default ACLs; Snowflake tasks and pipes; Oracle UDTs; Expanded permissions for MSSQL, MySQL, and ClickHouse.</li>
</ul>
<!-- -->
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">macOS + Linux</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Homebrew</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Docker</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Windows</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">CI</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Manual Installation</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>To download and install the latest release of the Atlas CLI, simply run the following in your terminal:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">curl</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-sSf</span><span class="token plain"> https://atlasgo.sh </span><span class="token operator" style="color:rgb(137, 221, 255)">|</span><span class="token plain"> </span><span class="token function" style="color:rgb(130, 170, 255)">sh</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Get the latest release with <a href="https://brew.sh/" target="_blank" rel="noopener noreferrer" class="">Homebrew</a>:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">brew </span><span class="token function" style="color:rgb(130, 170, 255)">install</span><span class="token plain"> ariga/tap/atlas</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>To pull the Atlas image and run it as a Docker container:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> pull arigaio/atlas</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> arigaio/atlas </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--help</span><br></span></code></pre></div></div><p>If the container needs access to the host network or a local directory, use the <code>--net=host</code> flag and mount the desired
directory:</p><div class="language-shell codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-shell codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token function" style="color:rgb(130, 170, 255)">docker</span><span class="token plain"> run </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--rm</span><span class="token plain"> </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--net</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain">host </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-v</span><span class="token plain"> </span><span class="token variable" style="color:rgb(191, 199, 213)">$(</span><span class="token variable builtin class-name" style="color:rgb(255, 203, 107)">pwd</span><span class="token variable" style="color:rgb(191, 199, 213)">)</span><span class="token plain">/migrations:/migrations </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  arigaio/atlas migrate apply </span><span class="token punctuation" style="color:rgb(199, 146, 234)">\</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--url</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"mysql://root:pass@:3306/test"</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>Download the <a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" target="_blank" rel="noopener noreferrer" class="">latest release</a> and
move the atlas binary to a file location on your system PATH.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p><strong>GitHub Actions</strong></p><p>Use the <a href="https://github.com/marketplace/actions/setup-atlas" target="_blank" rel="noopener noreferrer" class="">setup-atlas</a> action to install Atlas in your GitHub Actions workflow:</p><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-yaml codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">uses</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> ariga/setup</span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">atlas@v0</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">with</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token key atrule">cloud-token</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> secrets.ATLAS_CLOUD_TOKEN </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div><p><strong>Other CI Platforms</strong></p><p>For other CI/CD platforms, use the installation script. See the <a class="" href="https://atlasgo.io/integrations#cicd-platforms">CI/CD integrations</a> for more details.</p></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><p>If you want to manually install the Atlas CLI, pick one of the below builds suitable for your system.</p><div class="grid grid-cols-1 lg:grid-cols-3 auto-cols-fr gap-4 mt-4"><div class="flex flex-col gap-4"><h3>MacOS</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue"><p><a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-darwin-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Linux</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-amd64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest" class="!font-mono">ARM 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-linux-arm64-latest.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div><div class="flex flex-col gap-4"><h3>Windows</h3><div class="flex flex-col items-center p-4 rounded-lg dark:bg-[#fff] border-lightGrey border"><div class="flex gap-4 items-center"><img class="" src="https://atlasgo.io/icons-docs/download.svg" alt="Download icon"><span class="!text-darkBlue !font-mono"><p><a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe" class="!font-mono">AMD 64 </a>
(<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.md5" class="!font-mono">md5</a>/<a href="https://atlasbinaries.com/atlas/atlas-windows-amd64-latest.exe.sha256" class="!font-mono">sha256</a>)</p></span></div></div></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="column-level-data-lineage">Column-Level Data Lineage<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#column-level-data-lineage" class="hash-link" aria-label="Direct link to Column-Level Data Lineage" title="Direct link to Column-Level Data Lineage" translate="no">​</a></h2>
<p>Atlas Cloud now traces column-level data lineage across tables, views, and datasets. Select any column
to see where its data comes from, which transformation expressions shape it, and what downstream objects
depend on it.</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/lineage-graph/expression-pinned.png" alt="Atlas Cloud lineage graph showing column lineage with a pinned expression" width="100%"><p style="font-size:12px">Tracing column lineage with pinned transformation expressions</p></div>
<p>Lineage is supported for PostgreSQL, MySQL, ClickHouse, CockroachDB, and Snowflake (including dynamic
tables). Tables or data sources referenced in queries but not defined in the current schema appear as
external dataset nodes, letting you trace lineage beyond the boundaries of your managed schema.</p>
<p>To learn more, see the <a class="" href="https://atlasgo.io/cloud/features/lineage-graph">data lineage documentation</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="offline-access--registry-backups">Offline Access &amp; Registry Backups<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#offline-access--registry-backups" class="hash-link" aria-label="Direct link to Offline Access &amp; Registry Backups" title="Direct link to Offline Access &amp; Registry Backups" translate="no">​</a></h2>
<p>As part of a broader business continuity strategy, this release adds two features to Atlas that
ensure your deployment pipeline keeps running autonomously, with no single point of failure.</p>
<p>Atlas Pro now supports license grant caching, so CI/CD jobs continue using Atlas Pro capabilities
even without connectivity to Atlas Cloud. <a class="" href="https://atlasgo.io/integrations/github-actions#offline-access">GitHub Actions</a>,
<a class="" href="https://atlasgo.io/integrations/gitlab-ci-components#offline-access">GitLab CI</a>, and <a class="" href="https://atlasgo.io/integrations/circleci-orbs#offline-access">CircleCI</a> work out of the box with built-in caching.
<a class="" href="https://atlasgo.io/integrations/bitbucket-pipes#offline-access">Bitbucket Pipelines</a> requires a small cache configuration.
The <a class="" href="https://atlasgo.io/integrations/kubernetes/install#persisting-the-atlas-grant-cache">Kubernetes operator</a> supports
persistent volumes for grant caching across pod restarts.</p>
<p>Migration directories can now be backed up to your own storage with
<a class="" href="https://atlasgo.io/cloud/features/registry#migration-directories">registry backups</a>. Atlas replicates every
<code>atlas migrate push</code> to one or more backup locations and falls back to them automatically on read.
Supported providers include AWS S3, Google Cloud Storage, and Azure Blob Storage:</p>
<div class="theme-tabs-container tabs-container tabList_M0Dn"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_ysIP tabs__item--active">AWS S3</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Google Cloud Storage</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">Azure Blob Storage</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migration</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">dir</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"atlas://app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">repo</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">backup</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token string" style="color:rgb(195, 232, 141)">"s3://my-atlas-backups/migrations?region=us-east-1"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migration</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">dir</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"atlas://app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">repo</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">backup</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token string" style="color:rgb(195, 232, 141)">"gs://my-atlas-backups/migrations"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div><div role="tabpanel" class="tabItem_OMyP" hidden=""><div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token plain">env </span><span class="token string" style="color:rgb(195, 232, 141)">"prod"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token keyword" style="font-style:italic">migration</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">dir</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"atlas://app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">repo</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">name</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"app"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">backup</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">        </span><span class="token string" style="color:rgb(195, 232, 141)">"azureblob://my-container/migrations?storage_account=myaccount"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div></div></div></div>
<p>Our next version will extend backup storage to declarative workflows, automatically storing schemas
and their plans alongside migration directories.</p>
<p>To learn more, see the <a class="" href="https://atlasgo.io/cloud/bots#offline-access">offline access</a> and
<a class="" href="https://atlasgo.io/cloud/features/registry#migration-directories">backup repositories</a> documentation.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="schema-ownership-policy">Schema Ownership Policy<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#schema-ownership-policy" class="hash-link" aria-label="Direct link to Schema Ownership Policy" title="Direct link to Schema Ownership Policy" translate="no">​</a></h2>
<p>GitHub <code>CODEOWNERS</code> enforces who can modify files, but it cannot enforce who can modify schema objects. A
developer with access to the <code>inventory/</code> schema folder could alter the schema files to include an
<code>ALTER TABLE public.users</code>, a core table owned by another team, causing a migration that crosses schema boundaries.
This is especially relevant as AI agents become more autonomous: they optimize for their goal and may modify any object that gets them there, regardless of ownership boundaries.</p>
<p>Atlas v1.2 introduces the ownership policy: a lint check that validates migration changes only touch
resources the author is authorized to modify. Define <code>allow</code> and <code>deny</code> blocks in your <code>atlas.hcl</code> to
specify which GitHub users or teams can modify matched schema objects:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">atlas.hcl</div><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-hcl codeBlock_TAPP thin-scrollbar" style="color:#bfc7d5;background-color:#292d3e"><code class="codeBlockLines_AdAo"><span class="token-line" style="color:#bfc7d5"><span class="token keyword" style="font-style:italic">lint</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  ownership </span><span class="token string" style="color:rgb(195, 232, 141)">"github"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    allow </span><span class="token string" style="color:rgb(195, 232, 141)">"core-tables"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"public.*[type=table]"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">teams</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"backend"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">users</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"a8m"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    allow </span><span class="token string" style="color:rgb(195, 232, 141)">"inventory"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"inventory.*"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">teams</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"logistics"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    deny </span><span class="token string" style="color:rgb(195, 232, 141)">"contractors"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">match</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"*"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">users</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">"contractor-x"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<p>When a violation is detected, Atlas posts a comment on the pull request:</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/ownership-policy-gh-comment.png" alt="Ownership policy violation reported as a GitHub PR comment" width="100%"><p style="font-size:12px">Atlas blocks a PR that crosses schema boundaries</p></div>
<p>To learn more, see the <a class="" href="https://atlasgo.io/guides/schema-ownership">ownership policy guide</a> and the
<a class="" href="https://atlasgo.io/lint/analyzers#ownership-policy">analyzers reference</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="database-driver-improvements">Database Driver Improvements<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#database-driver-improvements" class="hash-link" aria-label="Direct link to Database Driver Improvements" title="Direct link to Database Driver Improvements" translate="no">​</a></h2>
<p>Beyond the headline features, we spent time in this release speeding up our parsers and
optimizing internal operations across all drivers. Here are the driver-specific highlights:</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql">PostgreSQL<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#postgresql" class="hash-link" aria-label="Direct link to PostgreSQL" title="Direct link to PostgreSQL" translate="no">​</a></h3>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/postgres-routine-matview-permissions">Routine and materialized view permissions</a>:
<code>GRANT</code>/<code>REVOKE</code> for functions, procedures, and materialized views, with overloaded routine handling
and column-level grants.</li>
<li class=""><a class="" href="https://atlasgo.io/guides/postgres/security-default-privileges">Default ACL management</a>: Atlas inspects <code>pg_default_acl</code>
and automatically revokes undeclared default privileges in HCL schemas.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/postgres-user-mapping">User mappings</a> for foreign data wrappers are now first-class resources.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="snowflake">Snowflake<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#snowflake" class="hash-link" aria-label="Direct link to Snowflake" title="Direct link to Snowflake" translate="no">​</a></h3>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-tasks-and-pipes">Tasks and pipes</a>: Tasks support scheduling, DAG dependencies,
conditional execution, and session parameters. Pipes support continuous data loading with <code>COPY INTO</code>.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-functions-and-procedures">Functions and procedures</a>: All Snowflake languages
(SQL, JavaScript, Python, Java), overloading, and secure mode.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/snowflake-file-format">File formats</a> as named resources, referenced from stages and
external tables.</li>
<li class="">Dynamic table improvements: <code>cluster_by</code>, refresh mode extraction, and column type display in HCL.</li>
<li class="">Security views and <code>MAP(Key, Value)</code> type support.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="mysql">MySQL<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#mysql" class="hash-link" aria-label="Direct link to MySQL" title="Direct link to MySQL" translate="no">​</a></h3>
<ul>
<li class="">Routine permissions for functions and procedures.</li>
<li class="">New lint checks (<a class="" href="https://atlasgo.io/lint/analyzers">MY130-MY136</a>): Blocking change detection for table copies,
DML-blocking foreign keys, and primary key rebuilds.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="clickhouse">ClickHouse<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#clickhouse" class="hash-link" aria-label="Direct link to ClickHouse" title="Direct link to ClickHouse" translate="no">​</a></h3>
<ul>
<li class=""><a class="" href="https://atlasgo.io/changelog/clickhouse-wildcard-grants">Wildcard grants</a> (<code>GRANT SELECT ON db.prefix*</code>) for
pattern-based permissions.</li>
<li class=""><a class="" href="https://atlasgo.io/changelog/clickhouse-vector-similarity-index">Vector similarity index</a> for approximate nearest
neighbor search on embedding columns.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="oracle">Oracle<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#oracle" class="hash-link" aria-label="Direct link to Oracle" title="Direct link to Oracle" translate="no">​</a></h3>
<ul>
<li class="">User-defined types (UDTs) with methods, PL/SQL types, and system-defined data types.</li>
<li class=""><code>VECTOR</code> and <code>JSON</code> column data types.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="sql-server">SQL Server<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#sql-server" class="hash-link" aria-label="Direct link to SQL Server" title="Direct link to SQL Server" translate="no">​</a></h3>
<ul>
<li class="">Type-level permissions and ACL support.</li>
<li class="">Routine permissions for functions and procedures.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="whats-next">What's Next<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#whats-next" class="hash-link" aria-label="Direct link to What's Next" title="Direct link to What's Next" translate="no">​</a></h2>
<p>This release also ships <a class="" href="https://atlasgo.io/atlas-schema/input-variables#variable-validation">variable validation blocks</a>
for input constraints, <a class="" href="https://atlasgo.io/changelog/repository-rules">repository rules</a> for enforcing naming conventions
in Atlas Cloud, and <a class="" href="https://atlasgo.io/atlas-schema/projects#data-configuration">data skip_diff</a> to exclude columns
with dynamic defaults like <code>now()</code> from data comparison. We ship improvements continuously between
releases, so follow the <a class="" href="https://atlasgo.io/changelog">Atlas changelog</a> to stay up to date.</p>
<p>Here's what's expected in the upcoming release:</p>
<ul>
<li class="">NoSQL database support for MongoDB, Amazon DocumentDB, DynamoDB, and others.</li>
<li class="">Declarative backup storage, extending backup URLs to the declarative workflow, automatically
storing schemas and their plans alongside migration directories.</li>
<li class="">Security graph: Map access paths across your databases, surface overprivileged roles, and identify permission risks before they become incidents.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>Atlas v1.2 brings schema governance with the ownership policy, full observability with column-level data
lineage, resilience with offline access and registry backups, and continued expansion across Oracle,
Snowflake, PostgreSQL, MSSQL, MySQL, and ClickHouse.</p>
<p>We'd love to hear your feedback! Join our <a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a> or
<a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content:encoded>
            <category>release</category>
            <category>atlas v1.2</category>
            <category>ownership</category>
            <category>lineage</category>
            <category>oracle</category>
            <category>snowflake</category>
            <category>postgres</category>
            <category>security</category>
        </item>
    </channel>
</rss>