// oapth = { features = ["with-sqlx-postgres", "with-sqlx-runtime-async-std"], version = "SOME_VERSION" }

use oapth::{Commands, Config, SqlxPostgres};
use std::path::Path;

#[async_std::main]
async fn main() -> oapth::Result<()> {
    let config = Config::with_url_from_default_var()?;
    let mut commands = Commands::new(SqlxPostgres::new(&config).await?);
    commands.migrate_from_dir(Path::new("my_custom_migration_group_path"), 128).await?;
    Ok(())
}

值得注意的是，这些强制依赖项可能已经作为瞬态部分包含在您的应用程序中。如有疑问，请检查您的Cargo.lock文件或使用cargo tree进行分析。

默认无功能特性

为了实际运行事务，有必要指定所需的功能，否则您将获得大量不会做太多的事情的代码。请参阅支持的 backs。

cargo install oapth-cli
oapth migrate # Will do nothing

支持的backs

每个后端在库使用时都有一个可选的功能

oapth = { features = ["with-tokio-postgres"], version = "SOME_VERSION" }

• Diesel（MariaDB/Mysql） - with-diesel-mssql
• Diesel（PostgreSQL） - with-diesel-mysql
• Diesel（SQLite） - with-diesel-postgres
• mysql_async - with-mysql_async
• rusqlite - with-rusqlite
• SQLx（MariaDB/MySql） - with-sqlx-mysq
• SQLx（MS-SQL） - with-sqlx-mssql
• SQLx（PostgreSQL） - with-sqlx-postgres
• SQLx（SQLite） - with-sqlx-sqlite
• tiberius - with-tiberius
• tokio-postgres - with-tokio-postgres

或者在安装CLI二进制文件时

cargo install oapth-cli --features "postgres"

• mssql
• mysql
• postgres
• sqlite

Diesel支持

仅支持迁移，并且模式打印仍在开发中。对于任何不受支持的用例，请使用官方的Diesel CLI二进制文件。

命名空间/模式

对于支持的数据库，没有直接的用户参数可以将迁移插入单个数据库模式中，但可以在SQL文件中指定模式，并按照最适合您的方式安排迁移组结构。

-- oapth UP

CREATE SCHEMA cool_department_schema;

CREATE TABLE cool_department_schema.author (
  id INT NOT NULL PRIMARY KEY,
  full_name VARCHAR(50) NOT NULL
);

-- oapth DOWN

DROP TABLE cool_department_schema.author;
DROP SCHEMA cool_department_schema;

迁移时区

对于PostgreSQL（除Diesel外），迁移时间戳以数据库中声明的时间区存储和检索。对于其他所有内容，时间戳为UTC。