دستاویزات/ایس کیو ایل ڈیٹا بیس

Nexy کے ساتھ نیین کا استعمال کریں۔

نیون سرور لیس ہے PostgreSQL: ایک Nexy پروجیکٹ اسے PostgreSQL کی طرح استعمال کرتا ہے، psycopg ڈرائیور کے ساتھ، DATABASE_URL میں نیون کا پولڈ کنکشن سٹرنگ، اور ایک ایسا پول جو ڈیٹابیس کو سونے سے بچاتا ہے۔

کنکشن کی تاریں حاصل کریں۔

نیون کنسول میں، Connect ہر شاخ کے لیے دو تار دکھاتا ہے:

فرق صرف میزبان کے نام میں -pooler ہے۔

ڈرائیور انسٹال کریں۔

uv add "psycopg[binary]"

HTTP پر نیون کا سرور لیس ڈرائیور JavaScript کے لیے ہے۔ Python سے کنکشن TCP اور TLS پر عام PostgreSQL ہے۔

دو URLs

DATABASE_URL=postgresql+psycopg://app_owner:secret@ep-cool-sun-a1b2c3-pooler.eu-central-1.aws.neon.tech/app?sslmode=requireDIRECT_DATABASE_URL=postgresql+psycopg://app_owner:secret@ep-cool-sun-a1b2c3.eu-central-1.aws.neon.tech/app?sslmode=require

نیون اپنے تاروں کو postgresql://... کے طور پر نقل کرتا ہے: postgresql کے بعد +psycopg شامل کریں۔ رکھیں sslmode=require، اور channel_binding=require جب کنسول اسے شامل کرتا ہے۔

انجن

نیون کمپیوٹ اس وقت معطل ہو جاتا ہے جب یہ بیکار ہوتا ہے، جو آپ کے پول کے کنکشن کو بند کر دیتا ہے۔ pool_pre_ping ایک مردہ کو استعمال کرنے سے پہلے اس کی جگہ لے لیتا ہے، اور pool_recycle نیون سے پہلے کنکشن گرا دیتا ہے:

import os from dotenv import load_dotenvfrom sqlmodel import create_engine load_dotenv() engine = create_engine(    os.environ["DATABASE_URL"],    pool_size=5,    max_overflow=5,    pool_pre_ping=True,    pool_recycle=300,)

معطلی کے بعد پہلی درخواست انتظار کرتی ہے جب کہ کمپیوٹ شروع ہوتا ہے، چند سو ملی سیکنڈ۔ اگر آپ کے لیے اہم ہے تو پروڈکشن برانچ پر آٹو سسپینڈ کو بند کر دیں۔

ایک ماڈل اور ایک ہینڈلر

باقی ہے PostgreSQL۔ ایک ماڈل:

from datetime import datetime, timezone from sqlalchemy import Column, DateTimefrom sqlmodel import Field, SQLModel  class Visit(SQLModel, table=True):    id: int | None = Field(default=None, primary_key=True)    path: str    at: datetime = Field(        default_factory=lambda: datetime.now(timezone.utc),        sa_column=Column(DateTime(timezone=True)),    )

from collections.abc import Iterator from sqlmodel import Session from src.configs.db import engine  def get_session() -> Iterator[Session]:    with Session(engine) as session:        yield session

from sqlmodel import Session, func, select from nexy.http import Dependsfrom src.configs.session import get_sessionfrom src.models.visit_model import Visit  async def POST(path: str, session: Session = Depends(get_session)):    session.add(Visit(path=path))    session.commit()    return {"visits": session.exec(select(func.count()).select_from(Visit)).one()}

from sqlmodel import Session, func, select from nexy.decorators import Controllerfrom nexy.http import Dependsfrom src.configs.session import get_sessionfrom src.models.visit_model import Visit  @Controller("/api/visits")class VisitsApiController:    async def post(self, path: str, session: Session = Depends(get_session)):        session.add(Visit(path=path))        session.commit()        return {"visits": session.exec(select(func.count()).select_from(Visit)).one()}

منتقلی براہ راست یو آر ایل سے ہوتی ہے۔

پولڈ ہوسٹ کے سامنے پی جی باؤنسر کلائنٹس کے درمیان رابطوں کا اشتراک کرتا ہے، جو مختصر سوالات کے مطابق ہوتا ہے، نہ کہ منتقلی کے طویل سیشن کے۔ nx migrate پڑھتا ہے DATABASE_URL، تو اس کمانڈ کے لیے براہ راست میزبان کی طرف اشارہ کریں:

DATABASE_URL="$DIRECT_DATABASE_URL" nx migrate -m "create visits"DATABASE_URL="$DIRECT_DATABASE_URL" nx migrate --upgrade

alembic/env.py src/configs/db.py کا انجن استعمال کرتا ہے، جو ایک ہی متغیر کو پڑھتا ہے۔

پولر کے پیچھے بیانات تیار

psycopg ایک استفسار تیار کرتا ہے جو اس نے پانچ بار چلایا ہے۔ اگر پولڈ میزبان جواب دیتا ہے prepared statement "_pg3_0" does not exist، تو اسے بند کر دیں:

engine = create_engine(    os.environ["DATABASE_URL"],    pool_pre_ping=True,    pool_recycle=300,    connect_args={"prepare_threshold": None},)

asyncpg کے ساتھ، ترتیب connect_args={"statement_cache_size": 0} ہے۔

ترقی اور پیش نظارہ کے لیے شاخیں

نیون برانچ ڈیٹا بیس کی ایک کاپی ہے، جو ایک سیکنڈ میں بنتی ہے۔ ایک فی ڈویلپر، یا فی پل کی درخواست، ٹیسٹ ڈیٹا کو پیداوار سے دور رکھتا ہے:

neonctl branches create --name dev-adaneonctl connection-string dev-ada --pooled

اس سٹرنگ کو ڈویلپر کے .env میں، یا پیش نظارہ تعیناتی کے ماحول میں رکھیں۔

ٹیسٹ

ان کے لیے بنائی گئی برانچ کے خلاف ٹیسٹ چلائیں، ایک ٹرانزیکشن کے اندر جو رول بیک کیا گیا ہے: دیکھیں ٹرانزیکشن میں ٹیسٹ۔

اگلے اقدامات

• استعمال کریں۔ PostgreSQL Nexy کے ساتھ : اقسام، تلاش، اپسرٹس اور async
• ڈیٹا بیس
• تعیناتی

صفحہ Markdown کے طور پر کاپی کریں GitHub پر ترمیم کریں