wgtmac commented on code in PR #12644:
URL: https://github.com/apache/iceberg/pull/12644#discussion_r2015906621


##########
format/spec.md:
##########
@@ -1453,13 +1457,15 @@ Each sort field in the fields list is stored as an 
object with the following pro
 
 | V1       | V2       | V3       | Field            | JSON representation | 
Example     |
 
|----------|----------|----------|------------------|---------------------|-------------|
-| required | required | required | **`transform`**  | `JSON string`       | 
`bucket[4]` |
-| required | required | omitted  | **`source-id`**  | `JSON int`          | 1  
         |
+| required | required | required¹ | **`transform`**  | `JSON string`       | 
`bucket[4]` |

Review Comment:
   I guess the note is in the wrong place?



##########
format/spec.md:
##########
@@ -1414,12 +1414,16 @@ Each partition field in `fields` is stored as a JSON 
object with the following p
 
 | V1       | V2       | V3       | Field            | JSON representation | 
Example      |
 
|----------|----------|----------|------------------|---------------------|--------------|
-| required | required | omitted  | **`source-id`**  | `JSON int`          | 1  
          |

Review Comment:
   If both `source-ids` and `source-id` are written for single-arg transform, a 
v3-supported reader can take a shortcut on `source-ids` and only fall back to 
`source-id` when `source-ids` is missing. Isn't this a desirable feature? 
Though someone may argue that we have to check the consistency between them 
like the above discussion.



##########
format/spec.md:
##########
@@ -1605,13 +1611,8 @@ All readers are required to read tables with unknown 
partition transforms, ignor
 Writing v3 metadata:
 
 * Partition Field and Sort Field JSON:
-    * `source-ids` was added and is required
-    * `source-id` is no longer required and should be omitted; always use 
`source-ids` instead
-
-Reading v1 or v2 metadata for v3:
-
-* Partition Field and Sort Field JSON:
-    * `source-ids` should default to a single-value list of the value of 
`source-id`
+    * `source-ids` was added and is required in case of multi-argument 
transforms.

Review Comment:
   ```suggestion
       * `source-ids` was added and is required in the case of multi-argument 
transforms.
   ```



-- 
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