[Feature] Add $properties Iceberg Metadata Table by mixermt · Pull Request #68504 · StarRocks/starrocks

mixermt · 2026-01-27T10:24:52Z

Why I'm doing:

Currently, StarRocks exposes various Iceberg metadata through metadata tables (table$snapshots, table$history, table$partitions, etc.), but table-level properties are not accessible via SQL. Users need to use external tools or access the Iceberg catalog directly to view configuration properties like location, write.format.default, or compression settings.

This feature adds a table$properties metadata table to expose Iceberg table properties, similar to Trino's implementation, providing a consistent and queryable interface for table configuration.

What I'm doing:

Add support for querying Iceberg table properties via table$properties metadata table syntax:

SELECT * FROM iceberg_catalog.db.my_table$properties;

Returns table properties as key-value pairs:

key	value
location	s3://bucket/warehouse/db/my_table
write.format.default	parquet

Implementation includes:

Added PROPERTIES to MetadataTableType enum
Created IcebergPropertiesTable class with key/value schema
Created IcebergPropertiesTableScanner to read from table.properties() API
Added ICEBERG_PROPERTIES_TABLE to thrift TTableType enum
Registered in factory classes and BE descriptors

Fixes #issue

What type of PR is this:

Does this PR entail a change in behavior?

Yes, this PR will result in a change in behavior.
No, this PR will not result in a change in behavior.

If yes, please specify the type of change:

Interface/UI changes: syntax, type conversion, expression evaluation, display information
Parameter changes: default values, similar parameters but with different default values
Policy changes: use new policy to replace old one, functionality automatically enabled
Feature removed
Miscellaneous: upgrade & downgrade compatibility, etc.

Checklist:

I have added test cases for my bug fix or my new feature
This pr needs user documentation (for new or modified features or behaviors)
- I have added documentation for my new feature or new function
- This pr needs auto generate documentation
This is a backport pr

CLAassistant · 2026-01-27T10:24:59Z

All committers have signed the CLA.

StarRocks-Reviewer · 2026-01-27T17:47:15Z

@cursor review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

gensrc/thrift/Types.thrift

alvin-celerdata · 2026-01-27T19:23:47Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a89c05cbd7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java

Youngwb · 2026-01-28T01:57:00Z

I'm curious why you don't directly use show create table to check the properties.

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java

mixermt · 2026-01-28T07:56:26Z

I'm curious why you don't directly use show create table to check the properties.

@Youngwb SHOW CREATE TABLE output is not queryable data, you need to make huge parsing effort to get simple table properties.
Additionally this is something that already supported by many query/computation engines like Trino (with the same syntax) or in Spark with SHOW TBLPROPERTIES.

mixermt · 2026-01-28T13:38:58Z

@codex review

chatgpt-codex-connector · 2026-01-28T13:39:05Z

To use Codex here, create a Codex account and connect to github.

mixermt · 2026-02-02T17:01:35Z

@alvin-celerdata , @stephen-shelby
Not sure about the process, is there any blocker on my side ?

alvin-celerdata · 2026-02-02T17:35:56Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 589f0ab5bb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java

test/sql/test_iceberg/T/test_metadata_table

github-actions · 2026-02-02T20:49:48Z

[Java-Extensions Incremental Coverage Report]

❌ fail : 0 / 2 (00.00%)

file detail

	path	covered_line	new_line	coverage	not_covered_line_detail
🔵	com/starrocks/connector/iceberg/IcebergMetadataScannerFactory.java	0	2	00.00%	[56, 57]

github-actions · 2026-02-02T20:49:51Z

[FE Incremental Coverage Report]

✅ pass : 0 / 0 (0%)

github-actions · 2026-02-02T20:50:58Z

[BE Incremental Coverage Report]

✅ pass : 0 / 0 (0%)

alvin-celerdata · 2026-02-05T18:03:27Z

@codex review

chatgpt-codex-connector · 2026-02-05T18:09:42Z

Codex Review: Didn't find any major issues. Keep them coming!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

mixermt · 2026-02-06T06:51:04Z

