Como configurar sinalizações do banco de dados

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 a instância. É possível usar sinalizações de banco de dados em muitas operações, como no ajuste dos parâmetros e das opções do SQL Server, assim como na configuração e ajustes de uma instância.

Ao definir, remover ou modificar uma sinalização de 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

  1. No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
  2. Abra a instância e clique em Editar.
  3. Role a tela para baixo até a seção Sinalizações.
  4. 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.
  5. Clique em Salvar para salvar as alterações.
  6. 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 mantê-las e adicionar novas, inclua os valores de todas as sinalizações que você quiser definir 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 delas seguido de um sinal de igual ("=").

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:

Você receberá uma resposta JSON semelhante a esta:

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

  1. No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
  2. Abra a instância e clique em Editar.
  3. Abra a seção Sinalizações do banco de dados.
  4. Clique no X ao lado de todas as sinalizações exibidas.
  5. 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:

Você receberá uma resposta JSON semelhante a esta:

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

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

  1. No Console do Google Cloud, crie um novo projeto do Console do Cloud ou abra um atual selecionando o nome dele.
  2. 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 listadas 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:

Você receberá uma resposta JSON semelhante a esta:

Na saída, procure o campo databaseFlags.

Sinalizações aceitas

Sinalização do Cloud SQL Valores
e notas aceitáveis de tipo		 Necessário
reiniciar?		 Em versão Beta?
1204 (sinalizador de rastreamento) boolean
on | off		 Não Não
1222 (sinalizador de rastreamento) boolean
on | off		 Não Não
1224 (sinalizador de rastreamento) boolean
on | off		 Não Não
2528 (sinalizador de rastreamento) boolean
on | off		 Não Não
3205 (sinalizador de rastreamento) boolean
on | off		 Não Não
3226 (sinalizador de rastreamento) boolean
on | off		 Não Não
3625 (sinalizador de rastreamento) boolean
on | off		 Sim Não
4199 (sinalizador de rastreamento) boolean
on | off		 Não Não
4616 (sinalizador de rastreamento) boolean
on | off		 Não Não
7806 (sinalizador de rastreamento) boolean
on | off		 Sim Não
contagem de bucket do cache de verificação de acesso integer
0 ... 65536		 Não Não
cota de cache de verificação de acesso integer
0 ... 2147483647		 Não Não
máscara de afinidade integer
2147483648 ... 2147483647		 Não Não
xps do agente boolean
on | off		 Não Não
soft-numa automático desativado boolean
on | off		 Sim Não
limite de custo para carregamento em paralelo integer
0 ... 32767		 Não Não
autenticação de banco de dados contida boolean
on | off		 Não Não
entre rede de propriedade de banco de dados boolean
on | off		 Não Não
limite do cursor integer
-1 ... 2147483647		 Não Não
idioma de texto completo padrão integer
0 ... 2147483647		 Não Não
idioma padrão integer
0 ... 2147483647		 Não Não
rastreamento padrão ativado boolean
on | off		 Não Não
bloquear resultados de gatilhos boolean
on | off		 Não Não
scripts externos ativados boolean
on | off		 Sim Não
largura de banda de rastreamento de pés (máx.) integer
0 ... 32767		 Não Não
largura de banda de rastreamento de pés (mín.) integer
0 ... 32767		 Não Não
largura de banda de notificação em pés (máx.) integer
0 ... 32767		 Não Não
largura de banda de notificação em pés (mín.) integer
0 ... 32767		 Não Não
fator de preenchimento (%) integer
0 ... 100		 Não Não
memória de criação de índice (kb) integer
704 ... 2147483647		 Não Não
fechaduras integer
5000 ... 2147483647		 Sim Não
memória máxima do servidor (mb) integer
128 ... 2147483647		 Não Não
tamanho máxima da replicação de texto (b) integer
-1 ... 2147483647		 Não Não
máximo de linhas de execução do worker integer
128 ... 65535		 Não Não
gatilhos aninhados boolean
on | off		 Não Não
otimizar para cargas de trabalho ad-hoc boolean
on | off		 Não Não
tempo limite de ph integer
1 ... 3600		 Não Não
limite de custo do gerenciador de consulta integer
0 ... 2147483647		 Não Não
espera na consulta (s) integer
-1 ... 2147483647		 Não Não
intervalo de recuperação (min) integer
0 ... 32767		 Não Não
acesso remoto boolean
on | off		 Não Não
tempo limite de login remoto (s) integer
0 ... 2147483647		 Não Não
tempo limite da consulta remota (s) integer
0 ... 2147483647		 Não Não
transformar palavras com ruído boolean
on | off		 Não Não
limite de dois dígitos por ano integer
1753 ... 9999		 Não Não
conexões do usuário integer
0 ... 32767		 Sim Não
opções do usuário integer
0 ... 32767		 Não Não

A seguir