Como criar e gerenciar bancos de dados PostgreSQL

Esta página contém informações sobre como criar, listar e excluir os bancos de dados PostgreSQL em uma instância do Cloud SQL.

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

Para saber mais sobre os bancos de dados PostgreSQL, confira a documentação do PostgreSQL.

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 psql para criar ou gerenciar os bancos de dados, é necessário fazer o seguinte:

  • Acesso configurado e conectado à instância com um cliente psql. Para mais informações sobre as opções de conexão dos aplicativos externos, consulte esta página.

Criar um banco de dados

Siga as instruções em Identificadores e palavras-chave para criar o nome do banco de dados. Caso não sejam definidos na criação, os novos bancos de dados terão os seguintes valores padrão:

  • Conjunto de caracteres: UTF8
  • Compilação: en_US.UTF8

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

Console

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

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  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 criação de banco de dados no gcloud sql (em inglês).

Para conhecer os princípios e uma lista de valores de conjuntos de caracteres compatíveis, veja os seguintes tópicos da documentação do PostgreSQL:

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME \
[--charset=CHARSET] \
[--collation=COLLATION]

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 psql

Para informações de referência, consulte CREATE DATABASE (em inglês) na documentação do PostgreSQL.

Para conhecer os princípios e uma lista de valores de conjuntos de caracteres compatíveis, veja os seguintes tópicos da documentação do PostgreSQL:

CREATE DATABASE database_name
  [[ ENCODING encoding ][ LC_COLLATE lc_collate ]];

Listar bancos de dados

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

Console

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

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  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 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 psql

Para informações de referência, consulte a lista.

Ao listar os bancos de dados usando o cliente psql, você verá os outros modelos de banco de dados e um banco de dados do sistema que não aparecem no console. Não é possível excluir nem gerenciar o banco de dados do sistema.

\l

Excluir um banco de dados

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

Console

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

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  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 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 psql

Para informações de referência, consulte DROP DATABASE (em inglês) na documentação do PostgreSQL.

DROP DATABASE [database_name];

Próximas etapas

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