Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

6.9 KB
Raw Blame
use crate::models::connection::DatabaseType;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum TablePaginationStrategy {
    LimitOffset,
    FetchFirst,
    Db2FetchFirst,
    SqlServerTop,
    IrisTop,
    InformixFirst,
    FirebirdRows,
    Rownum,
    QuestDbLimit,
    Unbounded,
    AgentMaxRows,
}

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum PaginationContext {
    TablePreview,
    BoundedRead,
    UserQuery,
}

pub fn is_schema_aware(database_type: DatabaseType) -> bool {
    matches!(
        database_type,
        DatabaseType::Postgres
            | DatabaseType::SqlServer
            | DatabaseType::Oracle
            | DatabaseType::Redshift
            | DatabaseType::Dameng
            | DatabaseType::Gaussdb
            | DatabaseType::Kwdb
            | DatabaseType::Kingbase
            | DatabaseType::Highgo
            | DatabaseType::Uxdb
            | DatabaseType::Gbase8c
            | DatabaseType::Vastbase
            | DatabaseType::Yashandb
            | DatabaseType::Oscar
            | DatabaseType::Databricks
            | DatabaseType::SapHana
            | DatabaseType::Teradata
            | DatabaseType::Vertica
            | DatabaseType::Exasol
            | DatabaseType::OpenGauss
            | DatabaseType::OceanbaseOracle
            | DatabaseType::Gbase
            | DatabaseType::Gbase8s
            | DatabaseType::Databend
            | DatabaseType::Jdbc
            | DatabaseType::H2
            | DatabaseType::Snowflake
            | DatabaseType::Trino
            | DatabaseType::PrestoSql
            | DatabaseType::Hive
            | DatabaseType::Kyuubi
            | DatabaseType::Impala
            | DatabaseType::Argo
            | DatabaseType::Transwarp
            | DatabaseType::Spark
            | DatabaseType::Db2
            | DatabaseType::Informix
            | DatabaseType::Tdengine
            | DatabaseType::Xugu
            | DatabaseType::Sqlite
            | DatabaseType::DuckDb
            | DatabaseType::Iris
            // Spanner supports named schemas; the PostgreSQL dialect defaults to `public`.
            // GoogleSQL's default schema is the empty string, which the blank-schema filters
            // in `qualified_table_name` / `table_data_qualified_table_name` drop along with
            // the dot separator (`` `s`.`t` `` with an empty `s` is a Spanner syntax error).
            | DatabaseType::Spanner
    )
}

pub fn uses_fetch_first(database_type: DatabaseType) -> bool {
    matches!(database_type, DatabaseType::Oracle | DatabaseType::Dameng | DatabaseType::Db2)
}

pub fn uses_oracle_row_id(database_type: Option<DatabaseType>) -> bool {
    matches!(database_type, Some(DatabaseType::Oracle | DatabaseType::OceanbaseOracle))
}

/// Xugu exposes an unqualified ROWID pseudo-column for base, partitioned and
/// temporary tables. It is intentionally separate from Oracle's ROWIDTOCHAR
/// representation because qualified ROWID and ROWIDTOCHAR are not supported
/// by Xugu.
pub fn uses_xugu_row_id(database_type: Option<DatabaseType>) -> bool {
    database_type == Some(DatabaseType::Xugu)
}

/// PostgreSQL exposes `ctid` on ordinary tables. Pair it with `tableoid` to
/// distinguish inherited relations and `xmin` to reject a recycled tuple location.
pub fn uses_postgres_ctid(database_type: Option<DatabaseType>) -> bool {
    database_type == Some(DatabaseType::Postgres)
}

pub fn uses_synthetic_row_id(database_type: Option<DatabaseType>) -> bool {
    uses_oracle_row_id(database_type) || uses_xugu_row_id(database_type) || uses_postgres_ctid(database_type)
}

/// Oracle 系方言不支持 `INSERT ... VALUES (...), (...)` 多行语法,
/// 复制为 INSERT 与导出 INSERT 都需按行生成单条语句。
pub fn uses_single_row_insert_statements(database_type: DatabaseType) -> bool {
    matches!(database_type, DatabaseType::Oracle | DatabaseType::OceanbaseOracle)
}

pub fn pagination_strategy(database_type: Option<DatabaseType>, context: PaginationContext) -> TablePaginationStrategy {
    match database_type {
        Some(DatabaseType::Jdbc) => TablePaginationStrategy::AgentMaxRows,
        Some(DatabaseType::Cassandra)
            if matches!(context, PaginationContext::TablePreview | PaginationContext::UserQuery) =>
        {
            TablePaginationStrategy::AgentMaxRows
        }
        // Oracle's row-limiting clause (`FETCH FIRST`/`OFFSET ... FETCH`) was
        // introduced in 12c. ROWNUM remains compatible with the supported 11g
        // baseline while still providing a bounded read and user query pagination (#12789).
        Some(DatabaseType::Oracle) => TablePaginationStrategy::Rownum,
        // OSCAR (神通) rejects a statement that mixes its ROWNUM pseudo-column
        // with a LIMIT. The JDBC agent caps every table-data statement with
        // `Statement.setMaxRows()`, which the OSCAR driver forwards as a row
        // limit, so a ROWNUM-wrapped later page (its inner bound is
        // `offset + limit`, above the driver cap) collides. OSCAR supports
        // `LIMIT n OFFSET m` directly, so table previews use that single
        // pagination form instead of ROWNUM. Bounded reads (export, compare,
        // transfer) do not set the driver cap, so they keep ROWNUM.
        Some(DatabaseType::Oscar) if matches!(context, PaginationContext::TablePreview) => {
            TablePaginationStrategy::LimitOffset
        }
        Some(DatabaseType::Oscar) if matches!(context, PaginationContext::BoundedRead) => {
            TablePaginationStrategy::Rownum
        }
        Some(DatabaseType::Oscar) => TablePaginationStrategy::Unbounded,
        Some(DatabaseType::Dameng) => TablePaginationStrategy::Rownum,
        Some(DatabaseType::Db2) => TablePaginationStrategy::Db2FetchFirst,
        Some(DatabaseType::SqlServer) => TablePaginationStrategy::SqlServerTop,
        Some(DatabaseType::Iris) => TablePaginationStrategy::IrisTop,
        Some(DatabaseType::Informix | DatabaseType::Gbase8s) => TablePaginationStrategy::InformixFirst,
        Some(DatabaseType::Firebird) => TablePaginationStrategy::FirebirdRows,
        Some(DatabaseType::OceanbaseOracle) => TablePaginationStrategy::Rownum,
        Some(DatabaseType::Questdb) => TablePaginationStrategy::QuestDbLimit,
        _ => TablePaginationStrategy::LimitOffset,
    }
}

pub fn table_pagination_strategy(database_type: Option<DatabaseType>) -> TablePaginationStrategy {
    pagination_strategy(database_type, PaginationContext::TablePreview)
}

pub(super) fn is_simple_informix_identifier(name: &str) -> bool {
    let mut chars = name.chars();
    let Some(first) = chars.next() else {
        return false;
    };
    (first.is_ascii_alphabetic() || first == '_')
        && chars.all(|ch| ch.is_ascii_alphanumeric() || ch == '_' || ch == '$')
}

pub fn firebird_rows_clause(limit: usize, offset: usize) -> String {
    if offset > 0 {
        let start = offset + 1;
        let end = offset + limit;
        format!("ROWS {start} TO {end}")
    } else {
        format!("ROWS {limit}")
    }
}