run-cache 2.2.2__tar.gz → 2.3.1__tar.gz

{run_cache-2.2.2 → run_cache-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: run-cache
-Version: 2.2.2
+Version: 2.3.1
 Summary: dbt plugin that skips redundant model executions by caching results from previous runs
 Project-URL: Homepage, https://runcache.com
 License: Copyright (c) 2026 Fivetran, Inc.
@@ -46,8 +46,8 @@ Requires-Dist: humanize
 Requires-Dist: protobuf>=4.0.0
 Requires-Dist: pyperclip
 Requires-Dist: pytimeparse2
-Requires-Dist: query-cache-common==1.4.0
-Requires-Dist: query-cache-protobuf==1.3.0
+Requires-Dist: query-cache-common==1.5.0
+Requires-Dist: query-cache-protobuf==1.4.0
 Requires-Dist: rich
 Requires-Dist: ruamel-yaml
 Requires-Dist: sqlglot>=27.6.1

run_cache-2.3.1/src/dbt_run_cache/_version.py

@@ -0,0 +1 @@
+__version__ = "2.3.1"

{run_cache-2.2.2 → run_cache-2.3.1}/src/dbt_run_cache/adapters/base.py

@@ -53,6 +53,12 @@ class BaseAdapterExtension(abc.ABC):
     SYSTEM_METADATA_SCHEMAS: t.List[str] = ["information_schema"]
     """Schemas that should not have their last modified / view definition tracked"""
 
+    CLONE_CHAIN_DEPTH_LIMIT: t.Optional[int] = None
+    """How many clones of clones can be created before the database throws a "Cannot have more than N chained clones"-style error.
+    0 = cloning effectively disabled
+    None = no limit imposed
+    """
+
     _CONNECTION_BARRIER_TIMEOUT_SECONDS: float = 2.0
 
     def __init__(

{run_cache-2.2.2 → run_cache-2.3.1}/src/dbt_run_cache/adapters/bigquery.py

@@ -17,6 +17,7 @@ if t.TYPE_CHECKING:
 
 class BigQueryAdapterExtension(BaseAdapterExtension):
     REQUIRES_NAMED_CONNECTION = False
+    CLONE_CHAIN_DEPTH_LIMIT = 3
 
     def __init__(self, *args: t.Any, **kwargs: t.Any) -> None:
         super().__init__(*args, **kwargs)

{run_cache-2.2.2 → run_cache-2.3.1}/src/dbt_run_cache/adapters/databricks.py

@@ -33,6 +33,8 @@ def contains_unqualified_table_references(query: exp.Expr) -> bool:
 
 
 class DatabricksAdapterExtension(BaseAdapterExtension):
+    CLONE_CHAIN_DEPTH_LIMIT = 1
+
     def _fetch_last_modified_epochs(
         self, table_batch: t.Collection[exp.Table]
     ) -> t.Dict[str, t.Optional[int]]:

{run_cache-2.2.2 → run_cache-2.3.1}/src/dbt_run_cache/grpc/client.py

@@ -262,15 +262,15 @@ class QueryCacheGrpcClient:
     def register_clone(
         self, request: clone_service_models.CloneRequest
     ) -> t.Union[
-        clone_service_models.ReadyToCloneResponse, clone_service_models.UntrackableCloneResponse
+        clone_service_models.ReadyToCloneResponse, clone_service_models.UnableToCloneResponse
     ]:
-        """Register a clone table request.
+        """Attempts to register a clone table request.
 
         Args:
             request: CloneRequest with clone details
 
         Returns:
-            Either ReadyToCloneResponse or UntrackableCloneResponse
+            Either ReadyToCloneResponse or UnableToCloneResponse
 
         Raises:
             grpc.RpcError: If the RPC fails
@@ -282,15 +282,14 @@ class QueryCacheGrpcClient:
         # Can remove has field check once old services are deprecated
         if response.HasField("ready_to_clone"):
             return clone_service_models.ReadyToCloneResponse.from_proto(response.ready_to_clone)
+        if response.HasField("unable_to_clone"):
+            return clone_service_models.UnableToCloneResponse.from_proto(response.unable_to_clone)
 
         # Extract the actual response from the oneof wrapper
         which = response.WhichOneof("response")
         if which == "ready_to_clone_v1":
             return clone_service_models.ReadyToCloneResponse.from_proto(response.ready_to_clone_v1)
-        if which == "untrackable_clone":
-            return clone_service_models.UntrackableCloneResponse.from_proto(
-                response.untrackable_clone
-            )
+
         raise ValueError(f"Unexpected response type: {which}")
 
     def confirm_execution(self, request: execution_service_models.ConfirmExecutionRequest) -> None:

{run_cache-2.2.2 → run_cache-2.3.1}/src/dbt_run_cache/run_cache.py

@@ -698,6 +698,14 @@ class RunCache:
         clone_response = self._submit_clone_request(node)
         if clone_response is None:
             return False
+
+        if isinstance(clone_response, clone_service_models.UnableToCloneResponse):
+            clone_rejection_reason = clone_response.explained_decision.clone_rejection_reason
+            events.fire_debug_event(
+                f"Unable to clone {clone_response.clone_source}: {clone_rejection_reason}"
+            )
+            return False
+
         self._dev_cloner.clone(
             self._adapter,
             node,
@@ -844,6 +852,7 @@ class RunCache:
             labels=self._get_request_labels(node),
             clone_time_travel_limit=self._clone_time_travel_limit,
             clone_table_properties=self._get_table_properties(node),
+            clone_chain_depth_limit=self.clone_chain_depth_limit,
         )
 
     def _emit_enriched_sql_prepared_telemetry(
@@ -917,7 +926,7 @@ class RunCache:
         self, node: ModelOrSnapshotNode
     ) -> t.Optional[
         t.Union[
-            clone_service_models.ReadyToCloneResponse, clone_service_models.UntrackableCloneResponse
+            clone_service_models.ReadyToCloneResponse, clone_service_models.UnableToCloneResponse
         ]
     ]:
         assert self._dev_cloner is not None
@@ -977,6 +986,7 @@ class RunCache:
                 labels=self._get_request_labels(node),
                 clone_time_travel_limit=self._clone_time_travel_limit,
                 clone_table_properties=self._get_table_properties(node),
+                clone_chain_depth_limit=self.clone_chain_depth_limit,
             ), EnrichmentTimings(last_modified_duration_ms=last_modified_duration_ms)
 
         view_traversal_start = perf_counter()
@@ -1035,6 +1045,7 @@ class RunCache:
             labels=self._get_request_labels(node),
             clone_time_travel_limit=self._clone_time_travel_limit,
             clone_table_properties=self._get_table_properties(node),
+            clone_chain_depth_limit=self.clone_chain_depth_limit,
         ), EnrichmentTimings(
             view_traversal_duration_ms=view_traversal_duration_ms,
             last_modified_duration_ms=last_modified_duration_ms,
@@ -1059,6 +1070,7 @@ class RunCache:
             labels=self._get_request_labels(node),
             clone_source_table_type=clone_source_table_type,
             table_properties=self._get_table_properties(node),
+            clone_chain_depth_limit=self.clone_chain_depth_limit,
         )
 
     @staticmethod
@@ -1234,6 +1246,17 @@ class RunCache:
     def total_time_saved_ms(self) -> int:
         return self._total_time_saved_ms
 
+    @property
+    def clone_chain_depth_limit(self) -> t.Optional[int]:
+        default_limit = self._adapter_ext.CLONE_CHAIN_DEPTH_LIMIT
+
+        # in prod, we set 1 less than the actual limit (which may force an execute instead of a clone)
+        # this ensures that there is always at least 1 more clone left for a dev clone
+        if self._defer_enabled and self._profiles.is_defer_to_profile and default_limit is not None:
+            return max(default_limit - 1, 0)
+
+        return default_limit
+
 
 class _DataTestAdapterProxy:
     def __init__(

run_cache-2.2.2/src/dbt_run_cache/_version.py

@@ -1 +0,0 @@
-__version__ = "2.2.2"