Skip to content

feat: support V0 iceberg_tables schema for SqlCatalog #2380

Open
rchowell wants to merge 3 commits into
apache:mainfrom
rchowell:iceberg-type
Open

feat: support V0 iceberg_tables schema for SqlCatalog #2380
rchowell wants to merge 3 commits into
apache:mainfrom
rchowell:iceberg-type

Conversation

@rchowell
Copy link
Copy Markdown
Contributor

@rchowell rchowell commented Apr 28, 2026

Which issue does this PR close?

What changes are included in this PR?

This PR adds support for using a V0 SqlCatalog from other implementations like iceberg-python or iceberg-java, and it follows the iceberg-java behavior of checking an explicit schema-version property and migrating to V1 only-if the user requested this. I also added logging at the same level as iceberg-java.

Probe to see if we have a V0 or V1 table, then add the iceberg_type column if it does not exist. More details in apache/iceberg-python#3263

Are these changes tested?

  • Unit tests with migration path

Comment thread crates/catalog/sql/src/catalog.rs Outdated
@rchowell rchowell changed the title fix: automatically migrate V0 SqlCatalog catalog tables feat: support V0 iceberg_tables schema for SqlCatalog May 1, 2026
@rchowell
Copy link
Copy Markdown
Contributor Author

rchowell commented May 1, 2026

Ok @blackmwk thanks again for reviewing, I was mistaken and have fixed this PR to match iceberg-java much more closely. I also updated the PR title and description to be more accurate since this is more of a feature to support reading V0 tables in iceberg-rust. Thanks!

Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
let tbl_metadata_location_str = tbl_metadata_location.to_string();
self.execute(&format!(
"INSERT INTO {CATALOG_TABLE_NAME}
({CATALOG_FIELD_CATALOG_NAME}, {CATALOG_FIELD_TABLE_NAMESPACE}, {CATALOG_FIELD_TABLE_NAME}, {CATALOG_FIELD_METADATA_LOCATION_PROP}, {CATALOG_FIELD_RECORD_TYPE})
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we consider V0 schema here as well?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In iceberg-java, it looks like we only support creating V0 table. So I think it's fine for us to leave it here.

But still quite curious about the case when TableCreation has V1 schema.

https://github.com/apache/iceberg/blob/bb37293484468f0502de9986955860505aef9776/core/src/main/java/org/apache/iceberg/jdbc/JdbcUtil.java#L128

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To clarify on outcome, we fully support V1 catalog, migration from V0 to V1 catalog, and we support all catalog operations on V0 except for table creation and registration.

If we really want, we could later support mutations of V0 SQL catalog (outside of migration to V1).

Can we consider (maybe its OK as follow-up) to explicitly error to say this isn't supported?

Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/lib.rs Outdated
Copy link
Copy Markdown
Contributor

@blackmwk blackmwk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @rchowell for this pr!

Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Comment thread crates/catalog/sql/src/catalog.rs Outdated
Copy link
Copy Markdown
Contributor

@dannycjones dannycjones left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally LGTM. One small comment on the error handling around table creation/registration.

let tbl_metadata_location_str = tbl_metadata_location.to_string();
self.execute(&format!(
"INSERT INTO {CATALOG_TABLE_NAME}
({CATALOG_FIELD_CATALOG_NAME}, {CATALOG_FIELD_TABLE_NAMESPACE}, {CATALOG_FIELD_TABLE_NAME}, {CATALOG_FIELD_METADATA_LOCATION_PROP}, {CATALOG_FIELD_RECORD_TYPE})
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To clarify on outcome, we fully support V1 catalog, migration from V0 to V1 catalog, and we support all catalog operations on V0 except for table creation and registration.

If we really want, we could later support mutations of V0 SQL catalog (outside of migration to V1).

Can we consider (maybe its OK as follow-up) to explicitly error to say this isn't supported?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

column "iceberg_type" does not exist

4 participants