Skip to main content

yang_db/postgres/
mod.rs

1// PostgreSQL 数据库模块
2//
3// 与 `mysql` 模块保持一致的 API 形态:`Database` / `QueryBuilder` / `Transaction`
4// 等类型在本模块内同名,使 `yang_db::postgres::Database::connect(...)` 与
5// `yang_db::mysql::Database::connect(...)` 的调用方式完全一致。
6//
7// 方言差异(集中体现,便于审阅):
8// - 占位符:PostgreSQL 使用编号占位符 `$1`、`$2` ……(见 `condition.rs`),
9//   MySQL 使用 `?`。
10// - 自增主键:`insert()` 通过 `RETURNING` 子句取回生成的主键,而非 MySQL 的
11//   `last_insert_id()`。
12// - UPSERT:使用 `INSERT ... ON CONFLICT (...) DO UPDATE SET col = EXCLUDED.col`,
13//   而非 MySQL 的 `ON DUPLICATE KEY UPDATE`。
14// - 聚合:`sum`/`avg` 使用 `CAST(... AS DOUBLE PRECISION)`,而非 MySQL 的 `DOUBLE`。
15
16pub mod condition;
17pub mod copy;
18pub mod database;
19pub mod field;
20pub mod identifier;
21pub mod init;
22pub mod listener;
23pub(crate) mod params;
24pub mod query_builder;
25pub mod transaction;
26
27// 重新导出核心类型
28#[allow(deprecated)]
29pub use condition::{
30    condition_to_sql_owned, condition_to_sql_owned_checked, ComparisonOperator, Condition,
31    SqlValue, Subquery,
32};
33pub use database::{
34    ActiveQuery, CancelToken, Database, DatabaseConfig, LockWait, PgAdvisoryLock, PgRowCursor,
35    SslMode,
36};
37pub use field::FieldType;
38pub use identifier::{is_valid_identifier, quote_identifier, quote_qualified, quote_table};
39pub use init::split_sql_script;
40pub use listener::{Notification, PgNotificationListener};
41pub use query_builder::QueryBuilder;
42pub use transaction::{TableLockMode, Transaction, TransactionOptions};