Skip to main content

Module database

Module database 

Source
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
两种后端事务的统一句柄,并携带逻辑数据源身份。
DatabaseInitializer
持有数据库连接并执行 crate::table::TableDefinition 声明的结构同步。
Datasource
单个具名数据源。
DatasourceHealth
单个数据源的健康快照(比 ToolsHealth 的扁平资源列表更易按源读取)。
DatasourcePoolStatus
单个数据源的连接池状态快照。
DatasourceRegistry
应用持有的全部具名数据源。
PgAdoptionColumn
单列报告。
PgAdoptionIndex
单索引报告。
PgAdoptionReport
整个 schema 的接入报告。
PgAdoptionTable
单表报告。
PoolHandle
带逻辑数据源身份的连接池句柄。
SchemaBindingChange
一次同步后写入的所有权绑定。
SchemaDataViolation
一项阻止 Schema 更新的旧数据问题。
SchemaPreflightReport
只读 Schema 预检结果。
SchemaSyncChange
一项实际执行的 schema 变更。
SchemaSyncReport
启动期 schema 同步报告。

Enums§

AnyPool
可克隆的连接池句柄,按运行时后端分派。
SchemaBindingMode
表的所有权模式。
SchemaSyncChangeKind
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 同步。