You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/reference/query-languages/esql/esql-lookup-join.md
+9-9
Original file line number
Diff line number
Diff line change
@@ -30,6 +30,13 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind
30
30
:alt: esql lookup join
31
31
:::
32
32
33
+
$$$esql-source-index$$$
34
+
35
+
Source index
36
+
: An index which stores enrich data that the `LOOKUP` command can add to input tables. You can create and manage these indices just like a regular {{es}} index. You can use multiple source indices in an enrich policy. You also can use the same source index in multiple enrich policies.
37
+
38
+
## Example
39
+
33
40
In the case where there are multiple matches on the index `LOOKUP JOIN` the output rows is the combination of each match from the left with each match on the right.
34
41
35
42
Image you have the two tables:
@@ -76,12 +83,6 @@ FROM Left
76
83
77
84
::::
78
85
79
-
$$$esql-source-index$$$
80
-
81
-
Source index
82
-
: An index which stores enrich data that the `LOOKUP` command can add to input tables. You can create and manage these indices just like a regular {{es}} index. You can use multiple source indices in an enrich policy. You also can use the same source index in multiple enrich policies.
83
-
84
-
85
86
## Prerequisites [esql-enrich-prereqs]
86
87
87
88
To use `LOOKUP JOIN`, you must have:
@@ -90,7 +91,7 @@ To use `LOOKUP JOIN`, you must have:
90
91
91
92
## Limitations
92
93
93
-
The following is a list of current limitations with `LOOKUP JOIN`
94
+
The following are the current limitations with `LOOKUP JOIN`
94
95
95
96
*`LOOKUP JOIN` will be sucessfull if both left and right type of the join are both `KEYWORD` types or if the left type is of `TEXT` and the right type is `KEYWORD`.
96
97
* Indices in [lookup](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) mode are always single-sharded.
@@ -100,5 +101,4 @@ The following is a list of current limitations with `LOOKUP JOIN`
100
101
* The query will circuit break if you fetch too much data in a single page. A large heap is needed to manage results of multiple megabytes.
101
102
* This limit is per page of data which is about about 10,000 rows.
102
103
* Matching many rows per incoming row will count against this limit.
103
-
* This limit is approximately the same as for [`ENRICH`](/reference/query-languages/esql/esql-commands.md#esql-enrich).
104
-
104
+
* This limit is approximately the same as for [`ENRICH`](/reference/query-languages/esql/esql-commands.md#esql-enrich).
0 commit comments