Skip to main content

Backend

Enum Backend 

Source
pub enum Backend {
    Sqlite,
    Postgres,
    MySql,
}
Expand description

支持的后端

Variants§

§

Sqlite

§

Postgres

§

MySql

Implementations§

Source§

impl Backend

Source

pub const ID_MAX: usize = 128

Self::id_text 列能装多少个字符

Source

pub const ID_SHORT_MAX: usize = 45

Self::id_short 列能装多少个字符

Source

pub fn from_url(url: &str) -> Self

Source

pub fn id_text(&self) -> &'static str

主键/索引列的字符串类型。

MySQL 不能对 TEXT 建索引(1170:要 key length),必须用定长 VARCHAR。 128 跟 DTM 的 varchar(128) 对齐;复合主键三列合计仍在 InnoDB 限内。

Source

pub fn id_short(&self) -> &'static str

短标识列(op 之类),MySQL 下不必给到 128

Source

pub fn text(&self, n: usize) -> String

自由文本列(payload / url / 原因之类)。

MySQL 上只能用 VARCHAR:经 sqlx::Any 读 MySQL 的 TEXT (含 LONGTEXTMEDIUMTEXT、显式 CHARACTER SET utf8mb4)一律报 mismatched types; Rust type String is not compatible with SQL type BLOB。 五种写法实测下来只有 VARCHAR 能解成 String。

代价是有长度上限:n 要够装最长的内容。MySQL 单行还有 65535 字节的 总限制(utf8mb4 每字符 4 字节),所以别把每列都开得很大。

Source

pub fn q(&self, template: &str) -> String

把 SQL 模板渲染成这个后端能吃的语句。

做三件事:

  1. ?$1..$n(MySQL 保持 ?
  2. {INS}INSERT IGNORE INTO(MySQL)/ INSERT INTO(其它)
  3. {NOCONFLICT} → 空(MySQL)/ ON CONFLICT DO NOTHING(其它)
Source

pub fn create_index( &self, name: &str, table: &str, cols: &str, ) -> Option<String>

建索引。MySQL 不支持 CREATE INDEX IF NOT EXISTS,只能靠 建表时内联 KEY,所以这里对 MySQL 返回 None

Source

pub fn inline_index(&self, name: &str, cols: &str) -> String

建表时内联的索引定义。只有 MySQL 用得上(见 Self::create_index)。

Source

pub fn skip_locked(&self) -> &'static str

抢占待办事务时用的行锁后缀。

§为什么非要有这个

抢占是「先 SELECT 出最该跑的那笔,再 UPDATE 占坑」。不加锁的话, N 个推进 worker 的 SELECT 会全部选中同一行,然后挤在 UPDATE 上排队,最后只有一个成功、其余白跑一轮。实测 Postgres 上 1 个 worker 71 笔/秒、8 个也才 127 笔/秒 —— 并行度基本没了。

FOR UPDATE SKIP LOCKED 让每个 worker 自动跳过别人正在抢的行, 各拿各的,这才是真并行。

  • Postgres 9.5+ / MySQL 8.0+ 都支持
  • sqlite 返回空串:它没有行锁,写操作本来就是全库串行的, 加了也没用(语法上还不认)

Trait Implementations§

Source§

impl Clone for Backend

Source§

fn clone(&self) -> Backend

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for Backend

Source§

impl Debug for Backend

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Display for Backend

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Eq for Backend

Source§

impl PartialEq for Backend

Source§

fn eq(&self, other: &Backend) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Backend

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.