Unsupported Features in CockroachDB Serverless

On this page Carat arrow pointing down

CockroachDB serverless is a managed multi-tenant deployment of CockroachDB that automatically scales up and down based on the load on the cluster. CockroachDB serverless works with almost all workloads that CockroachDB supports, but there are feature differences between CockroachDB self-hosted or CockroachDB dedicated clusters and CockroachDB serverless clusters. This topic describes the features that are either unsupported or partially supported in CockroachDB serverless clusters. Cockroach Labs intends to eliminate these feature gaps in future releases of CockroachDB serverless.

Change data capture

Distributed SQL (DistSQL) is not supported, which improves the performance of changefeeds.

You can't collect metrics per changefeed.

You can't configure alerts on changefeeds.

Backups

CockroachDB serverless only support automated full backups. Automated incremental and revision history backups are not supported. However, user managed incremental and revision history backups using user provided storage locations are supported.

Automated database and table level backups are not supported in CockroachDB serverless. However, user managed database and table level backups using user provided storage locations are supported.

Both CockroachDB serverless and CockroachDB dedicated clusters do not support automated locality-aware backups. However, user managed locality-aware backups using user provided storage locations are supported in CockroachDB serverless, CockroachDB dedicated, and CockroachDB self-hosted clusters. That is, you need to configure and manage your own locality-aware backups.

Performance

Distributed SQL (DistSQL) is not supported in CockroachDB serverless clusters, so users do not benefit from the improved query performance that DistSQL offers, especially for online analytical processing (OLAP) queries and bulk operations like IMPORT.

Multi-region clusters

CockroachDB serverless is only supported in a single region, and does not support multi-region features.

Follower reads

Follower reads are not supported in CockroachDB serverless clusters.

Range management

The ALTER TABLE ... SPLIT AT and ALTER RANGE ... RELOCATE statements are not supported in CockroachDB serverless.

Query cancellation using pgwire

Canceling queries from client drivers/ORMs using the PostgreSQL wire protocol (pgwire) is not supported in CockroachDB serverless.

Self service upgrades

CockroachDB serverless is a fully managed multi-tenant deployment of CockroachDB. Major and minor upgrades of CockroachDB are handled by Cockroach Labs, and can't be initiated by users.

Monitoring workloads and cluster health

The DB Console is not supported in CockroachDB serverless. The CockroachDB Cloud Console provides metrics and graphs to monitor the health, performance, and state of your cluster.

The Cloud Console provides a subset of observability information from the DB Console including SQL Metrics, SQL Activity, and Databases information. The Cloud Console does not include information from the following DB Console pages:

  • Non-SQL metrics
  • Network Latency
  • Hot ranges
  • Jobs
  • Advanced Debug

CockroachDB serverless clusters do not expose Prometheus endpoints.

Audit logs

There is no self-service way of accessing audit logs for CockroachDB serverless clusters. If you are running production workloads and need access to audit logs, contact Cockroach Labs Support.

Encryption

Encryption at rest is not supported in CockroachDB serverless clusters.

Customer-managed encryption keys (CMEK) are not supported in CockroachDB serverless clusters.


Yes No
On this page

Yes No