<section><div><div><div><a><div><img></div><div>Node.js</div></a><a><div><img></div><div>SQL</div></a><a><div><img></div><div>Prisma</div></a><a><div><img></div><div>sqlc</div></a><a><div><img></div><div>tech</div></a></div><div><div><p data-line="0">Prisma界隈で話題沸騰中（自分調べ）のTypedSQLだが、自分の中ではかなりアツいと思っているので、その理由を語ろう。なおTypedSQLの機能とか仕組みについては記述しないのでドキュメントや以下の記事を参照するとよい。</p>
<p data-line="2"><span><iframe frameborder="0" scrolling="no"></iframe></span><a>https://www.prisma.io/docs/orm/prisma-client/using-raw-sql/typedsql</a></p>
<p data-line="4"><span><iframe frameborder="0" scrolling="no"></iframe></span><a>https://zenn.dev/tockn/articles/0e6eac6220e072</a></p>
<h1 data-line="6">
<a aria-hidden="true"></a> Prismaの難しさ</h1>
<p data-line="8">複雑なクエリを組み立てるのが特に難しい。複雑といっても何10行もあるようなクエリとかではなく、joinとか集計関数がいくつかあるくらいで十分複雑になる。たとえば特定のユーザーに紐づく記事をコメントの数を含めて取得したいとする。クエリは雰囲気こんな感じ。SQLとしては全然難しくない。</p>
<div><pre><code data-line="10">SELECT
  posts.id,
  count(comments.id) AS cnt
FROM
  posts
INNER JOIN
  users ON posts.author_id = users.id
LEFT JOIN
  comments ON posts.id = comments.post_id
WHERE
  posts.author_id = $1
  AND users.deleted_at is null
GROUP BY
  posts.id
</code></pre></div><p data-line="27">これをPrismaで書いてみる。</p>
<div><pre><code data-line="29">await prisma.post.findMany({
  where: {
    authorId: userId,
    author: { deletedAt: null },
  },
  select: {
    id: true,
    _count: {
      select: { comments: true },
    },
  },
});
</code></pre></div><p data-line="44">まあ難しくないけど、実現したいことからこの書き方にたどり着くにはけっこう時間がかかる。なんか全然直感的じゃないんだよな。PrismaよりSQLのほうが慣れてるからと言ってしまえばそうだけど、多くの人はそうじゃなかろうか。</p>
<p data-line="46">そして発行されるSQLはこうだ。</p>
<div><pre><code data-line="48">SELECT
  "public"."posts"."id",
  COALESCE("aggr_selection_0_Comment"."_aggr_count_comments", 0) AS "_aggr_count_comments"
FROM
  "public"."posts"
LEFT JOIN (
  SELECT
    "public"."comments"."post_id",
    COUNT(*) AS "_aggr_count_comments"
  FROM
    "public"."comments"
  WHERE
    1=1
  GROUP BY
    "public"."comments"."post_id"
) AS "aggr_selection_0_Comment"
  ON ("public"."posts"."id" = "aggr_selection_0_Comment"."post_id")
LEFT JOIN
  "public"."users" AS "j1" ON ("j1"."id" = "public"."posts"."author_id")
WHERE (
  ("j1"."id" = $1
  AND "j1"."deleted_at" IS NULL
  AND ("j1"."id" IS NOT NULL))
  AND ("public"."posts"."id") IN (SELECT "t2"."post_id" FROM "public"."comments" AS "t2" WHERE (1=1 AND "t2"."post_id" IS NOT NULL))
)
OFFSET
  $2
;
</code></pre></div><p data-line="79">🤯</p>
<p data-line="81">元々やりたかったことがこれで達成できているかを確認するのにだいぶ時間を要する。自分で実装して確認するならまだしも、このロジックに間違いがあったときにレビューで気付けるひとはPrismaの達人じゃないと無理そうだ。テストをがんばって書こう。</p>
<p data-line="83">もちろん <code>$queryRaw</code> などを使って生SQLを実行することはできるが、今度は実行結果が型安全じゃなくなるし、SQLのシンタックスエラーも動かしてみないとわからない。こういった問題から、Prismaをやめてsqlcにしたいと思っていたのがつい最近の話だった。</p>
<h1 data-line="85">
<a aria-hidden="true"></a> sqlc</h1>
<p data-line="87">sqlcというGoのライブラリがある。</p>
<p data-line="89"><span><iframe frameborder="0" scrolling="no"></iframe></span><a>https://github.com/sqlc-dev/sqlc</a></p>
<p data-line="91">これは基本的にはTypedSQLと同じコンセプトのもので、生SQLから型付きのコードを生成する。最近TypeScriptプラグインも開発が進んでいる。</p>
<p data-line="93"><span><iframe frameborder="0" scrolling="no"></iframe></span><a>https://github.com/sqlc-dev/sqlc-gen-typescript</a></p>
<p data-line="95">自分はGoでは基本的にsqlcを使っていて、sqlcのアプローチが好きだったのでTypeScriptプラグインが実用段階になったらPrismaから乗り換えたいと思っていた。</p>
<p data-line="97">しかし、sqlcのアプローチも万能ではない。例えばパラメータによる動的なクエリの構築が難しい。例えばPrismaで書くとこういうやつ。</p>
<div><pre><code data-line="99">function searchUser(params: SearchUerParams): Promise<User[]> {
  const where: Prisma.UserWhereInput = {};

  if (params.age) {
    where.age = params.age;
  }

  if (params.gender) {
    where.gender = params.gender;
  }

  return prisma.user.findMany({ where });
}
</code></pre></div><p data-line="115">これをsqlcでやるとすると、一応こんな感じのクエリでできなくはない。</p>
<div><pre><code data-line="117">SELECT
  *
