别名

Drizzle 支持对表、列、子查询和 CTE 使用别名——这直接映射到 SQL 的 AS 关键字。

表别名

你可以使用 alias 函数为表指定别名。当你需要多次连接同一张表时，这很有用，例如在员工和其经理这样的自引用关系中：

import { alias, mysqlTable, int, text } from "drizzle-orm/mysql-core";

const employees = mysqlTable("employees", {
  id: int().autoincrement().primaryKey(),
  name: text(),
  managerId: int("manager_id"),
});

const manager = alias(employees, "manager");

await db.select({
  employeeName: employees.name,
  managerName: manager.name,
})
  .from(employees)
  .leftJoin(manager, eq(employees.managerId, manager.id));

select `employees`.`name`, `manager`.`name`
from `employees`
left join `employees` `manager` on `employees`.`manager_id` = `manager`.`id`;

列别名

你可以使用列上的 .as() 方法以及 sql 表达式来为列指定别名。这直接映射到 SQL 的 AS 关键字，并允许你控制查询结果中列的名称：

const result = await db.select({
  id: users.id,
  lowerName: users.name.as("lower_name"),
}).from(users);

select `id`, `name` as `lower_name` from `users`;

你也可以将 .as() 与 sql 表达式一起使用：

const result = await db.select({
  id: users.id,
  lowerName: sql<string>`lower(${users.name})`.as("lower_name"),
}).from(users);

select `id`, lower(`name`) as `lower_name` from `users`;

子查询别名

当将子查询用作数据源时，你必须使用 .as() 提供一个别名。这使你能够在外部查询中引用该子查询的列：

const sq = db.select().from(users).where(eq(users.id, 42)).as('sq');

const result = await db.select().from(sq);

select `id`, `name`, `age` from (select `id`, `name`, `age` from `users` where `users`.`id` = 42) `sq`;

子查询也可以用于连接中：

const sq = db.select().from(users).where(eq(users.id, 42)).as('sq');

const result = await db.select().from(users).leftJoin(sq, eq(users.id, sq.id));

select `users`.`id`, `users`.`name`, `users`.`age`, `sq`.`id`, `sq`.`name`, `sq`.`age`
  from `users`
  left join (select `id`, `name`, `age` from `users` where `users`.`id` = 42) `sq`
    on `users`.`id` = `sq`.`id`;

CTE 别名

公共表表达式（CTE）使用 db.$with('alias') 进行别名处理。该别名名称用于在主查询中引用 CTE：

const sq = db.$with('sq').as(db.select().from(users).where(eq(users.id, 42)));

const result = await db.with(sq).select().from(sq);

with `sq` as (select `id`, `name`, `age` from `users` where `users`.`id` = 42)
select `id`, `name`, `age` from `sq`;

当在 CTE 中使用 sql 表达式时，你需要用 .as() 为它们指定别名，才能在外部查询中引用它们：

const sq = db.$with('sq').as(db.select({
  name: sql<string>`upper(${users.name})`.as('name'),
}).from(users));

const result = await db.with(sq).select({ name: sq.name }).from(sq);

with `sq` as (select upper(`name`) as `name` from `users`)
select `name` from `sq`;