select

何をするオプションか

select は Prisma クエリで取得するフィールドを明示的に指定するオプションです。省略すると全フィールドが返りますが、select を使えば必要な列だけに絞れます。

// id と title だけを取得
prisma.post.findMany({
  select: { id: true, title: true },
});

どんな場面で使うか

• API レスポンスに含めるフィールドを最小限に抑えたいとき
• パスワードハッシュや機密フィールドを誤って返さないようにしたいとき
• リレーション先から特定フィールドだけ取得したいとき（ネスト select）

よくある組み合わせ

リレーション先のフィールドを絞る（ネスト select）

prisma.post.findMany({
  select: {
    id: true,
    title: true,
    author: {
      select: { name: true }, // リレーション先も絞れる
    },
  },
});

include: { author: true } だと著者の全フィールドが返りますが、ネスト select なら name だけに絞れます。

_count でリレーション件数を取得

prisma.user.findMany({
  select: {
    id: true,
    name: true,
    _count: { select: { posts: true } }, // 投稿数だけ
  },
});

include との違い

リレーション先のフィールドも絞りたい場合は include ではなく select + ネスト select を選びます。

注意点

• include と select は同一クエリの同一レベルで併用できない。TypeScript の型エラーで気づける
• select を使うと戻り値の型が自動的に絞り込まれる。型が複雑になる場合は Prisma.PostGetPayload<{ select: ... }> で明示する
• ネストが深い select はクエリが読みにくくなる。深さ 2 段を超えたら関数や型エイリアスに切り出す

関連サンプルの見どころ

• prisma-relation-query: select と include の使い分けをモデルで比較するパターン
• prisma-keyword-search-query: select でレスポンスフィールドを最小化するパターン
• prisma-sort-query: Route Handler での select + orderBy の組み合わせ

select と include の違いを比較でまとめたページもあります → select vs include