> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerencie bancos de dados pela CLI

> Crie, consulte, redimensione, inicie, pare e exclua bancos de dados da Square Cloud com squarecloud db, e imprima ou troque o certificado TLS e a senha.

O `squarecloud db` gerencia os bancos de dados MongoDB, MySQL, PostgreSQL e Redis da sua conta. Ele também funciona como `squarecloud database`.

Bancos de dados não têm arquivo de configuração, então o `[dbID]` é o ID que você passa ou, quando você o omite em um terminal, um seletor com os seus bancos de dados. Encontre os IDs com [`squarecloud db list`](#squarecloud-db-list).

## `squarecloud db create`

```bash Uso theme={"system"}
squarecloud db create --name <name> --memory <MB> --type <engine> --version <version> [--json]
```

| Flag | Descrição |
| - | - |
| `--name <name>` | Nome do banco de dados, de 1 a 32 caracteres. |
| `--memory <MB>` | Memória alocada em MB. |
| `--type <engine>` | `mongo`, `mysql`, `redis` ou `postgres`. |
| `--version <version>` | Versão do motor: uma versão major, como `17` para PostgreSQL ou `8` para MongoDB, ou uma versão completa. |

As quatro flags são obrigatórias: sem elas, o comando imprime a ajuda. Criar um banco de dados exige um plano Standard, Pro ou Enterprise.

```bash theme={"system"}
squarecloud db create --name my-db --memory 1024 --type postgres --version 17
```

```bash Saída theme={"system"}
✓ Database my-db (<dbID>) created successfully
Save the password now: it is shown only once and cannot be recovered.
  PASSWORD: <password>
  URL: <connection URL>
```

<Warning>
  A senha é mostrada uma única vez. O `db info` não a mostra de novo; se você a perder, troque-a com [`db credentials reset password`](#squarecloud-db-credentials-reset).
</Warning>

Com `--json`, imprime o banco de dados criado, com a senha e a URL de conexão, em JSON.

## `squarecloud db list`

```bash Uso theme={"system"}
squarecloud db list [--json]
```

Imprime o nome, o ID, o motor, a memória e o cluster de todos os bancos de dados da sua conta.

## `squarecloud db info`

```bash Uso theme={"system"}
squarecloud db info [dbID] [--json]
```

Mostra o ID do banco de dados, nome, motor, memória, porta, cluster, dono e data de criação.

## `squarecloud db update`

```bash Uso theme={"system"}
squarecloud db update [dbID] [--name <name>] [--memory <MB>]
```

| Flag | Descrição |
| - | - |
| `--name <name>` | Novo nome do banco de dados. |
| `--memory <MB>` | Nova memória alocada em MB. |

Renomeia o banco de dados ou altera a memória dele. Passe pelo menos uma das duas flags: sem elas, o comando imprime a ajuda.

```bash theme={"system"}
squarecloud db update <dbID> --memory 2048
```

## `squarecloud db start`

```bash Uso theme={"system"}
squarecloud db start [dbID]
```

Inicia um banco de dados parado. Se ele já estiver rodando, a CLI avisa (`It is already running.`) e sai com código 0.

## `squarecloud db stop`

```bash Uso theme={"system"}
squarecloud db stop [dbID]
```

Para um banco de dados em execução. Se ele já estiver parado, a CLI avisa (`It is already stopped.`) e sai com código 0.

## `squarecloud db status`

```bash Uso theme={"system"}
squarecloud db status [dbID] [--all] [--raw] [--json]
```

| Flag | Descrição |
| - | - |
| `--all` | Mostra todos os bancos de dados em vez de um: ID do banco, se está rodando, CPU e memória. |
| `--raw` | Imprime as estatísticas numéricas brutas em JSON em vez da tabela. |

Imprime o ID do banco de dados, o uso de CPU, a memória, o disco e o status.

## `squarecloud db metrics`

```bash Uso theme={"system"}
squarecloud db metrics [dbID] [--json]
```

Imprime as últimas 24 horas de uso de CPU, uso de RAM e tráfego de rede do banco de dados, uma linha por amostra de 5 minutos.

## `squarecloud db credentials certificate`

```bash Uso theme={"system"}
squarecloud db credentials certificate [dbID]
```

Imprime o certificado TLS do banco de dados, que os clientes usam para se conectar por TLS.

```bash theme={"system"}
squarecloud db credentials certificate <dbID> > certificate.pem
# Salva o certificado em um arquivo.
```

## `squarecloud db credentials reset`

```bash Uso theme={"system"}
squarecloud db credentials reset <password|certificate> [dbID] [-y]
```

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

Troca a senha ou o certificado TLS, após uma confirmação `y/N`. O antigo para de funcionar na hora, então atualize todos os clientes que o usam. Uma senha nova é impressa uma única vez; depois de trocar o certificado, pegue o novo com `db credentials certificate`.

```bash theme={"system"}
squarecloud db credentials reset password <dbID>
```

## `squarecloud db delete`

```bash Uso theme={"system"}
squarecloud db delete [dbID] [-y]
```

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

<Warning>
  Excluir um banco de dados é permanente. Para guardar uma cópia dos dados, execute [`squarecloud db snapshot create --download`](/pt-br/cli-reference/snapshots#squarecloud-db-snapshot-create) antes.
</Warning>

Pergunta `Delete the database <dbID>? This action is irreversible [y/N]` antes de excluir.

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `create` | [`POST /v2/databases`](/pt-br/api-reference/endpoint/databases/create) | [`api.databases.create()`](/pt-br/sdks/js/databases) | [Criar banco de dados](/pt-br/vscode-extension/features#bancos-de-dados) |
| `list` | [`GET /v2/users/me`](/pt-br/api-reference/endpoint/users/me) | [`api.account.me()`](/pt-br/sdks/js/client) | [Seção Bancos de dados](/pt-br/vscode-extension/features#bancos-de-dados) |
| `info` | [`GET .../{database_id}`](/pt-br/api-reference/endpoint/databases/info) | [`api.databases.get()`](/pt-br/sdks/js/databases) | |
| `update` | [`PATCH .../{database_id}`](/pt-br/api-reference/endpoint/databases/edit) | [`api.databases.update()`](/pt-br/sdks/js/databases) | |
| `start` | [`POST .../start`](/pt-br/api-reference/endpoint/databases/start) | [`api.databases.start()`](/pt-br/sdks/js/databases) | [Iniciar](/pt-br/vscode-extension/features#bancos-de-dados) |
| `stop` | [`POST .../stop`](/pt-br/api-reference/endpoint/databases/stop) | [`api.databases.stop()`](/pt-br/sdks/js/databases) | [Parar](/pt-br/vscode-extension/features#bancos-de-dados) |
| `status` | [`GET .../status`](/pt-br/api-reference/endpoint/databases/status) | [`api.databases.status()`](/pt-br/sdks/js/databases) | |
| `status --all` | [`GET /v2/databases/status`](/pt-br/api-reference/endpoint/databases/status-all) | [`api.databases.statusAll()`](/pt-br/sdks/js/databases) | |
| `metrics` | [`GET .../metrics`](/pt-br/api-reference/endpoint/databases/metrics) | [`api.databases.metrics()`](/pt-br/sdks/js/databases) | |
| `credentials certificate` | [`GET .../credentials/certificate`](/pt-br/api-reference/endpoint/databases/credentials/get_certificate) | [`api.databases.certificate()`](/pt-br/sdks/js/databases) | [Baixar certificado TLS](/pt-br/vscode-extension/features#bancos-de-dados) |
| `credentials reset` | [`POST .../credentials/reset`](/pt-br/api-reference/endpoint/databases/credentials/reset) | [`api.databases.resetCredentials()`](/pt-br/sdks/js/databases) | |
| `delete` | [`DELETE .../{database_id}`](/pt-br/api-reference/endpoint/databases/delete) | [`api.databases.delete()`](/pt-br/sdks/js/databases) | [Excluir](/pt-br/vscode-extension/features#bancos-de-dados) |

Os snapshots de bancos de dados estão em [Snapshots](/pt-br/cli-reference/snapshots#squarecloud-db-snapshot-create).