Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The join column values are appended to `LinkedCollectionName` in the order liste
Use the same order as the referenced table's `PrimaryKeyColumns`, so the generated ID matches the referenced document ID.

This configuration only writes the `"Customers/42"` reference into the Orders document.
The `Customers/42` document itself exists only if the `customers` table is also configured as a root table.
To have CDC Sink create and update the referenced document, configure `customers` as an enabled root table whose `CollectionName` matches the linked table's `LinkedCollectionName`.

When loading the parent document, use [includes](../../../../../client-api/session/loading-entities.mdx#load-with-includes)
to fetch the referenced document without a second network call.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ import ContentFrame from "@site/src/components/ContentFrame";
* [Configure basic settings](#configure-basic-settings)
* [Schema explorer](#schema-explorer)
* [Configured tables](#configured-tables)
* [Add missing root tables](#add-missing-root-tables)
* [Configure linked tables](#configure-linked-tables)
* [Configure embedded tables](#configure-embedded-tables)
* [Test mapping](#test-mapping)
Expand Down Expand Up @@ -229,6 +230,32 @@ long taskId = result.TaskId;
11. Once you've finished configuring all tables and their advanced settings (see below),
click **Save task configuration** to save the task.
12. Click **Test** to preview the mapping output before saving.

---

### Add missing root tables

When a linked table references a source table that is not configured as a root table,
Studio displays a warning above the configured tables.

The parent document will contain the linked document ID,
but CDC Sink will not create the referenced document until the source table is also configured as a root table.

![Add missing root table warning](../assets/create-task-6.1.png)

1. **Missing root table warning**
Indicates how many referenced source tables are not configured as root tables.
2. **Add root table**
Click to open the **Add root tables** dialog.

![Add root tables dialog](../assets/create-task-6.2.png)

1. Select the source tables that you want to configure as root tables.
Studio selects all missing tables by default.
2. Click **Add 1 root table** (or **Add _n_ root tables** when multiple tables are selected).

Studio adds the selected tables to the configuration as root tables.
Review the generated mappings, then click **Save task configuration** to save the changes.

---

Expand Down
Loading