Neon é um Postgres serverless totalmente gerenciado. O Neon separa computação e armazenamento para oferecer recursos modernos de desenvolvedor, como auto-scaling, branching, armazenamento ilimitado e muito mais.

---

Comece criando um diretório de projeto, inicializando o diretório com bun init e adicionando o driver serverless do Neon como dependência do projeto.

mkdir bun-neon-postgres
cd bun-neon-postgres
bun init -y
bun add @neondatabase/serverless

---

Crie um arquivo .env.local e adicione sua string de conexão do Neon Postgres a ele.

DATABASE_URL=postgresql://usuario:senha@ep-adj-noun-guid.us-east-1.aws.neon.tech/neondb?sslmode=require

---

Cole o seguinte código no arquivo index.ts do seu projeto.

import { neon } from "@neondatabase/serverless";

// O Bun carrega automaticamente o DATABASE_URL do .env.local
// Consulte: https://bun.com/docs/runtime/environment-variables para mais informações
const sql = neon(process.env.DATABASE_URL);

const rows = await sql`SELECT version()`;

console.log(rows[0].version);

---

Inicie o programa usando bun ./index.ts. A versão do Postgres deve ser impressa no console.

bun ./index.ts

PostgreSQL 16.2 on x86_64-pc-linux-gnu, compiled by gcc (Debian 10.2.1-6) 10.2.1 20210110, 64-bit

---

Este exemplo usou a funcionalidade SQL-over-HTTP do driver serverless do Neon. O driver serverless do Neon também expõe os construtores Client e Pool para permitir sessões, transações interativas e compatibilidade com node-postgres.

Consulte a documentação do Neon para uma visão geral completa do driver serverless.