rdblue commented on code in PR #12658:
URL: https://github.com/apache/iceberg/pull/12658#discussion_r2015090975


##########
format/spec.md:
##########
@@ -648,6 +648,9 @@ Notes:
 5. The `content_offset` and `content_size_in_bytes` fields are used to 
reference a specific blob for direct access to a deletion vector. For deletion 
vectors, these values are required and must exactly match the `offset` and 
`length` stored in the Puffin footer for the deletion vector blob.
 6. The following field ids are reserved on `data_file`: 141.
 
+For `variant` type, the `lower_bounds` and `upper_bounds` store the minimum 
and maximum values for all shredded subcolumns within a file. These bounds are 
represented as a Variant object, where each subcolumn path serves as a key and 
the corresponding bound value as the value. The object is then serialized into 
binary format (see [Variant 
encoding](https://github.com/apache/parquet-format/blob/master/VariantEncoding.md)).
+Subcolumn paths follow the JSON path format, such as `$.event.event_type` for 
standard keys or `$.event.["user.name"]` for keys containing dots.

Review Comment:
   I think that `$.event.["user.name"]` should not have a `.` after `event` in 
the format. I would also say that if we are asking for JSON path notation, then 
we should use the canonical form, which is to always use `['name']` syntax 
(with single quotes, not double). I think that's probably a good idea.



-- 
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: issues-unsubscr...@iceberg.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@iceberg.apache.org
For additional commands, e-mail: issues-h...@iceberg.apache.org

Reply via email to