Lowercase field names required for Glue

[kbatuigas]

Description

This pull request adds an important clarification to the documentation for AWS Glue integration, specifically regarding field naming requirements. The update highlights a limitation that requires all table column names to be lowercase to avoid schema matching errors.

Documentation update for AWS Glue integration:

• Added a new section explaining that only lowercase field names are supported, as AWS Glue automatically converts all column names to lowercase. This prevents errors in Redpanda when matching columns for schema management.

Resolves https://redpandadata.atlassian.net/browse/1748
Review deadline:

Page previews

https://deploy-preview-1387--redpanda-docs-preview.netlify.app/current/manage/iceberg/iceberg-topics-aws-glue/#lowercase-field-names-required

Checks

• New feature
• Content gap
• Support Follow-up
• Small fix (typos, links, copyedits, etc)

[netlify]

✅ Deploy Preview for redpanda-docs-preview ready!

Name	Link
🔨 Latest commit	4b95d76
🔍 Latest deploy log	https://app.netlify.com/projects/redpanda-docs-preview/deploys/68e94af186884a0008475164
😎 Deploy Preview	https://deploy-preview-1387--redpanda-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

📝 Walkthrough

Walkthrough

Adds new guidance and examples to the Iceberg AWS Glue documentation (modules/manage/pages/iceberg/iceberg-topics-aws-glue.adoc): a limitation requiring lowercase field names; expanded notes on nested partition specs and default partitioning behavior; a prerequisite to include the S3 bucket URI for the Glue Data Catalog base location; updates to cluster configuration steps and examples (including rpk commands and iceberg-related properties); topic creation/alter examples with redpanda.iceberg.mode; produce/query examples showing AWS Glue/Athena usage and expected data format; and updated placeholders for region, bucket, and credentials.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Doc 1698: cluster settings: iceberg_rest_catalog_base_location bucket should always be the same as cloud_storage_bucket #1379 — Also updates the same AWS Glue Iceberg docs regarding catalog base location/bucket alignment.
• Additional guidance for Iceberg cluster configs for Glue catalog #1336 — Modifies the same Glue documentation and cluster configuration examples for Iceberg/Glue integration.
• Iceberg updates for REST catalog and wire format compatible modes #1238 — Introduces catalog base location property and Glue catalog support in related Iceberg/Glue docs.

Suggested reviewers

• simon0191
• wdberkeley
• Feediver1
• mattschumpert

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Out of Scope Changes Check	⚠️ Warning	In addition to the lowercase field name guidance, the pull request introduces unrelated content such as nested partition spec details, S3 prerequisite notes, cluster configuration examples, and Athena query snippets that are outside the scope of DOC-1748.	Please isolate or remove the unrelated documentation changes and focus this pull request solely on the lowercase field name requirement, moving additional topics to separate issues or pull requests.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The title succinctly and accurately reflects the primary change by stating that lowercase field names are required for AWS Glue integration, which matches the core update in the pull request. It is concise, clear, and directly related to the documented limitation without unnecessary detail or noise.
Linked Issues Check	✅ Passed	The documentation update clearly adds the lowercase field name requirement as specified in DOC-1748, directly addressing the linked issue’s objective to document that all column names must be lowercase for AWS Glue integration.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.
Description Check	✅ Passed	The provided pull request description includes all sections defined in the repository template: a clear Description with change context, a Jira issue resolution link, a Review deadline placeholder, a working Page previews URL, and the Checks list, so it largely conforms to the required structure.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[nvartolomei]

Replace can cause errors... with breaks schema management (end of sentence).

It is certain that it will break.

[paulohtb6]

Suggested change

	You must use only lowercase field names. AWS Glue automatically converts all table column names to lowercase. Redpanda relies on exact column name matching to manage schemas, and using uppercase letters can break schema management when Redpanda can't find matching columns.
	Use only lowercase field names. AWS Glue converts all table column names to lowercase, and Redpanda requires exact column name matches for schema management. Using uppercase letters will prevent Redpanda from finding matching columns and break schema management.

Slight change to enforce active voice. Feel free to reject parts that you don't agree

[paulohtb6]

minor nit on wording.

[nvartolomei]

🔥