Можно ли при вызове метода save указать, какие поля нужно изменять?

Указание полей для изменения при вызове метода save

Краткий ответ: Да, можно! В большинстве ORM и фреймворков есть механизмы для этого. В Django и SQLAlchemy есть встроенная поддержка.

Django ORM

Способ 1: Параметр update_fields

from django.db import models

class User(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()
    age = models.IntegerField()

# Обновление только конкретных полей
user = User.objects.get(id=1)
user.name = "Новое имя"
user.email = "new@example.com"

# Сохраняем только эти два поля
user.save(update_fields=[name, email])  # age НЕ обновится

Способ 2: QuerySet.update()

# Массовое обновление конкретных полей
User.objects.filter(id=1).update(
    name="Новое имя",
    email="new@example.com"
)
# age не меняется

Способ 3: Собственная реализация

from django.db import models

class UserManager(models.Manager):
    def update_fields(self, id, **fields):
        """Обновляет только указанные поля"""
        user = self.get(id=id)
        
        # Устанавливаем значения
        for field_name, value in fields.items():
            setattr(user, field_name, value)
        
        # Сохраняем только эти поля
        user.save(update_fields=list(fields.keys()))
        return user

class User(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()
    age = models.IntegerField()
    
    objects = UserManager()

# Использование
User.objects.update_fields(1, name="Иван", email="ivan@example.com")

SQLAlchemy

Способ 1: Простое обновление

from sqlalchemy import update
from sqlalchemy.orm import Session

class User:
    __tablename__ = "users"
    id = Column(Integer, primary_key=True)
    name = Column(String)
    email = Column(String)
    age = Column(Integer)

# Обновление конкретных полей
session = Session(engine)
session.execute(
    update(User).where(User.id == 1).values(
        name="Новое имя",
        email="new@example.com"
    )
)
session.commit()
# age НЕ обновится

Способ 2: ORM метод

from sqlalchemy.orm import Session

session = Session(engine)
user = session.get(User, 1)

# Изменяем только нужные атрибуты
user.name = "Новое имя"
user.email = "new@example.com"

session.add(user)
session.commit()

# Если нужно сохранить только эти поля,
# можно использовать Hybrid свойства

Способ 3: Функция обновления

from sqlalchemy import update
from sqlalchemy.orm import Session

def update_user_fields(user_id: int, **fields):
    """Обновляет только указанные поля"""
    session = Session(engine)
    
    # Строим dict только с переданными полями
    allowed_fields = {name, email, age}
    update_data = {
        k: v for k, v in fields.items()
        if k in allowed_fields
    }
    
    session.execute(
        update(User).where(User.id == user_id).values(**update_data)
    )
    session.commit()

# Использование
update_user_fields(1, name="Иван", email="ivan@example.com")

FastAPI + SQLAlchemy

Правильный подход для API

from fastapi import FastAPI
from pydantic import BaseModel
from sqlalchemy.orm import Session
from sqlalchemy import update

app = FastAPI()

# Pydantic модель для update (поля опциональны)
class UserUpdate(BaseModel):
    name: str | None = None
    email: str | None = None
    age: int | None = None

@app.put("/users/{user_id}")
def update_user(user_id: int, user_data: UserUpdate, db: Session):
    """Обновляет только переданные поля"""
    
    # Собираем только переданные поля
    update_data = user_data.model_dump(exclude_unset=True)
    
    # Обновляем в БД
    db.execute(
        update(User).where(User.id == user_id).values(**update_data)
    )
    db.commit()
    
    return {"status": "updated", "fields": list(update_data.keys())}

# Примеры запросов:
# PUT /users/1 {"name": "Иван"}  -> обновляет только name
# PUT /users/1 {"email": "new@example.com"}  -> только email
# PUT /users/1 {}  -> ничего не обновляет

Пользовательская реализация

С использованием декоратора

from functools import wraps

class Entity:
    def save(self, only_fields=None):
        """Сохраняет модель, опционально только указанные поля"""
        if only_fields is None:
            only_fields = self.get_all_fields()
        
        data_to_save = {}
        for field_name in only_fields:
            if hasattr(self, field_name):
                data_to_save[field_name] = getattr(self, field_name)
        
        self._save_to_db(data_to_save)
    
    def get_all_fields(self):
        return [k for k in self.__dict__ if not k.startswith(_)]
    
    def _save_to_db(self, data):
        # Имитация сохранения
        print(f"Сохраняем: {data}")

class User(Entity):
    def __init__(self, id, name, email, age):
        self.id = id
        self.name = name
        self.email = email
        self.age = age

# Использование
user = User(1, "Иван", "ivan@example.com", 30)

# Сохраняем всё
user.save()
# Сохраняем: {id: 1, name: Иван, email: ivan@example.com, age: 30}

# Изменяем
user.name = "Петр"
user.email = "petr@example.com"
user.age = 35

# Сохраняем только некоторые
user.save(only_fields=[name, email])
# Сохраняем: {name: Петр, email: petr@example.com}

Монго DB

from pymongo import MongoClient

client = MongoClient()
db = client["mydb"]
users = db["users"]

# Обновление только конкретных полей
users.update_one(
    {"_id": 1},
    {"$set": {"name": "Иван", "email": "ivan@example.com"}}
    # age не меняется
)

Лучшие практики

1. Валидация полей

ALLOWED_FIELDS = {name, email, phone}

def update_user(user_id, **fields):
    # Проверяем, что указаны только разрешённые поля
    invalid_fields = set(fields.keys()) - ALLOWED_FIELDS
    
    if invalid_fields:
        raise ValueError(f"Недопустимые поля: {invalid_fields}")
    
    # Сохраняем
    db.execute(
        update(User).where(User.id == user_id).values(**fields)
    )

2. Логирование изменений

def save_with_audit(user_id, **fields):
    """Сохраняет с логированием изменённых полей"""
    
    old_user = User.query.get(user_id)
    
    # Логируем что изменилось
    for field, new_value in fields.items():
        old_value = getattr(old_user, field, None)
        print(f"Поле {field}: {old_value} -> {new_value}")
    
    # Сохраняем
    db.execute(
        update(User).where(User.id == user_id).values(**fields)
    )
    db.commit()

3. Условное обновление

from sqlalchemy import and_

def update_if_not_exists(user_id, **fields):
    """Обновляет только если поля пусты"""
    
    user = session.get(User, user_id)
    
    fields_to_update = {}
    for field, value in fields.items():
        if getattr(user, field) is None:
            fields_to_update[field] = value
    
    if fields_to_update:
        session.execute(
            update(User)
            .where(User.id == user_id)
            .values(**fields_to_update)
        )
        session.commit()

Резюме

Можно ли указать поля при save()?

✅ Да, множество способов:

🏆 Best practice: Используй встроенные механизмы ORM для безопасности и оптимизации.