dbt-adapters 1.16.6__tar.gz → 1.17.0__tar.gz

dbt_adapters-1.17.0/.changes/1.17.0.md

@@ -0,0 +1,13 @@
+## dbt-adapters 1.17.0 - September 29, 2025
+
+### Features
+
+- Initial framework for UDF support ([#1268](https://github.com/dbt-labs/dbt-adapters/issues/1268))
+
+### Fixes
+
+- Fix duplicates when hard_deletes new_record is used with custom dbt_valid_to_current ([#1240](https://github.com/dbt-labs/dbt-adapters/issues/1240))
+- Update function related global macros to use `default__` naming scheme ([#1356](https://github.com/dbt-labs/dbt-adapters/issues/1356))
+
+### Contributors
+- [@jeremyyeo](https://github.com/jeremyyeo) ([#1240](https://github.com/dbt-labs/dbt-adapters/issues/1240))

{dbt_adapters-1.16.6 → dbt_adapters-1.17.0}/CHANGELOG.md

@@ -10,6 +10,21 @@ and is generated by [Changie](https://github.com/miniscruff/changie)
 - Do not edit this file directly. This file is auto-generated using [changie](https://github.com/miniscruff/changie)
 - For details on how to document a change, see the [contributing guide](/CONTRIBUTING.md#changelog-entry)
 
+## dbt-adapters 1.17.0 - September 29, 2025
+
+### Features
+
+- Initial framework for UDF support ([#1268](https://github.com/dbt-labs/dbt-adapters/issues/1268))
+
+### Fixes
+
+- Fix duplicates when hard_deletes new_record is used with custom dbt_valid_to_current ([#1240](https://github.com/dbt-labs/dbt-adapters/issues/1240))
+- Update function related global macros to use `default__` naming scheme ([#1356](https://github.com/dbt-labs/dbt-adapters/issues/1356))
+
+### Contributors
+- [@jeremyyeo](https://github.com/jeremyyeo) ([#1240](https://github.com/dbt-labs/dbt-adapters/issues/1240))
+
+
 ## dbt-adapters 1.16.6 - September 03, 2025
 
 ### Under the Hood
@@ -20,7 +35,6 @@ and is generated by [Changie](https://github.com/miniscruff/changie)
 ### Contributors
 - [@jasonlin45](https://github.com/jasonlin45) ([#1308](https://github.com/dbt-labs/dbt-adapters/issues/1308))
 
-
 ## dbt-adapters 1.16.5 - August 19, 2025
 
 ### Fixes

{dbt_adapters-1.16.6 → dbt_adapters-1.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbt-adapters
-Version: 1.16.6
+Version: 1.17.0
 Summary: The set of adapter protocols and base functionality that supports integration with dbt-core
 Project-URL: Homepage, https://github.com/dbt-labs/dbt-adapters/tree/main/dbt-adapters
 Project-URL: Documentation, https://docs.getdbt.com

dbt_adapters-1.17.0/src/dbt/adapters/__about__.py

@@ -0,0 +1 @@
+version = "1.17.0"

{dbt_adapters-1.16.6 → dbt_adapters-1.17.0}/src/dbt/adapters/base/relation.py

@@ -376,12 +376,17 @@ class BaseRelation(FakeAPIObject, Hashable):
         return hash(self.render())
 
     def __str__(self) -> str:
-        rendered = self.render() if self.limit is None else self.render_limited()
+        # TODO: This function seems to have more if's than it needs to. We should see if we can simplify it.
+        if self.is_function:
+            # If it's a function we skip all special rendering logic and just return the raw render
+            rendered = self.render()
+        else:
+            rendered = self.render() if self.limit is None else self.render_limited()
 
-        # Limited subquery is wrapped by the event time filter subquery, and not the other way around.
-        # This is because in the context of resolving limited refs, we care more about performance than reliably producing a sample of a certain size.
-        if self.event_time_filter:
-            rendered = self.render_event_time_filtered(rendered)
+            # Limited subquery is wrapped by the event time filter subquery, and not the other way around.
+            # This is because in the context of resolving limited refs, we care more about performance than reliably producing a sample of a certain size.
+            if self.event_time_filter:
+                rendered = self.render_event_time_filtered(rendered)
 
         return rendered
 
@@ -426,6 +431,10 @@ class BaseRelation(FakeAPIObject, Hashable):
     def is_pointer(self) -> bool:
         return self.type == RelationType.PointerTable
 
+    @property
+    def is_function(self) -> bool:
+        return self.type == RelationType.Function
+
     @classproperty
     def Table(cls) -> str:
         return str(RelationType.Table)
@@ -450,6 +459,10 @@ class BaseRelation(FakeAPIObject, Hashable):
     def PointerTable(cls) -> str:
         return str(RelationType.PointerTable)
 
+    @classproperty
+    def Function(cls) -> str:
+        return str(RelationType.Function)
+
     @classproperty
     def get_relation_type(cls) -> Type[RelationType]:
         return RelationType

{dbt_adapters-1.16.6 → dbt_adapters-1.17.0}/src/dbt/adapters/contracts/relation.py

@@ -22,6 +22,7 @@ class RelationType(StrEnum):
     # this is a "catch all" that is better than `None` == external to anything dbt is aware of
     External = "external"
     PointerTable = "pointer_table"
+    Function = "function"
 
 
 class MaterializationContract(Protocol):

dbt_adapters-1.17.0/src/dbt/include/global_project/macros/materializations/functions/function.sql

@@ -0,0 +1,16 @@
+{% materialization function, default %}
+    {% set existing_relation = load_cached_relation(this) %}
+    {% set target_relation = this.incorporate(type=this.Function) %}
+
+    {{ run_hooks(pre_hooks) }}
+
+    {% set function_type_macro = get_function_macro('scalar', 'sql') %}
+    {% set build_sql = function_type_macro(target_relation) %}
+
+    {{ function_execute_build_sql(build_sql, existing_relation, target_relation) }}
+
+    {{ run_hooks(post_hooks) }}
+
+    {{ return({'relations': [target_relation]}) }}
+
+{% endmaterialization %}

dbt_adapters-1.17.0/src/dbt/include/global_project/macros/materializations/functions/helpers.sql

@@ -0,0 +1,34 @@
+{% macro function_execute_build_sql(build_sql, existing_relation, target_relation) %}
+    {{ return(adapter.dispatch('function_execute_build_sql', 'dbt')(build_sql, existing_relation, target_relation)) }}
+{% endmacro %}
+
+{% macro default__function_execute_build_sql(build_sql, existing_relation, target_relation) %}
+
+    {% set grant_config = config.get('grants') %}
+
+    {% call statement(name="main") %}
+        {{ build_sql }}
+    {% endcall %}
+
+    {% set should_revoke = should_revoke(existing_relation, full_refresh_mode=True) %}
+    {% do apply_grants(target_relation, grant_config, should_revoke=should_revoke) %}
+
+    {% do persist_docs(target_relation, model) %}
+
+    {{ adapter.commit() }}
+
+{% endmacro %}
+
+
+{% macro get_function_macro(function_type, function_language) %}
+    {{ return(adapter.dispatch('get_function_macro', 'dbt')(function_type, function_language)) }}
+{% endmacro %}
+
+{% macro default__get_function_macro(function_type, function_language) %}
+    {% set macro_name = function_type ~ "_function_" ~ function_language %}
+    {% if not macro_name in context %}
+        {{ exceptions.raise_not_implemented(function_language ~ ' ' ~ function_type ~ ' function not implemented for adapter ' ~adapter.type()) }}
+    {% endif %}
+    {% set macro = context[macro_name] %}
+    {{ return(macro) }}
+{% endmacro %}

dbt_adapters-1.17.0/src/dbt/include/global_project/macros/materializations/functions/scalar.sql

@@ -0,0 +1,38 @@
+{% macro scalar_function_sql(target_relation) %}
+    {{ return(adapter.dispatch('scalar_function_sql', 'dbt')(target_relation)) }}
+{% endmacro %}
+
+{% macro default__scalar_function_sql(target_relation) %}
+    {{ scalar_function_create_replace_signature_sql(target_relation) }}
+    {{ scalar_function_body_sql() }};
+{% endmacro %}
+
+{% macro scalar_function_create_replace_signature_sql(target_relation) %}
+    {{ return(adapter.dispatch('scalar_function_create_replace_signature_sql', 'dbt')(target_relation)) }}
+{% endmacro %}
+
+{% macro default__scalar_function_create_replace_signature_sql(target_relation) %}
+    CREATE OR REPLACE FUNCTION {{ target_relation.render() }} ({{ formatted_scalar_function_args_sql()}}) RETURNS {{ model.return_type.type }} AS
+{% endmacro %}
+
+{% macro formatted_scalar_function_args_sql() %}
+    {{ return(adapter.dispatch('formatted_scalar_function_args_sql', 'dbt')()) }}
+{% endmacro %}
+
+{% macro default__formatted_scalar_function_args_sql() %}
+    {% set args = [] %}
+    {% for arg in model.arguments -%}
+        {%- do args.append(arg.name ~ ' ' ~ arg.type) -%}
+    {%- endfor %}
+    {{ args | join(', ') }}
+{% endmacro %}
+
+{% macro scalar_function_body_sql() %}
+    {{ return(adapter.dispatch('scalar_function_body_sql', 'dbt')()) }}
+{% endmacro %}
+
+{% macro default__scalar_function_body_sql() %}
+    $$
+       {{ model.compiled_code }}
+    $$ LANGUAGE SQL;
+{% endmacro %}

{dbt_adapters-1.16.6 → dbt_adapters-1.17.0}/src/dbt/include/global_project/macros/materializations/snapshots/helpers.sql

@@ -158,7 +158,12 @@
             and not (
                 --avoid updating the record's valid_to if the latest entry is marked as deleted
                 snapshotted_data.{{ columns.dbt_is_deleted }} = 'True'
-                and snapshotted_data.{{ columns.dbt_valid_to }} is null
+                and
+                {% if config.get('dbt_valid_to_current') -%}
+                    snapshotted_data.{{ columns.dbt_valid_to }} = {{ config.get('dbt_valid_to_current') }}
+                {%- else -%}
+                    snapshotted_data.{{ columns.dbt_valid_to }} is null
+                {%- endif %}
             )
             {%- endif %}
     )
@@ -172,10 +177,10 @@
 
         select
             'insert' as dbt_change_type,
-            {#
+            {#/*
                 If a column has been added to the source it won't yet exist in the
                 snapshotted table so we insert a null value as a placeholder for the column.
-             #}
+             */#}
             {%- for col in source_sql_cols -%}
             {%- if col.name in snapshotted_cols -%}
             snapshotted_data.{{ adapter.quote(col.column) }},
@@ -202,7 +207,12 @@
         and not (
             --avoid inserting a new record if the latest one is marked as deleted
             snapshotted_data.{{ columns.dbt_is_deleted }} = 'True'
-            and snapshotted_data.{{ columns.dbt_valid_to }} is null
+            and
+            {% if config.get('dbt_valid_to_current') -%}
+                snapshotted_data.{{ columns.dbt_valid_to }} = {{ config.get('dbt_valid_to_current') }}
+            {%- else -%}
+                snapshotted_data.{{ columns.dbt_valid_to }} is null
+            {%- endif %}
             )
 
     )

dbt_adapters-1.16.6/src/dbt/adapters/__about__.py

@@ -1 +0,0 @@
-version = "1.16.6"