szehon-ho commented on code in PR #17707: URL: https://github.com/apache/iceberg/pull/17707#discussion_r3867869935
########## docs/docs/spark-procedures.md: ########## @@ -410,6 +410,7 @@ Iceberg can compact data files in parallel using Spark with the `rewriteDataFile | `min-input-files` | 5 | Any file group with this number of files or more will be rewritten regardless of other criteria (the file group should have at least two files) | | `rewrite-all` | false | Force rewriting of all provided files overriding other options | | `max-file-group-size-bytes` | 107374182400 (100GB) | Largest amount of data that should be rewritten in a single file group. The entire rewrite operation is broken down into pieces based on partitioning and within partitions based on size into file-groups. This helps with breaking down the rewriting of very large partitions which may not be rewritable otherwise due to the resource constraints of the cluster. | +| `max-file-group-input-files` | Long.MAX_VALUE (unlimited) | Largest number of input files that should be rewritten in a single file group. This helps with breaking down the rewriting of very large partitions which may not be rewritable otherwise due to the resource constraints of the cluster. Should be set to at least `min-input-files`; setting it lower causes groups capped below that threshold to be silently skipped. | Review Comment: This row applies to the data-files planner, where a capped group is not necessarily skipped -- `BinPackRewriteFilePlanner` still rewrites it via the size or delete triggers. Suggested wording: "If set below `min-input-files`, no group can reach `min-input-files`, so the file-count rewrite trigger never fires; groups are then rewritten only when they meet the size thresholds or contain files exceeding the delete-file/delete-ratio thresholds." ########## docs/docs/spark-procedures.md: ########## @@ -549,6 +550,7 @@ Dangling deletes are always filtered out during rewriting. | `min-input-files` | 5 | Any file group exceeding this number of files will be rewritten regardless of other criteria | | `rewrite-all` | false | Force rewriting of all provided files overriding other options | | `max-file-group-size-bytes` | 107374182400 (100GB) | Largest amount of data that should be rewritten in a single file group. The entire rewrite operation is broken down into pieces based on partitioning and within partitions based on size into file-groups. This helps with breaking down the rewriting of very large partitions which may not be rewritable otherwise due to the resource constraints of the cluster. | +| `max-file-group-input-files` | Long.MAX_VALUE (unlimited) | Largest number of input files that should be rewritten in a single file group. This helps with breaking down the rewriting of very large partitions which may not be rewritable otherwise due to the resource constraints of the cluster. Should be set to at least `min-input-files`; setting it lower causes groups capped below that threshold to be silently skipped. | Review Comment: Here only the size triggers survive, so "silently skipped" still overstates it. Suggested wording: "If set below `min-input-files`, no group can reach `min-input-files`, so the file-count rewrite trigger never fires and groups are rewritten only when they meet the size thresholds." -- 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]
