gbrgr commented on code in PR #1824:
URL: https://github.com/apache/iceberg-rust/pull/1824#discussion_r2517380755
##########
crates/iceberg/src/scan/mod.rs:
##########
@@ -42,6 +45,28 @@ use crate::table::Table;
use crate::utils::available_parallelism;
use crate::{Error, ErrorKind, Result};
+/// Reserved column name for the file path metadata column.
+///
+/// When this column is selected in a table scan (e.g., `.select(["col1",
RESERVED_COL_NAME_FILE])`),
+/// each row will include the path of the file from which that row was read.
+/// This is useful for debugging, auditing, or tracking data lineage.
+///
+/// # Example
+/// ```no_run
+/// # use iceberg::scan::RESERVED_COL_NAME_FILE;
+/// # use iceberg::table::Table;
+/// # async fn example() -> iceberg::Result<()> {
+/// # let table: Table = todo!();
+/// // Select regular columns along with the file path
+/// let scan = table
+/// .scan()
+/// .select(["id", "name", RESERVED_COL_NAME_FILE])
+/// .build()?;
+/// # Ok(())
+/// # }
+/// ```
+pub const RESERVED_COL_NAME_FILE: &str = RESERVED_COL_NAME_FILE_INTERNAL;
Review Comment:
Added a new module
##########
crates/iceberg/src/scan/mod.rs:
##########
@@ -217,9 +242,13 @@ impl<'a> TableScanBuilder<'a> {
let schema = snapshot.schema(self.table.metadata())?;
- // Check that all column names exist in the schema.
+ // Check that all column names exist in the schema (skip reserved
columns).
if let Some(column_names) = self.column_names.as_ref() {
for column_name in column_names {
+ // Skip reserved columns that don't exist in the schema
+ if column_name == RESERVED_COL_NAME_FILE_INTERNAL {
Review Comment:
Done in the new module
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
