如何在NestJS(TypeORM)中查询SQL Server已存在的数据库视图？

正确的映射方式 #

直接使用@ViewEntity装饰器指定数据库中已存在的视图名称，同时确保实体类的字段与视图列一一对应即可，完全不需要expression参数。示例代码如下：

import { ViewEntity, Column, BaseEntity } from 'typeorm';

@ViewEntity({ name: 'database_view' }) // 这里指定数据库中已存在的视图名称
export class DatabaseView extends BaseEntity {
  @Column()
  col1: string;

  // 按数据库视图的实际列定义其他字段
}

这种方式下TypeORM会直接映射到已有视图，不会尝试创建或修改它，完全满足你无需重建视图的需求。

分析你提到的两种实现方式 #

• 用expression: 'select * from database_view'的写法属于变通方案，本质是让TypeORM创建一个基于现有视图的新视图（如果开启schema同步的话），既多余又可能带来维护隐患，不推荐使用。
• 仅写@ViewEntity()不指定参数的情况，TypeORM会默认用类名作为视图名称（比如类名View对应视图view），如果数据库中恰好有同名视图确实能运行，但这种方式不够明确，类名变更后会直接导致映射失效，不适合生产环境。

关于文档歧义的说明 #

TypeORM文档的描述确实容易混淆：第一句“View entity是映射到数据库视图的类”明确了它的映射能力，第二句“创建视图实体”实际指的是在代码中定义对应视图的实体类，并非要求你通过代码创建数据库视图。只要你关闭TypeORM的schema同步（synchronize: false），或者在迁移配置中排除该视图，就不会触发视图的重建操作。

额外注意事项 #

• 确保TypeORM的schema同步配置为关闭状态，或使用迁移工具时不包含该视图实体的同步逻辑，避免意外修改数据库中的现有视图。
• 实体类的字段类型、名称必须和数据库视图的列严格匹配，否则会出现查询报错。

内容的提问来源于stack exchange，提问作者Sven