Expand description
数据库管理模块
提供基于 crate::table::TableDefinition 的声明式 Schema 同步功能。
§主要组件
AnyDatabase:运行时数据库后端容器(MySQL / PostgreSQL,需启用mysql或postgres)AnyPool:与后端共享连接池的可克隆句柄,供受保护查询层使用AnyTransaction:两种后端事务的统一句柄DatabaseInitializer:声明式 Schema 同步器(MySQL / PostgreSQL,按后端分派方言)
§后端支持范围
mysql 与 postgres feature 均可单独启用并编译 Schema 同步。PostgreSQL 的
DDL 在单事务内执行、使用 pg_advisory_lock(bigint) 串行化多实例启动;原生
枚举、部分/表达式索引与 opaque 存量列按声明式规则演进。Record 解码与受保护
TableQuery / 内置 CRUD 的 PostgreSQL 执行层均已接入。
§示例
ⓘ
use yang_base::database::DatabaseInitializer;
use yang_db::Database;
let db = Database::connect("mysql://user:pass@localhost/db").await?;
let initializer = DatabaseInitializer::new(db);
initializer.sync_table_definitions(&table_definitions).await?;Structs§
- AnyDatabase
- 持有单个关系数据库连接池的运行时容器。
- AnyTransaction
- 两种后端事务的统一句柄,并携带逻辑数据源身份。
- Database
Initializer - 持有数据库连接并执行
crate::table::TableDefinition声明的结构同步。 - Datasource
- 单个具名数据源。
- Datasource
Health - 单个数据源的健康快照(比
ToolsHealth的扁平资源列表更易按源读取)。 - Datasource
Pool Status - 单个数据源的连接池状态快照。
- Datasource
Registry - 应用持有的全部具名数据源。
- PgAdoption
Column - 单列报告。
- PgAdoption
Index - 单索引报告。
- PgAdoption
Report - 整个 schema 的接入报告。
- PgAdoption
Table - 单表报告。
- Pool
Handle - 带逻辑数据源身份的连接池句柄。
- Schema
Binding Change - 一次同步后写入的所有权绑定。
- Schema
Data Violation - 一项阻止 Schema 更新的旧数据问题。
- Schema
Preflight Report - 只读 Schema 预检结果。
- Schema
Sync Change - 一项实际执行的 schema 变更。
- Schema
Sync Report - 启动期 schema 同步报告。
Enums§
- AnyPool
- 可克隆的连接池句柄,按运行时后端分派。
- Schema
Binding Mode - 表的所有权模式。
- Schema
Sync Change Kind - schema 同步变更类型。
Functions§
- describe_
postgres_ schema - 只读扫描 PostgreSQL schema 并生成接入报告。
- preflight_
table_ definitions_ grouped - 按表声明的逻辑数据源分组执行只读 schema 预检;任一源失败立即返回错误。
- preflight_
table_ definitions_ grouped_ outcomes - 按表声明的逻辑数据源分组执行只读 schema 预检。
- sync_
table_ definitions_ grouped - 按表声明的逻辑数据源分组执行 schema 同步;任一源失败立即返回错误。
- sync_
table_ definitions_ grouped_ outcomes - 按表声明的逻辑数据源分组执行 schema 同步。