Clarify pa.null error message: requires format-version 3+

010Soham · 010Soham · commit 63af4e193fbb · 2026-01-08T07:25:56.000Z
diff --git a/pyiceberg/io/pyarrow.py b/pyiceberg/io/pyarrow.py
@@ -1440,7 +1440,7 @@ def primitive(self, primitive: pa.DataType) -> PrimitiveType:
                 raise ValueError(
                     "Null type (pa.null()) is not supported in Iceberg format version "
                     f"{self._format_version}. Field: {field_path}. "
-                    "Use a concrete type (string, int, boolean, etc.) or set format-version=3."
+                    "Requires format-version=3+ or use a concrete type (string, int, boolean, etc.)."
                 )
             return UnknownType()
         elif isinstance(primitive, pa.UuidType):

Original file line number	Diff line number	Diff line change
`@@ -1440,7 +1440,7 @@ def primitive(self, primitive: pa.DataType) -> PrimitiveType:`
`1440`	`1440`	`raise ValueError(`
`1441`	`1441`	`"Null type (pa.null()) is not supported in Iceberg format version "`
`1442`	`1442`	`f"{self._format_version}. Field: {field_path}. "`
`1443`		`- "Use a concrete type (string, int, boolean, etc.) or set format-version=3."`
	`1443`	`+ "Requires format-version=3+ or use a concrete type (string, int, boolean, etc.)."`
`1444`	`1444`	`)`
`1445`	`1445`	`return UnknownType()`
`1446`	`1446`	`elif isinstance(primitive, pa.UuidType):`