Crie e conecte um banco de dados gerenciado

Introdução

Este tutorial leva você do zero a um banco de dados ativo e conectado em poucos minutos: crie a instância pelo dashboard, obtenha sua connection string e conecte-se a ela a partir do seu próprio código.

Pré-requisitos

Conta na Square Cloud: Crie sua conta pela página de cadastro.
Plano Standard ativo ou superior: Bancos de dados gerenciados exigem um plano Standard ativo ou superior. Confira os planos disponíveis e escolha o que se encaixa na sua carga de trabalho.

Passo 1: Escolha um engine

A Square Cloud oferece quatro engines de banco de dados gerenciados, já configurados para conectar e começar a usar:

Engine	Versão
PostgreSQL	17
MongoDB	8
MySQL	9
Redis	8

Este tutorial usa PostgreSQL, mas o mesmo fluxo do dashboard se aplica a todos os engines acima.

Passo 2: Crie o banco de dados

Crie uma nova instância de banco de dados

Acesse a página de Bancos de Dados e clique no botão “Criar Banco de Dados”.

Configurando sua instância de banco de dados

Selecione PostgreSQL (ou o engine escolhido no Passo 1) e preencha as informações necessárias, como nome do banco e RAM.

Finalize a criação da instância

Clique no botão “Criar” e aguarde a criação do banco de dados.

Passo 3: Obtenha a connection string

Assim que seu banco de dados estiver pronto, abra-o pela página de Bancos de Dados. Os detalhes de conexão (host, porta, usuário, senha e URL de conexão) são exibidos no dashboard da instância, junto com o certificado TLS que você precisará para se conectar.

Os bancos de dados da Square Cloud só aceitam conexões SSL/TLS. Veja como me conectar ao meu banco de dados para como o certificado é usado por diferentes clientes.

Passo 4: Conecte a partir do seu código

Com a connection string em mãos, conecte-se usando o cliente PostgreSQL da sua linguagem.

Node.js
Python

Instale o pacote pg e ative os módulos ES, que o exemplo abaixo usa (import e await no nível superior):

npm install pg
npm pkg set type=module

Conecte e verifique com uma query simples:

index.js

import fs from "node:fs";
import { Client } from "pg";

const cert = fs.readFileSync("certificate.pem").toString();

const client = new Client({
  connectionString: process.env.DATABASE_URL, // postgresql://user:password@host:port/dbname
  ssl: { ca: cert, cert: cert, key: cert },
});

await client.connect();
const result = await client.query("SELECT 1");
console.log("Connected! Result:", result.rows[0]);
await client.end();

Instale o psycopg2:

pip install psycopg2-binary

Conecte e verifique com uma query simples:

main.py

import os
import psycopg2

conn = psycopg2.connect(
    os.environ["DATABASE_URL"],  # postgresql://user:password@host:port/dbname
    sslmode="verify-ca",
    sslrootcert="certificate.pem",
    sslcert="certificate.pem",
    sslkey="certificate.pem",
)
cur = conn.cursor()
cur.execute("SELECT 1")
print("Connected! Result:", cur.fetchone())
cur.close()
conn.close()

Se a query retornar um resultado em vez de lançar um erro de conexão, sua aplicação está se comunicando com o banco de dados com sucesso.

Nunca fixe a connection string diretamente no código-fonte. Defina-a como uma variável de ambiente (DATABASE_URL) nas Variáveis de Ambiente da sua aplicação no dashboard, ou com o comando da CLI squarecloud app env set "DATABASE_URL=<connection-url>" --app <appID> (veja variáveis de ambiente na CLI), para que as credenciais nunca acabem no seu repositório. Depois, reinicie a aplicação: ela lê as variáveis de ambiente quando inicia. Veja Variáveis de ambiente.

Mantenha o certificate.pem no ZIP da sua aplicação, já que o código o lê do disco, mas fora de qualquer repositório público.

Próximos passos

Agora você tem um banco de dados gerenciado rodando e acessível a partir do seu código. A partir daqui:

Faça o deploy de um app para usá-lo

Hospede a aplicação que se conecta a este banco de dados na Square Cloud.

Erros de conexão com o banco

Corrija erros de SSL/TLS, timeout e acesso.

Snapshots

Crie e restaure snapshots de banco de dados pela CLI.

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.

Bots

Sites

APIs e backends

Bancos de dados

Aplicações self-hosted

Guias

Guias de migração

Crie e conecte um banco de dados gerenciado

Introdução

Pré-requisitos

Passo 1: Escolha um engine

Passo 2: Crie o banco de dados

Passo 3: Obtenha a connection string

Passo 4: Conecte a partir do seu código

Próximos passos

Faça o deploy de um app para usá-lo

Erros de conexão com o banco

Snapshots

Contate-nos

​Introdução

​Pré-requisitos

​Passo 1: Escolha um engine

​Passo 2: Crie o banco de dados

​Passo 3: Obtenha a connection string

​Passo 4: Conecte a partir do seu código

​Próximos passos

Faça o deploy de um app para usá-lo

Erros de conexão com o banco

Snapshots

​Contate-nos

Introdução

Pré-requisitos

Passo 1: Escolha um engine

Passo 2: Crie o banco de dados

Passo 3: Obtenha a connection string

Passo 4: Conecte a partir do seu código

Próximos passos

Contate-nos