// 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进行分析。

默认无功能

为了实际运行事务，必须指定所需的功能，否则您将获得一大堆不会做很多事情的代码。请参阅支持的后端。

cargo install oapth-cli
oapth migrate # Will do nothing

支持的后端

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

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。