[feature request] docs for IRC catalog connection

[kevinjqliu]

Feature Request / Improvement

I think we can improve the REST catalog documentation https://py.iceberg.apache.org/configuration/#rest-catalog

Specifically, it would be great to clarity

• auth (oauth/credential/token/sigv4)
• oauth2-server-uri
• the warehouse param (see Add warehouse parameter to the REST Catalog doc #2066 (comment) and Add warehouse parameter to the REST Catalog doc #2066 (comment))
• header, header.X-Iceberg-Access-Delegation
• credential vending
• remote-signing

And perhaps common REST catalog configurations

• Glue IRC / S3 Tables IRC
• Polaris
• UC IRC
• Lakekeeper
• R2
  Similar to the examples in duckdb https://duckdb.org/docs/stable/core_extensions/iceberg/iceberg_rest_catalogs#specific-catalog-examples

I found 2 good articles showing Glue IRC and OSS UC

[kevinjqliu]

Some of the catalog integrations might already exist in their respective docs

• lakekeeper, https://docs.lakekeeper.io/docs/latest/engines/?h=pyiceberg#pyiceberg
• R2 data catalog, https://developers.cloudflare.com/r2/data-catalog/config-examples/pyiceberg/
• UC, https://docs.databricks.com/aws/en/external-access/iceberg#use-databricks-tables-with-pyiceberg
  And some in the wild on blog posts
• Polaris, https://medium.com/@scottteal/tutorial-how-to-integrate-pyiceberg-and-snowflakes-service-for-apache-polaris-c706cd372ecd

[james5418]

Hi @kevinjqliu, I would like to work on this issue!

[kevinjqliu]

@james5418 feel free to open up a PR! I would suggest taking a look at the above catalog integrations to see how these params are relevant.