Skip to content

chore(docs): Improve athena.to_iceberg documentation #3246

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
villoro wants to merge 3 commits into
base: main
Choose a base branch
from
+6 −4
Open

chore(docs): Improve athena.to_iceberg documentation #3246

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b9cb598
[skip-ci] Improve `athena.to_iceberg` documentation
villoro Dec 10, 2025
0711f4c
[skip-ci] split long line
villoro Dec 10, 2025
92d0dc7
Fix long line
villoro Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions awswrangler/athena/_write_iceberg.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -412,10 +412,11 @@ def to_iceberg( # noqa: PLR0913
https://docs.aws.amazon.com/athena/latest/ug/merge-into-statement.html
merge_condition
The condition to be used in the MERGE INTO statement. Valid values: ['update', 'ignore'].
Default is ``update``.
merge_match_nulls
Instruct whether to have nulls in the merge condition match other nulls
Instruct whether to have nulls in the merge condition match other nulls.
keep_files
Whether staging files produced by Athena are retained. 'True' by default.
Whether staging files produced by Athena are retained. Default is ``True``.
data_source
Data Source / Catalog name. If None, 'AwsDataCatalog' will be used by default.
s3_output
Expand Down Expand Up @@ -448,7 +449,7 @@ def to_iceberg( # noqa: PLR0913
e.g. {'col name': 'bigint', 'col2 name': 'int'}
catalog_id
The ID of the Data Catalog from which to retrieve Databases.
If none is provided, the AWS account ID is used by default
If none is provided, the AWS account ID is used by default.
schema_evolution
If ``True`` allows schema evolution for new columns or changes in column types.
Columns missing from the DataFrame that are present in the Iceberg schema
Expand Down
3 changes: 2 additions & 1 deletion docs/source/install.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,8 @@ Run this command in any Python 3 notebook cell and then make sure to

**Platform compatibility notice:**

``awswrangler>=3.14.0`` defaults to PyArrow 21.0.0+, which requires CMake 3.25+ to build. On AL2-V3 notebook instances (CMake 2.8), you have the following options:
``awswrangler>=3.14.0`` defaults to PyArrow 21.0.0+, which requires CMake 3.25+ to build.
On AL2-V3 notebook instances (CMake 2.8), you have the following options:

* Pin PyArrow to an older version:

Expand Down