Primeiros passos

Do zero ao primeiro SELECT em cerca de dois minutos: crie o projeto no console, copie a connection string e conecte com psql ou com o driver da sua linguagem. Não há instalação nem configuração de servidor.

1. Criar o projeto

Entre em console.divz.com.br, clique em Novo projeto e dê um nome. O nome vira o slug do projeto, que é também o nome do banco — use letras minúsculas, números e hífen.

O provisionamento leva de 30 a 60 segundos: o DIVZ sobe um processo de compute dedicado ao projeto, cria o banco e o role dono, e registra a rota no pooler. Enquanto isso o projeto aparece como PROVISIONING; quando fica ACTIVE, a connection string está na tela.

2. Conectar

Copie a connection string do console. Ela tem esta forma — porta 5432, TLS obrigatório:

connection string

postgresql://meuprojeto_owner:SENHA@db.divz.com.br:5432/meuprojeto?sslmode=require

Com o psql instalado, isso já basta:

terminal

psql "postgresql://meuprojeto_owner:SENHA@db.divz.com.br:5432/meuprojeto?sslmode=require"

psql (16.9)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384)
meuprojeto=>

Node.js

node — pg

import { Client } from "pg"

const db = new Client({ connectionString: process.env.DATABASE_URL })
await db.connect()
const { rows } = await db.query("select version()")
console.log(rows[0].version)

Python

python — psycopg

import psycopg

with psycopg.connect(os.environ["DATABASE_URL"]) as conn:
    print(conn.execute("select version()").fetchone()[0])

Não há driver, SDK nem proxy específico do DIVZ para instalar. Qualquer biblioteca que fale o protocolo do PostgreSQL — incluindo Prisma, Drizzle, SQLAlchemy, ActiveRecord e o pgAdmin — conecta direto.

3. Criar a primeira tabela

sql

create table nota (
  id      bigserial primary key,
  texto   text not null,
  criada  timestamptz not null default now()
);

insert into nota (texto) values ('primeiro registro');
select * from nota;

O que fazer em seguida

Feche o banco para o resto da internet. Em Projeto → Segurança, adicione os IPs que podem conectar. Enquanto a lista está vazia, qualquer origem com a senha entra.
Crie um role de aplicação. O role dono tem privilégio demais para viver na variável de ambiente de um app em produção.
Abra um branch antes da primeira migração séria. É a forma barata de testar um ALTER TABLE sem risco.

Próximo: Conectar ao banco