Skip to main content


6.3.4 Do not configure 'user options' database flag for Cloud SQL on SQL Server instance (Automated)

Profile Applicability

• Level 1


Best practices recommend not configuring user options database flag for Cloud SQL on SQL Server instance.


The user options option specifies global defaults for all users. A list of default query processing options is established for the duration of a user's work session. The user options option allows you to change the default values of the SET options (if the server's default settings are not appropriate).

A user can override these defaults by using the SET statement. You can configure user options dynamically for new logins. After you change the setting of user options, new login sessions use the new setting; current login sessions are not affected. This recommendation is applicable to SQL Server database instances.


Setting custom flags via command line on certain instances will cause all omitted flags to be reset to defaults. This may cause you to lose custom flags and could result in unforeseen complications or instance restarts. Because of this, it is recommended you apply these flags changes during a period of low usage.


From Console:

  1. Go to the Cloud SQL Instances page in the Google Cloud Console by visiting
  2. Select the instance to open its Instance Overview page
  3. Ensure the database flag user options that has been set is not listed under the Database flags section.

From Command Line:

  1. Ensure the below command returns empty result for every Cloud SQL SQL Server database instance
gcloud sql instances list --format=json | jq '.settings.databaseFlags[] | select(.name=="user options")|.value'


From Console:

  1. Go to the Cloud SQL Instances page in the Google Cloud Console by visiting:
  2. Select the SQL Server instance for which you want to enable to database flag.
  3. Click Edit.
  4. Scroll down to the Flags section.
  5. Click the X next user options flag shown.
  6. Click Save to save your changes.
  7. Confirm your changes under Flags on the Overview page.

From Command Line:

  1. List all Cloud SQL database Instances:
gcloud sql instances list
  1. Clear the user options database flag for every Cloud SQL on SQL Server database instance using either of the below commands.

    1. Clearing all flags to their default value:

      gcloud sql instances patch <instance_name> --clear-database-flags
    2. To clear only user options database flag, configure the database flag by overriding the user options. Exclude user options flag and its value, and keep all other flags you want to configure.

      gcloud sql instances patch <instance_name> --database-flags [FLAG1=VALUE1,FLAG2=VALUE2]

This command overwrites all database flags previously set. To keep those and add new ones, include the values for all flags you want set on the instance; any flag not specifically included uses the default value. For flags that do not take a value, specify the flag name followed by an equals sign ("=").


Additional Information


This patch modifies database flag values, which may require you to restart your instance. The list of supported flags is on this page, along with details of which flags require a restart:


Some database flag settings can affect instance availability or stability, and remove the instance from the Cloud SQL Service-Level Agreement (SLA). For information about these flags, see Operational Guidelines.


Configuring the preceding flag does not restart the Cloud SQL instance.