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
@@ -35,7 +35,7 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind
35
35
:::
36
36
37
37
`<lookup_index>`
38
-
: The name of the lookup index. This must be a specific index name - wildcards, aliases, and remote cluster references are not supported.
38
+
: The name of the lookup index. This must be a specific index name - wildcards, aliases, and remote cluster references are not supported. Indices used for lookups must be configured with the [`lookup` index mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting).
39
39
40
40
`<field_name>`
41
41
: The field to join on. This field must exist in both your current query results and in the lookup index. If the field contains multi-valued entries, those entries will not match anything (the added fields will contain `null` for those rows).
@@ -107,6 +107,7 @@ FROM employees
107
107
108
108
To use `LOOKUP JOIN`, the following requirements must be met:
109
109
110
+
* Indices used for lookups must be configured with the [`lookup` index mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting)
110
111
***Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means:
111
112
* The data types must either be identical or be internally represented as the same type in {{esql}}
112
113
* Numeric types follow these compatibility rules:
@@ -122,7 +123,7 @@ For a complete list of supported data types and their internal representations,
122
123
123
124
The following are the current limitations with `LOOKUP JOIN`
124
125
125
-
* Indices in [lookup](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) mode are always single-sharded.
126
+
* Indices in [`lookup` mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) are always single-sharded.
126
127
* Cross cluster search is unsupported initially. Both source and lookup indices must be local.
127
128
* Currently, only matching on equality is supported.
128
129
*`LOOKUP JOIN` can only use a single match field and a single index. Wildcards, aliases, datemath, and datastreams are not supported.
0 commit comments