datazone-sdk 6.0.1.dev7__tar.gz → 6.0.1.dev9__tar.gz

{datazone_sdk-6.0.1.dev7 → datazone_sdk-6.0.1.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datazone-sdk
-Version: 6.0.1.dev7
+Version: 6.0.1.dev9
 Summary: Database and Delta storage client library for working with Delta Lake tables
 Author: Team Enigma
 Author-email: enigma@energinet.dk

{datazone_sdk-6.0.1.dev7 → datazone_sdk-6.0.1.dev9}/datazone/deltastorage/generated_columns.py

@@ -112,8 +112,9 @@ class DateBucket(GeneratedColumn):
             case (">" | ">="):
                 return [(">=", date_from_timestamp(value))]
             case "in":
-                dates = [date_from_timestamp(timestamp) for timestamp in value]
-                return [("in", list(dict.fromkeys(dates)))]
+                # de-duplicate: multiple timestamps can bucket to the same date
+                dates = {date_from_timestamp(timestamp) for timestamp in value}
+                return [("in", sorted(dates))]
             case _:
                 # for other operations, we cannot make any
                 # useful filters on the generated column

{datazone_sdk-6.0.1.dev7 → datazone_sdk-6.0.1.dev9}/datazone/deltastorage/table.py

@@ -10,6 +10,16 @@ from .slicing import HyperSlice
 
 
 def _sql_literal(value: Any) -> str:
+    """Render a Python value as a *type-correct* SQL literal for Delta predicates.
+
+    Earlier versions quoted every value as a string (``f"{col} {op} '{val}'"``),
+    which worked because the old delta-rs/datafusion implicitly cast the string
+    literal to the column type. The upgraded datafusion type-checks predicates
+    strictly and rejects comparing a non-string column to a string literal
+    (e.g. ``Timestamp(us, "UTC") <= Utf8View``). So numbers are left unquoted,
+    booleans become ``TRUE``/``FALSE`` and ``None`` becomes ``NULL``; only real
+    strings/dates are quoted (and escaped).
+    """
     if isinstance(value, dt.datetime):
         return f"'{value.isoformat()}'"
     if isinstance(value, dt.date):
@@ -25,7 +35,12 @@ def _sql_literal(value: Any) -> str:
 
 
 def _dnf_to_sql(dnf: list[tuple]) -> str:
-    """Convert DNF expression to SQL expression."""
+    """Convert a hyper slice (DNF expression) to a Delta predicate SQL string.
+
+    Needed because delta-rs overwrite/delete operations accept a SQL predicate
+    string, not the tuple filter format the SDK uses everywhere else. ``in`` is
+    expanded to ``OR`` of equalities since the predicate dialect has no ``IN``.
+    """
     if len(dnf) == 0:
         return "1=1"
 
@@ -46,11 +61,14 @@ def _dnf_to_sql(dnf: list[tuple]) -> str:
     return " AND ".join(sql_parts)
 
 
-def _empty_to_none(filters: list[tuple]) -> list[tuple] | None:
-    return filters if len(filters) > 0 else None
-
-
 def _filter_to_polars_expr(filter_: tuple) -> pl.Expr:
+    """Convert a single tuple filter to a Polars expression.
+
+    Needed so the SDK's ``(column, op, value)`` filters can be pushed down as
+    predicates to the native Polars Delta reader in ``Table.read``, instead of
+    PyArrow filters, whose compute kernels fail on delta-rs ``string_view``
+    columns (``ArrowNotImplementedError``).
+    """
     col, op, val = filter_
     if op == "=":
         return pl.col(col) == val
@@ -118,49 +136,52 @@ class Table:
     def read(
         self, hyper_slice: Optional[HyperSlice] = None, columns=None
     ) -> pl.DataFrame:
-        """Read from Delta table
+        """Read from Delta table.
+
+        All filters are pushed down to the native Delta reader. Partition
+        filters (including filters derived from generated partition columns)
+        result in partition pruning, while non-partition filters are pushed
+        down to the Parquet reader as predicates.
+
+        We use the native Polars Delta reader (`pl.scan_delta`) rather than
+        `DeltaTable.to_pyarrow_table(filters=...)` on purpose. The PyArrow
+        filter path evaluates predicates with PyArrow compute kernels, which
+        do not implement comparisons for the `string_view` type returned by
+        delta-rs. That mismatch raises errors such as
+        `ArrowNotImplementedError: Function 'greater_equal' has no kernel
+        matching input types (string_view, string_view)`. The native reader
+        evaluates predicates in its own engine and avoids this entirely.
 
         Args:
-            hyper_slice (HyperSlice): Hyper sliced used to filter data
+            hyper_slice (HyperSlice): Hyper slice used to filter data.
+            columns: Optional list of columns to project.
         """
         if hyper_slice is None:
             hyper_slice = []
 
-        # Generated filters are an optimization for partition pruning. Keep all
-        # partition filters out of row filters because partition values may be
-        # represented differently by PyArrow than by Delta's partition pruning.
-        partition_hyper_slice = self.schema().add_generated_filters(hyper_slice)
+        # Generated filters add predicates on generated partition columns
+        # (e.g. `date_utc` derived from `time_utc`) so the native reader can
+        # prune partitions even when the caller only filters the base column.
+        pushdown_slice = self.schema().add_generated_filters(hyper_slice)
+
+        # `credential_provider=None` makes Polars pass `storage_options` straight
+        # to the native object store, exactly like `dl.DeltaTable(...)` does. We
+        # avoid the default `credential_provider="auto"`, which would build a
+        # separate Polars-managed Azure credential and could diverge from the
+        # managed-identity / Azure CLI auth used everywhere else in this class.
+        lazy_frame = pl.scan_delta(
+            self.url,
+            storage_options=self.storage_options,
+            credential_provider=None,
+        )
 
-        delta_table = self.delta_table
-        partition_cols = delta_table.metadata().partition_columns
+        for filter_ in pushdown_slice:
+            lazy_frame = lazy_frame.filter(_filter_to_polars_expr(filter_))
 
-        if len(hyper_slice) == 0:
-            file_filters = None
-            partition_filters = None
-            post_filters = []
-        else:
-            file_filters = _empty_to_none(
-                [f for f in hyper_slice if f[0] not in partition_cols]
-            )
-            partition_filters = _empty_to_none(
-                [f for f in partition_hyper_slice if f[0] in partition_cols]
-            )
-            post_filters = [
-                f
-                for f in hyper_slice
-                if f[0] in partition_cols and f not in partition_hyper_slice
-            ]
-
-        pyarrow_table_existing_data = delta_table.to_pyarrow_table(
-            columns=columns,
-            partitions=partition_filters,
-            filters=file_filters,
-        )
+        if columns is not None:
+            lazy_frame = lazy_frame.select(columns)
 
-        df = pl.from_arrow(pyarrow_table_existing_data)
-        for filter_ in post_filters:
-            df = df.filter(_filter_to_polars_expr(filter_))
-        return df
+        return lazy_frame.collect()
 
     def _to_writable_pyarrow_table(self, df: pl.DataFrame, schema: Schema) -> pa.Table:
         """Convert Polars dataframe to pyarrow table with casted schema.

{datazone_sdk-6.0.1.dev7 → datazone_sdk-6.0.1.dev9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "datazone-sdk"
-version = "6.0.1.dev7"
+version = "6.0.1.dev9"
 description = "Database and Delta storage client library for working with Delta Lake tables"
 authors = [{ name = "Team Enigma", email = "enigma@energinet.dk" }]
 requires-python = ">=3.10"