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.

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:

Criar um banco de dados

Siga as instruções de Identificadores e palavras-chave (em inglês) para criar o nome do seu 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. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Selecione a instância à qual você quer adicionar o banco de dados.
  3. Selecione a guia BANCOS DE DADOS.
  4. Clique em Criar banco de dados.
  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.

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

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 código do projeto
  • instance-id: o código 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://www.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. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Selecione a instância na qual você quer listar os bancos de dados.
  3. Clique em BANCOS DE DADOS.

    Para uma instância recém-criada, veja o banco de dados postgres.

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

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 código do projeto
  • instance-id: o código da instância

Método HTTP e URL:

GET https://www.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 (em inglês).

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. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Selecione a instância que contém o banco de dados que você quer excluir.
  3. Clique em BANCOS DE DADOS.
  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, clique em OK.

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

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 código do projeto
  • instance-id: o código 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://www.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];

A seguir