> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Bancos de dados > PostgreSQL, MySQL e Redis na rede da sua conta (o MongoDB chega em breve), com senha forte gerada pela Cube, backup automático todo dia e acesso de fora com certificado. A página **Bancos de dados** do painel cria um banco para os seus projetos em poucos segundos. Ele fica na rede da sua conta: os seus projetos conectam pelo nome do banco, e nenhum projeto de outra conta alcança. PostgreSQL 17, MySQL 8.4 e Redis 8, e o MongoDB 8.0 em breve. Você escolhe o tipo, o nome e a memória. Um banco `loja-db` responde em `loja-db:5432` para os projetos da sua conta. Gerada pela Cube e guardada cifrada. Só aparece quando você pede, e fica registrado na Atividade. Um backup por dia com o banco no ar, guardado por 7 dias, para baixar ou restaurar. ## Planos e memória Bancos vêm a partir do plano **Stack**. A memória do banco sai da mesma memória do plano que a dos projetos, e cada banco tem **2 GB** de espaço. | Plano | Bancos | | ------------ | ----------- | | Free e Block | Não incluem | | Stack | 1 | | Tower | 3 | | Fortress | 6 | | Banco | Memória mínima | Porta | | ---------------------------------------------- | -------------- | ----- | | PostgreSQL | 512 MB | 5432 | | MySQL | 512 MB | 3306 | | MongoDB Em breve | 512 MB | 27017 | | Redis | 256 MB | 6379 | O MongoDB aparece no **Novo banco** como **Em breve** e ainda não pode ser criado; pela API, `mongodb` responde [`engine_unavailable`](/errors#param-engine-unavailable). A memória fica reservada no plano mesmo com o banco parado, como a de um projeto parado. Veja [Planos e memória](/account/plans). ## Criar um banco No painel, clique em **Bancos de dados** na barra lateral e depois em **Novo banco**. O **nome** é também o endereço que os projetos usam, então tem de 3 a 32 caracteres, só letras minúsculas sem acento, números e hífen, e começa com letra (ex.: `loja-db`). Ele não repete na sua conta. Em alguns segundos o banco fica **No ar**. A página dele mostra a conexão, o uso de memória e disco e os backups. Pela API, use [Criar um banco de dados](/api-reference/databases/create). ## Conectar um projeto A página do banco mostra, em **Conexão**, o endereço interno, a porta, o usuário, a senha e a **string de conexão** pronta. Ela vai numa variável de ambiente do projeto: | Banco | Variável sugerida | String de conexão | | ---------- | ----------------- | --------------------------------------------------------------- | | PostgreSQL | `DATABASE_URL` | `postgresql://cube:@loja-db:5432/loja_db` | | MySQL | `DATABASE_URL` | `mysql://cube:@loja-db:3306/loja_db` | | MongoDB | `MONGODB_URI` | `mongodb://cube:@loja-db:27017/loja_db?authSource=admin` | | Redis | `REDIS_URL` | `redis://default:@cache:6379` | O usuário é `cube` (`default` no Redis) e o banco dentro do servidor tem o nome com `_` no lugar de `-` (`loja-db` vira `loja_db`). Três jeitos de ligar o banco a um projeto, sem copiar a senha à mão: * **Na página do banco**, em **Ligar a um projeto**: escolha o projeto e clique em **Ligar ao projeto**. As outras variáveis do projeto ficam como estão. * **No Novo projeto**, no campo **Banco de dados**: a conexão entra na variável antes de o projeto iniciar. * **Nas Variáveis de ambiente** do projeto, em **Ligar banco**: a conexão entra na lista e é salva com **Salvar alterações**. A variável vale no próximo início ou reinício do projeto. No código, leia a variável: ```js Node.js (pg) theme={"dark"} const { Pool } = require('pg'); const pool = new Pool({ connectionString: process.env.DATABASE_URL }); pool.query('select now()').then(({ rows }) => console.log(rows[0])); ``` ```python Python (psycopg) theme={"dark"} import os import psycopg with psycopg.connect(os.environ["DATABASE_URL"]) as conn: print(conn.execute("select now()").fetchone()) ``` ```js Node.js (redis) theme={"dark"} const { createClient } = require('redis'); const redis = createClient({ url: process.env.REDIS_URL }); redis.connect().then(() => redis.set('visitas', 1)); ``` A conexão sem TLS é normal aqui: o banco e o projeto conversam dentro da rede da sua conta, sem passar pela internet. ## Só a sua conta alcança * Os projetos da sua conta chegam ao banco pelo nome. Projetos de outras contas não chegam, nem pelo nome nem pelo endereço. * Outra conta pode ter um banco com o mesmo nome: para os projetos dela, o nome leva ao banco dela. * A senha só aparece para a sua conta: no painel, com **Mostrar senha** ou copiar; pela API, só com a chave de **leitura e escrita** ([Ver a conexão](/api-reference/databases/credentials)). Cada vez que ela aparece, fica registrado na Atividade. ## Acesso externo Para conectar de fora da Cube (do seu computador, de um app de banco como DBeaver ou TablePlus, de um script), ligue o **Acesso externo** na página do banco. O banco continua fora da internet: a conexão chega por um túnel e só passa com o **certificado de cliente** daquele banco, e o banco ainda pede a senha. Na página do banco, em **Acesso externo**, clique em **Ligar acesso externo** e em **Gerar certificado**. Os arquivos aparecem uma vez só: * `.p12` e a senha dele, para apps de banco; * `.crt` (certificado), `.key` (chave) e `cube-ca.pem` (a CA da Cube), para `psql`, `mysql` e `redis-cli`. Salve os arquivos na mesma pasta, num lugar seguro. É o programa gratuito que abre o túnel no seu computador. ```bash macOS theme={"dark"} brew install cloudflared ``` ```powershell Windows theme={"dark"} winget install --id Cloudflare.cloudflared ``` ```bash Linux (Debian, Ubuntu) theme={"dark"} curl -fsSLo cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb sudo dpkg -i cloudflared.deb ``` Deixe este comando rodando num terminal. Ele abre a porta só no seu computador (`127.0.0.1`): ```bash theme={"dark"} cloudflared access tcp --hostname db.cubehost.dev --url 127.0.0.1:15432 ``` | Banco | Endereço | Porta no seu computador | | ---------- | -------------------- | ----------------------- | | PostgreSQL | `db.cubehost.dev` | 15432 | | MySQL | `mysql.cubehost.dev` | 13306 | | Redis | `db.cubehost.dev` | 16379 | Mais de um banco ao mesmo tempo? Um túnel por banco, cada um numa porta. Em outro terminal, na pasta dos arquivos. A senha é a do banco, em **Conexão**, e o programa pede na hora. ```bash psql theme={"dark"} chmod 600 loja-db.key psql "host=127.0.0.1 port=15432 user=cube dbname=loja_db sslmode=verify-full sslrootcert=cube-ca.pem sslcert=loja-db.crt sslkey=loja-db.key" ``` ```bash mysql theme={"dark"} mysql -h 127.0.0.1 -P 13306 -u cube -p --ssl-mode=VERIFY_IDENTITY --ssl-ca=cube-ca.pem --ssl-cert=docs.crt --ssl-key=docs.key docs ``` ```bash redis-cli theme={"dark"} redis-cli -h 127.0.0.1 -p 16379 --tls --cacert cube-ca.pem --cert cache.crt --key cache.key --askpass ``` ```js Node.js (pg) theme={"dark"} const fs = require('node:fs'); const { Client } = require('pg'); const client = new Client({ host: '127.0.0.1', port: 15432, user: 'cube', database: 'loja_db', password: process.env.DB_PASSWORD, ssl: { ca: fs.readFileSync('cube-ca.pem'), cert: fs.readFileSync('loja-db.crt'), key: fs.readFileSync('loja-db.key'), }, }); client.connect().then(() => client.query('select now()')).then(({ rows }) => console.log(rows[0])); ``` No app de banco, use o endereço `127.0.0.1` e a porta do túnel, ligue o SSL e escolha o `.p12` (com a senha dele) ou os três arquivos `.pem`. * **Um certificado por banco.** Ele só abre o banco dele, por 2 anos. O painel mostra quando ele foi gerado e até quando vale. Vencido, ele para de conectar e o painel mostra **Venceu**: gere outro. * **Gerar outro certificado** faz o atual parar na hora, e as conexões abertas com ele caem. Use se perdeu os arquivos ou acha que eles vazaram. * **Desligar** faz o mesmo e fecha o acesso de fora. Os projetos da sua conta seguem conectando pelo endereço interno. * A conexão vai cifrada do seu computador até a Cube, e sem o certificado nada passa. O `sslmode=verify-full` (no MySQL, `VERIFY_IDENTITY`) confere que do outro lado está a Cube. * O `psql` de qualquer versão funciona. No PostgreSQL 17, dá para somar `sslnegotiation=direct`. * Parado, o banco não aceita conexão de fora; os projetos da conta também não. ## Iniciar e parar **Parar** guarda os dados e mantém a memória reservada no plano; os projetos que usam o banco perdem a conexão até você **Iniciar** de novo. Iniciar só liga se o banco couber no plano de agora, somando a memória dos projetos e bancos ligados. Se o banco cair, ele volta sozinho. Se a conta for suspensa por falta de pagamento, os bancos param junto com os projetos, e pagar religa os que estavam no ar. Veja [Pagamento por Pix](/account/pix-billing). ## Backups Com o banco no ar, a Cube faz **um backup por dia** e guarda por **7 dias**. Banco parado não ganha o backup do dia. Se o do dia não sair, ele sai de novo em 1 hora. * **Baixar:** o arquivo sai no formato da ferramenta do próprio banco (PostgreSQL `.dump`, MySQL `.sql.gz`, MongoDB `.archive.gz`, Redis `.rdb`), por um link de 5 minutos só para a sua conta. * **Restaurar:** troca os dados do banco pelos do backup, só no mesmo banco de onde ele saiu e só pelo painel. * **PostgreSQL, MySQL e MongoDB:** o banco precisa estar no ar. As tabelas e coleções que estão no backup voltam ao que eram; o que foi criado depois dele fica. Os projetos que usam o banco veem os dados mudando: pare-os antes, se preferir. * **Redis:** os dados de agora são trocados pelos do backup inteiro. O banco para por alguns segundos e volta como estava. Restaurar não pode ser desfeito. Se quiser guardar os dados de agora, baixe o backup mais novo antes. ## Excluir Em **Zona de perigo**, na página do banco, **Excluir banco** pede o nome para confirmar. O banco para e os dados e os backups dele são apagados, sem volta. A variável com a conexão continua nos projetos: apague-a em Variáveis de ambiente se não for usar. ## Pela API | O quê | Rota | Chave | | ---------------------------------------------------------------------------------- | ---------------------------------------------------------- | ----------------- | | [Listar bancos](/api-reference/databases/list) | `GET /databases` | Leitura | | [Ver um banco](/api-reference/databases/get) | `GET /databases/{id}` | Leitura | | [Criar um banco](/api-reference/databases/create) | `POST /databases` | Leitura e escrita | | [Ver a conexão](/api-reference/databases/credentials) | `GET /databases/{id}/credentials` | Leitura e escrita | | [Iniciar](/api-reference/databases/start) e [parar](/api-reference/databases/stop) | `POST /databases/{id}/start` e `/stop` | Leitura e escrita | | [Desligar o acesso externo](/api-reference/databases/external-access-disable) | `DELETE /databases/{id}/external-access` | Leitura e escrita | | [Listar backups](/api-reference/databases/backups) | `GET /databases/{id}/backups` | Leitura | | [Baixar um backup](/api-reference/databases/backup-download-link) | `POST` e `GET /databases/{id}/backups/{backupId}/download` | Leitura e escrita | Excluir um banco, restaurar um backup e gerar o certificado do acesso externo ficam só no painel.