This page provides information about the Cloud SQL quotas and limits. Quotas are applied per-project; limits are applied to the instance or to the project, depending on the limit.
Quotas
A quota restricts how much of a Google Cloud resource your Google Cloud project can use. Cloud SQL is an example of this type of resource.
For Cloud SQL, quotas are part of a system that do the following:
- Monitor your use or consumption of Cloud SQL instances
- Restrict your consumption of these instances for reasons including ensuring fairness and reducing spikes in usage
- Maintain configurations that enforce prescribed restrictions automatically
- Provide a means to make or request changes to the quota
When a quota is exceeded, in most cases, the system blocks access to the relevant instance immediately, and the task that you're trying to perform fails. Quotas apply to each Google Cloud project and are shared across all instances that use that project.
Permissions to check and increase your quotas
To check and increase your quotas, you need the following permissions:
serviceusage.quotas.get:check your quotasserviceusage.quotas.update:increase your quotas
By default, these permissions are included in the basic IAM roles of Editor and Owner and in the predefined Quota Administrator role. If you need additional permissions, then contact your quota administrator.
Check your quotas
To check the current quotas for resources in your project, go to the Quotas page in the Google Cloud console and filter for Cloud SQL Admin API. These quotas apply only to API calls; they don't include database queries.
Increase your quotas
As your use of Google Cloud expands over time, your quotas can increase accordingly. If you expect a notable upcoming increase in usage, then make your request a few days in advance to ensure your quotas are adequately sized.
There's no charge for requesting for a quota increase. Your costs increase only if you use more resources.
To increase your quotas, follow these steps:
In the Google Cloud console, go to the Quotas page.
Filter for the Cloud SQL Admin API service.
If you don't see this service, then enable the Cloud SQL Admin API.
Select the checkboxes next to the quotas that you want to change, and then click Edit quotas.
For each quota that you selected, in the New limit field, enter the value for the desired limit.
In the Reason description field, enter a reason for your request of a quota increase, and then click Done.
Click Next.
Fill out your name, email, and phone number, and then click Submit request.
If you have trouble increasing your quotas, then file a support case.
How resource quotas are replenished
Daily quotas are replenished daily at midnight Pacific Time.
Quotas and resource availability
Resource quotas are the maximum amount of resources you can create for that resource type if those resources are available. Quotas do not guarantee that resources are available at all times. If a resource isn't physically available for your region, then you can't create new resources of that type, even if you still have remaining quota in your project.
Rate quotas
Cloud SQL supports rate quotas, which are also known as rate limits or API quotas. Rate quotas define how many requests you can make to the Cloud SQL Admin API.
Each rate quota corresponds to all requests for a category of one or more Cloud SQL Admin API methods. Rate quotas reset after a time interval that's specific to Cloud SQL (for example, the number of API requests per minute).
When you use the gcloud CLI or the Google Cloud console, you're making requests to the Cloud SQL Admin API and these requests count toward your rate quotas. If you use service accounts to access the API, then these requests also count toward your rate quotas.
Cloud SQL enforces and refills rate quotas automatically over 60-second
intervals. If your project reaches a rate quota's limit any time within 60
seconds, then you must wait for that quota to refill before making more requests in
that category. If your project exceeds this limit, then you receive an HTTP 429 status
code with the reason of rateLimitExceeded.
The Cloud SQL Admin API is divided into the following categories:
- Connect: look up values that are required to connect to a Cloud SQL database.
- Get: retrieve information about a resource (for example, an instance, an operation, or a backup).
- List: list resources.
- Mutate: create, modify, and delete resources.
- Default per region: interact with a Cloud SQL instance without connecting to, retrieving, listing, or mutating it.
- Default: list database flags and machine types (tiers) for Cloud SQL instances. The APIs in this category are global.
Cloud SQL imposes rate quotas for each category per minute, per user, and per region. For each unique combination of these attributes, Cloud SQL imposes a separate rate limit.
The Cloud SQL Admin API produces detailed metrics that can help you track your usage of the API, monitor performance of your Cloud SQL instance and the API, and discover problems between your instance and the API. For more information, see Monitoring API usage.
The following table provides information about the metric, APIs, and default limit for each category:
| Category | Metric | APIs | Default limit |
|---|---|---|---|
| Connect |
The number of requests that are made per minute per user per region to use the APIs in this category. |
1000 | |
| Get |
The number of requests that are made per minute per user per region to use the APIs in this category. |
500 | |
| List |
The number of requests that are made per minute per user per region to use the APIs in this category. |
500 | |
| Mutate |
The number of requests that are made per minute per user per region to use the APIs in this category. |
|
180 |
| Default per region |
The number of default regional requests that are made per minute per user per region to use the APIs in this category. |
180 | |
| Default |
The number of default requests that are made per minute per user to use the APIs in this category. |
180 |
Limits
There are restrictions on some Cloud SQL resources that are not replenished periodically and not shown on the Quotas page in the Google Cloud console. Some limits can be increased while others cannot.
Configurable limits
Instances per project
By default, you can have up to 1000 instances per project except in some cases, where you might have a limit of 100. File a support case to request an increase. Read replicas are counted as instances.
We recommend that you distribute your instance count across multiple projects to reduce the reliance on quota increase requests. This helps you avoid any potential blockages.
Maximum concurrent connections
The actual number of user connections allowed depends on the version of SQL Server that you are using, and also the limits of your application or applications and hardware. SQL Server allows a maximum of 32,767 user connections.
For information about configuring user connections in SQL Server, see the reference documentation.
Caveats
Cloud SQL Connectors's quota usage
The Cloud SQL Auth Proxy and other Cloud SQL Connectors use Cloud SQL Admin API's quota. The quota usage is calculated as:
Quota used = Instances of the proxy * Instances of Cloud SQL * 2 per
refresh attempt
A refresh attempt happens when a connector starts up, and typically happens every hour after that, but can happen as often as every 30 seconds if something goes, such as an instance failover or Admin API call failure.
If you use automatic instance discovery or the -projects parameter, then you
might see high quota usage because of the large number of instances. While the
Cloud SQL Auth Proxy is running, it issues 2 API calls per hour per connected instance.
If you're getting started with Cloud SQL, then keeping note of the above formula, you should be mindful of:
How quickly you scale up new DB clients
How quickly you add more instances
Using different service accounts for each application
Cloud SQL IAM database authentication
There's a per-minute login quota for each instance, which includes both successful and unsuccessful logins. When the quota is exceeded, logins are unavailable temporarily. We recommend that you avoid frequent logins and restrict logins using authorized networks. The quota for authorization of logins is 3000 per minute, per instance.
Forwarding rule quota
Each Cloud SQL instance consists of a forwarding rule and a load balancer. There's quota limit on the forwarding rule, based on the kind of load balancer to which it's pointing. There are multiple quotas on each kind of forwarding rules, per project, per network and per peering group. There's also an override rule for per network quota and per peering group quotas, for Cloud SQL. This means when we bump up the per network quota for producer networks, the per peering group quota gets bumped to the same value as well.
Cloud SQL producer VPC is peered with customer's VPC, so we often hit per network quota for Cloud SQL producer network, and per peering group quota for customer's VPC.
When we hit the quota, certain operations could fail, which includes:
Create Operation: We need new forwarding rules when we create new instances.
Update Operation: We allow customers to switch the network of instances, so we need new forwarding rules in the new network.
Maintenance Operation: Forwarding rules get recreated.
If you experience such issues, then file a support case and we'll bump the relevant quota(s) for you.
Fixed limits
IOPS
IOPS are the number of input/output operations (or read/write) operations that your disk can process per second.
Cloud SQL uses Compute Engine virtual machines (VMs) with persistent storage disks. For details on specific VM performance characteristics, see the maximum sustained IOPS table on the persistent disk performance page.
Operations limit
Micro and small tier machine types limit the number of concurrent operations.
Exceeding these limits causes a Too many operations error.
The db-custom-1-3840 (single CPU) machine type limit is 50 concurrent operations.
Cloud SQL storage limits
- Dedicated core: Up to 64 TB.
See CPU and memory pricing for more information.
Cloud SQL storage options
To configure a storage option for best performance, it's important to understand your workload and choose the appropriate disk type and size. For more information on the available choices for Cloud SQL, see instance settings.App Engine limits
Each App Engine instance running in a standard environment cannot have more than 100 concurrent connections to an instance. For PHP 5.5 apps, the limit is 60 concurrent connections.
App Engine applications are subject to request time limits depending on usage and environment. For more information, see how instances are managed in App Engine standard environment standard and flexible environments.
App Engine applications are also subject to additional App Engine quotas and limits as discussed on the App Engine Quotas page.
Cloud Run limits
Cloud Run container instances are limited to 100 connections to a Cloud SQL database. Each instance of a Cloud Run service or job can have 100 connections to the database, and as this service or job scales, the total number of connections per deployment can grow.
Cloud Functions limits
Cloud Functions (1st gen) limits concurrent executions to one per instance. You never have a situation where a single 1st gen function instance is processing two requests at the same time. In most situations, only a single database connection is needed.
Cloud Functions (2nd gen) is based on Cloud Run and has a limit of 100 database connections per instance.