【ITニュース解説】StormQueries – A Query Builder with ORM Superpowers

システムエンジニアを目指す皆さんがWeb開発の世界に足を踏み入れると、必ずデータベースとの連携という作業に直面する。データベースはWebアプリケーションの心臓部であり、データを保存したり、取り出したり、更新したりする作業は日常的に発生する。このデータベース操作を効率的かつ安全に行うために、様々なツールが開発されてきたが、その中でも特に広く使われているのが「クエリビルダー（Query Builder）」と「ORM（Object-Relational Mapper）」だ。

クエリビルダーは、SQLというデータベースを操作する言語を直接書く代わりに、プログラミング言語の関数やメソッドを使ってSQL文を組み立てるツールである。例えば、「products」というテーブルから「idが5」の商品を探す場合、SQLで「SELECT * FROM products WHERE id = 5;」と書く代わりに、クエリビルダーでは「$queries->find('products', ['id' => 5]);」のように記述できる。これは非常に直感的で、軽量で高速に動作し、特別な設定も不要なため、ちょっとしたデータの取得や更新には非常に便利である。しかし、複数のテーブルから関連するデータをまとめて取得する、いわゆる「階層データ」を扱う際には、その能力に限界があった。例えば、1つの請求書に複数の商品明細が含まれるようなデータを取得する際、クエリビルダーだけではそれぞれのデータを別々に取得して、プログラム側で関連付けなければならないなど、手間がかかる場合があるのだ。

一方、ORMは、データベースのテーブルをプログラミング言語の「オブジェクト」（モノ）として扱えるようにするツールである。例えば、「Product」というクラス（設計図）を作り、そのクラスのインスタンス（実体）がデータベースの「products」テーブルの1つのレコードに対応する、といった具合だ。ORMを使うと、リレーションシップ（テーブル間の関連性）の処理に非常に強力な能力を発揮し、先ほどの請求書と明細の例のように、関連するデータをまとめて簡単に取得できる。例えば、「ある顧客のすべての注文」といった複雑な関係性を持つデータも、あたかもオブジェクトのプロパティ（属性）にアクセスするように扱うことが可能になる。しかし、ORMは通常、データベースのスキーマ（構造）を定義するためのモデルやアノテーション（注釈）といった複雑な設定を必要とし、システム全体の負荷も大きくなりがちで、学習コストも高いという側面があった。

このように、クエリビルダーとORMはそれぞれ一長一短があり、「両方の良いとこ取りができるツールはないものか」という長年の課題があった。その課題に対する一つの答えとして開発されたのが、「StormQueries」である。

StormQueriesは、クエリビルダーの持つシンプルさと、ORMの持つ強力なデータ関連付け能力を併せ持つことを目指した新しいツールだ。このツールは、データベースへの接続さえ完了すれば、すぐに使い始められるという大きな利点がある。従来のORMのように、事前の複雑なスキーマ定義やモデルの作成は一切不要である。

StormQueriesが提供する主な機能は多岐にわたる。まず、アプリケーションの実行時の状況に応じて、動的にSQLクエリを組み立てることが可能である。これにより、柔軟な検索条件やフィルタリングを実装できる。また、一度作成したクエリの構造を再利用できるため、コードの重複を減らし、保守性を高めることも可能だ。さらに、クエリビルダーが苦手としていた階層データのフェッチ（取得）にも対応している。例えば、顧客情報とそれに紐づく複数の注文データを一度のデータベースアクセスで効率的に取得できる。

取得した結果を、開発者が独自に定義したオブジェクトに直接マッピングできる点も特徴的である。これは、既存のORMのように特定のモデルを修正する必要がなく、柔軟なデータ処理を可能にする。そして、最も注目すべきは、一切スキーマ設定なしでこれらの機能が利用できることだ。データベースに接続するだけで、テーブルの構造を自動的に解釈し、データ操作を可能にする。もちろん、複雑なサブクエリの記述にも対応しており、直感的で分かりやすい構文でデータベース操作を行える。特に、特定のフィールドの値を1ずつ増やすような「インクリメンタルアップデート」（例: field = field + 1）といった操作は、他の多くのツールでは意外と難しかったり不可能だったりするが、StormQueriesでは簡単に行うことができる。

実際のコード例を見てみよう。基本的なデータの作成（insert）、読み出し（find）、更新（update）、削除（delete）といったCRUD操作は非常にシンプルに記述できる。例えば、商品テーブルからIDが5の商品を取得するには、「$product = $queries->find('products', ['id' => 5]);」のように書く。これはSQLを直接書くよりも簡潔で分かりやすい。

動的なフィルタリングも簡単だ。例えば、「セール中の商品」を抽出し、さらに条件に応じて「特定のカテゴリの商品」を追加でフィルタリングする場合、「$query->where('category_id', $criteria->getCategoryId());」のように、条件分岐の中でwhere句を追加していくことができる。このように、メソッドをチェーン（数珠つなぎ）で繋いでいくことで、複雑な条件のクエリも分かりやすく構築できる。

サブクエリ、つまり別のクエリの結果をさらにクエリの中で利用するような高度な操作もサポートされている。「SubQuery::create」という機能を使うことで、メインのクエリの中に別のクエリを埋め込むような記述が可能だ。

そして、StormQueriesの真骨頂とも言えるのが、スキーマ設定なしでORMのようなリレーションシップを扱える点である。例えば、顧客情報と、その顧客が行った複数の注文情報を同時に取得したい場合、「select」と「leftJoin」を使って複数のテーブルを結合し、さらに「Map::many」という機能を使うことで、取得したデータを「顧客オブジェクトの中に注文のリストが含まれる」という階層的な構造として自動的にマッピングできる。これにより、取得した$customerオブジェクトのordersプロパティにアクセスするだけで、その顧客のすべての注文をループ処理で簡単に扱えるようになる。これは、従来のクエリビルダーでは非常に手間がかかった作業だが、StormQueriesはモデルや設定ファイルなしでこれを実現する。

既存の有名なツールと比較すると、StormQueriesの独自性がより明確になる。PHPの「Doctrine」や「Eloquent」といったORMは非常に強力だが、データベースのスキーマに合わせてモデルファイルを作成したり、設定を記述したりする手間が必要である。しかし、StormQueriesはデータベースに接続した瞬間からすぐに利用できる。また、「SQLAlchemy」や「Hibernate」のような高度なORMは、多機能である一方で、多くの定型的な記述（ボイラープレートコード）を必要とし、システム全体が重くなりがちだ。StormQueriesは、それらに比べて軽量で高速に動作し、必要な機能をシンプルに提供する。そして、純粋なクエリビルダーが提供できない階層データのマッピングというギャップを埋める存在なのである。

StormQueriesは、Web開発の現場で「クエリビルダーのシンプルさとORMの便利さを、両者の欠点なしに手に入れたい」という開発者の実体験から生まれた。もしあなたがこのようなデータベース操作の課題を感じているなら、StormQueriesは非常に有用なツールとなるだろう。GitHubでコードを確認したり、公式ドキュメントでさらに多くの例を見たりすることが可能である。これはまだ始まりに過ぎず、実際のアプリケーションの利用事例からインスピレーションを得た、さらなる機能拡張が計画されている。データベース操作をより直感的で、効率的で、そして強力に行うための新しい選択肢として、StormQueriesは注目に値する。