Criar e gerenciar bancos de dados

Nesta página, você vê informações sobre como criar, listar e excluir os bancos de dados do SQL Server em uma instância do Cloud SQL.

Uma instância recém-criada tem um banco de dados sqlserver.

Para mais informações sobre como criar bancos de dados do SQL Server e tópicos relacionados, consulte a documentação do SQL Server.

Para informações sobre como definir um valor padrão para o tipo de compilação usado para os bancos de dados em uma instância, consulte Como criar instâncias.

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 planeja usar o cliente sqlcmd para criar ou gerenciar os bancos de dados, é necessário que você tenha:

  • Acesso configurado e conectado à instância com um cliente sqlcmd.

Para criar um banco de dados na instância do Cloud SQL:

Console

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Selecione Banco de dados no menu de navegação do SQL.
  4. Clique em Create database.
  5. Na caixa de diálogo Novo banco de dados, especifique o nome do banco de dados.
  6. Clique em Criar.

gcloud

Para informações de referência, consulte gcloud sql databases create.

Para mais informações sobre ordenações no SQL Server, consulte Suporte a ordenações e Unicode na documentação do SQL Server.

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.

resource "google_sql_database" "database" {
  name     = "my-database"
  instance = google_sql_database_instance.instance.name
}

Aplique as alterações

Para aplicar a configuração do Terraform em um projeto Google Cloud , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

  1. Inicie o Cloud Shell.

  2. Defina o projeto Google Cloud padrão 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.

  1. 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 de main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. 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.

  3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
  4. Salve as alterações.
  5. 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

  1. 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.

  2. 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!".

  3. Abra seu Google Cloud projeto para conferir os resultados. No console do Google Cloud , navegue até seus recursos na interface para verificar se foram criados ou atualizados pelo Terraform.

Excluir as alterações

Para excluir as mudanças, faça o seguinte:

  1. Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento deletion_protection como false. 
    deletion_protection =  "false"
  2. Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite yes no prompt: 
    terraform apply

  1. 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ê vai 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ê vai receber uma resposta JSON semelhante a esta:

Listar seus bancos de dados

Para listar todos os bancos de dados em uma instância:

Console

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. 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 gcloud sql databases list.

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:

Mudar o proprietário de um banco de dados

Se você quiser descartar o login de usuário associado a um proprietário de banco de dados que não está mais ativo, primeiro atribua um novo proprietário.

Para adicionar um novo proprietário do banco de dados, faça o seguinte:

gcloud

  1. Conecte-se ao banco de dados e crie duas contas de demonstração: 
          create login TEST_LOGIN with password='TEST_PASSWORD'
      create login REPORT_USER with password='REPORT_USER_PASSWORD'
      GRANT CREATE ANY DATABASE TO TEST_LOGIN AS [CustomerDbRootRole]

    Faça as seguintes substituições:

    • TEST_LOGIN: o nome da conta de teste, como test-login.
    • TEST_PASSWORD: a senha da conta de teste.
    • REPORT_USER: o nome de uma segunda conta de usuário, como report-user. Essa conta se torna a nova proprietária do banco de dados.
    • REPORT_USER_PASSWORD: a senha da segunda conta de usuário.
  2. Conecte-se ao banco de dados usando a conta de teste que você acabou de criar. Em seguida, crie um banco de dados de teste usando o seguinte comando: 
        CREATE DATABASE TEST_DB

    Faça as seguintes substituições:

    • TEST_DB: o nome do banco de dados de teste que você quer criar, como test-database.
    • TEST_LOGIN: o nome da conta de teste, como test-login.

    O proprietário do banco de dados é definido automaticamente como a conta de teste.

  3. Conecte-se ao banco de dados usando o login do SQL Server. Em seguida, execute o comando a seguir para tentar descartar o login TEST_LOGIN: 
          drop login TEST_LOGIN

    Substitua TEST_LOGIN pelo nome da conta de teste, como test-login.

    A operação falha e o seguinte erro é retornado:

            Login TEST_LOGIN owns one or more database(s). Change
        the owner of the database(s) before dropping the login.
  4. Conecte-se ao banco de dados TEST_DB como a conta REPORT_USER e conceda a ela permissões para corresponder ao proprietário atual. 
          GRANT IMPERSONATE on LOGIN::REPORT_USER to TEST_LOGIN
  5. Conecte-se ao banco de dados como a conta de teste. Em seguida, execute o comando a seguir para autorizar a segunda conta como proprietária do banco de dados: 
          ALTER AUTHORIZATION ON DATABASE::TEST_DB TO REPORT_USER
  6. Conecte-se ao banco de dados como REPORT_USER e remova todas as permissões concedidas. 
          REVOKE IMPERSONATE on LOGIN::REPORT_USER to TEST_LOGIN
  7. Conecte-se ao banco de dados como a conta do SQL Server. Em seguida, execute o comando a seguir para descartar o login TEST_LOGIN: 
          DROP LOGIN TEST_LOGIN
    Quando terminar, a seguinte mensagem será retornada: 
          DROP LOGIN for TEST_LOGIN by sqlserver(sqlserver) is successful.

Excluir um banco de dados

Para excluir um banco de dados da instância do Cloud SQL:

Console

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Bancos de dados no menu à esquerda.
  4. Na lista de bancos de dados, encontre o banco de dados que você quer excluir e clique no ícone da lixeira.
  5. 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 gcloud sql databases delete.

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:

A seguir

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 recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Faça uma avaliação gratuita do Cloud SQL