🌍 知識グラフvol.7:Neo4jの「Cypher」に入門して感動した話

はじめに

これまで、AI（Claude）に言われるがままに Neo4j Desktop で Cypherクエリ を実行してきました。農作業記録がグラフとして可視化される便利さを肌で感じてはいましたが、クエリのコード自体は「呪文」のようなものでした。

今回、書籍『知識グラフ構築ガイド』の第3章に入り、ついにCypherの基本である CREATE句 と MATCH句 を学びました。実際に動かしてきた経験があるからこそ、「あの呪文にはこんな意味があったのか！」という感動が大きかったので、その学びを共有します。

---

1. Cypherの真髄は「直感的なビジュアル表現」

Cypherクエリ言語を学んで最も驚いたのは、その設計思想です。Cypherは、人がホワイトボードに描くような「丸（ノード）」と「矢印（リレーション）」をそのままテキストで表現することを目指して作られています 。

視覚的な文法

例えば、「Rosaはベルリンに住んでいる」という情報を記述する場合、Cypherでは以下のように書きます。

「Rosaはベルリンに住んでいる」

(:Person {name: 'Rosa'})-[:LIVES_IN]->(:Place {city: 'Berlin'})

• () (丸括弧): ノード（点）を表現しています。まるで円を描いているようです 。

• --[]--> (矢印): ノード間の関係性を表現しています 。

• {} (波括弧): ノードやリレーションが持つプロパティ（名前や日付などの属性）を格納します 。

このASCIIアートのような記法のおかげで、クエリの構造がそのまま知識グラフの構造と直感的に一致します 。

2. 「作る」と「探す」：CREATEとMATCH

今回、特に重点的に学んだのが、データを保存する CREATE と、データを検索する MATCH です。

CREATE句：知識をグラフに刻む

新しいデータを保存するには、先ほどのパターンに CREATE キーワードを付けるだけです 。 農作業記録システムであれば、以下のように「作業インスタンス」を作成できます。

「作業インスタンス」を作成

CREATE (:WorkInstance {work_date: '2025-12-19', work_type: '施肥'})

ここで重要なのは、リレーションの向きを明示することです。例えば「Rosaがベルリンに住んでいる」のであって「ベルリンがRosaに住んでいる」のではないという事実を正確に記録するためです 。

MATCH句：パターンで情報を引き出す

保存したデータを取り出すには MATCH 句を使います。これは、知識グラフに対してユーザーが定義したパターンを照合（パターンマッチング）する強力な仕組みです 。

例えば、登録したすべてのノードを確認したいときは、以下のように指示します。

登録したすべてのノードを確認

MATCH (n) RETURN n LIMIT 10

これは「任意のノード n を見つけ、その変数 n を返却せよ」という意味になります 。

3. なぜ「ラベル」が重要なのか？

学んだ中で特に「なるほど！」と思ったのが、ノードに付ける :Person や :Field といった「ラベル」 の役割です 。

ラベルは単に役割を整理するだけでなく、データベース内部では自動的にインデックスとして活用されます 。 これによって、知識グラフの規模が大きくなっても、特定の役割を持つデータを高速に検索できるようになります 。

「ドメインについて知っていることがあれば、積極的にラベルとして含めるべき」という教訓は、今後の農作業記録システムの拡張において、非常に重要な指針になりました 。

4.実践で使ったCypherの例

これまで作業記録をNeo4jのデータベースに記録するときに使ったCypherの例を挙げます。

実践で使ったCypherの例

📈 実践で使ったCypherの例

1. 基本パターン

基本パターン

//cypher
MATCH (n) RETURN n LIMIT 10
MATCH (n:Label) RETURN count(n)

3. リレーション検索

リレーション検索

//cypher
MATCH (a)-[r]->(b) RETURN a, r, b
MATCH (a:Label1)-[:REL_TYPE]->(b:Label2)

4. パス検索

パス検索

//cypher
MATCH (a)-[:REL1]->(b)-[:REL2]->(c)

6. データ作成

データ作成

//cypher
CREATE (n:Label {property: value})
CREATE (a)-[:REL]->(b)

8. 大規模インポート

大規模インポート

//cypher
LOAD CSV WITH HEADERS FROM 'file:///...'

---

まとめ：呪文が「言葉」に変わる瞬間

これまでは「Claudeに生成してもらったクエリ」を実行するだけでしたが、その構造を理解し始めると、Cypherが非常に人間にとってフレンドリーな言語であることが分かりました。

特に、リレーションをどの向きからでも一定のコストで走査できるというグラフDB特有の性質は、複雑な農作業オントロジー（CAVOC）を扱う上で大きな武器になります 。

次は、もっと複雑な条件での検索や、複数のノードを跨いだ分析クエリに挑戦し、システムをより「賢く」育てていきたいと思います！