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:

  • Criar a 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
  • Agrupamento: 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 Platform.

    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 (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]

cURL

A solicitação a seguir usa o método databases:insert para criar um novo banco de dados na instância especificada.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     --header 'Content-Type: application/json' \
     --data '{"project": "[PROJECT-ID]", "instance": "[INSTANCE_NAME]", "name": "[DATABASE_NAME]"}' \
     -X POST \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/databases

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

    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.

    Uma instância recém-criada deve ter 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]

cURL

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.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     -X GET \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/databases

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ê vê 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 Platform.

    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]

cURL

A solicitação a seguir usa o método databases:delete para excluir o banco de dados especificado.

ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
curl --header "Authorization: Bearer ${ACCESS_TOKEN}" \
     -X DELETE \
     https://www.googleapis.com/sql/v1beta4/projects/[PROJECT-ID]/instances/[INSTANCE_NAME]/databases/[DATABASE_NAME]

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

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud SQL para PostgreSQL