FROM
  users
WHERE
  (CASE WHEN @has_age::bool THEN age = @age ELSE true END)
  AND (CASE WHEN @has_gender::bool THEN gender = @gender ELSE true END)
</code></pre></div><p data-line="127">そしてこれはPostgreSQL限定で、MySQLだと無理らしい。これについては以下で議論されているがあまり進展はない。</p>
<p data-line="129"><span><iframe frameborder="0" scrolling="no"></iframe></span><a>https://github.com/sqlc-dev/sqlc/discussions/364</a></p>
<p data-line="131">それから、シンプルなクエリであればクエリを別途定義するよりPrismaのようなORMを使う方が便利だと思う。</p>
<div><pre><code data-line="133">// シンプルなSELECT
const user = await prisma.user.findUnique({ where: { id: userId } });

// INSERTするだけ
await prisma.user.create({ data });
</code></pre></div><p data-line="141">まあこれは好みの問題なのでどっちでもいいけど、個人的にはこういうシンプルなクエリを毎回別ファイルに書いて型生成みたいなものは冗長に感じる。</p>
<h1 data-line="144">
<a aria-hidden="true"></a> つまり何がアツイのか</h1>
<p data-line="146">sqlcやTypedSQLが苦手とするケースがあって、そういったケースは従来のPrismaのAPIのようなORM（というかクエリビルダかな）を使ったほうが便利だと思っている。しかしこれら両方を解決するようなライブラリはなかった。そう、TypedSQLが現れるまでは。</p>
<p data-line="148">自分がアツイと感じている点は、シンプルなクエリや動的なクエリはPrisma APIで、joinや集計関数を伴うような複雑なクエリはTypedSQL、という使い分けが同じライブラリでできるようになったというところなのだ。</p>
<p data-line="150">Prismaは他にも細かいところで気になる点は色々あるけど、TypedSQLの登場はそういう問題はどうでもいいのでPrismaを使い続けようと思わせるぐらいのでインパクトがあった。これはアツい。アツいのだ。</p>
</div></div><span></span><aside><div><a><img alt="hokaccha" height="80" referrerPolicy="no-referrer" width="80"></a><div><a>hokaccha</a></div><div><p><span>Software engineer at Ubie Inc.</span></p><div><span></span><a aria-label="@hokaccha" data-tooltip-for-desktop="true" data-tooltip-position="bottom" role="tooltip"><svg x="0px" y="0px" viewBox="0 0 27 27" xml:space="preserve" aria-label="GitHub"><path fill="currentColor" d="M13.4,1.2C7,1,1.8,6,1.7,12.4c0,0.1,0,0.4,0,0.5c0,5.1,3.2,9.8,8.2,11.5c0.6,0.1,0.7-0.2,0.7-0.6s0-1.8,0-2.9 c0,0-3.3,0.6-4-1.5c0,0-0.6-1.3-1.3-1.8c0,0-1.1-0.7,0.1-0.7c0.7,0.1,1.5,0.6,1.8,1.2c0.6,1.2,2.2,1.7,3.4,1h0.1 c0.1-0.6,0.4-1.2,0.7-1.6C8.7,17.1,6,16.9,6,12.3c0-1.1,0.5-2.1,1.2-2.8c0-1.1,0-2.2,0.3-3.2c1-0.4,3.3,1.3,3.3,1.3c2-0.6,4-0.6,6,0 c0,0,2.2-1.6,3.2-1.2c0.5,1,0.5,2.2,0.1,3.2c0.7,0.7,1.2,1.8,1.2,2.8c0,4.5-2.8,5-5.5,5.2c0.6,0.6,0.9,1.3,0.7,2.2c0,1.7,0,3.5,0,4 s0.2,0.6,0.7,0.6c4.9-1.7,8.2-6.2,8-11.5c0.1-6.4-5.1-11.6-11.6-11.6C13.5,1.2,13.4,1.2,13.4,1.2z"></path></svg></a><a aria-label="@hokaccha" data-tooltip-for-desktop="true" data-tooltip-position="bottom" role="tooltip"><svg width="27" height="28" viewBox="0 0 27 28" fill="none" aria-label="X(Twitter)"><g clip-path="url(#clip0_1_18)"><path d="M16.0687 11.7356L26.12 0H23.7382L15.0106 10.1899L8.03988 0H0L10.5411 15.4089L0 27.7155H2.38199L11.5985 16.9546L18.9601 27.7155H27L16.0681 11.7356H16.0687ZM12.8062 15.5447L11.7382 14.0103L3.24025 1.80106H6.89884L13.7568 11.6543L14.8248 13.1887L23.7393 25.9963H20.0807L12.8062 15.5452V15.5447Z" fill="currentColor"></path></g><defs><clipPath><rect width="27" height="27.7297" fill="white"></rect></clipPath></defs></svg></a></div></div></div></aside><span></span></div></div><div><div></div></div></section>

複雑なクエリを簡単に構築できること

複雑なクエリを組み立てるのが特に難しいこと

PrismaはSQLよりも直感的であること

PrismaのAPIが全てのクエリに対して万能だから

TypedSQLの登場がPrismaを使い続ける理由になるほどのインパクトがあったから

sqlcが全ての機能を提供しているから

Prismaが最も人気のあるORMだから

動的なクエリが簡単に構築できること

シンプルなクエリを簡単に実行できること

全てのクエリが型安全であること

生SQLから型付きのコードを生成すること

SQLの実行速度を向上させること

全てのSQL文を自動生成すること

SQLのエラーを自動的に修正すること