ORM（Object-Relational Mapping，对象关系映射）是一种编程技术，用于在关系型数据库和面向对象编程语言之间转换或映射数据。SQL 和关系型数据库与 ORM 配合得非常好，因为它们允许应用程序使用面向对象的技术来管理数据库。

在 SQL 和关系型数据库的背景下，这种映射的概念出现在尝试将关系型数据库概念转换为面向对象概念时。

其工作原理如下：

1. 表变为类： 在面向对象框架中，类用于定义对象。在关系型数据库中，这些类通常直接与数据库表相关联。
2. 行变为对象： 正如数据库表中的每一行代表一个单一项目一样，类的一个实例（或对象）代表应用程序中的一个单一项目。
3. 列变为对象属性： 表中为每个项目存储的各个数据片段（即列），在应用程序中成为对象的属性。

ORM 通过引入一个可以使用流行的面向对象范式进行操作的“虚拟对象数据库”，解决了面向对象世界与关系型世界之间的不匹配问题。

使用 ORM 的一个主要优势是，它们使开发人员能够使用高级编程语言进行工作，从而简化了代码并降低了出错的可能性。这包括在底层数据库中创建、读取、更新和删除记录。如果数据库结构发生变化，ORM 还可以帮助封装数据库结构并将更改隔离在一个地方。

然而，ORM 可能会带来性能损失，并且可能不适合具有复杂查询或密集型数据库操作的应用程序，因为它们可能无法像手写 SQL 那样有效地优化 SQL 查询。

ORM 的示例包括 Java 中的 Hibernate、JavaScript 中的 Sequelize 和 Python 中的 SQLAlchemy。开发人员通常会选择适合其项目需求和首选编程语言的 ORM。

总之，在 SQL 和关系型数据库中使用 ORM 有助于简化数据管理，并创建更具可扩展性和可维护性的应用程序。但是，在选择时应审慎考虑应用程序的复杂性和性能要求。

数据库迁移是指对应用于数据库的更改或修改的管理。此过程主要处理数据库模式中的任何更改或更新。然而，它也涉及改变数据库状态和结构的各个方面，如添加、更改、删除列和表、索引、数据转换等。

之所以使用“迁移”一词，是因为这些更改或修改可以在不同的机器和系统之间移动，通常是从开发环境移动到生产环境。

迁移可能出于多种原因，例如增强数据库功能、更改数据库结构以匹配新的业务需求、解决错误或提高系统性能。

为了管理这些迁移，人们使用工具和软件来帮助将更改应用到数据库。它们还允许在出现错误或问题时进行回滚，使其成为现代数据库管理和软件开发生命周期中不可或缺的一部分。

数据库迁移的目标是在不阻碍或最小化应用程序停机时间的情况下，将数据库模式和数据从一个环境传输到另一个环境。

总的来说，数据库迁移对于在整个生命周期中维护数据库的完整性、性能和健康状况至关重要。

1. SQL 驱动程序：SQL 驱动程序充当软件应用程序与数据库之间的接口或桥梁。它们是使程序能够与数据库进行通信和交互的软件组件。SQL 驱动程序允许应用程序使用 SQL 命令与数据库建立连接、读取、写入、验证身份并执行事务。在实践中，各种类型的 SQL 驱动程序包括用于 Java 应用程序的 JDBC（Java 数据库连接）驱动程序、用于使用 ODBC API 的应用程序的 ODBC（开放数据库连接）驱动程序，以及用于 .NET 应用程序的 ADO.NET 驱动程序。 例如，如果您正在构建一个与 MySQL 数据库交互的 Java 应用程序，则需要一个专门为 MySQL 数据库实现 JDBC API 的 JDBC 驱动程序。该驱动程序了解如何将 Java 应用程序中的函数调用、例程和 SQL 命令转换为 MySQL 数据库能够有效理解和处理的格式。
2. SQL 方言：SQL 方言是指特定数据库管理系统（DBMS）所使用的 SQL（结构化查询语言）的变体或版本。SQL 是一种用于管理和操作关系型数据库的标准化语言。虽然 ANSI（美国国家标准协会）为 SQL 提供了一个标准，确保了在不同系统间的一致使用，但每个 DBMS 通常会在基础 SQL 之上引入额外的专有功能或语法，从而导致了不同的 SQL 方言。 例如，MySQL、Oracle Database、PostgreSQL 和 SQL Server 都有其独特的 SQL 方言。虽然基础的 SQL 命令（如 `SELECT`、`UPDATE`、`DELETE`、`INSERT` 和 `WHERE`）在所有 SQL 方言中通常相同，但在高级功能（如错误处理、存储过程和字符串连接语法）方面存在差异。这意味着开发人员必须了解他们正在使用的特定 SQL 方言，尤其是在迁移或集成不同的数据库系统时。

