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 e a instância for reiniciada, 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 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 1204, remote access e remote query timeout, use o seguinte comando:

gcloud sql instances patch [INSTANCE_NAME] --database-flags  \
    "1204"=on,"remote access"=on,"remote query timeout (s)"=300

REST v1

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://sqladmin.googleapis.com/v1/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.

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://sqladmin.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 v1

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://sqladmin.googleapis.com/v1/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:

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://sqladmin.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 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 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 v1

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://sqladmin.googleapis.com/v1/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.

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://sqladmin.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

As sinalizações não mencionadas abaixo não são compatíveis.

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

A seguir