TypeORM ‐ Query Builder

Query Builder

TypeORM의 쿼리빌더는 SQL 쿼리를 생성하고 실행하는데 사용되는 tool이다.
TypeORM은 find, save 등 단순한 SQL쿼리를 수행할 수 있는 기본적인 함수를 가지고 있으나, 복잡한 SQL 쿼리를 작성하는데 있어서는 많은 어려움이 있다.
따라서 이러한 경우 Query Builder 기능을 사용하여 SQL 쿼리문을 작성한다.

예시(추천 스토리)

    const stories = await this.storyRepository
      .createQueryBuilder('story')
      .innerJoinAndSelect('story.place', 'place')
      .addSelect(
        `
        (${RadiusOfEarth} * 2 * ATAN2(
          SQRT(
            SIN(RADIANS(place.latitude - ${userLatitude}) / 2) *
            SIN(RADIANS(place.latitude - ${userLatitude}) / 2) +
            COS(RADIANS(${userLatitude})) * COS(RADIANS(place.latitude)) *
            SIN(RADIANS(place.longitude - ${userLongitude}) / 2) *
            SIN(RADIANS(place.longitude - ${userLongitude}) / 2)
          ),
          SQRT(1 - (
            SIN(RADIANS(place.latitude - ${userLatitude}) / 2) *
            SIN(RADIANS(place.latitude - ${userLatitude}) / 2) +
            COS(RADIANS(${userLatitude})) * COS(RADIANS(place.latitude)) *
            SIN(RADIANS(place.longitude - ${userLongitude}) / 2) *
            SIN(RADIANS(place.longitude - ${userLongitude}) / 2)
          ))
        ))`,
        'distance',
      )
      .having('distance <= :radius', { radius })
      .orderBy('distance', 'ASC')
      .offset(offset)
      .limit(limit)
      .getMany();

Query Builder의 장점

1. SQL Injection 방지 Query Builder는 파라미터 바인딩을 통해 SQL injection 공격을 방지할 수 있다.

2. 성능 최적화 필요한 데이터만 선택적으로 로드하여 네트워크 사용량과 응답 시간을 최적화할 수 있습니다.