feat(iceberg): Add memory file IO support (#481)

* feat(iceberg): Add memory file IO support

Signed-off-by: Xuanwo <[email protected]>

* Fix typo

Signed-off-by: Xuanwo <[email protected]>

* Add comments for memory file io

Signed-off-by: Xuanwo <[email protected]>

---------

Signed-off-by: Xuanwo <[email protected]>

Author: Xuanwo

crates/iceberg/Cargo.toml

@@ -29,9 +29,10 @@ license = { workspace = true }
 keywords = ["iceberg"]
 
 [features]
-default = ["storage-fs", "storage-s3", "tokio"]
-storage-all = ["storage-fs", "storage-s3"]
+default = ["storage-memory", "storage-fs", "storage-s3", "tokio"]
+storage-all = ["storage-memory", "storage-fs", "storage-s3"]
 
+storage-memory = ["opendal/services-memory"]
 storage-fs = ["opendal/services-fs"]
 storage-s3 = ["opendal/services-s3"]
 

crates/iceberg/src/expr/predicate.rs

@@ -478,10 +478,10 @@ impl Predicate {
     /// # Example
     ///
     /// ```rust
-    /// use std::ops::Bound::Unbounded;
     /// use iceberg::expr::BoundPredicate::Unary;
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
+    /// use std::ops::Bound::Unbounded;
     /// let expr1 = Reference::new("a").less_than(Datum::long(10));
     ///
     /// let expr2 = Reference::new("b").less_than(Datum::long(20));
@@ -505,10 +505,10 @@ impl Predicate {
     /// # Example
     ///
     /// ```rust
-    /// use std::ops::Bound::Unbounded;
     /// use iceberg::expr::BoundPredicate::Unary;
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
+    /// use std::ops::Bound::Unbounded;
     /// let expr1 = Reference::new("a").less_than(Datum::long(10));
     ///
     /// let expr2 = Reference::new("b").less_than(Datum::long(20));
@@ -534,12 +534,14 @@ impl Predicate {
     /// # Example
     ///
     /// ```rust
-    /// use std::ops::Bound::Unbounded;
     /// use iceberg::expr::BoundPredicate::Unary;
     /// use iceberg::expr::{LogicalExpression, Predicate, Reference};
     /// use iceberg::spec::Datum;
+    /// use std::ops::Bound::Unbounded;
     /// let expr1 = Reference::new("a").less_than(Datum::long(10));
-    /// let expr2 = Reference::new("b").less_than(Datum::long(5)).and(Reference::new("c").less_than(Datum::long(10)));
+    /// let expr2 = Reference::new("b")
+    ///     .less_than(Datum::long(5))
+    ///     .and(Reference::new("c").less_than(Datum::long(10)));
     ///
     /// let result = expr1.negate();
     /// assert_eq!(&format!("{result}"), "a >= 10");
@@ -632,16 +634,16 @@ impl Not for Predicate {
     /// # Example
     ///     
     ///```rust
-    ///use std::ops::Bound::Unbounded;
-    ///use iceberg::expr::BoundPredicate::Unary;
-    ///use iceberg::expr::Reference;
-    ///use iceberg::spec::Datum;
-    ///let expr1 = Reference::new("a").less_than(Datum::long(10));
-    ///     
-    ///let expr = !expr1;
-    ///     
-    ///assert_eq!(&format!("{expr}"), "NOT (a < 10)");
-    ///```
+    /// use iceberg::expr::BoundPredicate::Unary;
+    /// use iceberg::expr::Reference;
+    /// use iceberg::spec::Datum;
+    /// use std::ops::Bound::Unbounded;
+    /// let expr1 = Reference::new("a").less_than(Datum::long(10));
+    ///
+    /// let expr = !expr1;
+    ///
+    /// assert_eq!(&format!("{expr}"), "NOT (a < 10)");
+    /// ```
     fn not(self) -> Self::Output {
         Predicate::Not(LogicalExpression::new([Box::new(self)]))
     }

crates/iceberg/src/expr/term.rs

@@ -56,7 +56,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").less_than(Datum::long(10));
@@ -76,7 +75,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").less_than_or_equal_to(Datum::long(10));
@@ -96,7 +94,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").greater_than(Datum::long(10));
@@ -116,7 +113,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").greater_than_or_equal_to(Datum::long(10));
@@ -136,7 +132,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").equal_to(Datum::long(10));
@@ -152,7 +147,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").not_equal_to(Datum::long(10));
@@ -168,7 +162,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").starts_with(Datum::string("foo"));
@@ -188,7 +181,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     ///
@@ -209,7 +201,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").is_nan();
@@ -225,7 +216,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").is_not_nan();
@@ -241,7 +231,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").is_null();
@@ -257,7 +246,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
     /// let expr = Reference::new("a").is_not_null();
@@ -273,7 +261,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use fnv::FnvHashSet;
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;
@@ -295,7 +282,6 @@ impl Reference {
     /// # Example
     ///
     /// ```rust
-    ///
     /// use fnv::FnvHashSet;
     /// use iceberg::expr::Reference;
     /// use iceberg::spec::Datum;

crates/iceberg/src/io/mod.rs

@@ -20,23 +20,41 @@
 //! # How to build `FileIO`
 //!
 //! We provided a `FileIOBuilder` to build `FileIO` from scratch. For example:
+//!
 //! ```rust
 //! use iceberg::io::{FileIOBuilder, S3_REGION};
+//! use iceberg::Result;
 //!
+//! # fn test() -> Result<()> {
+//! // Build a memory file io.
+//! let file_io = FileIOBuilder::new("memory").build()?;
+//! // Build an fs file io.
+//! let file_io = FileIOBuilder::new("fs").build()?;
+//! // Build an s3 file io.
 //! let file_io = FileIOBuilder::new("s3")
 //!     .with_prop(S3_REGION, "us-east-1")
-//!     .build()
-//!     .unwrap();
+//!     .build()?;
+//! # Ok(())
+//! # }
 //! ```
 //!
 //! Or you can pass a path to ask `FileIO` to infer schema for you:
+//!
 //! ```rust
 //! use iceberg::io::{FileIO, S3_REGION};
-//! let file_io = FileIO::from_path("s3://bucket/a")
-//!     .unwrap()
+//! use iceberg::Result;
+//!
+//! # fn test() -> Result<()> {
+//! // Build a memory file io.
+//! let file_io = FileIO::from_path("memory:///")?.build()?;
+//! // Build an fs file io.
+//! let file_io = FileIO::from_path("fs:///tmp")?.build()?;
+//! // Build an s3 file io.
+//! let file_io = FileIO::from_path("s3://bucket/a")?
 //!     .with_prop(S3_REGION, "us-east-1")
-//!     .build()
-//!     .unwrap();
+//!     .build()?;
+//! # Ok(())
+//! # }
 //! ```
 //!
 //! # How to use `FileIO`
@@ -52,6 +70,10 @@ mod file_io;
 pub use file_io::*;
 
 mod storage;
+#[cfg(feature = "storage-memory")]
+mod storage_memory;
+#[cfg(feature = "storage-memory")]
+use storage_memory::*;
 #[cfg(feature = "storage-s3")]
 mod storage_s3;
 #[cfg(feature = "storage-s3")]

crates/iceberg/src/io/storage.rs

@@ -18,6 +18,8 @@
 use super::FileIOBuilder;
 #[cfg(feature = "storage-fs")]
 use super::FsConfig;
+#[cfg(feature = "storage-memory")]
+use super::MemoryConfig;
 #[cfg(feature = "storage-s3")]
 use super::S3Config;
 use crate::{Error, ErrorKind};
@@ -26,6 +28,8 @@ use opendal::{Operator, Scheme};
 /// The storage carries all supported storage services in iceberg
 #[derive(Debug)]
 pub(crate) enum Storage {
+    #[cfg(feature = "storage-memory")]
+    Memory { config: MemoryConfig },
     #[cfg(feature = "storage-fs")]
     LocalFs { config: FsConfig },
     #[cfg(feature = "storage-s3")]
@@ -44,6 +48,10 @@ impl Storage {
         let scheme = Self::parse_scheme(&scheme_str)?;
 
         match scheme {
+            #[cfg(feature = "storage-memory")]
+            Scheme::Memory => Ok(Self::Memory {
+                config: MemoryConfig::new(props),
+            }),
             #[cfg(feature = "storage-fs")]
             Scheme::Fs => Ok(Self::LocalFs {
                 config: FsConfig::new(props),
@@ -72,13 +80,22 @@ impl Storage {
     ///
     /// * An [`opendal::Operator`] instance used to operate on file.
     /// * Relative path to the root uri of [`opendal::Operator`].
-    ///
     pub(crate) fn create_operator<'a>(
         &self,
         path: &'a impl AsRef<str>,
     ) -> crate::Result<(Operator, &'a str)> {
         let path = path.as_ref();
         match self {
+            #[cfg(feature = "storage-memory")]
+            Storage::Memory { config } => {
+                let op = config.build(path)?;
+
+                if let Some(stripped) = path.strip_prefix("memory:/") {
+                    Ok((op, stripped))
+                } else {
+                    Ok((op, &path[1..]))
+                }
+            }
             #[cfg(feature = "storage-fs")]
             Storage::LocalFs { config } => {
                 let op = config.build(path)?;
@@ -116,6 +133,7 @@ impl Storage {
     /// Parse scheme.
     fn parse_scheme(scheme: &str) -> crate::Result<Scheme> {
         match scheme {
+            "memory" => Ok(Scheme::Memory),
             "file" | "" => Ok(Scheme::Fs),
             "s3" | "s3a" => Ok(Scheme::S3),
             s => Ok(s.parse::<Scheme>()?),

crates/iceberg/src/io/storage_memory.rs

@@ -0,0 +1,43 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+use crate::Result;
+use opendal::{Operator, Scheme};
+use std::collections::HashMap;
+use std::fmt::{Debug, Formatter};
+
+#[derive(Default, Clone)]
+pub(crate) struct MemoryConfig {}
+
+impl Debug for MemoryConfig {
+    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
+        f.debug_struct("MemoryConfig").finish()
+    }
+}
+
+impl MemoryConfig {
+    /// Decode from iceberg props.
+    pub fn new(_: HashMap<String, String>) -> Self {
+        Self::default()
+    }
+
+    /// Build new opendal operator from given path.
+    pub fn build(&self, _: &str) -> Result<Operator> {
+        let m = HashMap::new();
+        Ok(Operator::via_map(Scheme::Memory, m)?)
+    }
+}

crates/iceberg/src/spec/datatypes.rs

@@ -17,7 +17,7 @@
 
 /*!
  * Data Types
-*/
+ */
 use crate::ensure_data_valid;
 use crate::error::Result;
 use crate::spec::datatypes::_decimal::{MAX_PRECISION, REQUIRED_LENGTH};

crates/iceberg/src/spec/partition.rs

@@ -17,7 +17,7 @@
 
 /*!
  * Partitioning
-*/
+ */
 use serde::{Deserialize, Serialize};
 use std::sync::Arc;
 use typed_builder::TypedBuilder;

crates/iceberg/src/spec/snapshot.rs

@@ -17,7 +17,7 @@
 
 /*!
  * Snapshots
-*/
+ */
 use crate::error::Result;
 use chrono::{DateTime, TimeZone, Utc};
 use serde::{Deserialize, Serialize};

crates/iceberg/src/spec/sort.rs

@@ -17,7 +17,7 @@
 
 /*!
  * Sorting
-*/
+ */
 use crate::error::Result;
 use crate::spec::Schema;
 use crate::{Error, ErrorKind};