<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://atlasgo.io/blog</id>
    <title>Atlas Blog</title>
    <updated>2026-11-12T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://atlasgo.io/blog"/>
    <subtitle>Atlas Blog</subtitle>
    <entry>
        <title type="html"><![CDATA[PostgreSQL 19: Security Changes and Preparing with Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/11/12/postgres-19</id>
        <link href="https://atlasgo.io/blog/2026/11/12/postgres-19"/>
        <updated>2026-11-12T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="postgres" term="postgres"/>
        <category label="postgresql 19" term="postgresql 19"/>
        <category label="postgres upgrade" term="postgres upgrade"/>
        <category label="database security" term="database security"/>
        <category label="security scan" term="security scan"/>
        <category label="schema as code" term="schema as code"/>
        <category label="snowflake" term="snowflake"/>
        <category label="databricks" term="databricks"/>
        <category label="clickhouse" term="clickhouse"/>
        <category label="atlas" term="atlas"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[ClickHouse CVEs: Find Vulnerable Servers with Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning</id>
        <link href="https://atlasgo.io/blog/2026/11/03/clickhouse-cve-scanning"/>
        <updated>2026-11-03T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="clickhouse" term="clickhouse"/>
        <category label="cve" term="cve"/>
        <category label="security" term="security"/>
        <category label="security scan" term="security scan"/>
        <category label="database security" term="database security"/>
        <category label="kubernetes" term="kubernetes"/>
        <category label="github actions" term="github actions"/>
        <category label="atlas pro" term="atlas pro"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Medallion Architecture on Snowflake with Atlas and dbt]]></title>
        <id>https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt</id>
        <link href="https://atlasgo.io/blog/2026/10/08/medallion-architecture-snowflake-atlas-dbt"/>
        <updated>2026-10-08T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Nhan Nguyen</name>
            <uri>https://github.com/nhannguyenc</uri>
        </author>
        <category label="snowflake" term="snowflake"/>
        <category label="dbt" term="dbt"/>
        <category label="medallion" term="medallion"/>
        <category label="data engineering" term="data engineering"/>
        <category label="schema as code" term="schema as code"/>
        <category label="grants" term="grants"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Atlas Kubernetes Operator v0.8: Drift Detection, Security Scanning, and Per-Resource Dev Databases]]></title>
        <id>https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8</id>
        <link href="https://atlasgo.io/blog/2026/10/01/atlas-operator-v0-8"/>
        <updated>2026-10-01T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Atlas Kubernetes Operator v0.8 adds pre-apply and scheduled drift detection, CVE scanning with AtlasSecurityScan, and a per-resource prewarmDevDB override.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="release" term="release"/>
        <category label="kubernetes" term="kubernetes"/>
        <category label="k8s operator" term="k8s operator"/>
        <category label="drift detection" term="drift detection"/>
        <category label="security" term="security"/>
        <category label="cve" term="cve"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: How Deriv Automates Schema Migrations with Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/09/30/case-study-deriv</id>
        <link href="https://atlasgo.io/blog/2026/09/30/case-study-deriv"/>
        <updated>2026-09-30T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Deriv replaced homegrown tooling, hand-written SQL, and a single-DBA bottleneck with a declarative Atlas workflow, letting developers own schema changes.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[DACPAC for PostgreSQL: Where Atlas Fills the Gap]]></title>
        <id>https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres</id>
        <link href="https://atlasgo.io/blog/2026/09/23/dacpac-for-postgres"/>
        <updated>2026-09-23T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="postgres" term="postgres"/>
        <category label="dacpac" term="dacpac"/>
        <category label="ssdt" term="ssdt"/>
        <category label="sql server" term="sql server"/>
        <category label="migration tools" term="migration tools"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[The AI-Native SDLC Playbook Stops at the Database]]></title>
        <id>https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database</id>
        <link href="https://atlasgo.io/blog/2026/08/31/ai-native-sdlc-database"/>
        <updated>2026-08-31T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Ariel Mashraki</name>
            <uri>https://github.com/a8m</uri>
        </author>
        <category label="ai agents" term="ai agents"/>
        <category label="sdlc" term="sdlc"/>
        <category label="migrations" term="migrations"/>
        <category label="schema-as-code" term="schema-as-code"/>
        <category label="drift detection" term="drift detection"/>
        <category label="claude code" term="claude code"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: How Health in Tech Maintains Databases and Security Compliance with Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech</id>
        <link href="https://atlasgo.io/blog/2026/08/11/case-study-health-in-tech"/>
        <updated>2026-08-11T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Atlas v1.3: Security Graph for Databases, Atlas Scripts, the atlas cloud Command, and More]]></title>
        <id>https://atlasgo.io/blog/2026/07/30/atlas-v1-3</id>
        <link href="https://atlasgo.io/blog/2026/07/30/atlas-v1-3"/>
        <updated>2026-07-30T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Ariel Mashraki</name>
            <uri>https://github.com/a8m</uri>
        </author>
        <category label="release" term="release"/>
        <category label="atlas v1.3" term="atlas v1.3"/>
        <category label="security graph" term="security graph"/>
        <category label="atlas scripts" term="atlas scripts"/>
        <category label="dataops" term="dataops"/>
        <category label="security" term="security"/>
        <category label="postgres" term="postgres"/>
        <category label="oracle" term="oracle"/>
        <category label="snowflake" term="snowflake"/>
        <category label="clickhouse" term="clickhouse"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: Scaling Aryon Security’s Database Deployments with the Atlas Kubernetes Operator]]></title>
        <id>https://atlasgo.io/blog/2026/07/21/case-study-aryon-security</id>
        <link href="https://atlasgo.io/blog/2026/07/21/case-study-aryon-security"/>
        <updated>2026-07-21T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: Automating Gumloop's Database Management with Atlas's Schema-as-Code Tooling]]></title>
        <id>https://atlasgo.io/blog/2026/07/06/case-study-gumloop</id>
        <link href="https://atlasgo.io/blog/2026/07/06/case-study-gumloop"/>
        <updated>2026-07-06T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: How EliseAI Democratized Schema Management Across 50 Databases]]></title>
        <id>https://atlasgo.io/blog/2026/06/25/case-study-eliseai</id>
        <link href="https://atlasgo.io/blog/2026/06/25/case-study-eliseai"/>
        <updated>2026-06-25T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Learn how EliseAI moved from a four-person schema gatekeeper model to letting 50+ engineers safely manage migrations with Atlas.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Case Study: How Wenrix Made Schema Migrations Reliable with Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/06/16/case-study-wenrix</id>
        <link href="https://atlasgo.io/blog/2026/06/16/case-study-wenrix"/>
        <updated>2026-06-16T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="case study" term="case study"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Testing PostgreSQL Schemas with pgTAP and Atlas]]></title>
        <id>https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas</id>
        <link href="https://atlasgo.io/blog/2026/06/11/testing-with-pgtap-and-atlas"/>
        <updated>2026-06-11T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="postgres" term="postgres"/>
        <category label="testing" term="testing"/>
        <category label="pgtap" term="pgtap"/>
        <category label="schema testing" term="schema testing"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[MySQL 8.0 End of Life: Plan Your Move Before Support Runs Out]]></title>
        <id>https://atlasgo.io/blog/2026/05/05/mysql-8-eol</id>
        <link href="https://atlasgo.io/blog/2026/05/05/mysql-8-eol"/>
        <updated>2026-05-05T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="mysql" term="mysql"/>
        <category label="mysql 8" term="mysql 8"/>
        <category label="migration" term="migration"/>
        <category label="schema as code" term="schema as code"/>
        <category label="database security" term="database security"/>
        <category label="atlas" term="atlas"/>
        <category label="ci-cd" term="ci-cd"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Policy as Code for Database Migrations]]></title>
        <id>https://atlasgo.io/blog/2026/04/29/policy-as-code</id>
        <link href="https://atlasgo.io/blog/2026/04/29/policy-as-code"/>
        <updated>2026-04-29T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="policy" term="policy"/>
        <category label="linting" term="linting"/>
        <category label="ci" term="ci"/>
        <category label="governance" term="governance"/>
        <category label="declarative migrations" term="declarative migrations"/>
        <category label="database devops" term="database devops"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Atlas v1.2: Column-Level Lineage, Registry Backup Storage, Schema Ownership Policy, and More]]></title>
        <id>https://atlasgo.io/blog/2026/04/09/atlas-v1-2</id>
        <link href="https://atlasgo.io/blog/2026/04/09/atlas-v1-2"/>
        <updated>2026-04-09T00:00:00.000Z</updated>
        <summary type="html"><![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.]]></summary>
        <content type="html"><![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>
        <author>
            <name>Ariel Mashraki</name>
            <uri>https://github.com/a8m</uri>
        </author>
        <category label="release" term="release"/>
        <category label="atlas v1.2" term="atlas v1.2"/>
        <category label="ownership" term="ownership"/>
        <category label="lineage" term="lineage"/>
        <category label="oracle" term="oracle"/>
        <category label="snowflake" term="snowflake"/>
        <category label="postgres" term="postgres"/>
        <category label="security" term="security"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Atlas v1.1: Database Security as Code, Declarative Data Management, and More]]></title>
        <id>https://atlasgo.io/blog/2026/02/03/atlas-v1-1</id>
        <link href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1"/>
        <updated>2026-02-03T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Atlas v1.1 introduces Database Security as Code for managing roles, users, and permissions declaratively. This release also adds declarative data management for lookup tables, support for CockroachDB, Aurora DSQL, Azure Fabric, and many driver improvements.]]></summary>
        <content type="html"><![CDATA[<p>We're excited to announce <a href="https://github.com/ariga/atlas/releases/tag/v1.1.0" target="_blank" rel="noopener noreferrer" class="">Atlas v1.1</a>.</p>
<p>This release delivers on a promise we made in v1.0: <strong>Database Security as Code</strong> is now available for Atlas Pro users.</p>
<p>We're also shipping <strong>declarative data management</strong> for lookup tables and seed data, expanding database coverage with
Aurora DSQL, Azure Fabric, and CockroachDB Cloud, and further improving our drivers and Atlas Cloud.</p>
<p>Here is what you can find in this release:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#database-security-as-code">Database Security as Code</a></strong> - Manage roles, users, and permissions declaratively across various popular Atlas-supported databases.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#declarative-data-management">Declarative Data Management</a></strong> - Define lookup tables and seed data as code using various sync modes.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#aurora-dsql-support">Aurora DSQL Support</a></strong> - Manage schemas on AWS's new serverless distributed SQL database.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#azure-fabric-support">Azure Fabric Support</a></strong> - Use Atlas to manage your Microsoft Azure Fabric databases.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#spanner-enhancements">Spanner Enhancements</a></strong> - Added support for Spanner's PostgreSQL dialect and vector indexes.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#clickhouse-improvements">ClickHouse Improvements</a></strong> - Cluster mode and data retention on table recreation.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#cockroachdb-support">CockroachDB Support</a></strong> - Full Atlas support for CockroachDB Cloud and self-hosted deployments.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#postgresql-enhancements">PostgreSQL Enhancements</a></strong> - <code>CAST</code> definitions and <code>replica identity</code> support.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#slack-integration">Slack Integration</a></strong> - Connect to our native Slack app for real-time notifications.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#schema-exporters">Schema Exporters</a></strong> - Declarative export for schema inspection, drift and diff reporting, and more.</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="database-security-as-code">Database Security as Code<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#database-security-as-code" class="hash-link" aria-label="Direct link to Database Security as Code" title="Direct link to Database Security as Code" translate="no">​</a></h2>
<p>Security best practices are clear: database users and those with specific roles should only have access to the resources and operations
they need. Permissions should be regularly reviewed. Every access change should be audited. But in practice, most teams manage database
permissions manually - if they manage them at all.</p>
<p>Atlas now lets you define database roles, users, and permissions as code - reviewed in PRs, deployed through CI/CD, tracked in git. The
same workflows used by Atlas for schema management can now be applied to database roles, users, groups, and their access control.</p>
<p>To congiure your users, roles, permissions, etc., simply add them to your desired state file. Atlas then handles the translation and
migrations to bring the database to that state.</p>
<p>Definitions can be written in SQL using <code>ROLE</code>, <code>USER</code>, <code>GRANT</code>, etc., or in Atlas HCL language:</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 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)">"Read-only access for application"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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_admin"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">superuser</span><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">create_db</span><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">create_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 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">login</span><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">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">user </span><span class="token string" style="color:rgb(195, 232, 141)">"app_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 property">password</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> var.app_password</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_admin</span><span class="token punctuation" style="color:rgb(199, 146, 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">for_each</span><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.users, table.orders, table.products</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</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"> each.value</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_readonly</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><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">for</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">to</span><span class="token plain">         </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> role.app_admin</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">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 property">grantable</span><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>
<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>This feature is currently supported by the PostgreSQL, MySQL, MariaDB, SQL Server, ClickHouse, Spanner, and Databricks drivers.
Each driver maps to its native permission model - Atlas handles the translation.</p></div></div>
<p>To enable support for security as code, add the following to your <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 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">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.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">    </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 theme-code-block-highlighted-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 theme-code-block-highlighted-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 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 punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<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>sensitive data handling</div><div class="admonitionContent_bl22"><p>Sensitive data, such as passwords, is masked as <code>&lt;sensitive&gt;</code> in logs and inspection output.
Use Atlas <a class="" href="https://atlasgo.io/atlas-schema/projects#data-sources">data sources</a> to read credentials from secret
managers at runtime and inject them using <a class="" href="https://atlasgo.io/atlas-schema/input-variables">input variables</a>,
so that passwords never touch your codebase.</p></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="declarative-data-management">Declarative Data Management<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#declarative-data-management" class="hash-link" aria-label="Direct link to Declarative Data Management" title="Direct link to Declarative Data Management" translate="no">​</a></h2>
<p>Managing lookup tables and seed data has always been an awkward task. You either seed them manually, write custom scripts,
or treat them as "special" tables outside your migration workflow.</p>
<p>Now with Atlas, you can <a class="" href="https://atlasgo.io/atlas-schema/hcl#data">manage your data declaratively</a> in both declarative and versioned workflows.
Include the table rows you want in your desired state file and Atlas generates the migration plan to get there:</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">HCL</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-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)">"countries"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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">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)">"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">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)">2</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="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)">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 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><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 plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">table</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> table.countries</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">rows</span><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 punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"> </span><span class="token property">id</span><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><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"> </span><span class="token string" style="color:rgb(195, 232, 141)">"US"</span><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)">"United States"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 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 property">id</span><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><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"> </span><span class="token string" style="color:rgb(195, 232, 141)">"IL"</span><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)">"Israel"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 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 property">id</span><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)">3</span><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"> </span><span class="token string" style="color:rgb(195, 232, 141)">"DE"</span><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)">"Germany"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 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 property">id</span><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><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"> </span><span class="token string" style="color:rgb(195, 232, 141)">"VN"</span><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)">"Vietnam"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 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-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"> countries </span><span class="token punctuation" style="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 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 plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    code </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)">2</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">    name </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)">100</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 plain"></span><br></span><span class="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><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">INSERT</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INTO</span><span class="token plain"> countries </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">id</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> code</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> name</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">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 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 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)">'United States'</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 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 string" style="color:rgb(195, 232, 141)">'IL'</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)">'Israel'</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 number" style="color:rgb(247, 140, 108)">3</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)">'DE'</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)">'Germany'</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 number" style="color:rgb(247, 140, 108)">4</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)">'VN'</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)">'Vietnam'</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></div></div>
<p>To get started, configure sync behavior in your environment:</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><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 plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></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"> UPSERT         </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// INSERT, UPSERT, or SYNC</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">include</span><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)">"countries"</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</span><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// e.g., "public.*"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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>You control how Atlas handles data changes with three modes:</p>
<ul>
<li class=""><strong>INSERT</strong> - Add new rows only, never touch existing data</li>
<li class=""><strong>UPSERT</strong> - Insert new rows, update existing ones by primary key</li>
<li class=""><strong>SYNC</strong> - Full sync: insert, update, and delete to match desired state</li>
</ul>
<p>With added <strong>data management</strong> support, you can now manage predefined data that is part of your application's expected
state, such as feature flags or settings.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="aurora-dsql-support">Aurora DSQL Support<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#aurora-dsql-support" class="hash-link" aria-label="Direct link to Aurora DSQL Support" title="Direct link to Aurora DSQL Support" translate="no">​</a></h2>
<p><a href="https://docs.aws.amazon.com/aurora-dsql/latest/userguide/what-is-aurora-dsql.html" target="_blank" rel="noopener noreferrer" class="">Amazon Aurora DSQL</a> is AWS's
new serverless distributed SQL database, and Atlas now supports managing these databases with the <code>dsql://</code> scheme:</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)">"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 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)">dsql_pass</span><span class="token string interpolation punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token string" style="color:rgb(195, 232, 141)">@cluster.dsql.us-east-1.on.aws/?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"</span><span class="token plain"></span><br></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 handles DSQL's quirks automatically by:</p>
<ul>
<li class="">Generating <code>CREATE INDEX ASYNC</code> instead of <code>CREATE INDEX CONCURRENTLY</code></li>
<li class="">Adding <code>-- atlas:txmode none</code> since DSQL doesn't support multi-statement DDL transactions</li>
<li class="">Skipping unsupported PG features, and more.</li>
</ul>
<p>See the <a class="" href="https://atlasgo.io/guides/dsql/automatic-migrations">DSQL getting started guide</a> for setup instructions.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="clickhouse-improvements">ClickHouse Improvements<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#clickhouse-improvements" class="hash-link" aria-label="Direct link to ClickHouse Improvements" title="Direct link to ClickHouse Improvements" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="cluster-mode">Cluster Mode<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#cluster-mode" class="hash-link" aria-label="Direct link to Cluster Mode" title="Direct link to Cluster Mode" translate="no">​</a></h3>
<p>Atlas now natively supports <a class="" href="https://atlasgo.io/guides/clickhouse/cluster-mode">ClickHouse clusters</a>.</p>
<p>Add the <code>?mode=cluster</code> query parameter to your connection URL, and Atlas automatically adds <code>ON CLUSTER '{cluster}'</code>
to all DDL statements. The revision table uses a replicated engine, keeping version tracking consistent across nodes.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="data-retention-on-table-recreation">Data Retention on Table Recreation<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#data-retention-on-table-recreation" class="hash-link" aria-label="Direct link to Data Retention on Table Recreation" title="Direct link to Data Retention on Table Recreation" translate="no">​</a></h3>
<p>Changing <code>ORDER BY</code> or <code>PARTITION BY</code> in ClickHouse requires table recreation. Previously, this meant data loss, but Atlas now handles this
automatically by creating a temp table, copying data, and swapping so you can safely modify sort keys and partitioning without losing data.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="azure-fabric-support">Azure Fabric Support<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#azure-fabric-support" class="hash-link" aria-label="Direct link to Azure Fabric Support" title="Direct link to Azure Fabric Support" translate="no">​</a></h2>
<p><a href="https://learn.microsoft.com/en-us/fabric/get-started/microsoft-fabric-overview" target="_blank" rel="noopener noreferrer" class="">Microsoft Fabric</a> is Microsoft's unified analytics platform that combines data warehousing, data engineering, and BI. The Fabric Data Warehouse is built on SQL Server and uses T-SQL.</p>
<p>Atlas now supports Fabric Data Warehouse, bringing the same declarative workflow and CI/CD integration you use for other databases to Microsoft's
modern analytics stack. Whether you're managing schemas across complex data pipelines or coordinating changes across multiple teams, Atlas keeps
your Fabric databases in sync with your codebase.</p>
<p><strong>Start managing your Fabric databases with Atlas by following our <a class="" href="https://atlasgo.io/guides/azure-fabric">guide</a>.</strong></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql-enhancements">PostgreSQL Enhancements<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#postgresql-enhancements" class="hash-link" aria-label="Direct link to PostgreSQL Enhancements" title="Direct link to PostgreSQL Enhancements" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="cast-support"><code>CAST</code> Support<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#cast-support" class="hash-link" aria-label="Direct link to cast-support" title="Direct link to cast-support" translate="no">​</a></h3>
<p>PostgreSQL lets you define custom type casts - how to convert between types implicitly or explicitly. These typically go hand-in-hand with custom
types, domains, or composite types.</p>
<p>Atlas now supports including <a class="" href="https://atlasgo.io/hcl/postgres#cast">cast definitions</a> in your HCL schema file:</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">cast</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></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"> varchar</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">target</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> composite.my_type</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 punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> INOUT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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">cast</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></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"> int4</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">target</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> composite.my_type</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 punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> function.int4_to_my_type</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"> ASSIGNMENT</span><br></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 <code>with</code> attribute specifies the conversion method (<code>INOUT</code> uses the types' I/O functions, or reference a custom function).</p>
<p>The <code>as</code> attribute controls when the cast applies: <code>IMPLICIT</code> (automatic), <code>ASSIGNMENT</code> (on assignment), or explicit only.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="replica-identity">Replica Identity<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#replica-identity" class="hash-link" aria-label="Direct link to Replica Identity" title="Direct link to Replica Identity" translate="no">​</a></h3>
<p>For logical replication, a table must have a replica identity so the subscriber can identify which rows to update or delete. By default,
this is the primary key. If there is no primary key, you can use a unique index or set it to <code>FULL</code> (the entire row becomes the identity).
Without a valid replica identity, <code>UPDATE</code> and <code>DELETE</code> operations will fail.</p>
<p>Atlas now manages <a class="" href="https://atlasgo.io/hcl/postgres#table-attributes">replica identity</a> as part of your schema:</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" 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 property">replica_identity</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> FULL</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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)">"accounts"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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 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">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"idx_account_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">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.account_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 property">replica_identity</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> index.idx_account_id  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Use this index instead of PK</span><span class="token plain"></span><br></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="spanner-enhancements">Spanner Enhancements<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#spanner-enhancements" class="hash-link" aria-label="Direct link to Spanner Enhancements" title="Direct link to Spanner Enhancements" translate="no">​</a></h2>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="postgresql-dialect">PostgreSQL Dialect<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#postgresql-dialect" class="hash-link" aria-label="Direct link to PostgreSQL Dialect" title="Direct link to PostgreSQL Dialect" translate="no">​</a></h3>
<p>Spanner's PostgreSQL dialect lets you use Spanner with the PostgreSQL ecosystem, granting access to ORMs like SQLAlchemy or GORM,
frameworks, and standard <code>libpq</code> drivers. You get Spanner's scalability without rewriting your data layer.</p>
<p>Atlas now supports Spanner's PostgreSQL dialect by auto-detecting the dialect from your target database and providing a PostgreSQL-based
Spanner dev database via the Docker driver:</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)">"spanner"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">"spanner://projects/my-project/instances/my-instance/databases/my-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">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://spannerpg/latest"</span><span class="token plain"></span><br></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="vector-indexes">Vector Indexes<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#vector-indexes" class="hash-link" aria-label="Direct link to Vector Indexes" title="Direct link to Vector Indexes" translate="no">​</a></h3>
<p>Atlas also now supports Spanner's <a class="" href="https://atlasgo.io/hcl/spanner#table.index"><code>VECTOR</code> index type</a> for similarity search workloads:</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">schema.sp.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.default</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)">"DocId"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> INT64</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="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)">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)">256</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="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)">"Category"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">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">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"DocEmbedding"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> sql(</span><span class="token string" style="color:rgb(195, 232, 141)">"ARRAY&lt;FLOAT32&gt;(vector_length=&gt;128)"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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.DocId</span><span class="token punctuation" style="color:rgb(199, 146, 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">  index </span><span class="token string" style="color:rgb(195, 232, 141)">"DocEmbeddingIdx"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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.DocEmbedding</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</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"> VECTOR</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">distance_type</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> COSINE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">tree_depth</span><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 property">num_leaves</span><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">include</span><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, column.Category</span><span class="token punctuation" style="color:rgb(199, 146, 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">schema </span><span class="token string" style="color:rgb(195, 232, 141)">"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 punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="cockroachdb-support">CockroachDB Support<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#cockroachdb-support" class="hash-link" aria-label="Direct link to CockroachDB Support" title="Direct link to CockroachDB Support" translate="no">​</a></h2>
<p>We're reviving <a href="https://www.cockroachlabs.com/" target="_blank" rel="noopener noreferrer" class="">CockroachDB</a> support with a dedicated <code>crdb://</code> driver. CockroachDB started as
PostgreSQL-compatible, but the differences have grown enough that it warrants its own implementation.</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)">"cockroach"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">"crdb://user:pass@cluster.cockroachlabs.cloud:26257/defaultdb?sslmode=verify-full"</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://crdb/v25.1.1/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>Connect to CockroachDB Cloud with <code>sslmode=verify-full</code>, or run locally with <code>sslmode=disable</code>.
Both declarative and versioned workflows are supported.</p>
<p><strong>Start managing your CockroachDB databases with Atlas by following our <a class="" href="https://atlasgo.io/guides/cockroachdb/automatic-migrations">guide</a>.</strong></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>CockroachDB support is available only to <a class="" href="https://atlasgo.io/features#pro">Atlas Pro users</a>. To use this feature, run:</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 login</span><br></span></code></pre></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="slack-integration">Slack Integration<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#slack-integration" class="hash-link" aria-label="Direct link to Slack Integration" title="Direct link to Slack Integration" translate="no">​</a></h2>
<p>Atlas Cloud now has a native Slack app. Get notified when CI runs complete, migrations deploy, schema drift is detected, or reviews
need attention. Configure per-project channels and filter which events you care about.</p>
<p>Set it up yourself in <strong>Settings &gt; Integrations</strong> in Atlas Cloud to keep your team up-to-date and informed about your Atlas projects.</p>
<p><img decoding="async" loading="lazy" alt="Screenshot of Atlas Cloud Slack integration settings" src="https://atlasgo.io/assets/images/slack-integration-bceac383826db981e317383b801493a8.png" width="1902" height="959" class="img__Ss2"></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="schema-exporters">Schema Exporters<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#schema-exporters" class="hash-link" aria-label="Direct link to Schema Exporters" title="Direct link to Schema Exporters" translate="no">​</a></h2>
<p>The new <a class="" href="https://atlasgo.io/atlas-schema/projects#exporters"><code>--export</code> flag</a> provides a declarative way to export schemas to files or external services
when running <code>atlas schema inspect</code> and <code>atlas schema diff</code>. This cleans up the command line and makes the export process simpler and
reproducible.</p>
<p>Start by adding your exporter configuration to your <code>atlas.hcl</code> file:</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 comment" style="color:rgb(105, 112, 152);font-style:italic">// Export as SQL files, one per object, preserving original names.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">exporter </span><span class="token string" style="color:rgb(195, 232, 141)">"sql"</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 punctuation" style="color:rgb(199, 146, 234)">{</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/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">split_by</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> object</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">naming</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> same </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// lower (default), upper, title.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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">// Export schema as HCL files with custom extension.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">exporter </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)">"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">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" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">split_by</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> object</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">ext</span><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)">".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 punctuation" style="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">// Send schema using a webhook.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">exporter </span><span class="token string" style="color:rgb(195, 232, 141)">"http"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"webhook"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">"https://api.example.com/schemas"</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 punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"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_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 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" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">exporter </span><span class="token string" style="color:rgb(195, 232, 141)">"multi"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"all"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">exporters</span><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">    exporter.sql.schema,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    exporter.hcl.schema,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    exporter.http.webhook,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</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_error</span><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> CONTINUE</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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)">"DB_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">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.multi.all</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 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>Then, run:</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"> prod </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">--export</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="mysql-tls-support">MySQL TLS Support<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#mysql-tls-support" class="hash-link" aria-label="Direct link to MySQL TLS Support" title="Direct link to MySQL TLS Support" translate="no">​</a></h2>
<p>MySQL does not require TLS by default, but many production setups mandate encrypted connections.
Atlas now supports TLS configuration in the connection string.</p>
<p>Use <code>?ssl-ca</code> for custom CA certificates, or <code>?ssl-cert</code> and <code>?ssl-key</code> for client certificate authentication:</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">mysql://user:pass@host:3306/db?tls=true&amp;ssl-ca=/path/to/ca.pem</span><br></span></code></pre></div></div>
<p>See the <a class="" href="https://atlasgo.io/concepts/url#mysql">MySQL URL docs</a> for details.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="whats-coming-next">What's Coming Next<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#whats-coming-next" class="hash-link" aria-label="Direct link to What's Coming Next" title="Direct link to What's Coming Next" translate="no">​</a></h2>
<p>This release showcases the momentum we've built leading up to and since our v1.0 release, and we're already looking ahead to what's next.</p>
<p>We're expanding roles, users, and database access-control to Redshift, Oracle, and Snowflake, and shipping column-level lineage for schema visualization in Atlas Cloud.</p>
<p>Beyond that, we're building out the full database security lifecycle:</p>
<ul>
<li class=""><strong>Discover</strong> - Already in Atlas Monitoring. Get notified when roles or permissions change. Detect and fix drift between declared and actual state.</li>
<li class=""><strong>Assess</strong> - Analyzers that flag overly permissive roles and excessive privileges.</li>
<li class=""><strong>Govern</strong> - Policy engine to enforce least-privilege by default. Block risky permission patterns before they reach production.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2026/02/03/atlas-v1-1#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>We hope you enjoy the new features and improvements. As always, we would love to hear your feedback and suggestions on our
<a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a>, and if you're interested in learning more about Atlas, <a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">schedule a demo</a>.</p>]]></content>
        <author>
            <name>Ariel Mashraki</name>
            <uri>https://github.com/a8m</uri>
        </author>
        <category label="release" term="release"/>
        <category label="atlas v1.1" term="atlas v1.1"/>
        <category label="security" term="security"/>
        <category label="roles" term="roles"/>
        <category label="permissions" term="permissions"/>
        <category label="data" term="data"/>
        <category label="cockroachdb" term="cockroachdb"/>
        <category label="dsql" term="dsql"/>
        <category label="clickhouse" term="clickhouse"/>
        <category label="spanner" term="spanner"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Announcing Atlas v1.0: A Milestone in Database Schema Management]]></title>
        <id>https://atlasgo.io/blog/2025/12/23/atlas-v1</id>
        <link href="https://atlasgo.io/blog/2025/12/23/atlas-v1"/>
        <updated>2025-12-23T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Atlas v1.0 marks a major milestone in database schema management. This release includes Monitoring as Code, Schema Statistics, production-ready drivers for Databricks, Snowflake, and Oracle, and much more.]]></summary>
        <content type="html"><![CDATA[<p>We're excited to announce <a href="https://github.com/ariga/atlas/releases/tag/v1.0.0" target="_blank" rel="noopener noreferrer" class="">Atlas v1.0</a> - just in time for the holidays! 🎄</p>
<p>v1.0 is a milestone release. Atlas has been production-ready for a few years now, running at some of the top companies
in the industry, and reaching 1.0 is our commitment to long-term stability and compatibility. It reflects what Atlas
has become: a schema management product built for real production use that both platform engineers and developers love.</p>
<p>Here's what's in this release:</p>
<ul>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#monitoring-as-code">Monitoring as Code</a></strong> - Configure Atlas monitoring with HCL, including RDS discovery and cross-account support.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#schema-statistics-and-insights">Schema Statistics</a></strong> - Size breakdowns, largest tables/indexes, fastest-growing objects, and growth trends over time.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#declarative-migrations-ui">Declarative Migrations UI</a></strong> - A new dashboard for databases, migrations, deployments, and status visibility.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#database-drivers">Database Drivers</a></strong> - Databricks, Snowflake, and Oracle graduate from beta to stable; plus improvements across Postgres, MySQL, Spanner, Redshift, and ClickHouse.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#deployment-rollout-strategies">Deployment Rollout Strategies</a></strong> - Staged rollouts (canaries, parallelism, and error handling) for multi-tenant and fleet deployments.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#deployment-traces">Deployment Traces</a></strong> - End-to-end traceability for how changes move through environments.</li>
<li class=""><strong><a class="" href="https://atlasgo.io/blog/2025/12/23/atlas-v1#multi-config-files-support">Multi-Config Files</a></strong> - Layer config files with <code>-c file://base.hcl,file://app.hcl</code>.</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="monitoring-as-code">Monitoring as Code<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#monitoring-as-code" class="hash-link" aria-label="Direct link to Monitoring as Code" title="Direct link to Monitoring as Code" translate="no">​</a></h2>
<p>Starting with the latest version of <a class="" href="https://atlasgo.io/monitoring/quickstart">Atlas Agent</a>, you can now define your monitoring setup as code using Atlas's HCL configuration language.
This keeps monitoring configuration in version control, makes it reviewable like any other change, and avoids "ClickOps" mistakes.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">agent.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)">"rds_discovery"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"my_instances"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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 punctuation" style="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">instance</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> data.rds_discovery.my_instances.instances</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">name</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> each.value.identifier</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">driver</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> each.value.driver</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">connection</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">host</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> each.value.address</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">port</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> each.value.port</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><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">  default_monitor </span><span class="token string" style="color:rgb(195, 232, 141)">"all"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">snapshot_interval</span><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)">"1h"</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">statistics</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">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>This new setup makes it much easier to run the same setup across many databases:</p>
<ol>
<li class="">Define a <code>default_monitor</code> once (scope, interval, stats collection)</li>
<li class="">Override it for specific databases/schemas when needed</li>
<li class="">Automate deployment of the agent with a consistent config</li>
</ol>
<p>For cloud fleets, you can even discover RDS and GCP instances automatically using data sources.</p>
<p>For a step-by-step example walk-through, watch our tutorial to get started with Monitoring as Code in under 5 minutes:</p>
<iframe width="100%" height="315" src="https://www.youtube.com/embed/AFqUlzQB-4g?si=4XOatZ9LEQgaxGhd" title="YouTube video player" loading="lazy" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin"></iframe>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="schema-statistics-and-insights">Schema Statistics and Insights<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#schema-statistics-and-insights" class="hash-link" aria-label="Direct link to Schema Statistics and Insights" title="Direct link to Schema Statistics and Insights" translate="no">​</a></h2>
<p>Atlas Monitoring can now collect statistics during each monitoring run, so you can track schema growth over time.
This includes database size breakdowns, the largest and fastest-growing tables/indexes, growth trends across the schema, and more.</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/images/schema-stats.png" alt="Schema statistics in Atlas Cloud" width="100%"><p style="font-size:12px">Schema statistics in Atlas Cloud</p></div>
<p>These statistics also power safer change reviews - for example, flagging risky changes on large objects (like operations that may cause table copies).
In practice, this means Atlas can use real schema context during CI and PR review to highlight risk before changes roll out.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="declarative-migrations-ui">Declarative Migrations UI<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#declarative-migrations-ui" class="hash-link" aria-label="Direct link to Declarative Migrations UI" title="Direct link to Declarative Migrations UI" translate="no">​</a></h2>
<p>Atlas Cloud now provides detailed migration logs, deployment status, and database tracking. You can see which databases
are up-to-date or have pending migrations, and track rollouts across environments.</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/images/deploy-logs-schema-apply.png" alt="Declarative migrations UI in Atlas Cloud" width="100%"><p style="font-size:12px">Declarative migrations UI in Atlas Cloud</p></div>
<p>When enabled, all of this information is reported by Atlas from your CD setup after planning and running migrations.
There is no need to connect your databases to Atlas Cloud; they remain isolated in your VPC.
To get started, see the <a class="" href="https://atlasgo.io/declarative/setup-cicd">CI/CD setup guide</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="deployment-rollout-strategies">Deployment Rollout Strategies<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#deployment-rollout-strategies" class="hash-link" aria-label="Direct link to Deployment Rollout Strategies" title="Direct link to Deployment Rollout Strategies" translate="no">​</a></h2>
<p>When deploying schema migrations to multiple tenant databases, sometimes you need more control than applying migrations
sequentially or all at once. The <code>deployment</code> block gives you fine-grained control over rollouts: canary deployments,
execution order, regional rollouts, parallel execution, and error handling strategies like fail-fast or continue-on-error.</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">deployment </span><span class="token string" style="color:rgb(195, 232, 141)">"staged"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 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">variable</span><span class="token keyword type variable" style="font-style:italic;color:rgb(191, 199, 213)"> "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 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">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// Stage 1: Canary tenants first</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  group </span><span class="token string" style="color:rgb(195, 232, 141)">"canary"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> startswith(var.name, </span><span class="token string" style="color:rgb(195, 232, 141)">"canary-"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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">// Stage 2: Free-tier with high parallelism</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  group </span><span class="token string" style="color:rgb(195, 232, 141)">"free"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> var.tier </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 string" style="color:rgb(195, 232, 141)">"FREE"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">parallel</span><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)">10</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_error</span><span class="token plain">   </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> CONTINUE</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">group.canary</span><span class="token punctuation" style="color:rgb(199, 146, 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">// Stage 3: Paid customers</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  group </span><span class="token string" style="color:rgb(195, 232, 141)">"paid"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">parallel</span><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)">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">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">group.free</span><span class="token punctuation" style="color:rgb(199, 146, 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)">"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(var.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"> urlsetpath(var.url, 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">rollout</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">deployment</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> deployment.staged</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">vars</span><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">name</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 punctuation" style="color:rgb(199, 146, 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 get started with rollout strategies and multi-tenant schema migrations, see the <a class="" href="https://atlasgo.io/guides/database-per-tenant/rollout">rollout guide</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="deployment-traces">Deployment Traces<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#deployment-traces" class="hash-link" aria-label="Direct link to Deployment Traces" title="Direct link to Deployment Traces" translate="no">​</a></h2>
<p><a class="" href="https://atlasgo.io/cloud/features/registry">Atlas Registry</a> now provides end-to-end visibility into how migrations progress through your environments.
You can track the full journey of each change, from planning and review, through dev and staging, to production with a controlled <a class="" href="https://atlasgo.io/guides/environment-promotion">environment
promotion</a> process. Track when and where each version was applied, which databases were affected, and whether executions
completed successfully.</p>
<p><img decoding="async" loading="lazy" alt="Deployment Trace" src="https://atlasgo.io/assets/images/deployment-trace-4e500e0229196e25525a5bd2bb84d9b8.png" width="2704" height="1440" class="img__Ss2"></p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="multi-config-files-support">Multi-Config Files Support<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#multi-config-files-support" class="hash-link" aria-label="Direct link to Multi-Config Files Support" title="Direct link to Multi-Config Files Support" translate="no">​</a></h2>
<p>Atlas now supports passing multiple configuration files, allowing you to maintain a base configuration with
organization-wide settings and layer project-specific configurations on top.</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 apply </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-c</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"file://base.hcl,file://app.hcl"</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><br></span></code></pre></div></div>
<p>A common pattern is to keep shared policies in <code>base.hcl</code>, and layer project/environment settings in separate file:</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">base.hcl (shared policies)</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_ysIP">app.hcl (project specific)</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">base.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 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><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><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">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" style="color:#bfc7d5"><span class="token plain">  </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Create and drop indexes concurrently.</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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">add</span><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">drop</span><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 comment" style="color:rgb(105, 112, 152);font-style:italic"># Skip destructive changes.</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">skip</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">drop_column</span><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">drop_table</span><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></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">project.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)">"external_schema"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"sqlalchemy"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">program</span><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)">"atlas-provider-sqlalchemy"</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)">"--path"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"./models"</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)">"--dialect"</span><span class="token plain">, </span><span class="token string" style="color:rgb(195, 232, 141)">"postgresql"</span><span class="token plain">,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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">src</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> data.external_schema.sqlalchemy.url</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/16/dev?search_path=public"</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 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)">"file://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><br></span></code></pre></div></div></div></div></div>
<p>Then run:</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">  </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-c</span><span class="token plain"> file://base.hcl,file://app.hcl </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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">atlas migrate apply </span><span class="token parameter variable" style="color:rgb(191, 199, 213)">-c</span><span class="token plain"> file://base.hcl,file://app.hcl </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>We're also working on making configs easier to share and reuse across projects using Atlas Registry.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="database-drivers">Database Drivers<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#database-drivers" class="hash-link" aria-label="Direct link to Database Drivers" title="Direct link to Database Drivers" translate="no">​</a></h2>
<p>This release includes significant improvements across our database drivers. Three drivers have graduated from beta to
stable: <strong><a class="" href="https://atlasgo.io/guides/databricks/automatic-migrations">Databricks</a></strong>, <strong><a class="" href="https://atlasgo.io/guides/snowflake/automatic-migrations">Snowflake</a></strong>,
and <strong><a class="" href="https://atlasgo.io/guides/oracle/automatic-migrations">Oracle</a></strong>. We've also added new features to existing drivers:</p>
<ul>
<li class=""><strong>MySQL:</strong> SRID support for spatial columns</li>
<li class=""><strong>PostgreSQL:</strong> Table storage parameters and schema collation</li>
<li class=""><strong>Google Spanner:</strong> Property graphs support</li>
<li class=""><strong>Oracle:</strong> Functions and procedures</li>
<li class=""><strong>Redshift:</strong> Functions and procedures</li>
<li class=""><strong>Databricks:</strong> Table locations, USING formats, user functions, and procedures</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="whats-coming-next">What's Coming Next<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#whats-coming-next" class="hash-link" aria-label="Direct link to What's Coming Next" title="Direct link to What's Coming Next" translate="no">​</a></h2>
<p>Reaching v1.0 is just the beginning. We're focusing on the areas teams keep pushing us on: bringing more of the database
lifecycle under version control and tightening the day-2 operational story. Here's what that means in practice:</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="database-security-as-code">Database Security as Code<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#database-security-as-code" class="hash-link" aria-label="Direct link to Database Security as Code" title="Direct link to Database Security as Code" translate="no">​</a></h3>
<p>We're bringing the same "as-code" and "manage it declaratively" workflow to database access control: roles, privileges, and users -
reviewed in pull requests and deployed via the same pipelines you already use for schema changes.</p>
<div class="language-hcl codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">permission.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">user </span><span class="token string" style="color:rgb(195, 232, 141)">"a8m"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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.dba</span><span class="token punctuation" style="color:rgb(199, 146, 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)">"admin"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">superuser</span><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">create_db</span><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">create_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 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)">"Administrator 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" 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">for_each</span><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">schema.public, schema.private</span><span class="token punctuation" style="color:rgb(199, 146, 234)">]</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"> each.value</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.dba</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, INSERT, UPDATE, 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><br></span></code></pre></div></div>
<p>Security as Code (SaC) is a paradigm promoted and adopted by leading security firms like Wiz,
CrowdStrike, and others. Atlas is now bringing it to databases, completing our
coverage of database management as code: from schema, policy, and monitoring - to security and access control.</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>This feature is currently in beta for enterprise customers and expected to reach GA in the
next version.</p></div></div>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="dbre-and-automation">DBRE and Automation<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#dbre-and-automation" class="hash-link" aria-label="Direct link to DBRE and Automation" title="Direct link to DBRE and Automation" translate="no">​</a></h3>
<p>In upcoming versions, you can expect stronger drift detection and alerting, deeper monitoring that goes beyond schemas to cover
performance and operational metrics, and better support for AI-assisted and agentic workflows.</p>
<p>Atlas already maintains authoritative status, which gives agents the context they need to operate safely.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="data-flow-and-lineage">Data Flow and Lineage<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#data-flow-and-lineage" class="hash-link" aria-label="Direct link to Data Flow and Lineage" title="Direct link to Data Flow and Lineage" translate="no">​</a></h3>
<p>This year, we invested heavily in analytical databases like Redshift, Snowflake, ClickHouse, and Databricks.
As adoption grew, we welcomed a new persona to our user base: data engineers. With this came
a common requested feature - while Atlas Cloud currently displays ERD-style schema overviews,
data teams need automatic lineage resolution similar to dbt, Snowflake, and BigQuery.</p>
<p>In upcoming versions, you can expect a dedicated lineage view that automatically loads
dependencies for any selected object, showing full upstream and downstream graphs.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2025/12/23/atlas-v1#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>This year we shipped 9 major releases, brought three drivers to production-ready status, and
expanded Atlas from a schema management product into a database reliability platform.
Reaching v1.0 reflects the maturity and stability we've built over the past few years.</p>
<p>Thank you to everyone who helped bring Atlas to where it is today. Wishing you all a Merry Christmas and a Happy New Year! 🎄</p>
<hr>
<p>Want to see how Atlas can help your team? <a href="https://calendly.com/d/cq3j-ktn-2rc" target="_blank" rel="noopener noreferrer" data-cta-placement="docs">Schedule a demo</a> with us.</p>]]></content>
        <author>
            <name>Ariel Mashraki</name>
            <uri>https://github.com/a8m</uri>
        </author>
        <category label="release" term="release"/>
        <category label="atlas v1" term="atlas v1"/>
        <category label="milestone" term="milestone"/>
        <category label="schema management" term="schema management"/>
        <category label="dbre" term="dbre"/>
    </entry>
    <entry>
        <title type="html"><![CDATA[Atlas v0.38: Linting Analyzers, PII Detection, Migration Hooks, and More]]></title>
        <id>https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks</id>
        <link href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks"/>
        <updated>2025-10-28T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Atlas v0.38 introduces expanded Oracle, Spanner, and Snowflake support, additional linting analyzers, pre- and post-migration hooks, broader schema monitoring, and much more.]]></summary>
        <content type="html"><![CDATA[<p>Hi everyone!</p>
<p>We're excited to share with you the release of <a href="https://github.com/ariga/atlas/releases/tag/v0.38.0" target="_blank" rel="noopener noreferrer" class="">Atlas v0.38</a>, filled with
many new features and enhancements for you to try.</p>
<ul>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#oracle">Oracle Triggers and Views</a> - We've expanded the support
for Oracle schemas to include triggers and views.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#snowflake">Snowflake Additions</a> - Our library of supported resources
for Snowflake has also expanded with the additions of stages, external tables, hybrid tables, and dynamic tables.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#spanner">Google Spanner Additions</a> - Spanner users can now manage
geo-partitioning placements, locality groups, sequences, and change streams with Atlas.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#analyzers">Expanded Analyzer Detection</a> - Our linting analyzers now
detect SQL injections in SQL schema and migration files, and incorrect usage of transactions in migration files.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#http">HTTP Data Source</a> - Users can now use HTTP endpoints as data
sources in the Atlas configuration file.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#pii">PII Detection</a> - Objects containing potentially sensitive or
PII data can now be automatically or manually tagged in the Atlas Registry.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#migration-hooks">Pre/Post-migration Hooks</a> - Pre- and post-migration
hooks enable teams to run custom logic before and after applying migrations.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#monitoring">Atlas Monitoring</a> - The Atlas Agent can now automatically
discover and monitor RDS instances across multiple AWS accounts using IAM role assumption.</li>
<li class=""><a class="" href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#azure-devops">Azure DevOps Repos CI/CD Integration</a> - Atlas now
provides native integration with Azure DevOps Pipelines and Azure Repos, including a dedicated Azure DevOps extension for seamless
database schema CI/CD workflows.</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>beta drivers</div><div class="admonitionContent_bl22"><p>We're eager to share that our beta drivers are growing to support more features to better manage schemas across database types.</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">macOS + Linux</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></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_OMyP"><p>To download and install the custom 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 assign-left variable" style="color:rgb(191, 199, 213)">ATLAS_FLAVOR</span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token string" style="color:rgb(195, 232, 141)">"oracle"</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>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:latest-extended</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:latest-extended </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:latest-extended 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)">"oracle://PDBADMIN:Pssw0rd0995@localhost:1521/FREEPDB1"</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-extended-latest.exe" target="_blank" rel="noopener noreferrer" class="">custom release</a> and
move the atlas binary to a file location on your system PATH.</p></div></div></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="oracle">Oracle Support Additions<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#oracle" class="hash-link" aria-label="Direct link to Oracle Support Additions" title="Direct link to Oracle Support Additions" translate="no">​</a></h2>
<p>With Atlas v0.38, we have expanded our Oracle driver (currently in beta) to include support for <strong>triggers</strong> and <strong>views</strong> in
your schema management. This means that any triggers and views in your Oracle schemas will be included in automatic schema
inspections, schema diffs, etc.</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 comment" style="color:rgb(105, 112, 152);font-style:italic">-- [...schema truncated for space]</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">-- Trigger that records any salary change</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">TRIGGER</span><span class="token plain"> TRG_UPDATE_SALARY_AUDIT</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">AFTER</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">UPDATE</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">OF</span><span class="token plain"> SALARY </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> EMPLOYEES</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token keyword" style="font-style:italic">FOR EACH ROW</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">WHEN</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">OLD</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY </span><span class="token operator" style="color:rgb(137, 221, 255)">!=</span><span class="token plain"> NEW</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 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">BEGIN</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">INSERT</span><span class="token plain"> </span><span class="token keyword" style="font-style:italic">INTO</span><span class="token plain"> SALARY_AUDIT </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">EMP_ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> OLD_SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> NEW_SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> CHANGE_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 keyword" style="font-style:italic">VALUES</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">(</span><span class="token plain">:OLD</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">EMP_ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> :OLD</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> :NEW</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> SYSDATE</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">END</span><span class="token punctuation" style="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">-- View that shows employees with department names and computed annual salary</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">VIEW</span><span class="token plain"> EMPLOYEE_INFO_VIEW </span><span class="token keyword" style="font-style:italic">AS</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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">EMP_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">    e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">FIRST_NAME </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><span class="token operator" style="color:rgb(137, 221, 255)">||</span><span class="token plain"> e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">LAST_NAME </span><span class="token keyword" style="font-style:italic">AS</span><span class="token plain"> 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">    d</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">DEPT_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">    e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 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">e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">SALARY </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)">12</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">AS</span><span class="token plain"> ANNUAL_SALARY</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">HIRE_DATE</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"> EMPLOYEES e</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"> DEPARTMENTS d </span><span class="token keyword" style="font-style:italic">ON</span><span class="token plain"> e</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">DEPT_ID </span><span class="token operator" style="color:rgb(137, 221, 255)">=</span><span class="token plain"> d</span><span class="token punctuation" style="color:rgb(199, 146, 234)">.</span><span class="token plain">DEPT_ID</span><span class="token punctuation" style="color:rgb(199, 146, 234)">;</span><br></span></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="snowflake">Snowflake Support Additions<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#snowflake" class="hash-link" aria-label="Direct link to Snowflake Support Additions" title="Direct link to Snowflake Support Additions" translate="no">​</a></h2>
<p>Atlas v0.38 introduces broader support for our Snowflake driver (currently in beta), providing more flexibility in using
Atlas to manage your Snowflake schema.</p>
<p>Newly supported resources include:</p>
<ul>
<li class="">
<p><strong>Stages:</strong> Define external storage locations for loading and unloading data.</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">stage </span><span class="token string" style="color:rgb(195, 232, 141)">"mystage"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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">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://mybucket/data/"</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_integration</span><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)">"my_integration"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">directory_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)">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)">"This is my stage"</span><span class="token plain"></span><br></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>
</li>
<li class="">
<p><strong>External Tables:</strong> Refer to data stored outside Snowflake, such as in S3, and query it as if it were a regular 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">external_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">  column </span><span class="token string" style="color:rgb(195, 232, 141)">"event_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"> 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 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"></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)">"value:c1::varchar"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 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">location</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">stage</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> stage.mystage</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)">"data/events/"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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>
</li>
<li class="">
<p><strong>Hybrid Tables:</strong> Combine transactional and analytical workloads in a single table, supporting flexible data operations.</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">hybrid_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" 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">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)">"User 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">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 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 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 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 punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
</li>
<li class="">
<p><strong>Dynamic Tables:</strong> Define tables that automatically refresh based on upstream changes, supporting incremental or full refresh modes.</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">dynamic_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" 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">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)">"User 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 property">target_lag</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> DOWNSTREAM </span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic">// or "&lt;num&gt; { seconds | minutes | hours | days }"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">refresh_mode</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> INCREMENTAL, or FULL</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 * FROM users"</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 punctuation" style="color:rgb(199, 146, 234)">}</span><br></span></code></pre></div></div>
</li>
</ul>
<p>Read more about implementing these resources in the <a href="https://atlasgo.io/hcl/snowflake" target="_blank" rel="noopener noreferrer" class="">Atlas configuration documentation</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="spanner">Google Spanner Support Additions<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#spanner" class="hash-link" aria-label="Direct link to Google Spanner Support Additions" title="Direct link to Google Spanner Support Additions" translate="no">​</a></h2>
<p>Atlas v0.38 also comes with more support for the Google Spanner driver (currently in beta) to improve managing your Spanner
schema with Atlas.</p>
<p>The newly added resource support includes:</p>
<ul>
<li class="">
<p><strong>Geo-partitioning Placements:</strong> Partition logical tables at the row level into distinct placements mapped to different
instance partitions to serve data locally by region while maintaining one unified database.</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)">"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.default</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)">"Location"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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(MAX)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">placment_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 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.OrderId</span><span class="token punctuation" style="color:rgb(199, 146, 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">placement </span><span class="token string" style="color:rgb(195, 232, 141)">"europeplacement"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">instance_partition</span><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)">"euro-partition"</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_leader</span><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)">"europe-west1"</span><span class="token plain"></span><br></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>
</li>
<li class="">
<p><strong>Locality Groups:</strong> Control whether their data uses high-performance SSD storage, standard HDD storage, or flexible
age-based policies that transition data from SSD to HDD over time.</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)">"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.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.hotspot_group</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token punctuation" style="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)">"hotspot_group"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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 property">ssd_to_hdd_spill_timespan</span><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)">"24h"</span><span class="token plain"></span><br></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>
</li>
<li class="">
<p><strong>Sequences:</strong> Generate a series of unique integer values to use as a column's default value (e.g., ID numbers).</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)">"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.default</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><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"> INT64</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)">"GET_NEXT_SEQUENCE_VALUE(SEQUENCE orders_sequence)"</span><span class="token plain">)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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.OrderId</span><span class="token punctuation" style="color:rgb(199, 146, 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">sequence </span><span class="token string" style="color:rgb(195, 232, 141)">"orders_sequence"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">kind</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> bit_reversed_positive</span><br></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>
</li>
<li class="">
<p><strong>Change Streams:</strong> Capture and stream data changes (e.g., inserts, updates, and deletes) from a database in near real-time.</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">stream </span><span class="token string" style="color:rgb(195, 232, 141)">"OrdersStream"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">tables</span><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 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">retention_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 string" style="color:rgb(195, 232, 141)">"7d"</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_capture_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)">"NEW_ROW"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 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>
</li>
</ul>
<p>Read more about using Atlas's Google Spanner driver in our <a class="" href="https://atlasgo.io/guides/spanner/automatic-migrations">guides</a> and <a class="" href="https://atlasgo.io/hcl/spanner">docs</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="analyzers">Expanded Analyzer Detection<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#analyzers" class="hash-link" aria-label="Direct link to Expanded Analyzer Detection" title="Direct link to Expanded Analyzer Detection" translate="no">​</a></h2>
<p>Atlas contains a number of <a class="" href="https://atlasgo.io/lint/analyzers">analyzers and checkers</a> that automatically detect destructive changes, backward-incompatible
changes, and much more. These have been expanded to include flagging <a class="" href="https://atlasgo.io/lint/analyzers#nested-transactions">nested transactions</a>
and detecting <a class="" href="https://atlasgo.io/lint/analyzers#sql-injection">SQL injections</a> that can make schemas or migrations vulnerable to untrusted input.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="transactions">Transactions in Migration Files<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#transactions" class="hash-link" aria-label="Direct link to Transactions in Migration Files" title="Direct link to Transactions in Migration Files" translate="no">​</a></h3>
<p>Atlas wraps all migration files in individual transactions by default, which can cause errors when manually-written migration
files contain their own transaction statements (for example, <code>START TRANSACTION</code>).</p>
<p>The <code>nestedtx</code> analyzer flags these statements, allowing you to handle the overlap by either removing the manual transaction
control or adding <code>-- atlas:txmode none</code> to the file header to indicate that this migration file should not be wrapped in a
transaction by Atlas.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="sql-injection-analyzer">SQL Injection Analyzer<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#sql-injection-analyzer" class="hash-link" aria-label="Direct link to SQL Injection Analyzer" title="Direct link to SQL Injection Analyzer" translate="no">​</a></h3>
<p>The <a class="" href="https://atlasgo.io/lint/analyzers#sql-injection">SQL injection analyzer</a> scans migration files and declarative schemas for potentially
vulnerable SQL constructs. It detects unsafe dynamic SQL patterns like string concatenation and variable interpolation that
could allow untrusted input to be executed.</p>
<p>With the increasing use of automated tools and AI assistance in schema development, this analyzer helps catch unintentional
security risks early in the development cycle with two checks:</p>
<ul>
<li class="">Use of <code>EXEC</code>/<code>EXECUTE</code> statements with string concatenation or variable interpolation</li>
<li class="">Dynamic SQL construction using improper string operations</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>note</div><div class="admonitionContent_bl22"><p>This analyzer is currently only supported on the PostgreSQL driver, with plans to expand to MySQL and SQL Server in the next release.</p></div></div>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>Example output</summary><div><div class="collapsibleContent_VYua"><div class="language-planlog codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_kX1v"><pre tabindex="0" class="prism-code language-planlog 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 1 to 2 (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 2</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">    -- </span><span class="token plain">possible SQL injection vulnerabilities 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">L11: expression concatenates parameter(s) into dynamic statement</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         https://atlasgo.io/lint/analyzers#SA101</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">      -- </span><span class="token plain">L25: function call propagates parameter into dynamic statement without sanitization</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">         https://atlasgo.io/lint/analyzers#SA101</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 (234.583µs)</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 plain">500.5µ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">1 version with warnings</span><span class="token action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token plain">11 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">6 diagnostics'</span><br></span></code></pre></div></div></div></div></details>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="http">HTTP Data Source<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#http" class="hash-link" aria-label="Direct link to HTTP Data Source" title="Direct link to HTTP Data Source" translate="no">​</a></h2>
<p>Atlas now supports using an <a class="" href="https://atlasgo.io/atlas-schema/projects#data-source-http">HTTP endpoint as a data source</a>, allowing you to fetch
data from internal and external services and use it dynamically in your project configuration. It can perform <code>GET</code>, <code>HEAD</code>,
or <code>POST</code> requests, with the option to include headers, a request body, timeouts, TLS certificates, and retry logic.</p>
<p>After the request runs, Atlas exposes attributes like the response body, headers, status code, and URL, which can be referenced
in your configuration (e.g., pulling a secret or setting an environment variable based on an API response).</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="example">Example<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#example" class="hash-link" aria-label="Direct link to Example" title="Direct link to Example" translate="no">​</a></h3>
<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)">"http"</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"example"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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)">"https://service.example.com/search?q=atlas"</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 punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(195, 232, 141)">"GET"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">request_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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">"Accept"</span><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><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token property">request_timeout_ms</span><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)">5000</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">retry</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token property">attempts</span><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 property">min_delay_ms</span><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">max_delay_ms</span><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 punctuation" style="color:rgb(199, 146, 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)">"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">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.my.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">  </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)">"mysql://root:</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 function" style="color:rgb(130, 170, 255)">jsondecode</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)">http</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)">example</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)">response_body</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)">password</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)">@host:3306/database"</span><span class="token plain"></span><br></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="pii">PII Visibility and Detection<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#pii" class="hash-link" aria-label="Direct link to PII Visibility and Detection" title="Direct link to PII Visibility and Detection" translate="no">​</a></h2>
<p>Atlas Registry now supports tagging database objects that contain potentially sensitive or personally identifiable information
(PII). This capability helps organizations meet privacy, security, and compliance requirements such as <strong>SOC 2</strong>, <strong>GDPR</strong>, and
<strong>ISO 27001</strong>, which require visibility and control over how personal data is stored and accessed.</p>
<p>Atlas automatically detects objects that may contain PII by using pattern-based analysis of schema metadata to inspect object names,
column names, and comments to identify fields likely to store sensitive information. Users can also manually add or remove PII tags
(or any other tags, such as "PHI"), filter to view only tagged objects, and maintain a consistent data classification strategy
across environments.</p>
<div style="text-align:center"><img src="https://atlasgo.io/u/cloud/pii/pii-demo.png" alt="PII tagging in Atlas Registry" width="100%"><p style="font-size:12px">PII tagging in Atlas Registry</p></div>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="migration-hooks">Pre- and Post-migration Hooks<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#migration-hooks" class="hash-link" aria-label="Direct link to Pre- and Post-migration Hooks" title="Direct link to Pre- and Post-migration Hooks" translate="no">​</a></h2>
<p>Pre- and post-migration scripts are now generally available. They let teams run custom logic before and after applying
migrations. This is ideal for enforcing guardrails, refreshing materialized views, or seeding and updating data as part
of the migration deployment process.</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 keyword" style="font-style:italic">env</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</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"> atlas.env</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  pre </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" style="color:#bfc7d5"><span class="token plain">    </span><span class="token keyword" style="font-style:italic">skip</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">      </span><span class="token property">condition</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> atlas.env </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 string" style="color:rgb(195, 232, 141)">"staging"</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)">"Skipping staging warm-up"</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 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">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/pre-flight.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">  </span><span class="token punctuation" style="color:rgb(199, 146, 234)">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  post </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" 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">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/analytics_refresh.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">on_error</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(199, 146, 234)">=</span><span class="token plain"> BREAK</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(199, 146, 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" data-collapsed="true"><summary>Example output</summary><div><div class="collapsibleContent_VYua"><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 pre-migration hooks (1 hook 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">hook 1/1 at atlas.hcl:11 (2 statements):</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">CALL ensure_guardrails();</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">CALL validate_data_integrity();</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.583µs</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 1 (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 1</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 t1(c1 int);</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 t1 ADD COLUMN c2 int;</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">148.583µs</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 action1"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token action1">  -- </span><span class="token duration">911.5µ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">1 migration</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 sql statements</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">Executing post-migration hooks (1 hook 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">hook 1/1 at atlas.hcl:23 (2 statements):</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">REFRESH MATERIALIZED VIEW CONCURRENTLY analytics.latest_activity;</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">CALL sync_reporting_cache();</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.375µs</span><span class="token plain">)</span><br></span></code></pre></div></div></div></div></details>
<p>Hooks run outside the migration transaction and can be conditionally skipped with <code>skip { condition = ... }</code>.
This feature provides fine-grained control and automation around database change execution.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="monitoring">Atlas Schema Monitoring<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#monitoring" class="hash-link" aria-label="Direct link to Atlas Schema Monitoring" title="Direct link to Atlas Schema Monitoring" translate="no">​</a></h2>
<p>In the previous release, we added the ability to automatically discover database instances for monitoring using the Atlas Agent,
rather than manually creating them in the Atlas Cloud.</p>
<p>Expanding on this feature, we have now added the ability to discover and monitor RDS instances across multiple AWS (sub-)accounts
by assuming an IAM role if a trusted relationship is established. Read more about this <a class="" href="https://atlasgo.io/monitoring/discovery">in our docs</a>.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="azure-devops">Azure DevOps Repos CI/CD Integration<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#azure-devops" class="hash-link" aria-label="Direct link to Azure DevOps Repos CI/CD Integration" title="Direct link to Azure DevOps Repos CI/CD Integration" translate="no">​</a></h2>
<p>Atlas now provides first-class support for Azure DevOps, bringing professional database CI/CD workflows to teams using Azure Repos and
Azure Pipelines. This integration includes a dedicated <a href="https://marketplace.visualstudio.com/items?itemName=Ariga.atlas-action" target="_blank" rel="noopener noreferrer" class="">Azure DevOps extension</a>
that simplifies the setup and execution of schema migration workflows.</p>
<h3 class="anchor anchorTargetStickyNavbar_SAay" id="getting-started-with-azure-devops">Getting Started with Azure DevOps<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#getting-started-with-azure-devops" class="hash-link" aria-label="Direct link to Getting Started with Azure DevOps" title="Direct link to Getting Started with Azure DevOps" translate="no">​</a></h3>
<p>Setting up Atlas with Azure DevOps takes just a few steps. Here's a quick example of what the pipeline configuration looks like:</p>
<details class="details_B4FW alert alert--info details_SZgV" data-collapsed="true"><summary>View configuration</summary><div><div class="collapsibleContent_VYua"><div class="language-yaml codeBlockContainer_ZGJx theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockTitle_L5qy">azure-pipelines.yml</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">trigger</span><span class="token punctuation" style="color:rgb(199, 146, 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">branches</span><span class="token punctuation" style="color:rgb(199, 146, 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">include</span><span class="token punctuation" style="color:rgb(199, 146, 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"> main</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(199, 146, 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">include</span><span class="token punctuation" style="color:rgb(199, 146, 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)">'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><span class="token string" style="color:rgb(195, 232, 141)">'azure-pipelines.yml'</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 key atrule">pr</span><span class="token punctuation" style="color:rgb(199, 146, 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">branches</span><span class="token punctuation" style="color:rgb(199, 146, 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">include</span><span class="token punctuation" style="color:rgb(199, 146, 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"> main</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">paths</span><span class="token punctuation" style="color:rgb(199, 146, 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">include</span><span class="token punctuation" style="color:rgb(199, 146, 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)">'migrations/*'</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 key atrule">pool</span><span class="token punctuation" style="color:rgb(199, 146, 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">vmImage</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" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token key atrule">variables</span><span class="token punctuation" style="color:rgb(199, 146, 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">group</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">vars</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 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">checkout</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> self</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">persistCredentials</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)">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">fetchDepth</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">fetchTags</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)">true</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 punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">script</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)">    echo "Configuring git user for commits...."</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">    git config user.email "azure-pipelines[bot]@users.noreply.github.com"</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token scalar string" style="color:rgb(195, 232, 141)">    git config user.name "azure-pipelines[bot]"</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">displayName</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)">'Configure Git User for Commits'</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 punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">script</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> curl </span><span class="token punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain">sSf https</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain">//atlasgo.sh </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 key atrule">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Install Atlas</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 punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">script</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas version</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Atlas Version</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 punctuation" style="color:rgb(199, 146, 234)">-</span><span class="token plain"> </span><span class="token key atrule">script</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> atlas login </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">token $(ATLAS_TOKEN)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Atlas Login</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"># Lint migrations on pull requests</span><span class="token plain"></span><br></span><span class="token-line" 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">task</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasAction@1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">condition</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> eq(variables</span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">'Build.Reason'</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"> 'PullRequest')</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 key atrule">SYSTEM_ACCESSTOKEN</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $(System.AccessToken)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">inputs</span><span class="token punctuation" style="color:rgb(199, 146, 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">action</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)">'migrate lint'</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><span class="token string" style="color:rgb(195, 232, 141)">'file://migrations'</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_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)">'app-schema-2'</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">config</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://atlas.hcl'</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><span class="token string" style="color:rgb(195, 232, 141)">'ci'</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">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Lint Migrations</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"># Push migrations to Atlas Cloud on main branch</span><span class="token plain"></span><br></span><span class="token-line" 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">task</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasAction@1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">condition</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> and(succeeded()</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> eq(variables</span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">'Build.SourceBranch'</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"> 'refs/heads/main'))</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">inputs</span><span class="token punctuation" style="color:rgb(199, 146, 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">action</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)">'migrate push'</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><span class="token string" style="color:rgb(195, 232, 141)">'file://migrations'</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_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)">'app-schema-2'</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">latest</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)">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">env</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)">'ci'</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">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Push Migrations</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 migrations to database on main branch</span><span class="token plain"></span><br></span><span class="token-line" 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">task</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> AtlasAction@1</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">condition</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> and(succeeded()</span><span class="token punctuation" style="color:rgb(199, 146, 234)">,</span><span class="token plain"> eq(variables</span><span class="token punctuation" style="color:rgb(199, 146, 234)">[</span><span class="token string" style="color:rgb(195, 232, 141)">'Build.SourceBranch'</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"> 'refs/heads/main'))</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">inputs</span><span class="token punctuation" style="color:rgb(199, 146, 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">action</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)">'migrate apply'</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><span class="token string" style="color:rgb(195, 232, 141)">'file://migrations'</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">url</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> $(DB_URL)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">  </span><span class="token key atrule">displayName</span><span class="token punctuation" style="color:rgb(199, 146, 234)">:</span><span class="token plain"> Apply Migrations</span><br></span></code></pre></div></div></div></div></details>
<p>This pipeline automatically:</p>
<ol>
<li class=""><strong>Lints</strong> new migrations when you open a pull request, surfacing potential issues directly in your PR,</li>
<li class=""><strong>Pushes</strong> migration directories to Atlas Cloud's Schema Registry when changes merge to main, and</li>
<li class=""><strong>Applies</strong> pending migrations to your target database with the connection string from your pipeline variables.</li>
</ol>
<p>For more information on how to set up Atlas with Azure DevOps, see the
<a class="" href="https://atlasgo.io/guides/ci-platforms/azure-devops-repos">Azure DevOps Repos CI/CD Integration</a> guide.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="change-in-v038-atlas-migrate-lint">Change in v0.38: <code>atlas migrate lint</code><a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#change-in-v038-atlas-migrate-lint" class="hash-link" aria-label="Direct link to change-in-v038-atlas-migrate-lint" title="Direct link to change-in-v038-atlas-migrate-lint" translate="no">​</a></h2>
<p>As <a class="" href="https://atlasgo.io/blog/2025/09/17/v037-databricks-clickhouse-and-migration-rules#deprecate-lint">announced in v0.37</a>, starting with <strong>v0.38</strong>, the, the <code>atlas migrate lint</code> command will no longer be included in
the Starter (free) plan of Atlas.
The code remains open-source (Apache 2 license) and available in Atlas Community Edition. If you need the command without
using Atlas Pro, you can still build Atlas from source or use the community binary.</p>
<p>We want to be transparent about this change. Over time, <code>migrate lint</code> was split between the Starter and Pro plans,
creating extra maintenance overhead. At the same time, the shift toward AI-driven schema changes highlights the need for
stronger, deterministic guardrails. To focus on that, we're keeping the existing lint engine in the Community build while
rewriting the new engine with advanced checks and governance features, included in the official binary and available only
in Atlas Pro.</p>
<p>This reduces complexity in the official binary and lets us focus on advancing Atlas in the areas teams and AI systems
rely on most. Users of the free version can still run linting through Atlas Community, while Pro users remain unaffected.</p>
<h2 class="anchor anchorTargetStickyNavbar_SAay" id="wrapping-up">Wrapping Up<a href="https://atlasgo.io/blog/2025/10/28/v038-analyzers-pii-and-migration-hooks#wrapping-up" class="hash-link" aria-label="Direct link to Wrapping Up" title="Direct link to Wrapping Up" translate="no">​</a></h2>
<p>Atlas v0.38 adds support for additional database-specific features and introduces several security and workflow improvements.</p>
<p>This release expands database platform coverage with Oracle triggers and views, Google Spanner geo-partitioning placements and
locality groups, and stages, external tables, hybrid tables, and dynamic tables for Snowflake.</p>
<p>New security analyzers detect SQL injection patterns and transaction issues in migration files. HTTP data sources allow dynamic
configuration from external APIs, while PII detection helps with data governance.</p>
<p>Additional features include pre- and post-migration hooks, schema monitoring capabilities, and Azure DevOps integration with
a marketplace extension.</p>
<p>We hope you enjoy these new features and improvements. As always, we would love to hear your feedback and suggestions
on our <a href="https://discord.com/invite/zZ6sWVg6NT" target="_blank" rel="noopener noreferrer" class="">Discord server</a>.</p>]]></content>
        <author>
            <name>Noa Rogoszinski</name>
        </author>
        <category label="oracle" term="oracle"/>
        <category label="google spanner" term="google spanner"/>
        <category label="snowflake" term="snowflake"/>
        <category label="analyzer" term="analyzer"/>
        <category label="data source" term="data source"/>
        <category label="http" term="http"/>
        <category label="pii" term="pii"/>
        <category label="migration hooks" term="migration hooks"/>
        <category label="schema monitoring" term="schema monitoring"/>
        <category label="azure devops" term="azure devops"/>
    </entry>
</feed>