Skip to content

Commit 87ef558

Browse files
committed
rename heading, tweak opening sentence, add collision info
1 parent e5643da commit 87ef558

File tree

2 files changed

+8
-4
lines changed

2 files changed

+8
-4
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +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-
For important information about using `LOOKUP JOIN`, refer to [Implementation details](../../../../esql/esql-lookup-join.md#implementation-details).
45+
For important information about using `LOOKUP JOIN`, refer to [Usage notes](../../../../esql/esql-lookup-join.md#implementation-details).
4646
::::
4747

4848
**Examples**

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

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -156,13 +156,17 @@ 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
159+
## Usage notes
160160

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.
161+
This section covers important details about `LOOKUP JOIN` that impact query behavior and results. Review these details to ensure your queries work as expected and to troubleshoot unexpected results.
162162

163163
### Handling name collisions
164164

165-
In case of name collisions, the newly created columns will override existing columns.
165+
When fields from the lookup index match existing column names, the new columns override the existing ones.
166+
Before the `LOOKUP JOIN`, preserve columns by either:
167+
168+
* Using `RENAME` to assign non-conflicting names
169+
* Using `EVAL` to create new columns with different names, then `DROP` the original columns
166170

167171
### Sorting behavior
168172

0 commit comments

Comments
 (0)