Skip to content

Commit 92148cf

Browse files
authored
[DOCS] Update esql-lookup-join.md to mention index mode requirement (#126901)
* Update esql-lookup-join.md to mention index mode requirement * fix 8.x page mapping metadata
1 parent e28fca2 commit 92148cf

File tree

1 file changed

+4
-3
lines changed

1 file changed

+4
-3
lines changed

docs/reference/query-languages/esql/esql-lookup-join.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
navigation_title: "Correlate data with LOOKUP JOIN"
33
mapped_pages:
4-
- https://www.elastic.co/guide/en/elasticsearch/reference/current/esql-enrich-data.html
4+
- https://www.elastic.co/guide/en/elasticsearch/reference/8.18/_lookup_join.html
55
---
66

77
# LOOKUP JOIN [esql-lookup-join-reference]
@@ -35,7 +35,7 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind
3535
:::
3636

3737
`<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).
3939

4040
`<field_name>`
4141
: 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
107107

108108
To use `LOOKUP JOIN`, the following requirements must be met:
109109

110+
* Indices used for lookups must be configured with the [`lookup` index mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting)
110111
* **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means:
111112
* The data types must either be identical or be internally represented as the same type in {{esql}}
112113
* Numeric types follow these compatibility rules:
@@ -122,7 +123,7 @@ For a complete list of supported data types and their internal representations,
122123

123124
The following are the current limitations with `LOOKUP JOIN`
124125

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.
126127
* Cross cluster search is unsupported initially. Both source and lookup indices must be local.
127128
* Currently, only matching on equality is supported.
128129
* `LOOKUP JOIN` can only use a single match field and a single index. Wildcards, aliases, datemath, and datastreams are not supported.

0 commit comments

Comments
 (0)