osirisdb 0.7.0

A SQL database engine built from scratch in Rust featuring a custom parser, binder, query planner, optimizer, catalog, and storage engine.
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

use crate::{
    ast::{CreateDatabaseStmt, session::database_session::UseDatabaseStmt},
    common::symbol::Symbol,
};

/// A fully resolved and validated `CREATE DATABASE` statement.
///
/// Unlike [`CreateDatabaseStmt`] which is a raw parse-time snapshot,
/// `BoundCreateDatabaseStmt` has been validated against the catalog:
///
/// - Database name confirmed to not already exist (or IF NOT EXISTS noted)
/// - Owner resolved — guaranteed to be a valid role symbol
/// - Tablespace confirmed to exist if specified
/// - Connection limit validated to be >= -1
///
/// This is what the executor receives — no further validation needed.
#[derive(Debug, Clone, PartialEq)]
pub struct BoundCreateDatabaseStmt {
    /// Interned name of the database to create.
    pub name: Symbol,

    /// Whether to silently succeed if the database already exists.
    pub if_not_exists: bool,

    /// Resolved owner — always present.
    ///
    /// If the user specified `OWNER alice`, this is alice's symbol.
    /// If not specified, this is the session user's symbol.
    /// Guaranteed to be a valid role in the catalog.
    pub owner: Symbol,

    /// Optional encoding symbol e.g. `UTF8`, `SQL_ASCII`.
    pub encoding: Option<Symbol>,

    /// Optional locale symbol e.g. `en_US.UTF-8`.
    pub locale: Option<Symbol>,

    /// Optional tablespace symbol.
    ///
    /// If present, confirmed to exist in the catalog at bind time.
    pub tablespace: Option<Symbol>,

    /// Optional connection limit.
    ///
    /// Validated to be >= -1. `None` means unlimited.
    pub connection_limit: Option<i64>,
}

/// A fully resolved and validated `USE` statement.
///
/// Unlike [`UseDatabaseStmt`] which is a raw parse-time snapshot,
/// `BoundUseDatabaseStmt` has been verified against the catalog to ensure
/// that the target database actually exists and the user has access privileges.
///
/// The executor receives this to update the session context state.
#[derive(Debug, Clone, PartialEq)]
pub struct BoundUseDatabaseStmt {
    /// The validated name of the database to switch to.
    pub database_name: Symbol,
}

/// Converts a bound statement back into a raw AST statement for the catalog.
///
/// The bound statement has already resolved all defaults (e.g. owner),
/// so the resulting `CreateDatabaseStmt` has `owner` set to the resolved
/// value and `if_not_exists` preserved as-is.
impl From<BoundCreateDatabaseStmt> for CreateDatabaseStmt {
    fn from(b: BoundCreateDatabaseStmt) -> Self {
        CreateDatabaseStmt {
            name: b.name,
            if_not_exists: b.if_not_exists,
            owner: Some(b.owner), // owner is always resolved in bound stmt
            encoding: b.encoding,
            locale: b.locale,
            tablespace: b.tablespace,
            connection_limit: b.connection_limit,
        }
    }
}

/// Converts a bound `USE` statement back into a raw AST statement.
impl From<BoundUseDatabaseStmt> for UseDatabaseStmt {
    fn from(b: BoundUseDatabaseStmt) -> Self {
        UseDatabaseStmt {
            database_name: b.database_name,
        }
    }
}