Kenneth Oh
07/31/2026, 11:05 PMRocky
07/31/2026, 11:05 PMaccess_control = ranger in your fe.conf and configure the StarRocks Ranger plugin on your Frontend (FE) nodes.
2. Kerberos Limitation: StarRocks currently does not support connecting to Apache Ranger servers that use Kerberos for authentication.
3. Policy Enforcement: Authorization checks occur at the FE level before query execution. This ensures that regardless of whether your data is stored locally (shared-nothing) or in object storage (shared-data), the security policies are strictly enforced.
If you are using the Data Sharing feature (cross-cluster sharing), note that authorization is typically managed by the cluster initiating the query. If that cluster is integrated with Ranger, it will apply the policies defined in the Ranger service associated with that cluster' with that cluster's cluster' that cluster.
References
• administration/user_privs/authorization/ranger_plugin.md
• best_practices/authentication_authorization.mdKenneth Oh
08/01/2026, 8:19 AMRocky
08/01/2026, 8:19 AM_row_id and _last_updated_sequence_number. These allow you to track individual rows even after operations like compaction or rewrite_data_files.
* Variant Data Type: 4.1 includes native support for the Iceberg Variant type, allowing high-performance queries on semi-structured data stored in the Iceberg v3 format.
* Default Column Values: Support for reading and creating tables with the Iceberg v3 default value property.
Shared Data Architecture Considerations
In the Shared Data architecture (where StarRocks itself stores data in object storage), the engine's ability to query External Catalogs (like Iceberg) remains consistent with the shared-nothing version. The 4.1 release specifically optimizes the data lake analytics experience for shared-data clusters, ensuring that features like deletion vector support and metadata caching are available and performant.
Summary Table for Iceberg Deletes in StarRocks
Iceberg Version | Delete Mechanism | StarRocks Support
v1 | Copy-on-Write (CoW) | Full support
v2 | Position / Equality Deletes (MoR) | Supported (v3.1+ for Position, v3.3+ for Equality)
v3 | Binary Deletion Vectors (MoR) | Supported from v4.1 onwards
To use these features, ensure your Iceberg table is created or upgraded to format-version = '3'.
References
• data_source/catalog/iceberg/iceberg_catalog.md
• release_notes/release-4.0.md
• data_source/feature-support-data-lake-analytics.md
• data_source/catalog/iceberg/DML.md
References
• data_source/catalog/iceberg/iceberg_catalog.md
• release_notes/release-4.0.md
• release_notes/release-2.1.md
• release_notes/release-3.4.md
• data_source/feature-support-data-lake-analytics.mdKenneth Oh
08/01/2026, 8:22 AMRocky
08/01/2026, 8:23 AM_row_id, _last_updated_sequence_number."
3. Iceberg DDL Operations (v4.1):
The documentation for default values notes:
> "This feature requires Iceberg format version 3 ("format-version" = "3")."
Why you only see v2 in the "Iceberg table version" table:
The table you quoted specifically refers to the supported Merge-on-Read (MoR) mechanisms. Currently, StarRocks only supports v2-style MoR (Position Deletes and Equality Deletes).
As of StarRocks 4.1, Binary Deletion Vectors (the v3 MoR mechanism) are not yet supported for queries. In fact, the 4.1 release notes include a "fail fast" mechanism for this exact reason:
"Fails fast for unsupported Iceberg V3 features. #70242"Summary of Iceberg v3 Support in 4.1 Iceberg v3 Feature | Supported in 4.1? Row Lineage (
_row_id) | Yes
VARIANT Data Type | Yes
Default Column Values | Yes
Binary Deletion Vectors | No (Fails fast)
DML (DELETE/TRUNCATE) | Yes (via Partition Overwrite/CoW)
Recommendation: If your Iceberg v3 tables rely on Binary Deletion Vectors for updates and deletes, you should continue to use position deletes (v2) or wait for a future StarRocks update that implements the binary vector scanner.
References
• releasenotes/release-4.1.md
• data_source/catalog/iceberg/iceberg_metadata_tables.md
• sql-reference/data-types/semi-structured/VARIANT.md
References
• data_source/catalog/iceberg/DML.md
• data_source/feature-support-data-lake-analytics.md
• data_source/catalog/deltalake_catalog.md
• data_source/catalog/iceberg/iceberg_catalog.md
• sql-reference/sql-statements/table_bucket_part_index/DELETE.md
• data_source/catalog/iceberg/DDL.mdKenneth Oh
08/01/2026, 4:27 PMRocky
08/01/2026, 4:27 PM.puffin files) for Merge-on-Read (MoR), StarRocks 4.1 will not be able to process those deletions. In fact, StarRocks 4.1 includes a "fail fast" mechanism (via PR #70242) specifically to detect and reject Iceberg v3 tables that use unsupported features like binary deletion vectors to prevent incorrect query results.
What is supported for Iceberg v3 in StarRocks 4.1:
StarRocks 4.1 introduced "Iceberg v3 support," but it is limited to the following capabilities:
* Row Lineage Tracking: You can query the metadata columns _row_id and _last_updated_sequence_number.
* VARIANT Data Type: Native support for the Iceberg v3 Variant type for semi-structured data.
* Default Column Values: Support for reading and creating tables that use the v3 schema-level default values.
What is NOT supported:
* Binary Deletion Vectors (v3 MoR): StarRocks cannot currently read the bitset-based deletion vectors introduced in the v3 specification.
* Querying MoR v3 Tables: If a v3 table has active deletion vectors, StarRocks will fail the query rather than ignore the deletes (which would result in "dirty" reads).
Summary of Deletion Support
Iceberg Version | Delete Mechanism | StarRocks 4.1 Support
v1 | Copy-on-Write (CoW) | Full Support
v2 | Position Deletes (MoR) | Full Support
v2 | Equality Deletes (MoR) | Full Support
v3 | Binary Deletion Vectors (MoR) | Not Supported (Fails fast)
Recommendation: For your StarRocks-PySpark pipeline, you should continue to use Iceberg v2 for tables requiring Merge-on-Read, or ensure your v3 tables are compacted (using rewrite_data_files) into a state without active deletion vectors before querying them in StarRocks.
References
• releasenotes/release-4.1.md
• data_source/catalog/iceberg/iceberg_catalog.md
• data_source/catalog/iceberg/iceberg_metadata_tables.md
References
• data_source/catalog/iceberg/iceberg_catalog.md
• data_source/catalog/iceberg/DML.md
• release_notes/release-4.0.md
• data_source/feature-support-data-lake-analytics.md
• release_notes/release-2.1.md