Add cloud-first release notes for v24.2.0

src/current/_config_cockroachdb.yml

@@ -3,5 +3,5 @@ current_cloud_version: v24.1
 destination: _site/docs
 homepage_title: CockroachDB Docs
 versions:
-  stable: v24.1
+  stable: v24.2
   dev: v24.2

src/current/_data/releases.yml

@@ -6509,4 +6509,38 @@
     docker_arm_experimental: false
     docker_arm_limited_access: false
   source: true
-  previous_release: v24.2.0-beta.3
+  previous_release: v24.2.0-beta.3
+
+- release_name: v24.2.0
+  major_version: v24.2
+  release_date: '2024-08-12'
+  release_type: Production
+  go_version: go1.22.5
+  sha: 953d09cce5a01cc0053e138516d80a27454f027c
+  has_sql_only: true
+  has_sha256sum: true
+  mac:
+    mac_arm: true
+    mac_arm_experimental: true
+    mac_arm_limited_access: false
+  windows: true
+  linux:
+    linux_arm: true
+    linux_arm_experimental: false
+    linux_arm_limited_access: false
+    linux_intel_fips: true
+    linux_arm_fips: false
+  docker:
+    docker_image: cockroachdb/cockroach
+    docker_arm: true
+    docker_arm_experimental: false
+    docker_arm_limited_access: false
+  source: true
+  previous_release: v24.2.0-rc.1
+  cloud_only: true
+  cloud_only_message_short: 'Available only for select CockroachDB Cloud clusters'
+  cloud_only_message: >
+      This version is currently available only for select
+      CockroachDB Cloud clusters. To request to upgrade
+      a CockroachDB self-hosted cluster to this version,
+      [contact support](https://support.cockroachlabs.com/hc/requests/new).

src/current/_includes/releases/v24.2/feature-detail-key.html

@@ -0,0 +1,25 @@
+<table>
+ <thead>
+  <tr>
+   <th id="feature-detail-key" colspan="2">Feature detail key</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>&starf;</td>
+   <td>Features marked "All&starf;" were recently made available in the CockroachDB Cloud platform. They are available for all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+  </tr>
+  <tr>
+   <td>&starf;&starf;</td>
+   <td>Features marked "All&starf;&starf;" were recently made available via tools maintained outside of the CockroachDB binary. They are available to use with all supported versions of CockroachDB, under the deployment methods specified in their row under Availability.</td>
+  </tr>
+  <tr>
+   <td>{% include icon-yes.html %}</td>
+   <td>Feature is available for this deployment method of CockroachDB as specified in the icon’s column: CockroachDB Self-Hosted, CockroachDB Dedicated, or CockroachDB Serverless.</td>
+  </tr>
+  <tr>
+   <td>{% include icon-no.html %}</td>
+   <td>Feature is not available for this deployment method of CockroachDB as specified in the icon’s column: CockroachDB Self-Hosted, CockroachDB Dedicated, or CockroachDB Serverless.</td>
+  </tr>
+ </tbody>
+</table>

src/current/_includes/releases/v24.2/feature-highlights-change-data-capture.html

@@ -0,0 +1,29 @@
+<table>
+ <thead>
+  <tr>
+   <th class="center-align" colspan="1" rowspan="2">Feature</th>
+   <th class="center-align" colspan="4" rowspan="1">Availability</th>
+  </tr>
+  <tr>
+   <th colspan="1" rowspan="1">Ver.</th>
+   <th colspan="1" rowspan="1" style="white-space: nowrap;">Self-Hosted</th>
+   <th colspan="1" rowspan="1">Dedicated</th>
+   <th colspan="1" rowspan="1">Serverless</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>
+    <p class="feature-summary">CockroachDB Changefeeds - Improved null handling usability</p>
+    <p class="feature-description">
+     <a href="https://www.cockroachlabs.com/docs/v24.2/change-data-capture-overview.html">Changefeed</a> users can distinguish between JSON <code>NULL</code> values and SQL <code>NULL</code> values in changefeed messages, by using the <a href="https://www.cockroachlabs.com/docs/v24.2/changefeed-messages#json">
+      <code>encode_json_value_null_as_object</code> option</a> with <code>CREATE CHANGEFEED</code>. This enables a consumer to distinguish an unset value from a null JSON token.
+    </p>
+   </td>
+   <td>24.2</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+ </tbody>
+</table>

src/current/_includes/releases/v24.2/feature-highlights-migrations.html

@@ -0,0 +1,44 @@
+<table>
+ <thead>
+  <tr>
+   <th class="center-align" colspan="1" rowspan="2">Feature</th>
+   <th class="center-align" colspan="4" rowspan="1">Availability</th>
+  </tr>
+  <tr>
+   <th colspan="1" rowspan="1">Ver.</th>
+   <th colspan="1" rowspan="1" style="white-space: nowrap;">Self-Hosted</th>
+   <th colspan="1" rowspan="1">Dedicated</th>
+   <th colspan="1" rowspan="1">Serverless</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>
+    <p class="feature-summary">MOLT tooling is now available as a Docker container</p>
+    <p class="feature-description">
+      Users can now deploy CockroachDB's MOLT <a href="https://www.cockroachlabs.com/docs/molt/molt-fetch.html">Fetch</a> and <a href="https://www.cockroachlabs.com/docs/molt/molt-verify.html">Verify</a> tools using a multi-platform Docker image that supports both <code>linux/amd64</code> and <code>linux/arm64</code> architectures. For installation details, refer to <a href="https://www.cockroachlabs.com/docs/releases/molt.html">MOLT Releases</a>.
+    </p>
+   </td>
+   <td>All<sup>&starf;&starf;</sup>
+   </td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+  <tr>
+   <td>
+    <p class="feature-summary">
+       MOLT Fetch transformation rules
+     </p>
+    <p class="feature-description">
+       Column exclusion, computed columns, and partitioned tables are now supported in table migrations with MOLT Fetch. They are supported via a new <a href="https://www.cockroachlabs.com/docs/molt/molt-fetch.html#transformations">transformations framework</a> that allows the user to specify a JSON file with instructions on how MOLT Fetch should treat certain schemas, tables, or underlying columns.
+     </p>
+   </td>
+   <td>All<sup>&starf;&starf;</sup>
+   </td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+ </tbody>
+</table>

src/current/_includes/releases/v24.2/feature-highlights-observability.html

@@ -0,0 +1,41 @@
+<table>
+ <thead>
+  <tr>
+   <th class="center-align" colspan="1" rowspan="2">Feature</th>
+   <th class="center-align" colspan="4" rowspan="1">Availability</th>
+  </tr>
+  <tr>
+   <th colspan="1" rowspan="1">Ver.</th>
+   <th colspan="1" rowspan="1" style="white-space: nowrap;">Self-Hosted</th>
+   <th colspan="1" rowspan="1">Dedicated</th>
+   <th colspan="1" rowspan="1">Serverless</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>
+    <p class="feature-summary">CockroachDB Dedicated clusters on Azure now integrate with Azure Monitor for metrics and logs (limited access)</p>
+    <p class="feature-description">
+      <a href="https://www.cockroachlabs.com/docs/cockroachcloud/export-logs?filters=azure-monitor-log-export">Exporting logs</a> to Azure Monitor Logs and <a href="https://www.cockroachlabs.com/docs/cockroachcloud/export-metrics?filters=azure-monitor-metrics-export">exporting metrics</a> to Azure Monitor Metrics and Prometheus-compatible metric sinks from your CockroachDB Dedicated cluster hosted on Azure is now supported in <a href="https://cockroachlabs.com/docs/stable/feature-availability.html">Limited Access</a>.
+    </p>
+   </td>
+   <td>All<sup>&starf;</sup>
+   </td>
+   <td class="icon-center">{% include icon-no.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-no.html %}</td>
+  </tr>
+  <tr>
+   <td>
+    <p class="feature-summary">Improved Overload Dashboard</p>
+    <p class="feature-description">
+      Updates to the <a href="https://www.cockroachlabs.com/docs/v24.2/ui-overload-dashboard">Overload dashboard</a> include moving important metrics nearer the top and adding more informative tooltips. These enhancements aim to help users more easily identify when <a href="https://www.cockroachlabs.com/docs/v24.2/admission-control">Admission Control</a> mechanisms are activated due to overload.
+    </p>
+   </td>
+   <td>v24.2</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+ </tbody>
+</table>

src/current/_includes/releases/v24.2/feature-highlights-operations.html

@@ -0,0 +1,42 @@
+<table>
+ <thead>
+  <tr>
+   <th class="center-align" colspan="1" rowspan="2">Feature</th>
+   <th class="center-align" colspan="4" rowspan="1">Availability</th>
+  </tr>
+  <tr>
+   <th colspan="1" rowspan="1">Ver.</th>
+   <th colspan="1" rowspan="1" style="white-space: nowrap;">Self-Hosted</th>
+   <th colspan="1" rowspan="1">Dedicated</th>
+   <th colspan="1" rowspan="1">Serverless</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>
+    <p class="feature-summary">CockroachDB Cloud Terraform Provider - Operations at scale</p>
+    <p class="feature-description">
+      This release includes updates to enhance operations at scale using the <a href="https://github.com/cockroachdb/terraform-provider-cockroach">CockroachDB Cloud Terraform Provider</a> across multiple Terraform projects. A new Resource for User Role Grants makes it easier to manage user account access to clusters across projects. A new Data Source for Folders allows better access to clusters organized in folders across multiple projects. A new Service Account Resource brings CockroachDB Cloud API access under Terraform management.
+    </p>
+   </td>
+   <td>All<sup>&starf;&starf;</sup>
+   </td>
+   <td class="icon-center">{% include icon-no.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+  <tr>
+   <td>
+    <p class="feature-summary">Support for Optional Innovation Releases</p>
+    <p class="feature-description">As of v24.2, CockroachDB has shifted from a 6-month <a href="https://www.cockroachlabs.com/docs/releases/release-support-policy.html">major version release cycle</a> to a 3-month cycle. The additional versions, called <a href="https://cockroachlabs.com/releases/release-support-policy#innovation-releases">Innovation releases</a>, are optional and can be skipped for CockroachDB Dedicated and Self-Hosted, but are required for CockroachDB Serverless. Innovation releases have shorter support windows than Regular releases. Users can upgrade directly from a Regular release to the next Regular release, without needing to upgrade to the intermediary Innovation release.
+    </p>
+    <p class="feature-description">In CockroachDB Dedicated, users can now choose to deploy or upgrade a cluster on any supported version. CockroachDB Serverless clusters continue to receive all major versions and patches for both Innovation releases and Regular releases as they become available.</p>
+   </td>
+   <td>24.2
+   </td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-no.html %} <br></br>(not skippable)</td>
+  </tr>
+ </tbody>
+</table>

src/current/_includes/releases/v24.2/feature-highlights-sql.html

@@ -0,0 +1,56 @@
+<table>
+ <thead>
+  <tr>
+   <th class="center-align" colspan="1" rowspan="2">Feature</th>
+   <th class="center-align" colspan="4" rowspan="1">Availability</th>
+  </tr>
+  <tr>
+   <th colspan="1" rowspan="1">Ver.</th>
+   <th colspan="1" rowspan="1" style="white-space: nowrap;">Self-Hosted</th>
+   <th colspan="1" rowspan="1">Dedicated</th>
+   <th colspan="1" rowspan="1">Serverless</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>
+    <p class="feature-summary">Vector search</p>
+    <p class="feature-description">
+      Users can now store <a href="https://www.cockroachlabs.com/docs/v24.2/vector.html">
+      <code>VECTOR</code>
+     </a> embeddings within CockroachDB with <code>pgvector</code>-compatible semantics to build AI-driven applications. Numerous <a href="https://www.cockroachlabs.com/docs/v24.2/functions-and-operators.html#pgvector-functions">built-in functions</a> have been added for running similarity search across vectors. Note that vector indexing is not supported in this release. This feature is in <a href="https://cockroachlabs.com/docs/stable/feature-availability.html">Preview</a> and requires an <a href="https://www.cockroachlabs.com/docs/stable/enterprise-licensing">Enterprise license</a>.
+    </p>
+   </td>
+   <td>24.2</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+  <tr>
+   <td>
+    <p class="feature-summary">Generic query plans</p>
+    <p class="feature-description">
+      Users can now enable <a href="https://www.cockroachlabs.com/docs/v24.2/cost-based-optimizer.html#query-plan-type">generic query plans</a>. Generic query plans optimize query execution for prepared statements by reusing precompiled query plans, and significantly reduce the CPU overhead associated with parsing and planning repeated queries, at the expense of plan quality. This feature is in <a href="https://cockroachlabs.com/docs/stable/feature-availability.html">Preview</a> and requires an <a href="https://www.cockroachlabs.com/docs/stable/enterprise-licensing">Enterprise license</a>.
+    </p>
+   </td>
+   <td>24.2</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+  <tr>
+   <td>
+    <p class="feature-summary">
+      COMMENT ON TYPE
+    </p>
+    <p class="feature-description">
+      CockroachDB users can now <a href="https://www.cockroachlabs.com/docs/v24.2/comment-on.html#add-a-comment-to-a-type">annotate a type with a comment</a> and reference the comment later for documentation purposes.
+    </p>
+   </td>
+   <td>24.2</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+   <td class="icon-center">{% include icon-yes.html %}</td>
+  </tr>
+ </tbody>
+</table>