diff --git a/src/current/_includes/v23.1/known-limitations/cdc-queries-column-families.md b/src/current/_includes/v23.1/known-limitations/cdc-queries-column-families.md new file mode 100644 index 00000000000..a68a7949824 --- /dev/null +++ b/src/current/_includes/v23.1/known-limitations/cdc-queries-column-families.md @@ -0,0 +1 @@ +Creating a changefeed with {% if page.name == "cdc-queries.md" %} CDC queries {% else %} [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) {% endif %} on tables with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %} is not supported. [Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/127761) \ No newline at end of file diff --git a/src/current/_includes/v23.1/known-limitations/changefeed-column-family-message.md b/src/current/_includes/v23.1/known-limitations/changefeed-column-family-message.md new file mode 100644 index 00000000000..b8aafbe11dc --- /dev/null +++ b/src/current/_includes/v23.1/known-limitations/changefeed-column-family-message.md @@ -0,0 +1 @@ +When you create a changefeed on a table with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %}, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. [Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/127736) \ No newline at end of file diff --git a/src/current/_includes/v23.2/known-limitations/cdc-queries-column-families.md b/src/current/_includes/v23.2/known-limitations/cdc-queries-column-families.md new file mode 100644 index 00000000000..a68a7949824 --- /dev/null +++ b/src/current/_includes/v23.2/known-limitations/cdc-queries-column-families.md @@ -0,0 +1 @@ +Creating a changefeed with {% if page.name == "cdc-queries.md" %} CDC queries {% else %} [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) {% endif %} on tables with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %} is not supported. [Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/127761) \ No newline at end of file diff --git a/src/current/_includes/v23.2/known-limitations/changefeed-column-family-message.md b/src/current/_includes/v23.2/known-limitations/changefeed-column-family-message.md new file mode 100644 index 00000000000..b8aafbe11dc --- /dev/null +++ b/src/current/_includes/v23.2/known-limitations/changefeed-column-family-message.md @@ -0,0 +1 @@ +When you create a changefeed on a table with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %}, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. [Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/127736) \ No newline at end of file diff --git a/src/current/_includes/v24.1/known-limitations/cdc-queries-column-families.md b/src/current/_includes/v24.1/known-limitations/cdc-queries-column-families.md new file mode 100644 index 00000000000..505a8c9700e --- /dev/null +++ b/src/current/_includes/v24.1/known-limitations/cdc-queries-column-families.md @@ -0,0 +1 @@ +Creating a changefeed with {% if page.name == "cdc-queries.md" %} CDC queries {% else %} [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) {% endif %} on tables with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %} is not supported. [#127761](https://github.com/cockroachdb/cockroach/issues/127761) \ No newline at end of file diff --git a/src/current/_includes/v24.1/known-limitations/changefeed-column-family-message.md b/src/current/_includes/v24.1/known-limitations/changefeed-column-family-message.md new file mode 100644 index 00000000000..41744b9b4b4 --- /dev/null +++ b/src/current/_includes/v24.1/known-limitations/changefeed-column-family-message.md @@ -0,0 +1 @@ +When you create a changefeed on a table with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %}, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. [#127736](https://github.com/cockroachdb/cockroach/issues/127736) \ No newline at end of file diff --git a/src/current/_includes/v24.2/known-limitations/cdc-queries-column-families.md b/src/current/_includes/v24.2/known-limitations/cdc-queries-column-families.md new file mode 100644 index 00000000000..505a8c9700e --- /dev/null +++ b/src/current/_includes/v24.2/known-limitations/cdc-queries-column-families.md @@ -0,0 +1 @@ +Creating a changefeed with {% if page.name == "cdc-queries.md" %} CDC queries {% else %} [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) {% endif %} on tables with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %} is not supported. [#127761](https://github.com/cockroachdb/cockroach/issues/127761) \ No newline at end of file diff --git a/src/current/_includes/v24.2/known-limitations/changefeed-column-family-message.md b/src/current/_includes/v24.2/known-limitations/changefeed-column-family-message.md new file mode 100644 index 00000000000..41744b9b4b4 --- /dev/null +++ b/src/current/_includes/v24.2/known-limitations/changefeed-column-family-message.md @@ -0,0 +1 @@ +When you create a changefeed on a table with more than one {% if page.name == "changefeeds-on-tables-with-column-families.md" %} column family {% else %} [column family]({% link {{ page.version.version }}/changefeeds-on-tables-with-column-families.md %}) {% endif %}, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. [#127736](https://github.com/cockroachdb/cockroach/issues/127736) \ No newline at end of file diff --git a/src/current/v23.1/cdc-queries.md b/src/current/v23.1/cdc-queries.md index 5017188447a..adbf7f7b42e 100644 --- a/src/current/v23.1/cdc-queries.md +++ b/src/current/v23.1/cdc-queries.md @@ -55,6 +55,7 @@ For a SQL diagram of the CDC query syntax, see the [`CREATE CHANGEFEED`]({% link {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} ## CDC query function support diff --git a/src/current/v23.1/changefeeds-on-tables-with-column-families.md b/src/current/v23.1/changefeeds-on-tables-with-column-families.md index d329ab26a7d..91e115557fe 100644 --- a/src/current/v23.1/changefeeds-on-tables-with-column-families.md +++ b/src/current/v23.1/changefeeds-on-tables-with-column-families.md @@ -80,6 +80,8 @@ The output shows the `primary` column family with `4` in the value (`{"id":4,"na - When you do not specify column family names in the `CREATE` or `ALTER TABLE` statement, the family names will default to either of the following: - `primary`: Since `primary` is a key word, you'll receive a syntax error if you run `CREATE CHANGEFEED FOR table FAMILY primary`. To avoid this syntax error, use double quotes: `CREATE CHANGEFEED FOR table FAMILY "primary"`. You'll receive output from the changefeed like: `table.primary`. - `fam__`: For a table that does not include a name for the family: `FAMILY (id, name)`, you'll receive output from the changefeed containing: `table.fam_0_id_name`. This references the table, the family ID and the two columns that this column family includes. +- Creating a changefeed with [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) is not supported on tables with more than one column family. +- When you create a changefeed on a table with more than one column family, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. For more details, refer to [Message format](#message-format). For examples of starting changefeeds on tables with column families, see the following examples for Enterprise and Core changefeeds. diff --git a/src/current/v23.1/create-and-configure-changefeeds.md b/src/current/v23.1/create-and-configure-changefeeds.md index 6ae79096141..402ab752516 100644 --- a/src/current/v23.1/create-and-configure-changefeeds.md +++ b/src/current/v23.1/create-and-configure-changefeeds.md @@ -210,6 +210,8 @@ For more information, see [`EXPERIMENTAL CHANGEFEED FOR`]({% link {{ page.versio {% include {{ page.version.version }}/known-limitations/cdc.md %} - {% include {{ page.version.version }}/known-limitations/cdc-execution-locality.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} ## See also diff --git a/src/current/v23.1/known-limitations.md b/src/current/v23.1/known-limitations.md index 09551645816..0259937a078 100644 --- a/src/current/v23.1/known-limitations.md +++ b/src/current/v23.1/known-limitations.md @@ -718,3 +718,5 @@ Change data capture (CDC) provides efficient, distributed, row-level changefeeds {% include {{ page.version.version }}/known-limitations/cdc.md %} {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} diff --git a/src/current/v23.2/cdc-queries.md b/src/current/v23.2/cdc-queries.md index 48e69326eff..20b20550d19 100644 --- a/src/current/v23.2/cdc-queries.md +++ b/src/current/v23.2/cdc-queries.md @@ -53,6 +53,7 @@ To emit different properties for a row, specify the following explicitly in CDC {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} ## CDC query function support diff --git a/src/current/v23.2/changefeeds-on-tables-with-column-families.md b/src/current/v23.2/changefeeds-on-tables-with-column-families.md index d329ab26a7d..91e115557fe 100644 --- a/src/current/v23.2/changefeeds-on-tables-with-column-families.md +++ b/src/current/v23.2/changefeeds-on-tables-with-column-families.md @@ -80,6 +80,8 @@ The output shows the `primary` column family with `4` in the value (`{"id":4,"na - When you do not specify column family names in the `CREATE` or `ALTER TABLE` statement, the family names will default to either of the following: - `primary`: Since `primary` is a key word, you'll receive a syntax error if you run `CREATE CHANGEFEED FOR table FAMILY primary`. To avoid this syntax error, use double quotes: `CREATE CHANGEFEED FOR table FAMILY "primary"`. You'll receive output from the changefeed like: `table.primary`. - `fam__`: For a table that does not include a name for the family: `FAMILY (id, name)`, you'll receive output from the changefeed containing: `table.fam_0_id_name`. This references the table, the family ID and the two columns that this column family includes. +- Creating a changefeed with [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) is not supported on tables with more than one column family. +- When you create a changefeed on a table with more than one column family, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. For more details, refer to [Message format](#message-format). For examples of starting changefeeds on tables with column families, see the following examples for Enterprise and Core changefeeds. diff --git a/src/current/v23.2/create-and-configure-changefeeds.md b/src/current/v23.2/create-and-configure-changefeeds.md index 73ac6e9b3b3..1b0c4bcce1d 100644 --- a/src/current/v23.2/create-and-configure-changefeeds.md +++ b/src/current/v23.2/create-and-configure-changefeeds.md @@ -183,6 +183,8 @@ For more information, see [`EXPERIMENTAL CHANGEFEED FOR`]({% link {{ page.versio - {% include {{ page.version.version }}/known-limitations/pcr-scheduled-changefeeds.md %} - {% include {{ page.version.version }}/known-limitations/cdc-execution-locality.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} ## See also diff --git a/src/current/v23.2/known-limitations.md b/src/current/v23.2/known-limitations.md index d0d42f3375c..88ce97f510c 100644 --- a/src/current/v23.2/known-limitations.md +++ b/src/current/v23.2/known-limitations.md @@ -709,3 +709,5 @@ Change data capture (CDC) provides efficient, distributed, row-level changefeeds - {% include {{ page.version.version }}/known-limitations/cdc-execution-locality.md %} {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} diff --git a/src/current/v24.1/cdc-queries.md b/src/current/v24.1/cdc-queries.md index 55ce8c9fdb5..c6aa634597e 100644 --- a/src/current/v24.1/cdc-queries.md +++ b/src/current/v24.1/cdc-queries.md @@ -53,6 +53,7 @@ To emit different properties for a row, specify the following explicitly in CDC {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} ## CDC query function support diff --git a/src/current/v24.1/changefeeds-on-tables-with-column-families.md b/src/current/v24.1/changefeeds-on-tables-with-column-families.md index d329ab26a7d..91e115557fe 100644 --- a/src/current/v24.1/changefeeds-on-tables-with-column-families.md +++ b/src/current/v24.1/changefeeds-on-tables-with-column-families.md @@ -80,6 +80,8 @@ The output shows the `primary` column family with `4` in the value (`{"id":4,"na - When you do not specify column family names in the `CREATE` or `ALTER TABLE` statement, the family names will default to either of the following: - `primary`: Since `primary` is a key word, you'll receive a syntax error if you run `CREATE CHANGEFEED FOR table FAMILY primary`. To avoid this syntax error, use double quotes: `CREATE CHANGEFEED FOR table FAMILY "primary"`. You'll receive output from the changefeed like: `table.primary`. - `fam__`: For a table that does not include a name for the family: `FAMILY (id, name)`, you'll receive output from the changefeed containing: `table.fam_0_id_name`. This references the table, the family ID and the two columns that this column family includes. +- Creating a changefeed with [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) is not supported on tables with more than one column family. +- When you create a changefeed on a table with more than one column family, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. For more details, refer to [Message format](#message-format). For examples of starting changefeeds on tables with column families, see the following examples for Enterprise and Core changefeeds. diff --git a/src/current/v24.1/create-and-configure-changefeeds.md b/src/current/v24.1/create-and-configure-changefeeds.md index 7427a07ab4e..4b01ac33dce 100644 --- a/src/current/v24.1/create-and-configure-changefeeds.md +++ b/src/current/v24.1/create-and-configure-changefeeds.md @@ -182,6 +182,8 @@ For more information, see [`EXPERIMENTAL CHANGEFEED FOR`]({% link {{ page.versio {% include {{ page.version.version }}/known-limitations/cdc.md %} - {% include {{ page.version.version }}/known-limitations/pcr-scheduled-changefeeds.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} ## See also diff --git a/src/current/v24.1/known-limitations.md b/src/current/v24.1/known-limitations.md index 29425ccf89f..89d3e6bdd64 100644 --- a/src/current/v24.1/known-limitations.md +++ b/src/current/v24.1/known-limitations.md @@ -486,6 +486,8 @@ Change data capture (CDC) provides efficient, distributed, row-level changefeeds {% include {{ page.version.version }}/known-limitations/cdc.md %} - {% include {{ page.version.version }}/known-limitations/pcr-scheduled-changefeeds.md %} {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} #### `ALTER CHANGEFEED` limitations diff --git a/src/current/v24.2/cdc-queries.md b/src/current/v24.2/cdc-queries.md index 55ce8c9fdb5..c6aa634597e 100644 --- a/src/current/v24.2/cdc-queries.md +++ b/src/current/v24.2/cdc-queries.md @@ -53,6 +53,7 @@ To emit different properties for a row, specify the following explicitly in CDC {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} ## CDC query function support diff --git a/src/current/v24.2/changefeeds-on-tables-with-column-families.md b/src/current/v24.2/changefeeds-on-tables-with-column-families.md index d329ab26a7d..91e115557fe 100644 --- a/src/current/v24.2/changefeeds-on-tables-with-column-families.md +++ b/src/current/v24.2/changefeeds-on-tables-with-column-families.md @@ -80,6 +80,8 @@ The output shows the `primary` column family with `4` in the value (`{"id":4,"na - When you do not specify column family names in the `CREATE` or `ALTER TABLE` statement, the family names will default to either of the following: - `primary`: Since `primary` is a key word, you'll receive a syntax error if you run `CREATE CHANGEFEED FOR table FAMILY primary`. To avoid this syntax error, use double quotes: `CREATE CHANGEFEED FOR table FAMILY "primary"`. You'll receive output from the changefeed like: `table.primary`. - `fam__`: For a table that does not include a name for the family: `FAMILY (id, name)`, you'll receive output from the changefeed containing: `table.fam_0_id_name`. This references the table, the family ID and the two columns that this column family includes. +- Creating a changefeed with [CDC queries]({% link {{ page.version.version }}/cdc-queries.md %}) is not supported on tables with more than one column family. +- When you create a changefeed on a table with more than one column family, the changefeed will emit messages per column family in separate streams. As a result, [changefeed messages]({% link {{ page.version.version }}/changefeed-messages.md %}) for different column families will arrive at the [sink]({% link {{ page.version.version }}/changefeed-sinks.md %}) under separate topics. For more details, refer to [Message format](#message-format). For examples of starting changefeeds on tables with column families, see the following examples for Enterprise and Core changefeeds. diff --git a/src/current/v24.2/create-and-configure-changefeeds.md b/src/current/v24.2/create-and-configure-changefeeds.md index 7427a07ab4e..4b01ac33dce 100644 --- a/src/current/v24.2/create-and-configure-changefeeds.md +++ b/src/current/v24.2/create-and-configure-changefeeds.md @@ -182,6 +182,8 @@ For more information, see [`EXPERIMENTAL CHANGEFEED FOR`]({% link {{ page.versio {% include {{ page.version.version }}/known-limitations/cdc.md %} - {% include {{ page.version.version }}/known-limitations/pcr-scheduled-changefeeds.md %} - {% include {{ page.version.version }}/known-limitations/alter-changefeed-cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} ## See also diff --git a/src/current/v24.2/known-limitations.md b/src/current/v24.2/known-limitations.md index 3e289d19d32..c0fc9639e75 100644 --- a/src/current/v24.2/known-limitations.md +++ b/src/current/v24.2/known-limitations.md @@ -471,6 +471,8 @@ Change data capture (CDC) provides efficient, distributed, row-level changefeeds {% include {{ page.version.version }}/known-limitations/cdc.md %} - {% include {{ page.version.version }}/known-limitations/pcr-scheduled-changefeeds.md %} {% include {{ page.version.version }}/known-limitations/cdc-queries.md %} +- {% include {{ page.version.version }}/known-limitations/cdc-queries-column-families.md %} +- {% include {{ page.version.version }}/known-limitations/changefeed-column-family-message.md %} #### `ALTER CHANGEFEED` limitations