ActiveRecord**、**Ecto**、**SqlAlchemy**、**Drizzle 依赖于静态模型的概念，因为模型在使用前必须先定义。

Knex 和 HoneySQL 都非常适合执行即席查询，因为它们允许构建任意 SQL 语句，而无需 模型 或在应用程序内处理 SQL 字符串。

Conman 在我们所有的选项中提供了最终的控制权，因为我们可以直接利用 手写 的 SQL 查询和语句。

services:
  db:
    container_name: ubntth_pg
    image: postgres
    restart: always
    environment:
      POSTGRES_USER: root
      POSTGRES_PASSWORD: root
      POSTGRES_DB: ubntth_db
    ports:
      - "5432:5432"
  pgadmin:
    container_name: ubntth_pgadmin4
    image: dpage/pgadmin4
    restart: always
    environment:
      PGADMIN_DEFAULT_EMAIL: root@admin.com
      PGADMIN_DEFAULT_PASSWORD: root
    ports:
      - "5050:80"

export DB_HOST=127.0.0.1
export DB_PORT=5432
export DB_USER=root
export DB_PASS=root
export DB_NAME=ubntth_db
export DB_URL=postgres://root:root@127.0.0.1:5432/ubntth_db

{
  "name": "orms_and_migrations",
  "version": "1.0.0",
  "description": "ORMs and Migrations",
  "main": "run.mjs",
  "scripts": {
    "dev": "bun run.mjs",
    "gen:migration": "drizzle-kit generate:pg --schema=./schema.mjs",
    "run:migration": "bun ./src/schema.mjs",
    "drizzle-studio": "bunx drizzle-kit studio",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [
    "PostgresSQL",
    "Javascript",
    "SQL",
    "Databases"
  ],
  "author": "ChiefKemist",
  "license": "ISC",
  "dependencies": {
    "drizzle-orm": "^0.28.6",
    "elysia": "^0.6.19",
    "pg": "^8.11.3"
  },
  "devDependencies": {
    "@types/pg": "^8.10.2",
    "drizzle-kit": "^0.19.13"
  }
}

/** @type { import("drizzle-kit").Config } */
export default {
  schema: "./schema.mjs",
  driver: 'pg',
  dbCredentials: {
    connectionString: Bun.env.DB_URL,
  }
};

import { drizzle } from "drizzle-orm/node-postgres";
import { Client } from "pg";

export const connect = () => {
    const client = new Client({
        connectionString: "postgres://user:password@host:port/db",
    });

    // or
    const client = new Client({
        host: Bun.env.DB_HOST,
        port: Bun.env.DB_PORT,
        user: Bun.env.DB_USER,
        password: Bun.env.DB_PASS,
        database: Bun.env.DB_NAME,
    });

    await client.connect();
    const db = drizzle(client);

    return db
};

import { pgTable, serial, text, varchar } from "drizzle-orm/pg-core";

export const users = pgTable('users', {
  id: serial('id').primaryKey(),
  fullName: varchar('full_name', { length: 256 }),
  //phone: varchar('phone', { length: 256 }),
}, (users) => ({
  nameIdx: index('name_idx').on(users.fullName),
}));

//export const accounts = pgTable('accounts', {
//  id: serial('id').primaryKey(),
//  bankName: varchar('bank_name', { length: 256 }),
//  //accountNumber: varchar('account_number', { length: 256 }),
//  userId: int('user_id').references(() => users.id),
//});

import { drizzle } from "drizzle-orm/postgres-js";
import { migrate } from "drizzle-orm/postgres-js/migrator";
import postgres from "postgres";
import { connect } from "./connection"l

//const sql = postgres("...", { max: 1 })
//const db = drizzle(sql);

const db = connect();

await migrate(db, { migrationsFolder: "drizzle" });