From 6f0362d4ca3c93cb7a6d85a09542e7e222a25525 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:37:46 +0200 Subject: [PATCH 1/8] [DOCS] Update esql-lookup-join.md to mention index mode requirement --- docs/reference/query-languages/esql/esql-lookup-join.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 6f358161b02ae..21415d4933e75 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -35,7 +35,7 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind ::: `` -: The name of the lookup index. This must be a specific index name - wildcards, aliases, and remote cluster references are not supported. +: The name of the lookup index. This must be a specific index name - wildcards, aliases, and remote cluster references are not supported. Indexes used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting). `` : 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,8 @@ FROM employees To use `LOOKUP JOIN`, the following requirements must be met: + +* Indexes used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) * **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means: * The data types must either be identical or be internally represented as the same type in {{esql}} * Numeric types follow these compatibility rules: @@ -122,7 +124,7 @@ For a complete list of supported data types and their internal representations, The following are the current limitations with `LOOKUP JOIN` -* Indices in [lookup](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) mode are always single-sharded. +* Indices in [`lookup` mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) mode are always single-sharded. * Cross cluster search is unsupported initially. Both source and lookup indices must be local. * Currently, only matching on equality is supported. * `LOOKUP JOIN` can only use a single match field and a single index. Wildcards, aliases, datemath, and datastreams are not supported. From de3aeeb8e90735900f92c7f20dbecf24fb546613 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:40:40 +0200 Subject: [PATCH 2/8] Update docs/reference/query-languages/esql/esql-lookup-join.md --- docs/reference/query-languages/esql/esql-lookup-join.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 21415d4933e75..4dd170189fc22 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -124,7 +124,7 @@ For a complete list of supported data types and their internal representations, The following are the current limitations with `LOOKUP JOIN` -* Indices in [`lookup` mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) mode are always single-sharded. +* Indices in [`lookup` mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) are always single-sharded. * Cross cluster search is unsupported initially. Both source and lookup indices must be local. * Currently, only matching on equality is supported. * `LOOKUP JOIN` can only use a single match field and a single index. Wildcards, aliases, datemath, and datastreams are not supported. From 6073827f31262ab72ac7954fb06791799b5789b4 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:42:09 +0200 Subject: [PATCH 3/8] Fix typos --- docs/reference/query-languages/esql/esql-lookup-join.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 4dd170189fc22..2fa476814902a 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -35,7 +35,7 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind ::: `` -: The name of the lookup index. This must be a specific index name - wildcards, aliases, and remote cluster references are not supported. Indexes used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting). +: 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](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting). `` : 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). @@ -108,7 +108,7 @@ FROM employees To use `LOOKUP JOIN`, the following requirements must be met: -* Indexes used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) +* Indices used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) * **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means: * The data types must either be identical or be internally represented as the same type in {{esql}} * Numeric types follow these compatibility rules: From e6a557998a6b1e4a37b2c7440df112de3cf34eaa Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:47:03 +0200 Subject: [PATCH 4/8] fix url --- docs/reference/query-languages/esql/esql-lookup-join.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 2fa476814902a..ffbf3cceae1fa 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -35,7 +35,7 @@ The `LOOKUP JOIN` command adds new columns to a table, with data from {{es}} ind ::: `` -: 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](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting). +: 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). `` : 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). From 8aa2b54ec2d2d31f122ed1800bdf9e23e8d4aa81 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:47:31 +0200 Subject: [PATCH 5/8] so many typos --- docs/reference/query-languages/esql/esql-lookup-join.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index ffbf3cceae1fa..4dd87c6240b3e 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -108,7 +108,7 @@ FROM employees To use `LOOKUP JOIN`, the following requirements must be met: -* Indices used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) +* Indices used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) * **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means: * The data types must either be identical or be internally represented as the same type in {{esql}} * Numeric types follow these compatibility rules: From ef1b35792fdf03171ca5a223f6d72b6ba3c90a91 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:47:57 +0200 Subject: [PATCH 6/8] fix url --- docs/reference/query-languages/esql/esql-lookup-join.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 4dd87c6240b3e..435a876c91f86 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -108,7 +108,7 @@ FROM employees To use `LOOKUP JOIN`, the following requirements must be met: -* Indices used for lookups must be configured with the [`lookup` index mode](https://claude.ai/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) +* Indices used for lookups must be configured with the [`lookup` index mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) * **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means: * The data types must either be identical or be internally represented as the same type in {{esql}} * Numeric types follow these compatibility rules: From 4a6afdabb6f7a494c96518f6a5b66e666297f7d1 Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:48:24 +0200 Subject: [PATCH 7/8] I shouldn't have done this PR in the UI --- docs/reference/query-languages/esql/esql-lookup-join.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 435a876c91f86..2da5a5067f19f 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -107,7 +107,6 @@ FROM employees To use `LOOKUP JOIN`, the following requirements must be met: - * Indices used for lookups must be configured with the [`lookup` index mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) * **Compatible data types**: The join key and join field in the lookup index must have compatible data types. This means: * The data types must either be identical or be internally represented as the same type in {{esql}} From 08e307a32fd4ccea1d73a1fa91edbc246ff8e75d Mon Sep 17 00:00:00 2001 From: Liam Thompson <32779855+leemthompo@users.noreply.github.com> Date: Wed, 16 Apr 2025 11:52:35 +0200 Subject: [PATCH 8/8] fix 8.x page mapping metadata --- docs/reference/query-languages/esql/esql-lookup-join.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/esql-lookup-join.md b/docs/reference/query-languages/esql/esql-lookup-join.md index 2da5a5067f19f..38e5101856fa1 100644 --- a/docs/reference/query-languages/esql/esql-lookup-join.md +++ b/docs/reference/query-languages/esql/esql-lookup-join.md @@ -1,7 +1,7 @@ --- navigation_title: "Correlate data with LOOKUP JOIN" mapped_pages: - - https://www.elastic.co/guide/en/elasticsearch/reference/current/esql-enrich-data.html + - https://www.elastic.co/guide/en/elasticsearch/reference/8.18/_lookup_join.html --- # LOOKUP JOIN [esql-lookup-join-reference]