RussellSpitzer commented on code in PR #16425:
URL: https://github.com/apache/iceberg/pull/16425#discussion_r4418894097


##########
format/spec.md:
##########
@@ -1801,6 +1804,40 @@ If a delete column in an equality delete file is later 
dropped from the table, i
 
 Manifests hold the same statistics for delete files and data files. For delete 
files, the metrics describe the values that were deleted.
 
+### Column Files
+
+Starting in v4, a data file may store fields in column files listed in 
[`column_files`](#column-file-fields). A column file is an Iceberg data file 
and must have the same row count as its data file.

Review Comment:
   This says "data file" 3 times and means a different thing each time 
(manifest entry, parquet/orc/avro, source data file)
   
   I would try to rewrite this to be a bit more clear?
   
   "A column file can be any supported Iceberg file type and must have rows 
which align with the data file it modifies."



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to