データベース フラグを構成する

このページでは、Cloud SQL のデータベース フラグを構成する方法について説明し、インスタンスに設定できるフラグの一覧も示します。データベース フラグは、SQL Server パラメータの調整、オプションの調整、インスタンスの構成や調整など、多くの操作で使用します。

データベース インスタンスのフラグを設定、削除、変更すると、データベースが再起動される場合があります。その場合、フラグの値はフラグを削除するまでインスタンスに対して保持されます。インスタンスがレプリカのソースである場合、レプリカもインスタンスの現在の構成に合わせて再起動します。

データベース フラグの構成

データベース フラグの設定

Console

  1. Google Cloud Console で新しい Cloud Console プロジェクトを作成するか、プロジェクト名を選択して既存のプロジェクトを開きます。
  2. インスタンスを開き、[編集] をクリックします。
  3. 下方向にスクロールして [フラグ] セクションを表示します。
  4. それまでにインスタンスで設定したことのないフラグを設定するには、[項目を追加] をクリックし、プルダウン メニューからフラグを選択して、その値を設定します。
  5. [保存] をクリックして、変更を保存します。
  6. [概要] ページの [フラグ] で、変更を確認します。

gcloud

インスタンスを編集します。

gcloud sql instances patch [INSTANCE_NAME] --database-flags [FLAG1=VALUE1,FLAG2=VALUE2]

このコマンドでは、以前に設定されたすべてのデータベース フラグが上書きされます。これらを保持し、新しいフラグを追加するには、インスタンスに設定するすべてのフラグの値を含めます。具体的に含まれていないフラグはデフォルト値に設定されます。値のないフラグについては、フラグ名の後に等号(=)を付けておきます。

REST v1beta4

既存のデータベースのフラグを設定するには:

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • project-id: プロジェクト ID
  • instance-id: インスタンス ID

HTTP メソッドと URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 本文のリクエスト:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "flag_name",
        "value": "flag_value"
      }
    ]
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

データベースにすでに構成されているフラグがある場合は、以前のコマンドを変更するときにそれらのフラグも含めるようにします。PATCH コマンドは、既存のフラグをリクエストで指定されているフラグで上書きします。

すべてのフラグをデフォルト値にクリアする

Console

  1. Google Cloud Console で新しい Cloud Console プロジェクトを作成するか、プロジェクト名を選択して既存のプロジェクトを開きます。
  2. インスタンスを開き、[編集] をクリックします。
  3. [データベースのフラグ] セクションを開きます。
  4. 表示されているフラグの横にある X をクリックします。
  5. [保存] をクリックして、変更を保存します。

gcloud

インスタンスのすべてのフラグをデフォルト値にクリアします。

gcloud sql instances patch [INSTANCE_NAME] --clear-database-flags

インスタンスを再起動する確認を求められます。

REST v1beta4

既存のインスタンスのフラグをすべてクリアするには:

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • project-id: プロジェクト ID
  • instance-id: インスタンス ID

HTTP メソッドと URL:

PATCH https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON 本文のリクエスト:

{
  "settings":
  {
    "databaseFlags": []
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

データベース フラグの現在の値を表示する

インスタンスに対して設定されているデータベース フラグを確認する

Cloud SQL インスタンスに対して設定されているフラグを確認するには:

Console

  1. Google Cloud Console で新しい Cloud Console プロジェクトを作成するか、プロジェクト名を選択して既存のプロジェクトを開きます。
  2. インスタンスを選択して、[インスタンスの概要] ページを開きます。

    設定済みのデータベース フラグは、[データベースのフラグ] セクションに一覧表示されます。

gcloud

インスタンスの状態を取得します。

gcloud sql instances describe [INSTANCE_NAME]

出力では、データベース フラグは settings の下にコレクション databaseFlags として一覧表示されます。出力でのフラグの表示の詳細については、インスタンスのリソースの表示をご覧ください。

REST v1beta4

インスタンスに構成されているフラグを一覧表示するには:

後述のリクエストのデータを使用する前に、次のように置き換えます。

  • project-id: プロジェクト ID
  • instance-id: インスタンス ID

HTTP メソッドと URL:

GET https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

リクエストを送信するには、次のいずれかのオプションを展開します。

次のような JSON レスポンスが返されます。

出力で databaseFlags フィールドを探します。

サポートされているフラグ

Cloud SQL フラグ
有効な値と注意事項
再起動が
必要か
ベータ版
1204(トレースフラグ) boolean
on | off
いいえ いいえ
1222(トレースフラグ) boolean
on | off
いいえ いいえ
1224(トレースフラグ) boolean
on | off
いいえ いいえ
2528(トレースフラグ) boolean
on | off
いいえ いいえ
3205(トレースフラグ) boolean
on | off
いいえ いいえ
3226(トレースフラグ) boolean
on | off
いいえ いいえ
3625(トレースフラグ) boolean
on | off
はい いいえ
4199(トレースフラグ) boolean
on | off
いいえ いいえ
4616(トレースフラグ) boolean
on | off
いいえ いいえ
7806(トレースフラグ) boolean
on | off
はい いいえ
access check cache bucket count integer
0 ... 65536
いいえ いいえ
access check cache quota integer
0 ... 2147483647
いいえ いいえ
affinity mask integer
2147483648 ... 2147483647
いいえ いいえ
agent xps boolean
on | off
いいえ いいえ
automatic soft-numa disabled boolean
on | off
はい いいえ
cost threshold for parallelism integer
0 ... 32767
いいえ いいえ
contained database authentication boolean
on | off
いいえ いいえ
cross db ownership chaining boolean
on | off
いいえ いいえ
cursor threshold integer
-1 ... 2147483647
いいえ いいえ
default full-text language integer
0 ... 2147483647
いいえ いいえ
default language integer
0 ... 2147483647
いいえ いいえ
default trace enabled boolean
on | off
いいえ いいえ
disallow results from triggers boolean
on | off
いいえ いいえ
external scripts enabled boolean
on | off
はい いいえ
ft crawl bandwidth (max) integer
0 ... 32767
いいえ いいえ
ft crawl bandwidth (min) integer
0 ... 32767
いいえ いいえ
ft notify bandwidth (max) integer
0 ... 32767
いいえ いいえ
ft notify bandwidth (min) integer
0 ... 32767
いいえ いいえ
fill factor (%) integer
0 ... 100
いいえ いいえ
index create memory (kb) integer
704 ... 2147483647
いいえ いいえ
locks integer
5000 ... 2147483647
はい いいえ
max server memory (mb) integer
128 ... 2147483647
いいえ いいえ
max text repl size (b) integer
-1 ... 2147483647
いいえ いいえ
max worker threads integer
128 ... 65535
いいえ いいえ
nested triggers boolean
on | off
いいえ いいえ
optimize for ad hoc workloads boolean
on | off
いいえ いいえ
ph timeout (s) integer
1 ... 3600
いいえ いいえ
query governor cost limit integer
0 ... 2147483647
いいえ いいえ
query wait (s) integer
-1 ... 2147483647
いいえ いいえ
recovery interval (min) integer
0 ... 32767
いいえ いいえ
remote access boolean
on | off
いいえ いいえ
remote login timeout (s) integer
0 ... 2147483647
いいえ いいえ
remote query timeout (s) integer
0 ... 2147483647
いいえ いいえ
transform noise words boolean
on | off
いいえ いいえ
two digit year cutoff integer
1753 ... 9999
いいえ いいえ
user connections integer
0 ... 32767
はい いいえ
user options integer
0 ... 32767
いいえ いいえ

次のステップ