FindUnique와 FindFirst는 Prisma ORM에서 제공하는 데이터 조회 메서드입니다. 이 두 메서드는 비슷해 보이지만 중요한 차이점이 있습니다. 이에 대해 자세히 알아보도록 하겠습니다.

FindUnique와 FindFirst 비교

FindUnique

FindUnique는 고유 식별자나 고유 제약 조건이 설정된 필드를 기반으로 단일 레코드를 조회할 때 사용합니다.

• 목적: 유일한(unique) 필드 값으로 정확히 하나의 레코드를 찾는 것
• 조건: 반드시 유니크 제약조건이 있는 필드나 필드 조합으로만 쿼리 가능
• 결과: 일치하는 레코드가 있으면 해당 레코드를, 없으면 null 반환
• 최적화: 데이터베이스 인덱스를 활용하여 더 효율적인 쿼리 생성

// 예시: id로 사용자 찾기
const user = await prisma.user.findUnique({
  where: {
    id: 1
  }
});

// 예시: 이메일로 사용자 찾기 (이메일이 unique 제약조건이 있을 때)
const user = await prisma.user.findUnique({
  where: {
    email: "[email protected]"
  }
});

FindFirst

FindFirst는 다양한 조건에 맞는 첫 번째 레코드를 찾을 때 사용합니다.

• 목적: 다양한 조건으로 필터링된 결과 중 첫 번째 레코드 반환
• 조건: 어떤 필드든 사용 가능 (unique 제약조건이 없는 필드도 가능)
• 결과: 조건에 맞는 첫 번째 레코드 또는 null 반환
• 추가 기능: 정렬(orderBy), 건너뛰기(skip) 등의 추가 옵션 사용 가능

// 예시: 활성 상태인 첫 번째 사용자 찾기
const user = await prisma.user.findFirst({
  where: {
    isActive: true
  }
});

// 예시: 조건과 정렬을 함께 사용
const user = await prisma.user.findFirst({
  where: {
    age: { gte: 18 }
  },
  orderBy: {
    createdAt: 'desc'
  }
});

phone 칼럼이 unique, not null일 때의 시나리오

만약 phone 칼럼이 unique와 not null 제약조건을 갖고 있고, 중복된 phone 값이 데이터베이스에 삽입되려고 한다면:

중복 삽입 시도 시