diff --git a/docs/server/ongoing-tasks/cdc-sink/document-modeling/content/_linked-tables-csharp.mdx b/docs/server/ongoing-tasks/cdc-sink/document-modeling/content/_linked-tables-csharp.mdx index a4d8e82098..e009b246bf 100644 --- a/docs/server/ongoing-tasks/cdc-sink/document-modeling/content/_linked-tables-csharp.mdx +++ b/docs/server/ongoing-tasks/cdc-sink/document-modeling/content/_linked-tables-csharp.mdx @@ -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. diff --git a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.1.png b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.1.png new file mode 100644 index 0000000000..18ac806a2d Binary files /dev/null and b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.1.png differ diff --git a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.2.png b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.2.png new file mode 100644 index 0000000000..a105127e18 Binary files /dev/null and b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/create-task-6.2.png differ diff --git a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.1.snagx b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.1.snagx new file mode 100644 index 0000000000..d53c93c73e Binary files /dev/null and b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.1.snagx differ diff --git a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.2.snagx b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.2.snagx new file mode 100644 index 0000000000..fdb7bd6eda Binary files /dev/null and b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/assets/snagit/create-task-6.2.snagx differ diff --git a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/content/_create-task-csharp.mdx b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/content/_create-task-csharp.mdx index 99a188055e..8c7be5a71c 100644 --- a/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/content/_create-task-csharp.mdx +++ b/docs/server/ongoing-tasks/cdc-sink/manage-cdc-sink-tasks/content/_create-task-csharp.mdx @@ -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) @@ -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. ---