@alvin-celerdata what are the next steps? First SR contribution.
I can't really understand the complete workflow.

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

…test Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

github-actions · 2026-02-19T17:33:09Z

🌎 Translation Required?

✅ All translation files are up to date.
Great job! No translation actions are required for this PR.

🕒 Last updated: Thu, 19 Feb 2026 17:33:08 GMT

mixermt requested review from a team as code owners January 27, 2026 10:24

github-actions bot added behavior_changed title needs [type] documentation Improvements or additions to documentation labels Jan 27, 2026

wanpengfei-git added the PROTO-REVIEW label Jan 27, 2026

wanpengfei-git requested a review from a team January 27, 2026 10:25

mergify bot assigned mixermt Jan 27, 2026

mixermt changed the title ~~Add "properties" Iceberg Metadata Table~~ [Feature] Add "properties" Iceberg Metadata Table Jan 27, 2026

github-actions bot removed behavior_changed title needs [type] labels Jan 27, 2026

mixermt changed the title ~~[Feature] Add "properties" Iceberg Metadata Table~~ [Feature] Add $properties Iceberg Metadata Table Jan 27, 2026

cursor bot reviewed Jan 27, 2026

View reviewed changes

alvin-celerdata reviewed Jan 27, 2026

View reviewed changes

gensrc/thrift/Types.thrift Outdated Show resolved Hide resolved

chatgpt-codex-connector bot reviewed Jan 27, 2026

View reviewed changes

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java Outdated Show resolved Hide resolved

stephen-shelby reviewed Jan 28, 2026

View reviewed changes

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java Show resolved Hide resolved

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java Show resolved Hide resolved

mixermt force-pushed the add-iceberg-properties-table branch from 1df50d9 to 589f0ab Compare January 28, 2026 22:30

chatgpt-codex-connector bot reviewed Feb 2, 2026

View reviewed changes

...data-reader/src/main/java/com/starrocks/connector/iceberg/IcebergPropertiesTableScanner.java Outdated Show resolved Hide resolved

test/sql/test_iceberg/T/test_metadata_table Show resolved Hide resolved

mixermt added 5 commits February 19, 2026 19:23

Add Iceberg Table Properties

4940f95

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

Add documentation

0853294

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

Code review fixes - Single Meta Split, Types - make last, end to end …

7952361

…test Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

Add expected results

06d9e73

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

Add location as a synthetic property

812446a

Signed-off-by: Michael Taranov <michael.taranov@taboola.com>

mixermt force-pushed the add-iceberg-properties-table branch from b9ce6d4 to 812446a Compare February 19, 2026 17:32

github-actions bot added the docs-maintainer label Feb 19, 2026

Conversation

mixermt commented Jan 27, 2026 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why I'm doing:

What I'm doing:

What type of PR is this:

Checklist:

Uh oh!

CLAassistant commented Jan 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

StarRocks-Reviewer commented Jan 27, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

alvin-celerdata commented Jan 27, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Youngwb commented Jan 28, 2026

Uh oh!

Uh oh!

Uh oh!

mixermt commented Jan 28, 2026

Uh oh!

mixermt commented Jan 28, 2026

Uh oh!

chatgpt-codex-connector bot commented Jan 28, 2026

Uh oh!

mixermt commented Feb 2, 2026

Uh oh!

alvin-celerdata commented Feb 2, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 2, 2026

[Java-Extensions Incremental Coverage Report]

file detail

Uh oh!

github-actions bot commented Feb 2, 2026

[FE Incremental Coverage Report]

Uh oh!

github-actions bot commented Feb 2, 2026

[BE Incremental Coverage Report]

Uh oh!

alvin-celerdata commented Feb 5, 2026

Uh oh!

chatgpt-codex-connector bot commented Feb 5, 2026

Uh oh!

mixermt commented Feb 6, 2026

Uh oh!

github-actions bot commented Feb 19, 2026

🌎 Translation Required?

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Comments

mixermt commented Jan 27, 2026 •

edited by github-actions bot

Loading

CLAassistant commented Jan 27, 2026 •

edited

Loading