fix(docs): clarify postgresql adapter setup

[AmanVarshney01]

Summary

• load .env before PostgreSQL adapter examples read DATABASE_URL
• fail with a clear error when DATABASE_URL is missing instead of passing an undefined value into pg
• document the optional pg.Pool setup for users who want to manage the pool directly
• mirror the guidance in current and v6 PostgreSQL driver adapter docs

Root cause

The docs passed process.env.DATABASE_URL directly to PrismaPg, which can produce confusing pg errors when the environment variable is missing. The current adapter accepts pg.PoolConfig, so the docs should keep that setup but make the environment handling explicit and show the pool form as an advanced option.

Validation

• inspected @prisma/adapter-pg@7.8.0 types: PrismaPg accepts pg.Pool | pg.PoolConfig | string
• pnpm exec cspell content/docs/orm/core-concepts/supported-databases/postgresql.mdx content/docs/orm/core-concepts/supported-databases/database-drivers.mdx content/docs/orm/v6/overview/databases/postgresql.mdx content/docs/orm/v6/overview/databases/database-drivers.mdx --show-context
• git diff --check

Fixes #7464

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
blog	Ready	Preview, Comment	May 26, 2026 1:21pm
docs	Ready	Preview, Comment	May 26, 2026 1:21pm
eclipse	Ready	Preview, Comment	May 26, 2026 1:21pm
site	Ready	Preview, Comment	May 26, 2026 1:21pm

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: bdd8c653-7a1a-4ed1-bed3-e0f551e664db

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[github-actions]

🍈 Lychee Link Check Report

95 links: ✅ 25 OK | 🚫 0 errors | 🔀 3 redirects | 👻 67 excluded

✅ All links are working!

---

Full Statistics Table

Status	Count
✅ Successful	25
🔀 Redirected	3
👻 Excluded	67
🚫 Errors	0
⛔ Unsupported	0
⏳ Timeouts	0
❓ Unknown	0

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	✅ No changes detected	-	May 26, 2026, 1:28 PM