indexlake 0.6.0

An experimental table format with extensible index support.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

use std::panic::Location;

pub type ILResult<T> = Result<T, ILError>;

#[derive(Debug)]
pub enum ILError {
    InternalError(String, &'static Location<'static>),
    NotSupported(String, &'static Location<'static>),
    CatalogError(String, &'static Location<'static>),
    StorageError(String, &'static Location<'static>),
    IndexError(String, &'static Location<'static>),
    InvalidInput(String, &'static Location<'static>),
}

impl ILError {
    #[track_caller]
    pub fn internal(msg: impl Into<String>) -> Self {
        ILError::InternalError(msg.into(), Location::caller())
    }

    #[track_caller]
    pub fn not_supported(msg: impl Into<String>) -> Self {
        ILError::NotSupported(msg.into(), Location::caller())
    }

    #[track_caller]
    pub fn catalog(msg: impl Into<String>) -> Self {
        ILError::CatalogError(msg.into(), Location::caller())
    }

    #[track_caller]
    pub fn storage(msg: impl Into<String>) -> Self {
        ILError::StorageError(msg.into(), Location::caller())
    }

    #[track_caller]
    pub fn index(msg: impl Into<String>) -> Self {
        ILError::IndexError(msg.into(), Location::caller())
    }

    #[track_caller]
    pub fn invalid_input(msg: impl Into<String>) -> Self {
        ILError::InvalidInput(msg.into(), Location::caller())
    }
}

impl std::fmt::Display for ILError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            ILError::InternalError(msg, loc) => write!(f, "Internal error: {msg} at {loc}"),
            ILError::NotSupported(msg, loc) => write!(f, "Not supported: {msg} at {loc}"),
            ILError::CatalogError(msg, loc) => write!(f, "Catalog error: {msg} at {loc}"),
            ILError::StorageError(msg, loc) => write!(f, "Storage error: {msg} at {loc}"),
            ILError::IndexError(msg, loc) => write!(f, "Index error: {msg} at {loc}"),
            ILError::InvalidInput(msg, loc) => write!(f, "Invalid input: {msg} at {loc}"),
        }
    }
}

impl std::error::Error for ILError {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        None
    }
}

impl From<parquet::errors::ParquetError> for ILError {
    #[track_caller]
    fn from(err: parquet::errors::ParquetError) -> Self {
        ILError::StorageError(err.to_string(), Location::caller())
    }
}

impl From<arrow::error::ArrowError> for ILError {
    #[track_caller]
    fn from(err: arrow::error::ArrowError) -> Self {
        ILError::InternalError(err.to_string(), Location::caller())
    }
}

impl From<tokio::task::JoinError> for ILError {
    #[track_caller]
    fn from(err: tokio::task::JoinError) -> Self {
        ILError::InternalError(format!("Tokio join error: {err}"), Location::caller())
    }
}

impl From<uuid::Error> for ILError {
    #[track_caller]
    fn from(err: uuid::Error) -> Self {
        ILError::InternalError(format!("UUID error: {err}"), Location::caller())
    }
}

#[cfg(feature = "datafusion")]
impl From<ILError> for datafusion_common::DataFusionError {
    fn from(err: ILError) -> Self {
        datafusion_common::DataFusionError::External(Box::new(err))
    }
}