Como configurar sinalizações do banco de dados

MySQL | PostgreSQL | SQL Server

Nesta página, descrevemos como configurar sinalizações de banco de dados para o Cloud SQL e listamos as sinalizações que podem ser definidas para sua instância. É possível usar sinalizações de banco de dados em muitas operações, como no ajuste dos parâmetros do MySQL, das opções e na configuração e nos ajustes de uma instância.

Em alguns casos, para configurar uma sinalização pode ser necessário configurar outra para ativar toda a funcionalidade desejada. Por exemplo, para ativar a geração lenta de registros de consulta, é necessário definir as sinalização slow_query_log como on e a sinalização log_output como FILE. Dessa forma, os registros serão disponibilizados por meio do Visualizador de registros no Console do Google Cloud Platform.

Ao definir, remover ou mudar uma sinalização para uma instância de banco de dados, ele pode ser reiniciado. O valor da sinalização persiste nessa instância até você removê-lo. Se a instância for a origem de uma réplica, a réplica também será reiniciada para se alinhar com a configuração atual da instância.

Como configurar sinalizações do banco de dados

Como configurar uma sinalização do banco de dados

Console

No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
Importante: Você precisa estar ciente de que alguns identificadores de recurso, como IDs do projeto, podem ser mantidos além do tempo de vida do seu projeto. Por esse motivo, evite armazenar informações confidenciais em identificadores de recurso.
...consulte as diretrizes de nomenclatura
Abra a instância e clique em Editar.
Role a tela para baixo até a seção Sinalizações.
Para definir uma sinalização que ainda não tenha sido definida, clique em Adicionar item, selecione a sinalização no menu suspenso e defina o valor.
Clique em Salvar para salvar as alterações.
Confirme as alterações em Sinalizações, na página "Visão geral".

gcloud

Edite a instância:

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

Esse comando substituirá todas as sinalizações do banco de dados definidas anteriormente. Para manter essas sinalizações e adicionar novas, inclua os valores de todas as que você quiser configurar na instância. Qualquer sinalização não incluída especificamente será definida com o valor padrão. Para sinalizações sem valor, especifique o nome da sinalização seguido de um sinal de igual ("=").

Por exemplo, para definir os sinalizadores general_log, skip_show_database e wait_timeout, use o seguinte comando:

gcloud sql instances patch [INSTANCE_NAME] --database-flags \
    general_log=on,skip_show_database=on,wait_timeout=200000

REST v1beta4

Para definir uma sinalização de um banco de dados atual:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: em relação ao comando abaixo, presume-se que você usou gcloud init ou gcloud auth login para autenticar gcloud com sua conta de usuário. É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Por exemplo, para definir a sinalização general_log para um banco de dados existente, use:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "databaseFlags":
    [
      {
        "name": "general_log",
        "value": "on"
      }
    ]
  }
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Se houver sinalizações para o banco de dados, modifique o comando anterior para incluí-las. O comando PATCH substitui as sinalizações existentes pelas especificadas na solicitação.

Como redefinir as sinalizações ao valor padrão

Console

No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
Importante: Você precisa estar ciente de que alguns identificadores de recurso, como IDs do projeto, podem ser mantidos além do tempo de vida do seu projeto. Por esse motivo, evite armazenar informações confidenciais em identificadores de recurso.
...consulte as diretrizes de nomenclatura
Abra a instância e clique em Editar.
Abra a seção Sinalizações do banco de dados.
Clique no X ao lado de todas as sinalizações exibidas.
Clique em Salvar para salvar as alterações.

gcloud

Redefina todas as sinalizações ao valor padrão em uma instância:

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

Confirme se a instância será reiniciada.

REST v1beta4

Para apagar todas as sinalizações de uma instância existente:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo chamado request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Como visualizar os valores atuais das sinalizações do banco de dados

Para visualizar todos os valores atuais das variáveis do sistema MySQL, faça login na instância com o cliente mysql e insira a seguinte instrução:

 SHOW VARIABLES;

É possível alterar o valor somente para sinalizações compatíveis (conforme listado abaixo).

Como determinar quais sinalizações do banco de dados foram configuradas para uma instância

Para ver quais sinalizações foram definidas para uma instância do Cloud SQL:

Console

