Add support to query Iceberg table by branch/tag name

[agrawalreetika]

Description

Add support to query Iceberg table by branch/tag name

Motivation and Context

Resolves #22029

Impact

Resolves #22029

Test Plan

Added tests

Contributor checklist

• Please make sure your submission complies with our development, formatting, commit message, and attribution guidelines.
• PR description addresses the issue accurately and concisely. If the change is non-trivial, a GitHub Issue is referenced.
• Documented new properties (with its default value), SQL syntax, functions, or other functionality.
• If release notes are required, they follow the release notes guidelines.
• Adequate tests were added if applicable.
• CI passed.

Release Notes

Please follow release notes guidelines and fill in the release notes below.

== RELEASE NOTES ==

Iceberg Connector Changes
* Add support to query Iceberg table by branch/tag name :pr:`23539`

[steveburnett]

LGTM! (docs)

Pull branch, local doc build, looks good. Thanks!

[steveburnett]

Nit, update the PR number in the release note entry from the default 12345.

== RELEASE NOTES ==

Iceberg Connector Changes
* Add support to query Iceberg table by branch name or tag name :pr:`23539`

[tdcmeehan]

Nice work!

[ZacBlanco]

code and tests LGTM, one suggestion on the error message

[hantangwangd]

Should we add some test cases about query on schema changes? Referring to: https://iceberg.apache.org/docs/nightly/branching/#schema-selection-with-branches-and-tags. It seems that Iceberg has some differences in handling queries on branch and tag.

[agrawalreetika]

Should we add some test cases about query on schema changes? Referring to: https://iceberg.apache.org/docs/nightly/branching/#schema-selection-with-branches-and-tags. It seems that Iceberg has some differences in handling queries on branch and tag.

If any schema changes are performed after tag creation, Tag based query access uses the snapshot's schema.
Since, currently we always use current snapshot schema tag based test with schema changes are blocked.
Will add the tests for tags access with schema changes based on how we decide to handle schema behaviour here

[hantangwangd]

Will add the tests for tags access with schema changes based on how we decide to handle schema behavior

OK, got it.

[hantangwangd]

Thanks for adding this feature. Change looks good to me since we have not yet decide how to choose the schema of queries on tag and snapshot.

[agrawalreetika]

@tdcmeehan @ZacBlanco Can you check on this one?

[agrawalreetika]

@steveburnett Could you please review the docs changes?

[steveburnett]

LGTM! (docs)

Pull updated branch, new local doc build, looks good. Thanks!