はじめに
ここでは、Couchbase ServerのN1QLで利用することのできる、二つの特殊なJOINのタイプについて解説します（CouchbaseのJOINには３つの種類が存在し、もう一つはANSI JOINです）。
この二つのJOINは、それぞれ混同しやすいCouchbase独自のキーワードを持ちます。すなわち、ON KEYSとON KEYです。
公式ドキュメント（後掲）にあたることにより、構文の理解（句中の右辺、左辺の意味）を得ることができますが、ここでは、直感的な理解を助ける事を意図し、実例による解説を行います。
Lookup JOIN
ON KEYS句を用います。
利用例
SELECT DISTINCT airline.name, airline.callsign, route.destinationairport, route.stops, route.airline
FROM `travel-sample` route
JOIN `travel-sample` airline
ON KEYS route.airlineid
WHERE route.type = "route"
AND airline.type = "airline"
AND route.sourceairport = "SFO"
AND route.stops = 0
LIMIT 4;
データモデル
- 「ルート」と「エアライン」という、二つの種類のデータモデルがある
- 「ルート」モデルのデータ構造は、「エアライン」（への参照）を含む
クエリの目的
- 特定の条件（SFO発の直行便）を満たす「ルート」の情報とともに、その「ルート」が持つ「エアライン」の情報を取得する
Index JOIN
ON KEY句を用います。
利用例
SELECT * FROM `travel-sample` airline
JOIN `travel-sample` route
ON KEY route.airlineid FOR airline
WHERE route.type="route"
AND airline.type="airline"
AND airline.icao = "MLA";
データモデル
データモデル
- 「ルート」と「エアライン」という、二つの種類のデータモデルがある
- 「ルート」モデルのデータ構造は、「エアライン」（への参照）を含む
クエリの目的
- 特定の条件（ICAOコード「MLA」）を満たす「エアライン」から、「ルート」で用いられているものを抽出し、その情報を取得する
注意
上記のクエリを実行するためには、下記のインデックスが必ず必要になります（ travel-sampleバケットのプライマリーインデックスで代替することはできません）。
CREATE INDEX airline_icao ON `travel-sample`(icao) WHERE type="airline";
最後に
なぜ、それぞれのキーワードに、単数形・複数形が用いられているかを考えてみるのも、興味深い試みかと思います。
最後に、蛇足となりそうですが、公式ドキュメントのAdaptive Indexの章では、ここで扱ったINDEX JOINでは、Array Index（Adaptive Indexを含む）を利用できない、とされています。現実のプロジェクトでの応用の経験がないため、確定的なことは言えませんが、おそらくあまり意識しなければならない場面はないのではないかとも思われます。