Pular para o conteúdo principal
client.databases trabalha com os seus bancos de dados na Square Cloud (MongoDB, MySQL, PostgreSQL e Redis). Todos os métodos, exceto create e status_all, recebem o id do banco de dados primeiro. Para listar seus bancos de dados, use client.account.me(): sua lista databases contém todos os bancos de dados que a chave pode ver. A hospedagem de bancos de dados requer um plano Standard, Pro ou Enterprise. Os exemplos usam o client de Criando o cliente. database_id é o id de um dos seus bancos de dados: client.account.me() lista todos.

Criando um banco de dados

databases.create(name, type=, version=, memory=) recebe o nome por posição e os outros campos como argumentos keyword-only.
O password e o certificate são retornados apenas por create() (e por reset_credentials()). A chamada espera pelo menos 120 s antes de expirar.

Obtendo um banco de dados

Atualizando um banco de dados

update(database_id, name=None, ram=None) renomeia ou redimensiona um banco de dados. Os dois argumentos são keyword-only, e os que ficam como None não são enviados. Passe pelo menos um (caso contrário, 400 NO_UPDATE_DATA).

Iniciar e parar

Assim como as chamadas de ciclo de vida das aplicações, elas esperam pelo menos 120 s, e uma recusa resulta em 409 com um código e uma mensagem vazia: CONTAINER_ALREADY_STARTED, CONTAINER_ALREADY_STOPPED, CONTAINER_NOT_FOUND, CONTAINER_INSUFFICIENT_DISK_SPACE, CONTAINER_NETWORK_CONFLICT ou ACTION_FAILED. Enquanto uma restauração de snapshot está em andamento, elas resultam em 409 RESTORE_IN_PROGRESS.

Status e métricas

status(database_id) retorna valores formatados; raw=True (keyword-only) retorna números. status_all() retorna um resumo por banco de dados. metrics(database_id) retorna as últimas 24 horas, um ponto a cada 5 minutos, do mais recente para o mais antigo. Passe range="7d" (keyword-only) para ter pontos de hora em hora ao longo de 7 dias, com os picos da hora em cpu_max e ram_max. Isso requer um plano Pro ou Enterprise: nos outros planos, a chamada retorna o histórico de 24 horas sem erro. Um range diferente de "24h" (o padrão) ou "7d" resulta em 400 INVALID_PARAMETERS.
Os campos de status são os mesmos do status de aplicações, e os pontos de métricas são os mesmos das métricas de aplicações.

Credenciais

certificate(database_id) retorna o certificado TLS como PEM codificado em base64. reset_credentials(database_id, type) rotaciona a senha (e retorna a nova) ou o certificado (e retorna ''). O banco de dados precisa estar em execução (400 DATABASE_NOT_RUNNING).

Excluindo um banco de dados

Enquanto uma restauração de snapshot está em andamento, delete resulta em 409 RESTORE_IN_PROGRESS.
A exclusão é permanente. Crie um snapshot antes, caso você possa precisar dos dados novamente.

Snapshots

client.databases.snapshots tem os mesmos list, create, restore e restore_state das aplicações. Veja Snapshots.

Próximos passos

Workspaces

Compartilhe aplicações com sua equipe.

Referência da API de bancos de dados

Os endpoints REST por trás destes métodos.

Bancos de dados pela CLI

As mesmas ações pelo terminal.