Como Fazer o Deploy do seu Primeiro 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.x.x
MongoDB	8.x.x
MySQL	9.x.x
Redis	7.4.x

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:

npm install pg

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) através do seu arquivo de configuração ou do dashboard, para que as credenciais nunca acabem no seu repositório.

Seu banco de dados está no ar

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.

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.

Tutoriais

Bots

Projetos Prontos

Bancos de Dados

APIs

Website

Guias de Migração

Como Fazer o Deploy do seu Primeiro 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

Seu banco de dados está no ar

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

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

​Seu banco de dados está no ar

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

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

Seu banco de dados está no ar

Contate-nos