No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
Importante: Você precisa estar ciente de que alguns identificadores de recurso, como IDs do projeto, podem ser mantidos além do tempo de vida do seu projeto. Por esse motivo, evite armazenar informações confidenciais em identificadores de recurso.
...consulte as diretrizes de nomenclatura
Selecione a instância para abrir a página Visão geral da instância.
As sinalizações do banco de dados que foram configuradas estão listadas na seção Sinalizações do banco de dados.

gcloud

Veja o estado da instância:

gcloud sql instances describe [INSTANCE_NAME]

Na saída, as sinalizações do banco de dados são listados no settings como a coleção databaseFlags. Para saber mais sobre a representação das sinalizações na saída, consulte Representação do recurso das instâncias.

REST v1beta4

Para listar as configurações de uma instância:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell (Windows)

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

{
  "settings":
  {
    "authorizedGaeApplications": [],
    "tier": "machine-type",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration":
    {
      "privateNetwork": "projects/project-id/global/networks/default",
      "authorizedNetworks": [],
      "ipv4Enabled": false
    },
    "locationPreference":
    {
      "zone": "zone",
      "kind": "sql#locationPreference"
    },
    "databaseFlags": [
      {
        "name": "general_log",
        "value": "on"
      }
    ],
    "dataDiskType": "PD_SSD",
    "maintenanceWindow":
    {
      "kind": "sql#maintenanceWindow",
      "hour": 0,
      "day": 0
    },
    "backupConfiguration":
    {
      "startTime": "03:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "54",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  }
}

Na saída, procure o campo databaseFlags.

Sinalizações aceitas

As sinalizações compatíveis no Cloud SQL são as mais solicitadas para o MySQL.

Para uma determinada sinalização, o Cloud SQL pode aceitar uma faixa diferente do parâmetro ou da opção correspondente do MySQL.

As sinalizações são aplicáveis a todas as versões do MySQL compatíveis com o Cloud SQL, exceto quando indicado.

A | B | C | D | E | F | G | I | L | M | N | O | P | Q | R | S | T | U | W

Sinalização do Cloud SQL	Digite Valores e notas aceitáveis	Necessário reiniciar?	Em Beta?
activate_all_roles_on_login	`boolean` `on` \| `off` padrão: `off` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
auto_increment_increment	`integer` `1` ... `65535`	Não	Não
auto_increment_offset	`integer` `1` ... `65535`	Não	Não
binlog_cache_size	`integer` `4096` ... `9223372036854775807`	Não	Não
binlog_row_image	`enumeration` `full` (padrão), `minimal`, ou `noblob`	Não	Não
binlog_stmt_cache_size	`4096` ... `9223372036854775807`	Não	Não
binlog_transaction_dependency_history_size	`integer` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
binlog_transaction_dependency_tracking	`enumeration` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
character_set_server	`string` utf8 ou utf8mb4 (recomendado)	Sim	Não
default_password_lifetime	`integer` `0...65535` padrão: `0` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
default_time_zone	`string` Especifique valores como deslocamentos de fuso horário, de `-12:59` a `+13:00`. Zeros à esquerda são obrigatórios. Por exemplo, Londres está no fuso horário UTC, que é +00:00 nos valores suportados para essa sinalização. Áreas com nome, como "Europa/Londres", não são compatíveis com o Cloud SQL. Observação: o ajuste automático do horário de verão não é compatível, e é necessário atualizar essa sinalização manualmente para contabilizá-la.	Sim	Não
disconnect_on_expired_password	`boolean` `on` \| `off` padrão: `on` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Sim	Não
eq_range_index_dive_limit	`integer` `0` ... `2147483647`	Não	Não
event_scheduler	`boolean` `on` \| `off` Se você estiver usando o Programador de eventos, configure a instância com uma política de ativação definida como SEMPRE para garantir a execução dos eventos programados.	Não	Não
explicit_defaults_for_timestamp	`boolean` `on` \| `off`	Não	Não
ft_max_word_len	`integer` `10` ... `252`	Sim	Não
ft_min_word_len	`integer` `1` ... `16`	Sim	Não
ft_query_expansion_limit	`integer` `0` ... `1000`	Sim	Não
general_log	`boolean` `on` \| `off` Consulte a seção Dicas para mais informações sobre registros gerais.	Não	Não
generated_random_password_length	`integer` `5-255` padrão: `20` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
group_concat_max_len	`integer` `4` ... `17179869184`	Não	Não
init_connect	`string`	Não	Não
innodb_adaptive_hash_index	`boolean` `on` \| `off`	Não	Não
innodb_adaptive_hash_index_parts	`integer` `1` ... `512`	Sim	Não
innodb_adaptive_max_sleep_delay	`integer` `0` ... `1000000`	Não	Não
innodb_autoinc_lock_mode	`integer` `0` ... `2`	Sim	Não
innodb_change_buffer_max_size	`integer` `0` ... `50`	Não	Não
innodb_concurrency_tickets	`integer` `1` ... `4294967295`	Não	Não
innodb_file_per_table	`boolean` `on` \| `off` Consulte a seção Dicas para mais informações sobre esta sinalização.	Não	Não
innodb_fill_factor	`integer` `10` ... `100`	Não	Não
innodb_ft_cache_size	`integer` `1600000` ... `80000000`	Sim	Não
innodb_ft_enable_diag_print	`boolean` `on` \| `off`	Não	Não
innodb_ft_enable_stopword	`boolean` `on` \| `off`	Não	Não
innodb_ft_max_token_size	`integer` `10` ... `252` Compatível apenas com MySQL 5.6 e versões posteriores.	Sim	Não
innodb_ft_min_token_size	`integer` `0` ... `16` Compatível apenas com MySQL 5.6 e versões posteriores.	Sim	Não
innodb_ft_num_word_optimize	`integer` `1000` ... `10000`	Não	Não
innodb_ft_result_cache_limit	`integer` `1000000` ... `4294967295`	Não	Não
innodb_ft_server_stopword_table	`string` Compatível apenas com MySQL 5.6 e versões posteriores.	Não	Não
innodb_ft_sort_pll_degree	`integer` `1` ... `32`	Sim	Não
innodb_ft_total_cache_size	`integer` `32000000` ... `1600000000`	Sim	Não
innodb_ft_user_stopword_table	`string`	Não	Não
innodb_large_prefix	`boolean` `on` \| `off` Compatível apenas com MySQL 5.6.	Não	Não
innodb_lock_wait_timeout	`integer` `1` ... `1073741824`	Não	Não
innodb_log_buffer_size	`integer` `262144` ... `4294967295`	Sim	Não
innodb_log_file_size	`integer` MySQL 5.6: `1048576` ... `274877906944` MySQL 5.7: `4194304` ... `274877906944`	Sim	Não
innodb_lru_scan_depth	`integer` `100` ... `9223372036854775807`	Não	Não
innodb_old_blocks_pct	`integer` `5` ... `95`	Não	Não
innodb_old_blocks_time	`integer` `0` ... `4294967295`	Não	Não
innodb_online_alter_log_max_size	`integer` `65536` ... `9223372036854775807`	Não	Não
innodb_optimize_fulltext_only	`boolean` `on` \| `off`	Não	Não
innodb_print_all_deadlocks	`boolean` `on` \| `off`	Não	Não
innodb_random_read_ahead	`boolean` `on` \| `off`	Não	Não
innodb_read_ahead_threshold	`integer` `0` ... `64`	Não	Não
innodb_read_io_threads	`integer` `1` ... `64`	Sim	Não
innodb_replication_delay	`integer` `0` ... `4294967295`	Não	Não
innodb_rollback_on_timeout	`boolean` `on` \| `off`	Sim	Não
innodb_rollback_segments	`integer` `1` ... `128`	Não	Não
innodb_sort_buffer_size	`integer` `65536` ... `67108864`	Sim	Não
innodb_stats_auto_recalc	`boolean` `on` \| `off`	Não	Não
innodb_stats_method	`enumeration` `nulls_equal` \| `nulls_unequal` \| `nulls_ignored`	Não	Não
innodb_stats_on_metadata	`boolean` `on` \| `off`	Não	Não
innodb_stats_persistent	`boolean` `on` \| `off`	Não	Não
innodb_stats_persistent_sample_pages	`integer` `1` ... `9223372036854775807`	Não	Não
innodb_stats_sample_pages	`integer` `1` ... `9223372036854775807`	Não	Não
innodb_stats_transient_sample_pages	`integer` `1` ... `9223372036854775807`	Não	Não
innodb_status_output	`boolean` `on` \| `off`	Não	Não
innodb_status_output_locks	`boolean` `on` \| `off`	Não	Não
innodb_strict_mode	`boolean` `on` \| `off`	Não	Não
innodb_thread_concurrency	`integer` `0` ... `1000`	Não	Não
innodb_thread_sleep_delay	`integer` `0` ... `1000000`	Não	Não
innodb_write_io_threads	`integer` `1` ... `64`	Sim	Não
interactive_timeout	`integer` `1` ... `31536000`	Não	Não
join_buffer_size	`integer` `128` ... `9223372036854775807`	Não	Não
local_infile	`boolean` `on` \| `off`	Não	Não
lock_wait_timeout	`integer` `1` ... `31536000`	Não	Não
log_bin_trust_function_creators	`boolean` `on` \| `off`	Não	Não
log_output	`set` `FILE` \| `TABLE` \| `NONE`	Não	Não
log_queries_not_using_indexes	`boolean` `on` \| `off`	Não	Não
log_throttle_queries_not_using_indexes	`integer` `0` ... `9223372036854775807`	Não	Não
long_query_time	`float` `0` ... `30000000` O Cloud SQL possibilita que você defina esta sinalização para menos de 1, se necessário. Se a sinalização `log_queries_not_using_indexes` também estiver ativada, será possível ver as consultas com menos do que o tempo especificado aqui.	Não	Não
lower_case_table_names	`integer` `0` ou `1` Na maioria dos casos, use o valor padrão 0. Isso faz com que os nomes de tabela e banco de dados diferenciem maiúsculas e minúsculas. Se você precisar alterar o valor dessa sinalização, confirme como a alteração afetará suas tabelas e bancos de dados atuais. Essa sinalização não é compatível com o MySQL 8 para Cloud SQL.	Sim	Não
mandatory_roles	`string` `role name` padrão: `empty string` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
max_allowed_packet	`integer` `16384` ... `1073741824` Esse valor precisa ser um múltiplo de 1024, se sql_mode=TRADITIONAL ou sql_mode=STRICT_ALL_TABLES.	Não	Não
max_binlog_size	`integer` `4096` ... `1073741824`	Não	Não
max_connections	`integer` `25` ... `100000`	Não	Não
max_digest_length	`integer` `0` ... `1048576`	Sim	Não
max_execution_time	`integer` `0` ... `9223372036854775807`	Não	Não
max_heap_table_size	`integer` `16384` ... `67108864` Consulte a seção Dicas para mais informações sobre esta sinalização.	Não	Não
max_join_size	`integer` `16` ... `9223372036854775807`	Não	Não
max_length_for_sort_data	`integer` `4` ... `8388608`	Não	Não
max_points_in_geometry	`integer` `3` ... `1048576`	Não	Não
max_prepared_stmt_count	`integer` `0` ... `1048576`	Não	Não
max_seeks_for_key	`integer` `1` ... `9223372036854775807`	Não	Não
max_sort_length	`integer` `4` ... `8388608`	Não	Não
max_sp_recursion_depth	`integer` `0` ... `255`	Não	Não
max_user_connections	`integer` `0` ... `4294967295`	Não	Não
max_write_lock_count	`integer` `1` ... `9223372036854775807`	Não	Não
net_read_timeout	`integer` `30` ... `4294967295`	Não	Não
net_retry_count	`integer` `10` ... `4294967295`	Não	Não
net_write_timeout	`integer` `60` ... `4294967295`	Não	Não
optimizer_prune_level	`integer` `0` ... `1`	Não	Não
optimizer_search_depth	`integer` `0` ... `62`	Não	Não
optimizer_trace_max_mem_size	`integer` `0` ... `9223372036854775807`	Não	Não
optimizer_trace_offset	`integer` `-9223372036854775808` ... `9223372036854775807`	Não	Não
parser_max_mem_size	`integer` `10000000` ... `9223372036854775807`	Não	Não
password_history	`integer` `0-4294967295` padrão: `0` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
password_require_current	`boolean` `on` \| `off` padrão: `off` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
password_reuse_interval	`integer` `0-4294967295` padrão: `0` Observação: a sinalização é compatível no MySQL 8.0 do Cloud SQL.	Não	Não
performance_schema	`boolean` `on` \| `off` (padrão) Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_accounts_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_digests_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_stages_history_long_size	`integer` `-1` ... `1048576`	Sim	Não
performance_schema_events_stages_history_size	`integer` `-1` ... `1024` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_statements_history_long_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_statements_history_size	`integer` `-1` ... `1024` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_transactions_history_long_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_transactions_history_size	`integer` `-1` ... `1024` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_waits_history_long_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_events_waits_history_size	`integer` `-1` ... `1024` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_hosts_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_cond_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_cond_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_digest_length	`integer` `0` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_file_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_file_handles	`integer` `0` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_file_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_index_stat	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_memory_classes	`integer` `0` ... `1024` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_metadata_locks	`integer` `-1` ... `104857600` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_mutex_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_mutex_instances	`integer` `-1` ... `104857600` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_prepared_statements_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_program_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_rwlock_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_rwlock_instances	`integer` `-1` ... `104857600` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_socket_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_socket_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_sql_text_length	`integer` `0` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_stage_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_statement_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_statement_stack	`integer` `1` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_table_handles	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_table_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_table_lock_stat	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_thread_classes	`integer` `0` ... `256` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_max_thread_instances	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_session_connect_attrs_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_setup_actors_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_setup_objects_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
performance_schema_users_size	`integer` `-1` ... `1048576` Consulte a seção Dicas para mais informações sobre sinalizações performance_schema.	Sim	Não
query_alloc_block_size	`integer` `1024` ... `4294967295`	Não	Não
query_cache_limit	`integer` `0` ... `223338299392`	Não	Não
query_cache_min_res_unit	`integer` `0` ... `9223372036854775807`	Não	Não
query_cache_size	`integer` `0` ... `223338299392` Consulte a seção Dicas para mais informações sobre esta sinalização.	Não	Não
query_cache_type	`enumeration` `0` ... `2` Consulte a seção Dicas para mais informações sobre esta sinalização.	Sim	Não
query_cache_wlock_invalidate	`boolean` `on` \| `off`	Não	Não
query_prealloc_size	`integer` `8192` ... `9223372036854775807`	Não	Não
range_alloc_block_size	`integer` `4096` ... `4294967295`	Não	Não
range_optimizer_max_mem_size	`integer` `0` ... `9223372036854775807`	Não	Não
read_buffer_size	`integer` `8192` ... `2147483647`	Não	Não
read_only	`boolean` `on` \| `off` Não afeta as réplicas.	Não	Não
read_rnd_buffer_size	`integer` `1` ... `2147483647`	Não	Não
show_compatibility_56	`boolean` `on` \| `off` Compatível apenas com MySQL 5.7.	Não	Não
skip_show_database	`flag` `on` \| `off`	Sim	Não
slave_parallel_type	`enumeration` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
slave_parallel_workers	`integer` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
slave_preserve_commit_order	`boolean` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
slave_pending_jobs_size_max	`integer` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
slow_query_log	`integer` `0` \| `1` Consulte a seção Dicas para mais informações sobre registros de consulta lentos.	Não	Não
sort_buffer_size	`integer` `32768` ... `9223372036854775807`	Não	Não
sql_mode	`string` Consulte Server SQL Modes na documentação do MySQL para ver os valores permitidos. A inclusão de modos combinados, como `ANSI`.`NO_DIR_IN_CREATE` não é aceita. Se você especificar uma lista separada por vírgulas usando os comandos gcloud, use o argumento --flags-file.	Não	Não
stored_program_cache	`integer` `16` ... `524288`	Não	Não
sync_binlog	`integer` `0` ... `4294967295` Compatível somente no MySQL 5.7 e 8.0 e em instâncias de réplica (não compatível com réplicas de failover de HA legadas). Se houver a remoção de uma réplica que usa essa sinalização, a sinalização será removida. Ela não é compatível com instâncias primárias e autônomas. 0 = desativa a sincronização do registro binário com o disco. 1 (padrão) = ativa a sincronização do registro binário com o disco antes de as transações serem confirmadas. Essa é a configuração mais segura, mas pode afetar o desempenho devido ao número maior de gravações no disco. N = em que N é um valor diferente de 0 ou 1: o registro binário é sincronizado com o disco depois que N grupos de confirmação do registro binário são coletados. Essa configuração pode ter um impacto negativo no desempenho devido ao maior número de gravações de disco. Um valor maior melhora o desempenho, mas aumenta o risco de perda de dados. O período de retenção do binlog em instâncias de réplica é definido automaticamente para um dia, ao contrário de sete dias em instâncias primárias.	Não	Não
table_definition_cache	`integer` `400` ... `524288`	Não	Não
table_open_cache	`integer` `1` ... `524288`	Não	Não
table_open_cache_instances	`integer` `1` ... `64`	Sim	Não
thread_cache_size	`integer` `0` ... `16384`	Não	Não
thread_stack	`integer` `131072` ... `9223372036854775807`	Sim	Não
tmp_table_size	`integer` `1024` ... `67108864` Consulte a seção Dicas para mais informações sobre essa sinalização.	Não	Não
transaction_alloc_block_size	`integer` `1024` ... `131072`	Não	Não
transaction_isolation	`enumeration` `READ-UNCOMMITTED` \| `READ-COMMITTED` \| `REPEATABLE-READ` \| `SERIALIZABLE`	Sim	Não
transaction_prealloc_size	`integer` `1024` ... `131072`	Não	Não
transaction_write_set_extraction	`enumeration` Para informações sobre como usar essa sinalização e os valores aceitáveis, consulte Como configurar a replicação paralela.	Não	Não
updatable_views_with_limit	`integer` `0` ... `1`	Não	Não
wait_timeout	`integer` `1` ... `31536000`	Não	Não

Dicas para trabalhar com sinalizações

general_log, slow_query_log

Para tornar disponíveis os registros general ou slow query, ative a sinalização correspondente e defina a sinalização log_output como FILE. Isso disponibiliza a saída de registro usando o visualizador de registros no Console do Google Cloud. As cobranças de registro do pacote de operações do Google Cloud são aplicáveis. Para minimizar o custo de armazenamento da instância, os registros general e slow query no disco da instância serão alternados quando o arquivo de registros tiver mais de 24 horas (e nenhuma alteração tiver sido feita dentro dessa duração) ou maior que 100 MB de tamanho. Os arquivos de registros antigos serão excluídos automaticamente depois da rotação.

Se log_output estiver definido como NONE, não será possível acessar os registros. Se você definir log_output como TABLE, a saída do registro será colocada em uma tabela no banco de dados. Se essa tabela ficar muito grande, isso afetará o tempo de reinicialização da instância ou resultará na perda da cobertura do SLA. Por isso, não recomendamos usar a opção TABLE. Se necessário, também é possível truncar suas tabelas de registros usando a API. Para obter mais informações, consulte a página de referência instance.truncateLog.

innodb_file_per_table

Em todas as versões do MySQL 5.6 e superiores, o valor padrão é ON.

max_heap_table_size, tmp_table_size

A exaustão da memória da instância disponível pode ocorrer quando você define tmp_table_size e max_heap_table_size muito alto para o número de consultas simultâneas processadas pela instância. A exaustão da memória causa falha e reinício da instância.

Alguns valores dessas sinalizações podem resultar na perda da cobertura do SLA da instância. Saiba mais. Para mais informações sobre como usar essas sinalizações, consulte Como o MySQL usa tabelas temporárias internas e O mecanismo de armazenamento MEMORY.

performance_schema*

É necessário usar a API para alterar o valor dessa sinalização. Não é possível fazer a ativação em instâncias com um tamanho de camada menor do que db-n1-standard-8 ou db-n1-highmem-4. Se esta sinalização estiver ativada, não será possível alterar sua camada para um tamanho que não seja aceito e será necessário desativá-la primeiro.

query_cache_size, query_cache_type

Alguns valores dessas sinalizações podem resultar na perda da cobertura do SLA da instância. Saiba mais.

Sinalizações gerenciadas pelo Cloud SQL

O Cloud SQL ajusta determinadas sinalizações do sistema, dependendo da camada da instância. Não é possível ajustar esses valores.

Sinalização do Cloud SQL	Valores e observações
innodb_buffer_pool_instances	Consulte a seção Instâncias do pool de buffer abaixo para mais informações sobre essa sinalização.
innodb_buffer_pool_size	Consulte a seção Tamanho do pool de buffer abaixo para mais informações sobre essa sinalização.

innodb_buffer_pool_instances

1 para f1-micro, g1-small e n1-standard-1.
2 para n1-standard-2.
4 para n1-standard-4 e n1-highmem-2.
8 para todos os outros níveis.

innodb_buffer_pool_size

tamanhos aproximados.

~ 1,5 GB para f1-micro, g1-small e n1-standard-1.
~ 4 GB para n1-standard-2.
~ 11 GB para n1-standard-4.
~ 22 GB para n1-standard-8.
~ 46 GB para n1-standard-16.
~ 92 GB para n1-standard-32.
~ 186 GB para n1-standard-64.
~ 10 GB para n1-highmem-2.
~ 20 GB para n1-highmem-4.
~ 40 GB para n1-highmem-8.
~ 80 GB para n1-highmem-16.
~ 160 GB para n1-highmem-32.
~ 320 GB para n1-highmem-64.

Solução de problemas

Clique nos links da tabela para ver detalhes:

Para este problema...	O problema pode ser...	Tente o seguinte...
Dados com o conjunto de caracteres `utf8mb4`.	Este conjunto de caracteres não é aceito.	Filtre as strings `utf8mb4` dos seus dados.
A ativação de uma sinalização provoca falha na instância.	O valor da sinalização `max_connections` pode ser definido como alto.	Entre em contato com o suporte ao cliente para solicitar a remoção de uma sinalização.
Não é possível adicionar a sinalização `performance_schema`.	O tamanho da instância é muito pequeno.	Atualize para uma instância maior.
O fuso horário não é alterado automaticamente.	A alteração automática de fuso horário não está disponível.	O horário precisa ser alterado manualmente. Saiba mais.
`Bad syntax for dict arg`	Os valores de parâmetro complexos exigem tratamento especial.	Saiba mais.

Dados com conjunto de caracteres utf8mb4

Falha ao importar dados com o conjunto de caracteres utf8mb4.

O problema pode ser

O conjunto de caracteres utf8mb4 não é aceito, ainda que a documentação tenha indicado o contrário anteriormente.

O que você deve tentar

Filtre as strings utf8mb4 dos seus dados.

A ativação de uma sinalização provoca falha na instância

Após a ativação de uma sinalização, as instâncias ficam alternando entre pânico e falha.

O problema pode ser

Definir o valor da sinalização max_connections muito alto causa esse erro.

O que você pode tentar

Entre em contato com o suporte ao cliente para solicitar a remoção de uma sinalização, seguida de um hard drain. Isso força a instância a reiniciar em um host diferente com uma nova configuração, sem a sinalização ou a configuração não pretendida.

Não é possível adicionar a sinalização performance_schema

Não é possível adicionar a sinalização performance_schema porque ela não está no menu suspenso de sinalizações compatíveis.

O problema pode ser

A performance_schema e as variantes dela (performance_schema_accounts_size, performance_schema_accounts_size etc.) não podem ser ativadas em instâncias menores que db-n1-standard-8 ou db-n1-highmem-4.

O que você pode tentar

Verifique se a sinalização performance_schema está ativada.

Edite a instância a fim de fazer upgrade para um tamanho maior se precisar usar essa sinalização.

O fuso horário não é alterado automaticamente

O fuso horário não foi alterado automaticamente para o horário de verão.

O problema pode ser

As alterações automáticas de fuso horário não estão disponíveis no Cloud SQL e precisam ser feitas manualmente, e não por string, mas por valor de ajuste de fuso horário.

O que você pode tentar

Edite a instância para alterar a sinalização default_time_zone. Áreas com nome não são aceitas. Por exemplo: Europe/LondonLondres está no fuso horário UTC, que seria um valor aceito de +00:00 para a sinalização default_time_zone.

Sintaxe incorreta do argumento dict

Você verá a mensagem de erro Bad syntax for dict arg ao tentar definir uma sinalização.

Possível problema

Valores de parâmetro complexos, como listas separadas por vírgulas, exigem tratamento especial quando usados com comandos gcloud.

O que você pode tentar

Use o parâmetro --flags-file da gcloud, que especifica um arquivo YAML ou JSON que contém um dicionário --flag:value útil para valores de sinalização complexos.

A seguir

Saiba mais sobre variáveis de sistema do MySQL.
Saiba mais sobre as diretrizes operacionais.