You are viewing a plain text version of this content. The canonical link for it is here.

Posted to dev@iceberg.apache.org by Eduard Tudenhöfner <et...@apache.org> on 2025/11/13 10:22:55 UTC

[DISCUSS] Adding min-rows-requested to the request of the /plan endpoint

Hey everyone,

I'd like to propose adding an optional *min-rows-requested* field to the
request of the */plan* endpoint so that the client can send a *hint* to the
server to not have to return more rows than necessary. It is not required
for the server to return that many rows since the scan may not produce that
many rows. The server can also return more rows than requested.

The proposed OpenAPI spec changes can be seen in PR #14565
<https://github.com/apache/iceberg/pull/14565>.

Looking forward to your thoughts/feedback.

Thanks,
Eduard

Re: [DISCUSS] Adding min-rows-requested to the request of the /plan endpoint

Posted by Fokko Driesprong <fo...@apache.org>.

Hey Eduard,

Thank you for raising this, and I think it makes sense to add it. I left a
comment on the naming on the PR itself.

Cheers, Fokko

Op do 13 nov 2025 om 11:23 schreef Eduard Tudenhöfner <
etudenhoefner@apache.org>:

> Hey everyone,
>
> I'd like to propose adding an optional *min-rows-requested* field to the
> request of the */plan* endpoint so that the client can send a *hint* to
> the server to not have to return more rows than necessary. It is not
> required for the server to return that many rows since the scan may not
> produce that many rows. The server can also return more rows than requested.
>
> The proposed OpenAPI spec changes can be seen in PR #14565
> <https://github.com/apache/iceberg/pull/14565>.
>
> Looking forward to your thoughts/feedback.
>
> Thanks,
> Eduard
>

Re: [DISCUSS] Adding min-rows-requested to the request of the /plan endpoint

Posted by Jean-Baptiste Onofré <jb...@nanthrax.net>.

Hi Eduard

Yes, I think it makes sense to add it.

Thanks !
Regards
JB

On Thu, Nov 13, 2025 at 11:22 AM Eduard Tudenhöfner
<et...@apache.org> wrote:
>
> Hey everyone,
>
> I'd like to propose adding an optional min-rows-requested field to the request of the /plan endpoint so that the client can send a hint to the server to not have to return more rows than necessary. It is not required for the server to return that many rows since the scan may not produce that many rows. The server can also return more rows than requested.
>
> The proposed OpenAPI spec changes can be seen in PR #14565.
>
> Looking forward to your thoughts/feedback.
>
> Thanks,
> Eduard