Neo4jのCypherクエリ、サンプルは豊富にあるのですが、記法がちょっとわかりづらいです。今回は、ノード(Node)に引き続き、リレーションシップ(Relationship)を見ていきます。ノード編で紹介した記法を理解している前提で説明します。
作成
aとbのノードの間に、タイプがAAAのリレーションシップを作成します。
MATCH (a:....) // ノードを任意の条件で検索し、aとする
MATCH (b:....) // ノードを任意の条件で検索し、bとする
CREATE (a)-[:AAA]->(b)
始端終端ノード (必須)
-
MATCHの検索結果を、変数(識別子)で参照させます。 -
()の中にラベルやプロパティを書くと、ノードが新規に作成されます。 -
()の中に何も書かないと、IDだけのノードが作成されます。
同じラベルやプロパティのノードが既に存在していても、
CREATE文でラベルやプロパティが書かれていると、ノードが作成されてしまいます。ただし、CREATE UNIQUEを使うと、終端に関しては、同じラベルやプロパティのノードは複製されず、既にあるノードにリレーションシップが作成されます。
方向 (必須)
-
-[:AAA]->か<-[:AAA]-で記述します。 -
-[:AAA]-と書くと、エラーとなります。
タイプ (必須)
-
[]の中に、:に続けて記述します。 -
-->や-[]->と書くと、エラーとなります。
プロパティ(任意)
- ノードと同様、リレーションシップにもデータを持たせることができます。
- 記法はノードの場合と同じです。
CREATE (a)-[:AAA{name:'bbb'}]->(b)
識別子 (任意)
- 作成直後にリレーションシップを参照したい場合は、ノードと同様、
(の直後に識別子を書きます。
CREATE (a)-[r:AAA]->(b) // 変数rで参照可能となる
検索
MATCH p=式 RETURN pの式に入れる部分を抜き出した形で説明します。
最小限
ありとあらゆるノードの間のパスを検索します。
()--() // (1) 方向関係なし
()-->() // (2) 左から右
()<--() // (3) 右から左
()は、「全部のノード」と覚えておきましょう。
(1)の場合、各ノードが始端と終端に設定されて検索されるため、同じパスが2回ずつ検索結果に含まれることになります。
リレーションシップに識別子をつける
リレーションシップ自体を、後から変数rで参照できるようにします。
()-[r]-()
type(r)で、リレーションシップのタイプ(冒頭の例ではAAA)を取得できます。
始端終端ノードを限定する
MATCHで検索した結果に識別子を割り当てるか、()の中に検索条件を直接書くかして、始端終端ノードを限定した状態でパスを検索できます。
(a)--() // 両方向
()--(a) // 上とまったく同じ結果
(a)-->() // aから他へのパス
(a)<--() // 他からaへのパス
矢印をつけなければ、リレーションシップの方向に関わらず検索できますので、ノード同士が双方向で繋がっている必要はありません。このため、同じ意味(タイプ、プロパティ)の繫がりであれば、どちらか一方向のリレーションシップだけ作成しておけば充分です。データベース領域の節約になります。
リレーションシップのタイプやプロパティで絞り込む
リレーションシップを作成する時に使った記法を使えば、タイプやプロパティで絞り込み検索ができます。
()-[:AAA]->() // タイプがAAAのリレーションシップ
()-[{name:'bbb’}]->() // nameプロパティがbbbのリレーションシップ
複数のタイプを一度に検索できます。
()-[:AAA|BBB]->() // AAAまたはBBBのリレーションシップ
２ホップ以上のリレーションシップ
間に何かが１つ挟まっているパスを検索します。
({title: 'The Matrix'})--()--({title: 'Cloud Atlas'})
ホップが複数になっても、リレーションシップのタイプやプロパティで絞り込みできます。
({title: 'The Matrix'})-[:DIRECTED]-()-[:DIRECTED]-({title: 'Cloud Atlas'})
省略記法
タイプやプロパティを指定しない場合、次のように書けます。
(a)-[*2]-(b) // (a)--()--(b)
(a)-[*3..4]-(b) // (a)--()--()--(b)または(a)--()--()--()--(b)
(a)-[*3..]-(b) // (a)--()--()--(b)以上のホップ数
(a)-[*..3]-(b) // (a)--()--()--(b)以下のホップ数
(a)-[*]-(b) // ホップ数無制限
(a)-[*0..]-(b) // ホップ数無制限 (a)のみというパスも含む
全てのホップで同じ条件で良ければ、省略記法でもタイプやプロパティを指定できます。例えば、少し前に出てきた例を書き換えると、こうなります。
({title: 'The Matrix'})-[:DIRECTED*2]-({title: 'Cloud Atlas'})
識別子、:タイプ、*数字、プロパティの順番です。全部入れると、このような感じになります。
()-[r:TYPE*3..4{key:'value'}]-()