Skip to content

Commit c1cc777

Browse files
committed
Create implementation details section, move collision, sorting tips there
1 parent 1d670f4 commit c1cc777

File tree

2 files changed

+16
-8
lines changed

2 files changed

+16
-8
lines changed

docs/reference/query-languages/esql/_snippets/commands/layout/lookup-join.md

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -42,13 +42,7 @@ If multiple documents in the lookup index match a single row in your
4242
results, the output will contain one row for each matching combination.
4343

4444
::::{tip}
45-
In case of name collisions, the newly created columns will override existing columns.
46-
::::
47-
48-
::::{warning}
49-
The output rows produced by `LOOKUP JOIN` can be in any order and may not
50-
respect preceding `SORT`s. To guarantee a certain ordering, place a `SORT` after
51-
any `LOOKUP JOIN`s.
45+
For important information about using the `LOOKUP JOIN`, refer to [Implementation details](../../../../esql/esql-lookup-join.md#implementation-details).
5246
::::
5347

5448
**Examples**

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

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,9 +156,23 @@ To obtain a join key with a compatible type, use a [conversion function](/refere
156156

157157
For a complete list of supported data types and their internal representations, see the [Supported Field Types documentation](/reference/query-languages/esql/limitations.md#_supported_types).
158158

159+
## Implementation details
160+
161+
This section covers key implementation aspects of `LOOKUP JOIN` that affect query behavior and results. Review these details to ensure your queries work as expected and to troubleshoot unexpected results.
162+
163+
### Handling name collisions
164+
165+
In case of name collisions, the newly created columns will override existing columns.
166+
167+
### Sorting behavior
168+
169+
The output rows produced by `LOOKUP JOIN` can be in any order and may not
170+
respect preceding `SORT`s. To guarantee a certain ordering, place a `SORT` after
171+
any `LOOKUP JOIN`s.
172+
159173
## Limitations
160174

161-
The following are the current limitations with `LOOKUP JOIN`
175+
The following are the current limitations with `LOOKUP JOIN`:
162176

163177
* Indices in [`lookup` mode](/reference/elasticsearch/index-settings/index-modules.md#index-mode-setting) are always single-sharded.
164178
* Cross cluster search is unsupported initially. Both source and lookup indices must be local.

0 commit comments

Comments
 (0)