Pular para o conteúdo principal
Uma instância PostgreSQL gerenciada com conexão TLS por certificado do cliente, um banco de dados e um role que são seus, extensões populares prontas para ativar e o pg_cron para tarefas agendadas. O que vale para todos os engines (limites, snapshots, Insights) está na visão geral de Bancos de dados.

Conectar

Copie a URL de conexão da página do banco de dados no dashboard. Ela tem este formato, com o usuário squarecloud e o banco squarecloud já criados para você:
O PostgreSQL exige SSL/TLS e o certificado do cliente, além da senha. Baixe o .pem em Conexão → Certificado SSL/TLS e aponte o cliente para ele:
Clientes em Go rejeitam sslmode=verify-full com este certificado (x509: certificate relies on legacy Common Name field): ele indica o host só no Common Name, que o Go não verifica mais. Use sslmode=verify-ca, que continua validando o certificado.
ORMs e outros clientes (Prisma, Drizzle, JDBC, ferramentas GUI) estão em erros de conexão com banco de dados.

Conexões

Cada banco de dados aceita até 256 conexões simultâneas, das quais 253 ficam disponíveis para os seus clientes. Passando disso, novas conexões falham com remaining connection slots are reserved for roles with the SUPERUSER attribute (ou sorry, too many clients already). Crie um pool por processo na inicialização e reutilize-o, dimensionado para que todas as aplicações, workers e shards juntos fiquem abaixo do limite. Uma conexão nova por requisição ou por query esgota o limite rapidamente. A aba Insights mostra quem está com as conexões abertas.

Seu usuário e permissões

O role squarecloud tem LOGIN, CREATEDB, CREATEROLE e BYPASSRLS, e é dono do banco squarecloud. Você pode criar bancos de dados, schemas, roles e grants, e mudar as configurações que um usuário comum pode mudar, para uma sessão ou como padrão:
O role não é superusuário e não tem direitos de replicação. Isso descarta:
  • ALTER SYSTEM e as configurações reservadas a superusuários;
  • COPY ... TO/FROM 'file' no lado do servidor (use o \copy do psql, que lê e escreve na sua máquina);
  • linguagens não confiáveis, como plpython3u;
  • replicação lógica e as ferramentas de change data capture que dependem dela.

Extensões

Já instaladas: plpgsql, mais pg_cron e pg_stat_statements no banco postgres. Você pode ativar estas em qualquer um dos seus bancos com CREATE EXTENSION, no banco que vai usá-las: vector (pgvector), pg_trgm, pgcrypto, uuid-ossp, citext, hstore, unaccent, ltree, btree_gin, btree_gist, cube, dict_int, fuzzystrmatch, intarray, isn, lo, seg, tablefunc, tcn, tsm_system_rows, tsm_system_time.
Nenhuma outra extensão está disponível, e nenhuma pode ser adicionada a pedido. O PostGIS, por exemplo, não está disponível.

Tarefas agendadas com pg_cron

O pg_cron fica no banco postgres. Conecte-se ao postgres (mesma URL, terminando em /postgres) e agende a tarefa para rodar no seu banco. Os horários são em UTC:
O histórico de execuções em cron.job_run_details nunca é limpo automaticamente. Agende a limpeza das suas linhas antigas:

Memória e configuração

  • O shared_buffers é 25% da RAM do banco de dados (no mínimo 128 MB). Mudar a RAM reinicia o banco para aplicá-lo.
  • Para o resto, o PostgreSQL conta com o cache de arquivos do sistema operacional, então a RAM exibida no dashboard sobe e depois fica alta. Isso é normal, não é um vazamento.
  • Uma única query pode escrever no máximo 1 GB de arquivos temporários (ordenações, hashes). Passando disso, a query falha com temporary file size exceeds temp_file_limit: adicione um índice ou processe os dados em lotes.
  • O write-ahead log ocupa de 256 a 512 MB do armazenamento do banco.
  • A configuração do servidor é a mesma em todos os bancos e não pode ser mudada por banco.

Consultas lentas

As instruções que levam 100 ms ou mais são registradas, e a aba Insights as lista com o tempo médio. Para a sua própria análise, conecte-se ao banco postgres, consulte o pg_stat_statements e use EXPLAIN ANALYZE na instrução:

Snapshots

Um snapshot do PostgreSQL contém todos os bancos de dados e roles da instância. Além dos casos gerais, ele falha quando um banco tem ALLOW_CONNECTIONS false, ou quando um lock seu (LOCK TABLE, um ALTER TABLE demorado) o bloqueia por mais de 5 minutos. A exportação é texto SQL puro, então um banco perto dos 10 GB de armazenamento pode não caber em um snapshot.

Erros comuns

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.