Repolode
brianc

brianc/node-postgres

Cliente PostgreSQL não bloqueante para Node.js, com driver em JavaScript puro e bindings nativos opcionais para libpq.

Estrelas
13,230
Forks
1,384
Issues abertas
566
Último commit
há 16 dias

O que é?

node-postgres (pacote npm pg) é um cliente PostgreSQL para Node.js que também funciona no bun, Deno e Cloudflare. Ele é escrito em JavaScript puro, com bindings nativos opcionais para libpq que expõem a mesma API do cliente em JavaScript puro.

A biblioteca atende às necessidades do dia a dia de aplicações Postgres: pool de conexões, consultas parametrizadas, prepared statements nomeadas com cache de planos de consulta e LISTEN/NOTIFY para notificações assíncronas. É possível transferir dados em massa com COPY TO e COPY FROM, e há suporte à conversão personalizada de tipos de dados entre JavaScript e PostgreSQL.

O repositório é um monorepo que também publica pacotes relacionados, como pg-pool, pg-cursor, pg-query-stream e pg-connection-string. Ele evita abstrações de propósito, sendo adequado para quem prefere escrever SQL diretamente em vez de usar um ORM.

Recursos principais

  • 01Cliente em JavaScript puro com bindings nativos opcionais para libpq que compartilham a mesma API
  • 02Pool de conexões integrado
  • 03Consultas parametrizadas e statements nomeadas com cache de planos de consulta
  • 04Notificações assíncronas via LISTEN/NOTIFY
  • 05Importação e exportação em massa com COPY TO/COPY FROM
  • 06Conversão extensível de tipos de dados entre JavaScript e PostgreSQL

Casos de uso

  • Serviços de backend em Node.js que se conectam a um banco de dados PostgreSQL
  • Funções serverless ou de edge no Cloudflare ou Deno que precisam de um driver Postgres
  • Aplicações que usam LISTEN/NOTIFY para eventos em tempo real
  • Tarefas de carregamento de dados em massa usando COPY

Início rápido

  1. 1

    Instale o pacote pg pelo npm

    npm install pg
  2. 2

    Consulte a documentação em node-postgres.com para se conectar e executar consultas

Em coleções

Tópicos

#postgresql#nodejs#database-driver#connection-pool#sql#javascript#libpq#node-postgres#postgres#postgresql-driver

Perguntas frequentes

O que é node-postgres?
Cliente PostgreSQL não bloqueante para Node.js, com driver em JavaScript puro e bindings nativos opcionais para libpq. node-postgres (pacote npm pg) é um cliente PostgreSQL para Node.js que também funciona no bun, Deno e Cloudflare. Ele é escrito em JavaScript puro, com bindings nativos opcionais para libpq que expõem a mesma API do cliente em JavaScript puro.
node-postgres é gratuito? Qual é a licença?
node-postgres é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
node-postgres ainda é mantido?
Manutenção ativa. O último commit de node-postgres foi em 23 de out. de 2026.
Para que posso usar node-postgres?
Serviços de backend em Node.js que se conectam a um banco de dados PostgreSQL Funções serverless ou de edge no Cloudflare ou Deno que precisam de um driver Postgres Aplicações que usam LISTEN/NOTIFY para eventos em tempo real Tarefas de carregamento de dados em massa usando COPY
Como instalar node-postgres?
Instale o pacote pg pelo npm: npm install pg Consulte a documentação em node-postgres.com para se conectar e executar consultas
Onde consigo node-postgres?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/brianc/node-postgres

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados