Stay organized with collections Save and categorize content based on your preferences.
This page provides information about the settings available for Cloud SQL instances.
Settings for Cloud SQL for SQL Server Setting Modifiable after creation? Possible values Instance ID N Composed of lowercase letters, numbers, and hyphens; must start with a letter. The total length must be 98 characters or less. Region N For Cloud SQL Enterprise Plus edition:africa-south1
— Johannesburg
asia-east1
— Taiwan
asia-east2
— Hong Kong
asia-northeast1
— Tokyo
asia-northeast3
— Seoul
asia-south1
— Mumbai
asia-southeast1
— Singapore
asia-southeast2
— Jakarta
australia-southeast1
— Sydney
australia-southeast2
— Melbourne
europe-central2
— Warsaw
europe-west1
— Belgium
europe-west2
— London
europe-west3
— Frankfurt
europe-west4
— Netherlands
europe-west6
— Zürich
europe-west8
— Milan
europe-west9
— Paris
europe-west10
— Berlin
europe-west12
— Turin
me-central1
— Doha
me-west1
— Tel Aviv
northamerica-northeast1
— Montréal
northamerica-northeast2
— Toronto
southamerica-east1
— San Paulo
us-central1
— Iowa
us-east1
— South Carolina
us-east4
— Northern Virginia
us-west1
— Oregon
us-west2
— Los Angeles
us-west3
— Salt Lake City
us-west4
— Las Vegas
For Cloud SQL Enterprise edition:
africa-south1
— Johannesburg
asia-east1
— Taiwan
asia-east2
— Hong Kong
asia-northeast1
— Tokyo
asia-northeast2
— Osaka
asia-northeast3
— Seoul
asia-south1
— Mumbai
asia-south2
— Delhi
asia-southeast1
— Singapore
asia-southeast2
— Jakarta
australia-southeast1
— Sydney
australia-southeast2
— Melbourne
europe-central2
— Warsaw
europe-north1
— Finland
europe-north2
— Stockholm
europe-southwest1
— Madrid
europe-west1
— Belgium
europe-west2
— London
europe-west3
— Frankfurt
europe-west4
— Netherlands
europe-west6
— Zürich
europe-west8
— Milan
europe-west9
— Paris
europe-west10
— Berlin
europe-west12
— Turin
me-central1
— Doha
me-central2
— Dammam
me-west1
— Tel Aviv
northamerica-northeast1
— Montréal
northamerica-northeast2
— Toronto
northamerica-south1
- Mexico
southamerica-east1
— São Paulo
southamerica-west1
— Santiago
us-central1
— Iowa
us-east1
— South Carolina
us-east4
— Northern Virginia
us-east5
— Columbus
us-south1
— Dallas
us-west1
— Oregon
us-west2
— Los Angeles
us-west3
— Salt Lake City
us-west4
— Las Vegas
Console string API enum string SQL Server 2019 EnterpriseFor Cloud SQL Enterprise edition:SQLSERVER_2019_ENTERPRISE
SQL Server 2022 Enterprise (default)SQLSERVER_2022_ENTERPRISE
Console string API enum string SQL Server 2017 StandardSQLSERVER_2017_STANDARD
SQL Server 2017 EnterpriseSQLSERVER_2017_ENTERPRISE
SQL Server 2017 ExpressSQLSERVER_2017_EXPRESS
SQL Server 2017 WebSQLSERVER_2017_WEB
SQL Server 2019 StandardSQLSERVER_2019_STANDARD
SQL Server 2019 EnterpriseSQLSERVER_2019_ENTERPRISE
SQL Server 2019 ExpressSQLSERVER_2019_EXPRESS
SQL Server 2019 WebSQLSERVER_2019_WEB
SQL Server 2022 Standard (default)SQLSERVER_2022_STANDARD
SQL Server 2022 EnterpriseSQLSERVER_2022_ENTERPRISE
SQL Server 2022 ExpressSQLSERVER_2022_EXPRESS
SQL Server 2022 WebSQLSERVER_2022_WEB
For resource limits of these versions, see Scale Limits.
Active Directory domain Y A dropdown menu for joining a managed Active Directory domain is available. The menu lists any Managed Microsoft AD domains in your project. From the dropdown menu, you can select a domain. For more information, see Overview of Managed Microsoft AD in Cloud SQL. Additionally, note the procedures and constraints for integrating with a managed AD domain in a different project. SSL mode Y Enforces/enables SSL as follows:ALLOW_UNENCRYPTED_AND_ENCRYPTED
: allows non-SSL/non-TLS and SSL/TLS connections. This is the default value.ENCRYPTED_ONLY
: only allows connections encrypted with SSL/TLS.requireSsl
to a compatible value or unset to avoid the conflict between values of two settings. For more information, see IpConfiguration. Server CA mode N
Lets you configure the server certificate authority (CA) for an instance. You can select one of the following available server CA options:
GOOGLE_MANAGED_INTERNAL_CA
: this is the default value for instances created with the gcloud CLI, the Cloud SQL Admin API, or Terraform. With this option, an internal CA dedicated to each Cloud SQL instance signs the server certificate for that instance.GOOGLE_MANAGED_CAS_CA
: with this option, a CA hierarchy consisting of a root CA and subordinate server CAs managed by Cloud SQL and hosted on Google Cloud Certificate Authority Service (CA Service) is used. The subordinate server CAs in a region sign the server certificates and are shared across instances in the region. For Cloud SQL Auth Proxy connections, to connect to an instance configured with the shared CA option, use the Cloud SQL Auth Proxy version 2.13.0 or later.CUSTOMER_MANAGED_CAS_CA
: with this option, you manage the CA hierarchy and the rotation of CA certificates. Before you can create an instance with this option, using CA Service, you create a CA pool in the same region as your instance and at least one CA in that pool. When you create your instance, you specify the CA pool. Your request is delegated to a project-specific service account, which has the permission to use the CA pool. The service account requests a CA from the pool and Cloud SQL uses that CA to sign the server certificate for the instance. For Cloud SQL Auth Proxy connections, to connect to an instance configured with the customer-managed CA option, use the Cloud SQL Auth Proxy version 2.14.3 or later.For more information, see Certificate authority (CA) hierarchies.
Set edition YENTERPRISE
or ENTERPRISE PLUS
To learn more about configuring simultaneous multithreading, see Simultaneous multithreading.
Storage type N SSD (only value)Note that creating or increasing storage capacity to 64 TB might increase latency of common operations, such as backups, dependent on your workload.
Enable automatic storage increases Y On (default value)There is also a drop-down menu with a list of multi-regions when you select Multi-region or regions when you select Region.
Instance deletion protection Y Activated or deactivated. Retain backups after instance deletion Y Activated or deactivated. Enable point-in-time recovery (PITR) YThe default value varies by instance. For more information, see Use PITR.
Availability: Single zone YThe instance ID is the name of the instance. It is used to uniquely identify your instance within the project. Choose an instance name that is aligned with the purpose of the instance when possible.
The total length of project-ID:instance-ID
must be 98 characters or less.
The number of CPUs for your instance.
The amount of memory available for your instance. For performance-sensitive workloads such as online transaction processing (OLTP), make sure that your instance has enough memory to contain the entire working set. However, there are other factors that can impact memory requirements, such as number of active connections. Perform load testing to avoid performance issues in production.
gcloud
command and REST API usage, see the reference documentation.
Storage type is determined by the machine type you select for your instance. Each machine type belongs to a specific machine series, and each machine series offers different storage type options.
Storage type by machine series:
Choosing SSD, the default value and only value, provides your instance with SSD storage. SSDs provide lower latency and higher data throughput.
You can integrate with Managed Microsoft AD, enabling Windows Authentication for the instance. To integrate, you choose a domain for the instance to join. For more information, see the Overview of Managed Microsoft AD in Cloud SQL.
(Optional) When you create an instance, you can select the server CA mode for the instance.
GOOGLE_MANAGED_INTERNAL_CA
: this is the default value. Cloud SQL creates a new self-signed server CA for each instance.GOOGLE_MANAGED_CAS_CA
: the instance uses a server CA hierarchy hosted by Certificate Authority Service and the issuing CAs are shared across all instances in the same region.CUSTOMER_MANAGED_CAS_CA
: the instance uses a server CA that you create from a CA pool. With this option, you manage the CA hierarchy and the rotation of CA certificates.For more information about these options, see Certificate authority (CA) hierarchies.
Choose a capacity to fit your database size. After you have created your instance, you can manually increase the storage capacity by editing your instance configuration, but you cannot decrease it. Increasing the storage capacity does not cause downtime.
The amount of storage capacity allocated for your instance affects the cost of your instance. For more information, see Storage and Networking Pricing.
For read replicas, the storage capacity must always be at least as high as the storage capacity of the primary instance. When a primary instance is resized, all read replicas are resized, if needed, so that they have at least as much storage capacity as the updated primary instance.
Note: Setting your storage capacity too small without enabling automatic storage increases can cause your instance to lose its SLA. Learn moreCloud SQL may override the enable automatic storage increases and automatic storage increase limit settings to perform critical database maintenance.
If you enable this setting, Cloud SQL checks your available storage every 30 seconds. If the available storage falls below a threshold size, Cloud SQL automatically adds additional storage capacity. If the available storage repeatedly falls below the threshold size, Cloud SQL continues to add storage until it reaches the maximum of 64 TB.
Note: You can increase storage size, but you cannot decrease it; the storage increases are permanent for the life of the instance. When you enable this setting, a spike in storage requirements can permanently increase storage costs (incrementally) for your instance. If an instance runs out of available space, it can cause the instance to go offline, and the Cloud SQL SLA might not cover the outage.The automatic storage increase setting of a primary instance automatically applies to any read replicas of that instance. The automatic storage increase setting cannot be independently set for read replicas.
Note: When an instance is nearly out of storage capacity, it's automatically stopped to prevent the loss of information. Enabling this setting might prevent such an operation. ThresholdThe threshold size depends on the amount of storage currently provisioned for your instance; it cannot be larger than 25 GB.
For instances provisioned with 500 GB of storage (or more), the threshold is always 25 GB.
For instances provisioned with less than 500 GB of storage, this formula is used to calculate the threshold:
5 + (provisioned storage)/25
The result of the division is rounded down to the nearest whole number.
Threshold calculation for an instance with 66 GB storage capacity:
5 + (1/25th of 66 GB) = 5 + (66/25) = 5 + 2.6 -> 5 + 2 = 7 GBThreshold calculation for an instance with 1000 GB storage capacity:
5 + (1/25th of 1000 GB) = 5 + (1000/25) = 5 + 40 = 45 -> rounded down to the maximum value of 25 GBAmount of storage added
The amount of storage added to the instance is equal to the threshold size, which cannot be larger than 25 GB.
Considerations for large disksFor instances provisioned with storage of 500 GB or more, the threshold size is always 25 GB and the amount of storage added is always 25 GB. As a result, the maximum possible empty space is 50 GB. If you do not manually resize the instance with disk greater than 5 TB, the disk can remain at 99% capacity all the time even though the instance has empty space.
Before an operation that rapidly grows disk space usage, such as a large import or a query that requires a large temp table, manually resize the disk, rather than depend on automatic storage increase to keep up.
The file system uses some space internally for file system metadata. This space isn't included in the disk usage metric (database/disk/bytes_used
). For large disks, the reserved space can take 1% to 3% of total disk size, so you might see the automatic storage increase occur before the disk usage reaches the threshold.
By default, your Cloud SQL instance is encrypted with a Google-owned and managed key. If you want to control this key, then use a customer-managed encryption key (CMEK) in Cloud Key Management Service (KMS). Cloud KMS integrates with Cloud SQL.
Using Cloud KMS keys gives you control over their protection level, location, rotation schedule, usage and access permissions. In addition, you can use various encryption keys across resources. Using Cloud KMS also lets you track key usage, view audit logs, and control key life cycles.
Instead of Google owning and managing the keys that protect your data, you control and manage these keys in Cloud KMS.
For more information about CMEKs, see About customer-managed encryption keys (CMEKs).
If you enable the automatic storage increase setting, you can provide a specific limit on how large the storage for your instance can automatically grow. Keep in mind that the bigger the size of the instance, the greater the operational latency.
You can't decrease storage size, so this limit can prevent your instance size from growing too large (due to a temporary increase in traffic). Keep in mind that when an instance becomes unable to add storage that it needs, the instance likely stops accepting incoming connections and could go offline.
Setting this limit to zero, the default value, means that there is no limit (other than the maximum available storage for the instance tier).
To set the limit when you create the instance, use the --storage-auto-increase-limit=INTEGER_VALUE_OF_GB
parameter, as described on the create instance page. To set the limit on an existing instance, use the same parameter with the gcloud beta sql instances patch
command.
The automatic storage increase limit setting of a primary instance automatically applies to any read replicas of that instance. The automatic storage increase limit setting cannot be independently set for read replicas.
These options determine if automated backups are performed and if transaction log backups are enabled. Both options add a small performance cost and use additional storage, but are required for the creation of replicas and clones, and for point-in-time recovery. When you select this option, you can also select a timeframe when automated backups occur.
Automated backups happen daily, during the time window you choose. At the end of seven days, the oldest backup is deleted.
For information about point-in-time recovery, see Overview of point-in-time recovery.
For information about replication, see Replication Options. For information about cloning instances, see Cloning Instances.
Note: Enabling or disabling point-in-time recovery causes the instance to be restarted. Existing database connections are closed and must be reopened.The default value for the number of retained backups is 7 but you can change it to any value in the range of 1 to 365.
See Automated backup and transaction log retention for more information.
You can choose to store backups in multiple or single regions. Multi-region is the default, and the recommended choice because it provides protection against downtime when a region becomes unavailable. Backups are stored in regions that are closest to the instance.
You also have the option of selecting a custom location for your backup. Only use this option if required by regulation or if an organization policy requires your backups to be in specific multiple or single regions. See Custom locations for more information.
Protects an instance against accidental deletion. If this setting is enabled, you must deactivate it before deleting the instance. See Prevent deletion of an instance.
Retains on-demand and automated backups for an instance after the instance is deleted. For more information about this setting, see Retained backups.
Point-in-time recovery lets you recover from a backup, starting from a specific point in time.
For information about point-in-time recovery, see Overview of point-in-time recovery.
Puts your instance and backups in a single zone. When you select this option, there is no failover in the event of an outage. Recommended only for test and development purposes.
When you select High availability (regional), if there is an outage, your instance fails over to another zone in the region where your instance is located, as long as the failover zone is not having an outage. It is recommended that you select High availability (regional) for instances in your production environment.
The day and hour that your maintenance events for the Cloud SQL instance are scheduled.
Read replicas do not support maintenance window settings at this time.
For more information about maintenance, see About maintenance on Cloud SQL instances.
Your preference about the relative timing of maintenance updates. You can receive your updates one or two weeks after the notification and test your maintenance updates in a test environment before your production instances get the update. You can also choose to receive the maintenance update five weeks ("week5
") after the notification is sent out. The maintenance timing setting doesn't affect the maintenance version that Cloud SQL applies to your instance.
If you don't set the maintenance timing setting, Cloud SQL chooses the timing of updates to your instance (within its maintenance window, if applicable).
For more information about maintenance, see About maintenance on Cloud SQL instances.
For information about configuring IP addresses, see Configuring IP connectivity.
Data cache is optional for Cloud SQL Enterprise Plus edition instances. Data cache utilizes local SSDs to extend the OS page cache from memory to the SSD tier. Cloud SQL manages this setting. Caching your entire working set provides maximum performance when using data cache. You can use the Google Cloud console, gcloud CLI, or Cloud SQL Admin API to turn this setting on or off for your Cloud SQL Enterprise Plus edition instances.
The following table shows the Data cache size for the various vCPU configurations. The Data cache size is fixed and is not configurable.
Performance-optimized machine family Enterprise plus machine type vCPUs Memory (GB) Data cache (GB) db-perf-optimized-N-2 2 16 375 db-perf-optimized-N-4 4 32 375 db-perf-optimized-N-8 8 64 375 db-perf-optimized-N-16 16 128 750 db-perf-optimized-N-32 32 256 1500 db-perf-optimized-N-48 48 384 3000 db-perf-optimized-N-64 64 512 6000 db-perf-optimized-N-80 80 640 6000 db-perf-optimized-N-96 96 768 6000 db-perf-optimized-N-128 128 864 9000 Memory-optimized machine family Machine type vCPUs Memory (GB) Data cache (GB) db-memory-optimized-N-4 4 128 750 db-memory-optimized-N-8 8 256 1500 db-memory-optimized-N-16 16 512 3000You can set specific database flags on the Cloud SQL instance.
For a complete list of the database flags you can set, see Configure Database Flags.
You can set a default collation value for the instance, as described on the Creating instances page. This collation setting is an instance-level default for sorting rules, case, and accent sensitivity in the instance databases.
This collation setting becomes the default for the system databases, too.
A collation setting of an instance or database is indicated in the Google Cloud console. You can verify an instance's default collation on the Instance Overview page (available through the Cloud SQL Instances page). Additionally, from the Instance Overview page, in the Navigation menu, you can click Databases to verify a specific database's collation setting.
This collation default is permanent at the instance level but not at the database level. You can change this default with a database administration tool, but only for a specific database that you are creating or updating. You cannot change the collation default for an instance after creating the instance (unless you recreate the instance).
If you clone an instance, the default collation carries over to the clone.
For a complete list of the supported collation settings, see Server-level collations.
This setting determines if database auditing is enabled. For more information, see SQL Server database auditing.
When you create an instance, you can set a time zone for the instance by using the --time-zone=WINDOWS_TIME_ZONE
parameter. The time zone for the instance can also be set or changed later by updating the settings of the instance using the --time-zone=WINDOWS_TIME_ZONE
parameter. If a time zone is not specified for the instance, the instance's time zone is UTC.
A read replica has the same time zone as its primary instance.
A clone has the same time zone as its source instance.
When you restore an instance from a backup, the source instance's time zone setting is applied to the restored instance; the time zone assigned to the backup isn't applied.
Note: Updating the time zone for your instance can cause inconsistencies in your data.For the available time zone values, see the Windows time zone column, under Time zone mapping.
Alternatively, you can get the available values by using this query:
SELECT * FROM sys.time_zone_info;
An example of a function for retrieving an instance's time zone is the following: SYSDATETIMEOFFSET. The AT TIME ZONE
function can be helpful for time conversions and more. For information about this function, see AT TIME ZONE (Transact-SQL).
The following time zones are unsupported for SQL Server 2017:
The following time zones are unsupported for all major versions, and may cause SQL Server to report incorrect times and UTC offsets if used:
For most instance settings, Cloud SQL applies the change immediately and connectivity to the instance is unaffected.
Changing the number of CPUs or the memory size results in the instance going offline for less than 60 seconds. Changing an instance's zone, configuring the private IP, changing its network, and enabling high availability results in the instance going offline for several minutes. Plan to make these kinds of changes when your service can handle an outage of this duration.
What's nextExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4