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.
Configurar sinalizações do banco de dados
Definir uma sinalização do banco de dados
Console
- No Console do Google Cloud, selecione o projeto que contém a instância do Cloud SQL para a qual você quer definir uma sinalização de banco de dados.
- 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
1204
, remote access
e remote query timeout (s)
,
use o seguinte comando:
gcloud sql instances patch INSTANCE_NAME \ --database-flags="1204"=on,"remote access"=on,"remote query timeout (s)"=300
Terraform
Para adicionar sinalizações do banco de dados, use um recurso do Terraform.
Aplique as alterações
Para aplicar a configuração do Terraform em um projeto do Google Cloud, conclua as etapas nas seções a seguir.
Preparar o Cloud Shell
- Inicie o Cloud Shell.
-
Defina o projeto padrão do Google Cloud em que você quer aplicar as configurações do Terraform.
Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.
Preparar o diretório
Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.
-
No Cloud Shell, crie um diretório e um novo
arquivo dentro dele. O nome do arquivo precisa ter a extensão
.tf
, por exemplo,main.tf
. Neste tutorial, o arquivo é chamado demain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.
Copie o exemplo de código no
main.tf
recém-criado.Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.
- Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
- Salve as alterações.
-
Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.
terraform init
Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção
-upgrade
:terraform init -upgrade
Aplique as alterações
-
Revise a configuração e verifique se os recursos que o Terraform vai criar ou
atualizar correspondem às suas expectativas:
terraform plan
Faça as correções necessárias na configuração.
-
Para aplicar a configuração do Terraform, execute o comando a seguir e digite
yes
no prompt:terraform apply
Aguarde até que o Terraform exiba a mensagem "Apply complete!".
- Abra seu projeto do Google Cloud para ver os resultados. No console do Google Cloud, navegue até seus recursos na IU para verificar se foram criados ou atualizados pelo Terraform.
Excluir as alterações
Para excluir as mudanças, faça o seguinte:
- Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento
deletion_protection
comofalse
.deletion_protection = "false"
- Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite
yes
no prompt:terraform apply
-
Remova os recursos aplicados anteriormente com a configuração do Terraform executando o seguinte comando e inserindo
yes
no prompt:terraform destroy
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.
Redefinir todas as sinalizações para o valor padrão
Console
- No Console do Google Cloud, selecione o projeto que contém a instância do Cloud SQL para que você quer limpar todas as sinalizações.
- 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 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:
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, selecione o projeto que contém a instância do Cloud SQL para a qual você quer ver as sinalizações do banco de dados que foram definidas.
- 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.
Solução de problemas
Problema | Solução de problemas |
---|---|
O Cloud SQL para SQL Server não aceita a modificação do fuso horário de uma instância atual. |
No Cloud SQL, o SQL Server é compatível com a configuração do fuso horário de uma nova instância, mas não de uma instância atual. No Cloud SQL para SQL Server, é possível usar a função |
A seguir
- Saiba mais sobre opções de configuração do SQL Server.