This page answers the frequently asked questions about CockroachDB Serverless and CockroachDB Dedicated.
General
What is CockroachDB Dedicated?
CockroachDB Dedicated provides fully-managed, single-tenant CockroachDB clusters with no shared resources. CockroachDB Dedicated supports single and multi-region clusters in AWS and GCP.
What is the difference between CockroachDB Dedicated standard and advanced?
CockroachDB Dedicated advanced clusters have access to features required for PCI readiness in addition to all CockroachDB Dedicated standard features. You must be a contract customer to create a CockroachDB Dedicated advanced cluster. For more information, contact us.
In what clouds and regions is CockroachDB Dedicated available?
The following regions are available for CockroachDB Dedicated:
| GCP | AWS |
|---|---|
asia-east1 (Changhua County) |
ap-northeast-1 (Tokyo) |
asia-east2 (Hong Kong) |
ap-northeast-2 (Seoul) |
asia-northeast1 (Tokyo) |
ap-northeast-3 (Osaka) |
asia-southeast1 (Jurong West) |
ap-south-1 (Mumbai) |
australia-southeast1 (Australia) |
ap-southeast-1 (Singapore) |
europe-west1 (St. Ghislain) |
ap-southeast-2 (Sydney) |
europe-west2 (London) |
ca-central-1 (Central Canada) |
europe-west3 (Frankfurt) |
eu-central-1 (Frankfurt) |
europe-west4 (Eemshaven) |
eu-north-1 (Stockholm) |
northamerica-northeast1 (Montréal) |
eu-west-1 (Ireland) |
southamerica-east1 (São Paulo) |
eu-west-2 (London) |
us-central1 (Iowa) |
eu-west-3 (Paris) |
us-east1 (South Carolina) |
sa-east-1 (São Paulo) |
us-west1 (Oregon) |
us-east-2 (Ohio) |
us-west2 (California) |
us-west-2 (Oregon) |
We run CockroachDB Dedicated in EKS and GKE - the managed Kubernetes offerings for AWS and GCP respectively - and support all regions in which their offerings are available. If a particular region is not available on the CockroachDB Cloud Console, it is usually due to the cloud provider not supporting EKS or GKE in that region. See list of EKS regions and list of GKE regions for details.
Known issue: In addition to the non-GKE regions, we had to temporarily disable the following GCP regions due to GCP's quota restrictions:
- Mumbai (
asia-south1) - Osaka (
asia-northeast2) - Hamina (
europe-north1) - Frankfurt (
europe-west3) - Zurich (
europe-west6)
If you want to create a cluster in a disabled region, please contact Support.
How do CockroachDB Dedicated free trials work?
CockroachDB Dedicated offers a 30-day free trial. Free trials require a credit card so we can validate that you are not a bot and provide a seamless transition into production. Free trials apply when you:
- Create the first cluster in your organization
- Select 9 or fewer nodes (we recommend starting with 3 so you can try scaling)
- Select up to 4 vCPUs of compute and 150 GiB of storage (the trial code will not apply to larger clusters)
- Select a single region or 3 regions
- Don't remove the pre-applied trial code at check out
Once the 30-day period is over, your cluster can be scaled beyond the trial period hardware limitations. You can create other paid clusters at any time. If Cockroach Labs has provided you with additional codes, you can use those on applicable clusters. For extended trial options, contact us.
How do I connect to my cluster?
To connect to a cluster, you need to authorize your network, create a SQL user, download the CA certificate, and then generate a connection string or parameters. You can use this information to connect to your cluster through the CockroachDB SQL client or a PostgreSQL-compatible driver or ORM. For more details, see Connect to Your CockroachDB Dedicated Cluster.
Security
Is my cluster secure?
Yes. We create individual sub-accounts and VPCs for each cluster within the cloud provider. These VPCs are firewalled from each other and any other outside connection, unless allowlisted for SQL and Web UI ports.
The allowlist is comprised of IP addresses that you provide to us, and is an additional layer of protection for your cluster. Connections will only be accepted if they come from an allowlisted IP address, which protects against both compromised passwords and any potential bugs in the server.
We use separate certificate authorities for each cluster, and all connections to the cluster over the internet use TLS 1.2 or 1.3.
See the Security Overview page for more information, and for comparison of security options by CockroachDB product.
Is encryption-at-rest enabled on CockroachDB Dedicated?
All data in CockroachDB Serverless and CockroachDB Dedicated is encrypted-at-rest by your chosen infrastructre-as-a-service provider, Google Cloud Platform (GCP) or Amazon Web Services (AWS), at the infrastructure level.
CockroachDB Serverless and CockroachDB Dedicated users delegate responsibility for encryption-at-rest to the cloud provider. Hence, CockroachDB's proprietary storage-layer encryption-at-rest functionality is currently only available with an Enterprise license and is not currently available to users of CockroachDB Serverless or CockroachDB Dedicated.
As a result, encryption will appear to be disabled in the DB Console, since the console is unaware of cloud provider encryption.
See the Security Overview page for more information, and for comparison of security options by CockroachDB product.
Is my cluster isolated? Does it share resources with any other clusters?
CockroachDB Dedicated is a single-tenant offering and resources are not shared between clusters.
Who has access to my cluster data?
The Cockroach Labs SRE team has direct access to CockroachDB Cloud cluster data. They adhere to the confidentiality agreement described in our Terms and Conditions.
Cluster maintenance
How do I change the configurations on my cluster?
Contact Support to change your cluster configuration.
How do I add nodes?
You can add nodes by accessing the Clusters page on the CockroachDB Cloud Console and clicking the ... button for the cluster you want to add or delete nodes for. See Cluster Mangement for more details.
CockroachDB Cloud does not support scaling a multi-node cluster down to a single node.
Do you auto-scale?
Today, we do not automatically scale nodes based on your capacity usage. To add or remove nodes, see Cluster Mangement. There are plans to allow auto-scaling in the future.
Who is responsible for backup?
Cockroach Labs runs full backups daily and incremental backups hourly for every CockroachDB Dedicated cluster. Full backups are retained for 30 days and incremental backups for 7 days. Only CockroachDB Dedicated cluster backups are available to users at this time. See the Use Managed-Service Backups page for ways to restore data from your cluster's automatic backups in the Console.
The backups for AWS clusters are encrypted using AWS S3’s server-side encryption and the backups for GCP clusters are encrypted using Google-managed server-side encryption keys.
All databases are not backed up at the same time. Each database is backed up every hour based on the time of creation. For larger databases, you might see an hourly CPU spike while the database is being backed up.
You can also back up and restore data on your own. If you need additional help, contact us.
Can I download the backups that CockroachDB Cloud takes for me?
CockroachDB Cloud automated backups cannot be downloaded, but you can manually run a backup to your own storage location at any time. To do this, you will need either admin or SELECT privileges on the data you are backing up.
Can I restore my self-hosted CockroachDB cluster to CockroachDB Dedicated?
Yes. You can backup your self-hosted CockroachDB databases to an external location and then restore to your CockroachDB Cloud cluster.
If you are backing up the data to AWS or GCP, use the specified option for the AUTH parameter.
Can I set up VPC peering or AWS PrivateLink after my cluster is created?
AWS clusters can set up a PrivateLink connection at any time after the cluster is created.
GCP clusters can also set up VPC peering after the cluster is created, but you will be locked into our default IP range (172.28.0.0/14) unless you configure a different IP range during cluster creation. You can use the default IP range for VPC peering as long as it doesn't overlap with the IP ranges in your network. For more information, see VPC peering.
Product features
Are enterprise features available to me?
Yes, CockroachDB Dedicated clusters run the enterprise version of CockroachDB and all enterprise features are available to you.
Is there a public API for CockroachDB Cloud?
Yes, see the Cloud API page for more information. We’re always looking for design partners and customer input for our features, so please contact us if you have specific API requirements.
Do you have a UI? How can I see details?
All customers of our CockroachDB Dedicated service can view and manage their clusters in the Console.
What latency should I expect when making a call to CockroachDB Dedicated?
Response times are under 10ms for public access but typically much lower. Additionally, using VPC peering or AWS PrivateLink will reduce latency.
Support
Where can I find the Support Policy and Service Level Agreement (SLA) for CockroachDB Dedicated?
The following pages can be found in our Terms & Conditions:
Am I in control of upgrades for my CockroachDB Dedicated clusters?
Yes, an Org Administrator can apply major release upgrades directly through the CockroachDB Cloud Console; however, patch release upgrades are automatically applied to all clusters. CockroachDB Dedicated clusters are restarted one node at a time for patch version updates, so previously established connections will need to be reestablished after the restart. For more information, see the Upgrade Policy.
What is the support policy for older versions of the software?
CockroachDB Dedicated supports the latest major version of CockroachDB and the version immediately preceding it. We highly recommend running one of the two latest versions of CockroachDB, but we will never force a major upgrade to a cluster without your knowledge. You can contact Support if you require an exception.
How do I check to see if CockroachDB Cloud is down?
The CockroachDB Cloud Status page is a publicly available page that displays the current uptime status of the following services:
- CockroachDB Cloud Console: The UI used for signing up for CockroachDB Cloud, cluster creation and management, and user management.
- AWS: The status reported here reflects the health of existing AWS CockroachDB Cloud clusters and the ability to provision new clusters in AWS.
- GCP: The status reported here reflects the health of existing GCP CockroachDB Cloud clusters and the ability to provision new clusters in GCP.
Cluster troubleshooting
What do I do if my queries are too slow?
To optimize schema design to achieve your performance goals, we recommend working with our Sales Engineering team before you set up your cluster. You can also read our SQL Performance Best Practices and Query Performance Optimization docs for more information.
Can I monitor my cluster with third-party tools?
Yes, CockroachDB Dedicated clusters support an integration with Datadog that enables data collection and alerting on a subset of CockroachDB metrics. Enabling the Datadog integration on your CockroachDB Dedicated cluster will apply additional charges to your Datadog bill. See Monitor with Datadog for more information.
If you need additional help, contact Support.
Was this helpful?
