sqlbuild 0.52.0__tar.gz → 0.53.0__tar.gz

sqlbuild-0.53.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.53.0"
+}

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.53.0](https://github.com/chio-labs/sqlbuild/compare/v0.52.0...v0.53.0) (2026-08-22)
+
+
+### Features
+
+* **incremental:** guard selective merge state ([#315](https://github.com/chio-labs/sqlbuild/issues/315)) ([9126551](https://github.com/chio-labs/sqlbuild/commit/9126551293221d88b290c9dfc46f9e46aac573b2))
+
 ## [0.52.0](https://github.com/chio-labs/sqlbuild/compare/v0.51.0...v0.52.0) (2026-08-21)
 
 

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sqlbuild
-Version: 0.52.0
+Version: 0.53.0
 Summary: Typed, test-first SQL pipelines with local E2E testing
 License-File: LICENSE
 Requires-Python: >=3.12

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sqlbuild"
-version = "0.52.0"
+version = "0.53.0"
 description = "Typed, test-first SQL pipelines with local E2E testing"
 readme = "README.md"
 requires-python = ">=3.12"

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/.agents/skills/sqlbuild/SKILL.md

@@ -1204,6 +1204,9 @@ Most keys are overridden by the more specific layer, but three merge instead:
 - `row_diff_exclude_columns` lists are unioned across layers.
 - `row_diff_tolerances` mappings are deep-merged across layers, so a header tolerance for one column adds to (rather than replaces) tolerances declared in defaults or path defaults.
 
+Other lists, including `merge_exclude_columns`, use normal override behavior: a more specific
+path default or `MODEL()` header replaces the complete list from the earlier layer.
+
 ### Settings
 
 Global feature toggles:
@@ -2756,6 +2759,8 @@ Validation runs only when every broader knob allows it: `sql_analysis` must be o
 | `cursor_start` | Lower bound floor for the cursor |
 | `cursor_inputs` | Map of upstream ref/source names to their cursor columns |
 | `unique_key` | Column(s) used for merge and delete_insert matching |
+| `merge_exclude_columns` | Columns omitted from matched-row updates for `merge`; new rows still insert every column |
+| `allow_full_refresh` | Set to `false` to reject `--full-refresh` before model execution |
 | `incremental_mode` | Set to `microbatch` to enable batched execution |
 | `batch_size` | Batch window size (e.g. `1d`, `1h`, or an integer) |
 | `lookback` | Extend the replay window backwards to re-process recent data |
@@ -3464,6 +3469,8 @@ MODEL (
   materialized incremental,
   incremental_strategy merge,
   unique_key [customer_id],
+  merge_exclude_columns [ingested_at],
+  allow_full_refresh false,
   cursor last_ordered_at,
   cursor_type timestamp,
   cursor_grain second,
@@ -3483,6 +3490,25 @@ GROUP BY customer_id
 
 `merge` always requires `unique_key`. The cursor controls which upstream rows are scanned; the unique key determines how they're matched against the target.
 
+`merge_exclude_columns` removes columns only from the matched-row `UPDATE` set. Every source
+column remains in the unmatched-row `INSERT`, so an immutable creation timestamp can be retained
+for existing keys and populated for new keys. Exclusions are matched case-insensitively, cannot
+duplicate or overlap `unique_key`, and must name declared columns when `contract enforced` is used.
+
+New columns admitted by `on_schema_change append_new_columns` or `sync_all_columns` are updated by
+default. Add a new column to `merge_exclude_columns` only when its target value must remain
+immutable after first insertion. Changing the list changes model version identity and may trigger
+the model's configured `replay_on_change` behavior, but it does not rewrite values already stored
+in the target.
+
+Set `allow_full_refresh false` when the incremental target cannot be reconstructed from its current
+inputs. Both `sqb plan --full-refresh` and `sqb build --full-refresh` fail and name all selected
+protected models before model execution. Omitted or `true` preserves normal full-refresh behavior.
+
+These controls still implement a Type 1 upsert: each unique key has one current row. Preserving an
+immutable column does not create row versions and is not SCD Type 2 history; use a snapshot or an
+immutable archival model when historical states are required.
+
 ### Cursors
 
 Cursors define the incremental replay boundary. SQLBuild queries `MAX(cursor)` from the target table and `MIN/MAX` from upstream inputs to compute the replay window automatically.

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapter/contract/classes/base_adapter.py

@@ -632,7 +632,11 @@ class BaseAdapter(StrictAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -640,7 +644,7 @@ class BaseAdapter(StrictAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(
@@ -1363,6 +1367,7 @@ class BaseAdapter(StrictAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         raise AdapterUserError(message="merge requires an engine-specific implementation")
 

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapter/contract/classes/duckdb_backed_adapter.py

@@ -1800,11 +1800,16 @@ class DuckDbBackedAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
         statements: tuple[str, ...] = self.render_merge(
-            destination=destination, sql=sql, unique_key=keys, source_columns=source_columns
+            destination=destination,
+            sql=sql,
+            unique_key=keys,
+            source_columns=source_columns,
+            exclude_columns=exclude_columns,
         )
         statement_recorder.record_many(statements)
         affected: int | None = None
@@ -1821,7 +1826,11 @@ class DuckDbBackedAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -1829,7 +1838,7 @@ class DuckDbBackedAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapter/contract/classes/materialization.py

@@ -183,6 +183,7 @@ class MaterializationMixin(ABC):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         """Upsert rows from a SELECT statement using MERGE or equivalent."""
         ...

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapter/contract/classes/strict_adapter.py

@@ -397,6 +397,7 @@ class StrictAdapter(
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
         """Render SQL statements that merge query rows into a destination."""
         ...

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapters/bigquery/classes/bigquery_adapter.py

@@ -700,7 +700,11 @@ class BigQueryAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -708,7 +712,7 @@ class BigQueryAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(
@@ -2045,11 +2049,16 @@ class BigQueryAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
         statements: tuple[str, ...] = self.render_merge(
-            destination=destination, sql=sql, unique_key=keys, source_columns=source_columns
+            destination=destination,
+            sql=sql,
+            unique_key=keys,
+            source_columns=source_columns,
+            exclude_columns=exclude_columns,
         )
         statement_recorder.record_many(statements)
         affected: int | None = None

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapters/databricks/classes/databricks_adapter.py

@@ -1717,7 +1717,11 @@ class DatabricksAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(key)} = __source.{self.render_identifier(key)}"
             for key in unique_key
@@ -1725,7 +1729,7 @@ class DatabricksAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(column)} = __source.{self.render_identifier(column)}"
             for column in source_columns
-            if column not in unique_key
+            if column.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(column) for column in source_columns)
         insert_values: str = ", ".join(
@@ -2032,11 +2036,16 @@ class DatabricksAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
         statements: tuple[str, ...] = self.render_merge(
-            destination=destination, sql=sql, unique_key=keys, source_columns=source_columns
+            destination=destination,
+            sql=sql,
+            unique_key=keys,
+            source_columns=source_columns,
+            exclude_columns=exclude_columns,
         )
         statement_recorder.record_many(statements)
         affected: int | None = None

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapters/postgres/classes/postgres_adapter.py

@@ -595,7 +595,11 @@ class PostgresAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -603,7 +607,7 @@ class PostgresAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(
@@ -1839,20 +1843,26 @@ class PostgresAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
-        non_key_columns: tuple[str, ...] = tuple(col for col in source_columns if col not in keys)
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*keys, *exclude_columns)
+        )
+        update_columns: tuple[str, ...] = tuple(
+            col for col in source_columns if col.lower() not in immutable_columns
+        )
         col_list: str = ", ".join(self.render_identifier(column) for column in source_columns)
         key_match_sql: str = " AND ".join(
             f"__target.{self.render_identifier(key)} = __source.{self.render_identifier(key)}"
             for key in keys
         )
         source_select_sql: str = f"({sql}) AS __source"
-        if non_key_columns:
+        if update_columns:
             update_set: str = ", ".join(
                 f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
-                for col in non_key_columns
+                for col in update_columns
             )
             update_sql: str = (
                 f"UPDATE {destination} AS __target SET {update_set} "

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapters/snowflake/classes/snowflake_adapter.py

@@ -560,7 +560,11 @@ class SnowflakeAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -568,7 +572,7 @@ class SnowflakeAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(
@@ -2001,11 +2005,16 @@ class SnowflakeAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
         statements: tuple[str, ...] = self.render_merge(
-            destination=destination, sql=sql, unique_key=keys, source_columns=source_columns
+            destination=destination,
+            sql=sql,
+            unique_key=keys,
+            source_columns=source_columns,
+            exclude_columns=exclude_columns,
         )
         statement_recorder.record_many(statements)
         affected: int | None = None

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/adapters/sqlserver/classes/sqlserver_adapter.py

@@ -781,18 +781,24 @@ class SqlServerAdapter(BaseAdapter):
         sql: str,
         unique_key: str | tuple[str, ...],
         statement_recorder: StatementRecorder,
+        exclude_columns: tuple[str, ...] = (),
     ) -> int | None:
         keys: tuple[str, ...] = (unique_key,) if isinstance(unique_key, str) else unique_key
         source_columns: tuple[str, ...] = self.query_column_names(connection=connection, sql=sql)
-        non_key_columns: tuple[str, ...] = tuple(col for col in source_columns if col not in keys)
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*keys, *exclude_columns)
+        )
+        update_columns: tuple[str, ...] = tuple(
+            col for col in source_columns if col.lower() not in immutable_columns
+        )
         key_match_sql: str = " AND ".join(
             f"__target.{self.render_identifier(key)} = __source.{self.render_identifier(key)}"
             for key in keys
         )
-        if non_key_columns:
+        if update_columns:
             update_set: str = ", ".join(
                 f"__target.{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
-                for col in non_key_columns
+                for col in update_columns
             )
             update_sql: str = (
                 f"UPDATE __target SET {update_set} FROM {destination} AS __target "
@@ -2213,7 +2219,11 @@ class SqlServerAdapter(BaseAdapter):
         sql: str,
         unique_key: tuple[str, ...],
         source_columns: tuple[str, ...] = (),
+        exclude_columns: tuple[str, ...] = (),
     ) -> tuple[str, ...]:
+        immutable_columns: frozenset[str] = frozenset(
+            column.lower() for column in (*unique_key, *exclude_columns)
+        )
         join_condition: str = " AND ".join(
             f"__target.{self.render_identifier(k)} = __source.{self.render_identifier(k)}"
             for k in unique_key
@@ -2221,7 +2231,7 @@ class SqlServerAdapter(BaseAdapter):
         update_assignments: str = ", ".join(
             f"{self.render_identifier(col)} = __source.{self.render_identifier(col)}"
             for col in source_columns
-            if col not in unique_key
+            if col.lower() not in immutable_columns
         )
         insert_columns: str = ", ".join(self.render_identifier(col) for col in source_columns)
         insert_values: str = ", ".join(

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/cli/commands/_helpers/build_planning/full_refresh.py

@@ -1,4 +1,4 @@
-"""Snapshot full-refresh safety enforcement for build commands."""
+"""Full-refresh safety enforcement for build commands."""
 
 from __future__ import annotations
 
@@ -28,7 +28,9 @@ def enforce_snapshot_full_refresh_policy(
     input_stream: TextIO,
     output_stream: TextIO,
 ) -> None:
-    """Fail or confirm before executing snapshot full-refresh entries."""
+    """Fail or confirm before executing protected full-refresh entries."""
+
+    enforce_model_full_refresh_policy(plan=plan)
 
     snapshot_entries: tuple[ModelPlanEntry, ...] = tuple(
         entry
@@ -78,6 +80,28 @@ def enforce_snapshot_full_refresh_policy(
         raise CliUserError("snapshot full refresh cancelled", code="C240")
 
 
+def enforce_model_full_refresh_policy(*, plan: PlanOutput) -> None:
+    """Reject destructive rebuilds for models that explicitly forbid them."""
+
+    protected_entries: tuple[ModelPlanEntry, ...] = tuple(
+        sorted(
+            (
+                entry
+                for entry in plan.model_entries
+                if entry.reason == PlanReason.FULL_REFRESH and entry.allow_full_refresh is False
+            ),
+            key=lambda entry: entry.name,
+        )
+    )
+    if protected_entries:
+        names: str = _model_names(protected_entries)
+        raise CliUserError(
+            f"full refresh is denied for model {names} by allow_full_refresh=false",
+            code="C265",
+            help="Set allow_full_refresh=true only for models that are safe to fully rebuild.",
+        )
+
+
 def _effective_policy(
     *, entry: ModelPlanEntry, snapshots_config: SnapshotsConfig
 ) -> SnapshotFullRefreshPolicy:

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/cli/commands/_helpers/plan/planning.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from io import StringIO
 
 from sqlbuild.cli.commands._helpers.build_planning.full_refresh import (
+    enforce_model_full_refresh_policy,
     enforce_snapshot_full_refresh_policy,
 )
 from sqlbuild.cli.commands._helpers.planning.external_refs import (
@@ -77,7 +78,7 @@ def compile_plan_pipeline(
             output_stream=StringIO(),
         )
         return virtual_result
-    return run_compile_pipeline(
+    result: CompilePipelineResult = run_compile_pipeline(
         discovered_inputs=invocation.discovered_inputs,
         adapter=invocation.adapter,
         options=CompilePipelineOptions(
@@ -110,3 +111,5 @@ def compile_plan_pipeline(
             ),
         ),
     )
+    enforce_model_full_refresh_policy(plan=result.plan_output)
+    return result

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/compiler/compile/_helpers/attachment/core.py

@@ -1382,6 +1382,10 @@ def project_defaults_to_mapping(defaults: DefaultsConfig) -> dict[str, object]:
         values["incremental_strategy"] = defaults.incremental_strategy
     if defaults.incremental_mode is not None:
         values["incremental_mode"] = defaults.incremental_mode
+    if defaults.merge_exclude_columns:
+        values["merge_exclude_columns"] = defaults.merge_exclude_columns
+    if defaults.allow_full_refresh is not None:
+        values["allow_full_refresh"] = defaults.allow_full_refresh
     if defaults.append_cursor_inclusive is not None:
         values["append_cursor_inclusive"] = defaults.append_cursor_inclusive
     if defaults.cursor_start is not None:

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/compiler/compile/_helpers/config/model_validation.py

@@ -48,6 +48,8 @@ _INCREMENTAL_ONLY_KEYS: tuple[str, ...] = (
     "on_schema_change",
     "replay_on_change",
     "append_cursor_inclusive",
+    "merge_exclude_columns",
+    "allow_full_refresh",
 )
 _SNAPSHOT_DISALLOWED_KEYS: tuple[str, ...] = (
     "incremental_strategy",
@@ -101,6 +103,8 @@ def validate_incremental_config(
     cursor_inputs: object | None = config.values.get("cursor_inputs")
     cursor_grain: str | None = _str(config=config, key="cursor_grain")
     replay_on_change: object | None = config.values.get("replay_on_change")
+    merge_exclude_columns: object | None = config.values.get("merge_exclude_columns")
+    allow_full_refresh: object | None = config.values.get("allow_full_refresh")
     if replay_on_change is not None and not isinstance(replay_on_change, str):
         raise CompileInputError(f"model '{model_name}': replay_on_change must be a string")
     if strategy is None:
@@ -146,6 +150,33 @@ def validate_incremental_config(
         )
     if strategy == IncrementalStrategy.MERGE and not has_unique_key:
         raise CompileInputError(f"model '{model_name}': merge strategy requires unique_key")
+    if merge_exclude_columns is not None:
+        excluded_columns: tuple[str, ...] = _validated_string_sequence(
+            value=merge_exclude_columns,
+            config_key="merge_exclude_columns",
+            model_name=model_name,
+        )
+        if strategy != IncrementalStrategy.MERGE:
+            raise CompileInputError(
+                f"model '{model_name}': merge_exclude_columns requires incremental_strategy=merge"
+            )
+        if len({column.lower() for column in excluded_columns}) != len(excluded_columns):
+            raise CompileInputError(
+                f"model '{model_name}': merge_exclude_columns contains duplicate columns"
+            )
+        unique_key_columns: frozenset[str] = frozenset(
+            column.lower() for column in _string_sequence(unique_key)
+        )
+        overlap: tuple[str, ...] = tuple(
+            column for column in excluded_columns if column.lower() in unique_key_columns
+        )
+        if overlap:
+            raise CompileInputError(
+                f"model '{model_name}': merge_exclude_columns cannot include unique_key "
+                f"column(s): {', '.join(overlap)}"
+            )
+    if allow_full_refresh is not None and not isinstance(allow_full_refresh, bool):
+        raise CompileInputError(f"model '{model_name}': allow_full_refresh must be a boolean")
 
     declared_column_names: frozenset[str] | None = _contract_declared_column_names(config)
     if declared_column_names is not None:
@@ -162,6 +193,12 @@ def validate_incremental_config(
             declared_column_names=declared_column_names,
             model_name=model_name,
         )
+        _validate_declared_config_columns(
+            column_names=_string_sequence(merge_exclude_columns),
+            config_key="merge_exclude_columns",
+            declared_column_names=declared_column_names,
+            model_name=model_name,
+        )
 
     if lookback is not None and cursor is None:
         raise CompileInputError(
@@ -541,11 +578,23 @@ def _contract_declared_column_names(config: CompileModelConfig) -> frozenset[str
 def _string_sequence(value: object | None) -> tuple[str, ...]:
     if isinstance(value, str):
         return (value,)
-    if isinstance(value, list):
+    if isinstance(value, list | tuple):
         return tuple(item for item in value if isinstance(item, str))
     return ()
 
 
+def _validated_string_sequence(
+    *, value: object, config_key: str, model_name: str
+) -> tuple[str, ...]:
+    if not isinstance(value, list | tuple) or not all(
+        isinstance(item, str) and item for item in value
+    ):
+        raise CompileInputError(
+            f"model '{model_name}': {config_key} must be a list of non-empty strings"
+        )
+    return tuple(item for item in value if isinstance(item, str))
+
+
 def _validate_declared_config_columns(
     *,
     column_names: tuple[str, ...],

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/compiler/discovery/_helpers/yml/project.py

@@ -373,6 +373,13 @@ def _load_defaults(*, payload: object, file_path: Path) -> DefaultsConfig:
             file_path=file_path,
         )
     )
+    merge_exclude_columns: tuple[str, ...] = tuple(
+        _load_string_sequence(
+            payload=mapping.get("merge_exclude_columns"),
+            label="defaults.merge_exclude_columns",
+            file_path=file_path,
+        )
+    )
     tags: tuple[str, ...] = tuple(
         _load_string_sequence(
             payload=mapping.get("tags"),
@@ -391,6 +398,8 @@ def _load_defaults(*, payload: object, file_path: Path) -> DefaultsConfig:
         contract=_optional_contract_policy(mapping=mapping, key="contract"),
         incremental_strategy=_optional_str(payload=mapping, key="incremental_strategy"),
         incremental_mode=_optional_str(payload=mapping, key="incremental_mode"),
+        merge_exclude_columns=merge_exclude_columns,
+        allow_full_refresh=_optional_nullable_bool(mapping=mapping, key="allow_full_refresh"),
         append_cursor_inclusive=_optional_templated_bool(
             mapping=mapping,
             key="append_cursor_inclusive",

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/compiler/manifest/_helpers/shared.py

@@ -92,12 +92,13 @@ def build_config_dict(values: dict[str, object]) -> dict[str, object]:
         "group": None,
         "materialized": str(materialized) if materialized is not None else "view",
         "incremental_strategy": values.get("incremental_strategy"),
+        "merge_exclude_columns": values.get("merge_exclude_columns"),
         "persist_docs": {},
         "post-hook": [],
         "pre-hook": [],
         "quoting": {},
         "column_types": {},
-        "full_refresh": None,
+        "full_refresh": values.get("allow_full_refresh"),
         "unique_key": values.get("unique_key"),
         "on_schema_change": values.get("on_schema_change", "ignore"),
         "on_configuration_change": "apply",

{sqlbuild-0.52.0 → sqlbuild-0.53.0}/src/sqlbuild/compiler/planner/_helpers/output/plan_entry.py

@@ -473,6 +473,7 @@ def plan_model_from_change(
         resolved_sql=resolved_sql,
         destination=model.destination,
         unique_key=unique_key,
+        merge_exclude_columns=_get_config_string_tuple(model=model, key="merge_exclude_columns"),
         warehouse_columns=warehouse_columns,
         cursor_column=cursor_column,
         cursor_bounds=ddl_cursor_bounds,
@@ -503,6 +504,8 @@ def plan_model_from_change(
         start_cursor_override=start_cursor_override,
         end_cursor_override=end_cursor_override,
         unique_key=unique_key,
+        merge_exclude_columns=_get_config_string_tuple(model=model, key="merge_exclude_columns"),
+        allow_full_refresh=_get_config_optional_bool(model=model, key="allow_full_refresh"),
         snapshot_strategy=snapshot_strategy,
         updated_at_column=updated_at_column,
         check_columns=check_columns,
@@ -717,6 +720,18 @@ def _get_unique_key(model: CompiledModel) -> tuple[str, ...]:
     return ()
 
 
+def _get_config_string_tuple(*, model: CompiledModel, key: str) -> tuple[str, ...]:
+    raw: object | None = model.config.values.get(key)
+    if isinstance(raw, list | tuple):
+        return tuple(value for value in raw if isinstance(value, str))
+    return ()
+
+
+def _get_config_optional_bool(*, model: CompiledModel, key: str) -> bool | None:
+    raw: object | None = model.config.values.get(key)
+    return raw if isinstance(raw, bool) else None
+
+
 def _get_check_columns(model: CompiledModel) -> tuple[str, ...]:
     """Extract check_columns from model config as a normalized tuple."""
 
@@ -850,6 +865,7 @@ def _build_logical_ddl_from_adapter(
     resolved_sql: str,
     destination: CompiledRelationLocation,
     unique_key: tuple[str, ...],
+    merge_exclude_columns: tuple[str, ...],
     warehouse_columns: tuple[ColumnInfo, ...],
     cursor_column: str | None = None,
     cursor_bounds: CursorBounds | None = None,
@@ -900,6 +916,7 @@ def _build_logical_ddl_from_adapter(
                 sql=resolved_sql,
                 unique_key=unique_key,
                 source_columns=source_columns,
+                exclude_columns=merge_exclude_columns,
             )
         )