indexlake-catalog-postgres 0.2.0

IndexLake postgres catalog
Documentation
use bb8::Pool;
use bb8_postgres::PostgresConnectionManager;
use bb8_postgres::tokio_postgres::NoTls;
use futures::StreamExt;
use indexlake::catalog::{
    Catalog, CatalogDataType, CatalogDatabase, CatalogSchemaRef, Row, RowStream, Scalar,
    Transaction,
};
use indexlake::{ILError, ILResult};
use log::{error, trace};

#[derive(Debug, Clone)]
pub struct PostgresCatalog {
    pool: Pool<PostgresConnectionManager<NoTls>>,
}

impl PostgresCatalog {
    pub fn new(pool: Pool<PostgresConnectionManager<NoTls>>) -> Self {
        Self { pool }
    }
}

#[async_trait::async_trait]
impl Catalog for PostgresCatalog {
    fn database(&self) -> CatalogDatabase {
        CatalogDatabase::Postgres
    }

    async fn query(&self, sql: &str, schema: CatalogSchemaRef) -> ILResult<RowStream<'static>> {
        trace!("postgres query: {sql}");
        let conn = self
            .pool
            .get_owned()
            .await
            .map_err(|e| ILError::catalog(format!("failed to get postgres connection: {e}")))?;
        let pg_row_stream = conn
            .query_raw(sql, Vec::<String>::new())
            .await
            .map_err(|e| ILError::catalog(format!("failed to query postgres: {sql} {e}")))?;

        let stream = pg_row_stream.map(move |row| {
            let pg_row =
                row.map_err(|e| ILError::catalog(format!("failed to get postgres row: {e}")))?;
            pg_row_to_row(&pg_row, &schema)
        });
        Ok(Box::pin(stream))
    }

    async fn transaction(&self) -> ILResult<Box<dyn Transaction>> {
        let conn = self
            .pool
            .get_owned()
            .await
            .map_err(|e| ILError::catalog(format!("failed to get postgres connection: {e}")))?;
        conn.batch_execute("START TRANSACTION")
            .await
            .map_err(|e| ILError::catalog(format!("failed to start postgres txn: {e}")))?;
        Ok(Box::new(PostgresTransaction { conn, done: false }))
    }
}

#[derive(Debug)]
pub struct PostgresTransaction {
    conn: bb8::PooledConnection<'static, PostgresConnectionManager<NoTls>>,
    done: bool,
}

impl PostgresTransaction {
    fn check_done(&self) -> ILResult<()> {
        if self.done {
            return Err(ILError::catalog(
                "Transaction already committed or rolled back",
            ));
        }
        Ok(())
    }
}

#[async_trait::async_trait]
impl Transaction for PostgresTransaction {
    async fn query(&mut self, sql: &str, schema: CatalogSchemaRef) -> ILResult<RowStream> {
        trace!("postgres txn query: {sql}");
        self.check_done()?;

        let pg_row_stream = self
            .conn
            .query_raw(sql, Vec::<String>::new())
            .await
            .map_err(|e| ILError::catalog(format!("failed to query postgres: {sql} {e}")))?;

        let stream = pg_row_stream.map(move |row| {
            let pg_row =
                row.map_err(|e| ILError::catalog(format!("failed to get postgres row: {e}")))?;
            pg_row_to_row(&pg_row, &schema)
        });
        Ok(Box::pin(stream))
    }

    async fn execute(&mut self, sql: &str) -> ILResult<usize> {
        trace!("postgres txn execute: {sql}");
        self.check_done()?;
        self.conn
            .execute(sql, &[])
            .await
            .map(|r| r as usize)
            .map_err(|e| ILError::catalog(format!("failed to execute postgres: {sql} {e}")))
    }

    async fn execute_batch(&mut self, sqls: &[String]) -> ILResult<()> {
        trace!("postgres txn execute batch: {:?}", sqls);
        self.check_done()?;
        let sql = sqls.join(";");
        self.conn
            .batch_execute(&sql)
            .await
            .map_err(|e| ILError::catalog(format!("failed to execute batch postgres: {sql} {e}")))
    }

    async fn commit(&mut self) -> ILResult<()> {
        trace!("postgres txn commit");
        self.check_done()?;
        self.conn
            .batch_execute("COMMIT")
            .await
            .map_err(|e| ILError::catalog(format!("failed to commit postgres txn: {e}")))?;
        self.done = true;
        Ok(())
    }

    async fn rollback(&mut self) -> ILResult<()> {
        trace!("postgres txn rollback");
        self.check_done()?;
        self.conn
            .batch_execute("ROLLBACK")
            .await
            .map_err(|e| ILError::catalog(format!("failed to rollback postgres txn: {e}")))?;
        self.done = true;
        Ok(())
    }
}

impl Drop for PostgresTransaction {
    fn drop(&mut self) {
        if self.done {
            return;
        }
        tokio::task::block_in_place(|| {
            tokio::runtime::Handle::current().block_on(async move {
                if let Err(e) = self.conn.batch_execute("ROLLBACK").await {
                    error!("[indexlake] failed to rollback postgres txn: {e}");
                }
            });
        });
    }
}

fn pg_row_to_row(
    pg_row: &bb8_postgres::tokio_postgres::Row,
    schema: &CatalogSchemaRef,
) -> ILResult<Row> {
    let mut values = Vec::new();
    let err_mapping = |e: bb8_postgres::tokio_postgres::error::Error| {
        ILError::catalog(format!("failed to get row value: {e}"))
    };
    for (idx, field) in schema.columns.iter().enumerate() {
        let scalar = match field.data_type {
            CatalogDataType::Boolean => {
                let v: Option<bool> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Boolean(v)
            }
            CatalogDataType::Int8 => {
                let v: Option<i16> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Int8(v.map(|v| v as i8))
            }
            CatalogDataType::Int16 => {
                let v: Option<i16> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Int16(v)
            }
            CatalogDataType::Int32 => {
                let v: Option<i32> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Int32(v)
            }
            CatalogDataType::Int64 => {
                let v: Option<i64> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Int64(v)
            }
            CatalogDataType::UInt8 => {
                let v: Option<i16> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::UInt8(v.map(|v| v as u8))
            }
            CatalogDataType::UInt16 => {
                let v: Option<i32> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::UInt16(v.map(|v| v as u16))
            }
            CatalogDataType::UInt32 => {
                let v: Option<i64> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::UInt32(v.map(|v| v as u32))
            }
            CatalogDataType::UInt64 => {
                let v: Option<f32> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::UInt64(v.map(|v| v as u64))
            }
            CatalogDataType::Float32 => {
                let v: Option<f32> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Float32(v)
            }
            CatalogDataType::Float64 => {
                let v: Option<f64> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Float64(v)
            }
            CatalogDataType::Utf8 => {
                let v: Option<String> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Utf8(v)
            }
            CatalogDataType::Binary => {
                let v: Option<Vec<u8>> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Binary(v)
            }
            CatalogDataType::Uuid => {
                let v: Option<uuid::Uuid> = pg_row.try_get(idx).map_err(err_mapping)?;
                Scalar::Binary(v.map(|v| v.as_bytes().to_vec()))
            }
        };
        if !field.nullable && scalar.is_null() {
            return Err(ILError::catalog(format!(
                "column {} is not nullable but got null value",
                field.name
            )));
        }
        values.push(scalar);
    }
    Ok(Row::new(schema.clone(), values))
}