Esta página contém informações sobre como criar, listar e excluir os bancos de dados MySQL em uma instância do Cloud SQL.
Uma instância recém-criada tem quatro bancos de dados de sistema:
information_schema
: fornece acesso a metadados do banco de dados e informações sobre o servidor MySQL.mysql
: o esquema do sistema. Esse arquivo contém tabelas que armazenam informações exigidas pelo servidor MySQL durante a execução.performance_schema
: um recurso para monitorar a execução do MySQL Server em um nível baixo.sys
: contém um conjunto de objetos que ajuda os DBAs e os desenvolvedores a interpretar os dados coletados pelo esquema de desempenho.
Antes de começar
Antes de concluir as tarefas nesta página, é necessário fazer o seguinte:
- Criou uma instância do Cloud SQL. Para saber mais, consulte o artigo Criar instâncias.
Se você planeja usar o cliente mysql para criar ou gerenciar os bancos de dados, é necessário fazer o seguinte:
- Acesso configurado e conectado à instância com um cliente
mysql
. Para mais informações sobre as opções de conexão dos aplicativos externos, consulte esta página.
Para criar um banco de dados na instância do Cloud SQL:
Console
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome da instância.
- Selecione Banco de dados no menu de navegação do SQL.
- Clique em Create database.
- Na caixa de diálogo Criar um banco de dados, especifique o nome do banco de dados e, se quiser, o conjunto de caracteres e a compilação.
Para mais informações sobre conjuntos de caracteres e compilações, consulte Conjuntos de caracteres, compilações, Unicode.
- Clique em Criar.
gcloud
Para informações de referência, consulte criação de banco de dados no gcloud sql.
Para mais informações sobre conjuntos de caracteres e compilações, consulte Conjuntos de caracteres, compilações, Unicode.
gcloud sql databases create DATABASE_NAME \ --instance=INSTANCE_NAME \ [--charset=CHARSET] \ [--collation=COLLATION]
Terraform
Para criar um 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
A solicitação a seguir usa o método databases:insert para criar um novo banco de dados na instância especificada.
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
- database-name: o nome de um banco de dados dentro da instância do Cloud SQL
Método HTTP e URL:
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases
Corpo JSON da solicitação:
{ "project": "project-id", "instance": "instance-id", "name": "database-name" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
REST v1beta4
A solicitação a seguir usa o método databases:insert para criar um novo banco de dados na instância especificada.
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
- database-name: o nome de um banco de dados dentro da instância do Cloud SQL
Método HTTP e URL:
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases
Corpo JSON da solicitação:
{ "project": "project-id", "instance": "instance-id", "name": "database-name" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Cliente MySQL
Para ver informações de referência, consulte CRIAR BANCO DE DADOS na documentação do MySQL.
Para mais informações sobre conjuntos de caracteres e compilações, consulte Conjuntos de caracteres, compilações, Unicode.
CREATE DATABASE database_name [[CHARACTER SET charset_name][COLLATE collation_name]];
Listar seus bancos de dados
Para listar todos os bancos de dados em uma instância:
Console
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome da instância.
- Clique em Bancos de dados no menu à esquerda. A página Bancos de dados listará os bancos de dados com o tipo de compilação, o conjunto de caracteres e o tipo de banco de dados.
gcloud
Para informações de referência, consulte a lista de bancos de dados do gcloud sql.
gcloud sql databases list \ --instance=INSTANCE_NAME
REST v1
A solicitação a seguir usa o método databases:list para listar os bancos de dados em uma instância.
Ao listar os bancos de dados usando a API, você verá os outros bancos de dados de modelo e um banco de dados de sistema que não aparecem no console. Não é possível excluir nem gerenciar o banco de dados do sistema.
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/databases
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
REST v1beta4
A solicitação a seguir usa o método databases:list para listar os bancos de dados em uma instância.
Ao listar os bancos de dados usando a API, você verá os outros bancos de dados de modelo e um banco de dados de sistema que não aparecem no console. Não é possível excluir nem gerenciar o banco de dados do sistema.
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/databases
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Cliente MySQL
Para informações de referência, consulte MOSTRAR BANCOS DE DADOS na documentação do MySQL.
SHOW DATABASES;
Excluir um banco de dados
Para excluir um banco de dados da instância do Cloud SQL:
Console
-
No console do Google Cloud, acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome da instância.
- Clique em Bancos de dados no menu à esquerda.
- Na lista de bancos de dados, encontre o banco de dados que você quer excluir e clique no ícone da lixeira.
- Na caixa de diálogo Excluir banco de dados, insira o nome do banco de dados e clique em Excluir.
gcloud
Para informações de referência, consulte excluir bancos de dados do gcloud sql databases.
gcloud sql databases delete DATABASE_NAME \ --instance=INSTANCE_NAME
REST v1
A solicitação a seguir usa o método databases:delete para excluir o banco de dados especificado.
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
- database-name: o nome de um banco de dados dentro da instância do Cloud SQL
Método HTTP e URL:
DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
REST v1beta4
A solicitação a seguir usa o método databases:delete para excluir o banco de dados especificado.
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
- database-name: o nome de um banco de dados dentro da instância do Cloud SQL
Método HTTP e URL:
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Cliente MySQL
Para informações de referência, consulte REMOVER BANCO DE DADOS na documentação do MySQL.
DROP DATABASE [database_name];
A seguir
- Gerenciar usuários na instância.
- Importar dados para a instância.
- Saiba mais sobre as opções de conexão com sua instância usando o cliente mysql.
- Criar uma tabela de banco de dados (em inglês).
- Procedimentos armazenados do Cloud SQL para MySQL.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud SWL em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Faça uma avaliação gratuita do Cloud SQL