How to add a raw PostgreSQL function to a query builder join in TypeORM?

在TypeORM中使用查询生成器添加原始的PostgreSQL函数可以让开发者直接使用数据库自带的功能进行复杂的查询操作，这是非常强大且灵活的。要在TypeORM的查询生成器中使用原始的PostgreSQL函数，我们可以使用raw方法。以下是一个具体的例子，展示如何在一个查询中加入PostgreSQL的LOWER函数，该函数用于将文本数据转化为小写。

示例

假设我们有一个名为User的实体，其中包含字段firstName和lastName。现在我们想要基于小写的firstName来搜索用户。我们可以这样做：

typescript
import { getConnection } from "typeorm";

// 创建QueryBuilder
const userRepository = getConnection().getRepository(User);
const users = await userRepository
  .createQueryBuilder("user")
  .where("LOWER(user.firstName) = LOWER(:firstName)", { firstName: 'alice' })
  .getMany();

console.log(users);

在这个例子中，我们使用了LOWER函数来确保在比较时忽略大小写的差异。LOWER(user.firstName)会将数据库中firstName字段的每个值转换为小写，并将其与小写的输入参数'alice'相比较。

扩展示例：使用更复杂的函数

如果需要使用更复杂的PostgreSQL函数或者表达式，我们同样可以通过raw方法直接插入原始SQL语句。比如，我们想根据用户的创建日期进行筛选，使用PostgreSQL的DATE_PART函数来提取年份：

typescript
import { getConnection } from "typeorm";

const userRepository = getConnection().getRepository(User);
const users = await userRepository
  .createQueryBuilder("user")
  .where("DATE_PART('year', user.createdAt) = :year", { year: 2021 })
  .getMany();

console.log(users);

注意事项

使用原始SQL或特定函数时，需要特别注意SQL注入的风险。尽管TypeORM的参数替换功能提供了一定的安全保障，但在构建复杂的SQL语句时，确保验证和清理任何用户输入的数据是非常重要的。

通过这些例子，我们可以看到在TypeORM中使用查询生成器结合原始的PostgreSQL函数是相对直接的，并能有效地利用数据库本身的功能来优化和简化数据查询。