docs: concatenate and merge options for dataframe operations component (#12819)

* add-concatenate-and-merge-options

* Apply suggestions from code review

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>

---------

Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com>
This commit is contained in:
Mendon Kissling
2026-04-22 13:10:16 -04:00
committed by GitHub
parent 5d6a7a0f31
commit 0202cb9a15
2 changed files with 50 additions and 0 deletions

View File

@ -109,6 +109,16 @@ The **Add Column** operation allows you to add a new column to the `Table` with
The parameters are **New Column Name** (`new_column_name`) and **New Column Value** (`new_column_value`).
</TabItem>
<TabItem value="concatenate" label="Concatenate">
The **Concatenate** operation combines multiple input `Table` objects into a single `Table` by stacking their rows vertically.
For example, if you have Table A and Table B, they are combined into one table with all rows from Table A, and then all rows from Table B.
This operation uses the **Table** (`df`) input.
Connect multiple `Table` outputs to the same input to concatenate them.
The output is a single `Table` containing the combined rows from all connected inputs.
</TabItem>
<TabItem value="dropcolumn" label="Drop Column">
@ -134,6 +144,21 @@ The default is `5`.
The output is a `Table` containing only the selected rows.
</TabItem>
<TabItem value="merge" label="Merge">
The **Merge** operation combines two input `Table` objects by matching rows that share the same value in a selected column.
For example, if one table has `id` and `name`, and another has `id` and `department`, you can merge both tables on `id` to produce one table with `id`, `name`, and `department`.
Provide the following parameters:
* **Left Table** (`left_dataframe`): The primary table in the merge.
* **Right Table** (`right_dataframe`): The secondary table in the merge.
* **Merge On Column** (`merge_on_column`): The shared column used to match rows. This column must exist in both tables.
* **Merge Type** (`merge_how`): Controls which matched and unmatched rows are kept in the output. Use `inner` to keep only matching rows, `left` to keep all rows from the left table, `right` to keep all rows from the right table, or `outer` to keep all rows from both tables.
The output is a `Table` containing matched records from both inputs.
</TabItem>
<TabItem value="renamecolumn" label="Rename Column">

View File

@ -109,6 +109,16 @@ The **Add Column** operation allows you to add a new column to the `Table` with
The parameters are **New Column Name** (`new_column_name`) and **New Column Value** (`new_column_value`).
</TabItem>
<TabItem value="concatenate" label="Concatenate">
The **Concatenate** operation combines multiple input `Table` objects into a single `Table` by stacking their rows vertically.
For example, if you have Table A, and Table B, they are combined into one table with all rows from Table A, and then all rows from Table B.
This operation uses the **Table** (`df`) input.
Connect multiple `Table` outputs to the same input to concatenate them.
The output is a single `Table` containing the combined rows from all connected inputs.
</TabItem>
<TabItem value="dropcolumn" label="Drop Column">
@ -134,6 +144,21 @@ The default is `5`.
The output is a `Table` containing only the selected rows.
</TabItem>
<TabItem value="merge" label="Merge">
The **Merge** operation combines two input `Table` objects by matching rows that share the same value in a selected column.
For example, if one table has `id` and `name`, and another has `id` and `department`, you can merge both tables on `id` to produce one table with `id`, `name`, and `department`.
Provide the following parameters:
* **Left Table** (`left_dataframe`): The primary table in the merge.
* **Right Table** (`right_dataframe`): The secondary table in the merge.
* **Merge On Column** (`merge_on_column`): The shared column used to match rows. This column must exist in both tables.
* **Merge Type** (`merge_how`): Controls which matched and unmatched rows are kept in the output. Use `inner` to keep only matching rows, `left` to keep all rows from the left table, `right` to keep all rows from the right table, or `outer` to keep all rows from both tables.
The output is a `Table` containing matched records from both inputs.
</TabItem>
<TabItem value="renamecolumn" label="Rename Column">