🎬 Introdução

Você já sabe escrever queries SQL no Query Tool do pgAdmin.

Você já sabe criar programas em Node.js e instalar pacotes com npm.

Agora chegou o momento de unir os dois mundos.

<aside> 👉🏻

Tudo que você fazia clicando no pgAdmin, agora vai fazer pelo código.

</aside>

A mesma query que você executava assim:

SELECT * FROM produtos;

Vai virar isso no Node:

client.query('SELECT * FROM produtos');

É exatamente a mesma coisa — só que agora quem executa é o seu programa, não o pgAdmin.

🧠 Como o Node conversa com o PostgreSQL?

Antes de escrever código, entenda o fluxo:

graph LR
    A[🖥️ Seu programa Node.js] -->|envia query SQL| B[📦 Biblioteca pg npm install pg]
    B -->|conecta via rede| C[(🐘 PostgreSQL localhost:5432)]
    C -->|retorna resultado| B
    B -->|retorna dados| A
    A -->|você visualiza| D[🖥️ Terminal]
    C -->|você também pode ver| E[🔧 pgAdmin]

O pgAdmin e o seu programa Node falam com o mesmo banco de dados:

• Quando você inserir um dado pelo Node, vai aparecer no pgAdmin.
• Quando você criar uma tabela no pgAdmin, o Node consegue ler.

📦 O que é a biblioteca pg?

O Node não sabe falar com o PostgreSQL por padrão.

Precisamos instalar uma biblioteca chamada pg — também conhecida como node-postgres.

Ela faz o papel de tradutor entre o Node e o banco:

graph TD
    A[Node.js / JavaScript] -->|não sabe falar SQL nativo| B{❌}
    A -->|instala pg via npm| C[pg node-postgres]
    C -->|fala com o banco| D[(PostgreSQL)]