что делает этот метод? def insertitemsindb(self, itemlist: List[ProductItem]):…
- User
что делает этот метод?
def insert_items_in_db(self, item_list: List[ProductItem]): """Записываем в БД список товаров item_list [ProductItem], у которых должны быть заполнены поля: rrc_price title art_code url_code product_type_id product_guid so_guid_1c - как product_guid, но c решеткой store_guid - гуид торговой точки, где будет запас товара (тут для каждой точки нужно остатки добавлять таким образом) quantity """ self.delete_itemf_from_db(item_list) just_one = bool(len(item_list) == 1) values_to_products = "" values_to_sale_offer = "" values_to_wtb_stocks = "" values_to_wtb_stocks_sokolov = "" for prod in item_list: size = prod.size if prod.size else "0" values_to_products += str( tuple([prod.product_guid, prod.art_code, prod.url_code, prod.title, prod.product_type_id, prod.active, prod.rrc_price]) ) values_to_sale_offer += str( tuple( [ f"(select id from b2c.products where guid_1c='{prod.product_guid}')", prod.art_code, prod.rrc_price, prod.active, True, f"{prod.product_guid}#{size}", ] ) ).replace('"', "") values_to_wtb_stocks += str( tuple( [ f"(select id from b2c.products where guid_1c='{prod.product_guid}')", f"(select id from b2c.sale_offer where guid_1c='{prod.product_guid}#{size}')", prod.store_guid, prod.quantity, prod.rrc_price, ] ) ).replace('"', "") values_to_wtb_stocks_sokolov += str( tuple( [ f"(select id from b2c.products where guid_1c='{prod.product_guid}')", f"(select id from b2c.sale_offer where guid_1c='{prod.product_guid}#{size}')", prod.quantity, ] ) ).replace('"', "") end_of_value = ";" if just_one or item_list[-1] == prod else "," values_to_products += end_of_value values_to_sale_offer += end_of_value values_to_wtb_stocks += end_of_value values_to_wtb_stocks_sokolov += end_of_value with cursor_wrapper(self.connector) as cursor: cursor.execute( f"insert into b2c.products (guid_1c, article, url_code, name, product_type_id, active, min_rrc) values {values_to_products};" ) cursor.execute(f"insert into b2c.sale_offer (product_id, article, rrc, active, in_range, guid_1c) values {values_to_sale_offer};") cursor.execute(f"insert into b2c.wtb_stocks (product_id, sale_offer_id, sale_point_id, quantity, price) values {values_to_wtb_stocks};") cursor.execute(f"insert into b2c.wtb_stocks_sokolov (product_id, sale_offer_id, quantity) values {values_to_wtb_stocks_sokolov};") Assistant
Метод
insert_items_in_dbвыполняет следующие действия:Основная цель
Массовая вставка данных о товарах, их предложениях и остатках в несколько таблиц базы данных PostgreSQL.
Пошаговое описание
-
Удаление старых данных
self.delete_itemf_from_db(item_list)- Удаляет существующие записи товаров из БД, чтобы избежать дубликатов или обновить данные.
- Подразумевается, что метод
delete_itemf_from_dbреализован отдельно.
-
Подготовка SQL-запросов
- Создаются строки с данными для вставки в 4 таблицы:
products: основная информация о товаре.sale_offer: предложения товаров (цены, статус).wtb_stocks: остатки товаров по торговым точкам.wtb_stocks_sokolov: специфичные остатки для "Соколов".
- Создаются строки с данными для вставки в 4 таблицы:
-
Формирование строк с данными Для каждого товара из
item_list:-
products
Вставляются поля:guid_1c(уникальный идентификатор товара),article(артикул),url_code(URL-код),name(название),product_type_id(тип товара),active(активность),min_rrc(рекомендованная розничная цена).
-
sale_offer
Вставляются поля:product_id(через подзапрос изproducts),article(артикул),rrc(рекомендованная цена),active(активность),in_range(в ассортименте),guid_1c(уникальный идентификатор предложения, включая размер).
-
wtb_stocks
Вставляются поля:product_id(через подзапрос),sale_offer_id(через подзапрос),sale_point_id(идентификатор торговой точки),quantity(количество),price(цена).
-
wtb_stocks_sokolov
Аналогичноwtb_stocks, но без указания торговой точки. -
Разделение значений
Если список содержит один товар, используется точка с запятой (;), иначе — запятая (,).
-
-
Выполнение SQL-запросов
- Вставка данных в таблицы:
INSERT INTO b2c.products (...) VALUES (...); INSERT INTO b2c.sale_offer (...) VALUES (...); INSERT INTO b2c.wtb_stocks (...) VALUES (...); INSERT INTO b2c.wtb_stocks_sokolov (...) VALUES (...);
- Вставка данных в таблицы:
Ключевые детали
-
Безопасность
Метод использует прямую конкатенацию строк для формирования SQL-запросов, что потенциально уязвимо к SQL-инъекциям. Однако в данном случае предполагается, что данные уже проверены или используются внутренние/доверенные источники. -
Связь между таблицами
Дляsale_offer,wtb_stocksиwtb_stocks_sokolovиспользуются подзапросы (SELECT id FROM ...), чтобы связать записи с соответствующими строками вproductsиsale_offer. -
Обработка ошибок
Если подзапросы не находят соответствующих записей (например, товар еще не создан), вставка завершится ошибкой. Это предполагает, что методdelete_itemf_from_dbкорректно очищает данные перед вставкой.
Пример структуры таблиц
-
b2c.products
Хранит основную информацию о товарах:guid_1c TEXT PRIMARY KEY, article TEXT, url_code TEXT, name TEXT, product_type_id INTEGER, active BOOLEAN, min_rrc NUMERIC -
b2c.sale_offer
Предложения товаров:product_id INTEGER REFERENCES products(id), article TEXT, rrc NUMERIC, active BOOLEAN, in_range BOOLEAN, guid_1c TEXT UNIQUE -
b2c.wtb_stocks
Остатки по торговым точкам:product_id INTEGER REFERENCES products(id), sale_offer_id INTEGER REFERENCES sale_offer(id), sale_point_id TEXT, quantity INTEGER, price NUMERIC -
b2c.wtb_stocks_sokolov
Специфичные остатки для "Соколов":product_id INTEGER REFERENCES products(id), sale_offer_id INTEGER REFERENCES sale_offer(id), quantity INTEGER
Использование
Метод предназначен для массовой загрузки данных о товарах, их предложениях и остатках в БД. Применяется, например, при синхронизации с внешними системами (1С, ERP и т.д.).
-
- User
как сформировать [ProductItem] для методов?
Assistant
Чтобы сформировать список объектов
ProductItemдля методаinsert_items_in_db, нужно:
1. Определить класс
ProductItemСоздайте класс (или
dataclass), который содержит все обязательные поля, указанные в комментарии к методу:from dataclasses import dataclass from typing import List, Optional @dataclass class ProductItem: rrc_price: float # Рекомендованная розничная цена title: str # Название товара art_code: str # Артикул url_code: str # URL-код товара (для ссылок) product_type_id: int # Идентификатор типа товара product_guid: str # Уникальный идентификатор товара (GUID) so_guid_1c: str # GUID предложения (product_guid + "#" + size) store_guid: str # GUID торговой точки quantity: int # Количество товара в наличии active: bool = True # Активность товара (по умолчанию True) size: Optional[str] = "0" # Размер (если есть, иначе "0")
2. Заполнить список
ProductItemСоздайте экземпляры класса
ProductItemи добавьте их в список. Пример:items = [ ProductItem( rrc_price=1999.99, title="Серебряное кольцо", art_code="ART123", url_code="silver_ring", product_type_id=1, product_guid="GUID123", so_guid_1c="GUID123#18.5", # product_guid + "#" + size store_guid="STORE456", quantity=10, size="18.5" ), ProductItem( rrc_price=2999.99, title="Золотое кольцо", art_code="GOLD789", url_code="gold_ring", product_type_id=2, product_guid="GUID456", so_guid_1c="GUID456#20", # product_guid + "#" + size store_guid="STORE789", quantity=5, size="20" ) ]
3. Важные детали
Обязательные поля
- Все поля, указанные в комментарии к методу, должны быть заполнены:
rrc_pricetitleart_codeurl_codeproduct_type_idproduct_guidso_guid_1c(формируется какproduct_guid + "#" + size)store_guidquantity
Поле
size- Если у товара нет размера (например, это кольцо без регулировки), используйте
"0"по умолчанию. so_guid_1cвсегда формируется какf"{product_guid}#{size}".
Торговые точки (
store_guid)- Если нужно добавить остатки для разных магазинов, создайте отдельный
ProductItemдля каждой комбинации товара и магазина:items = [ ProductItem(..., store_guid="STORE1", ...), ProductItem(..., store_guid="STORE2", ...) ]
Активность (
active)- По умолчанию
active=True. Если товар неактивен, установитеactive=False.
4. Пример с валидацией данных
Если вы хотите убедиться, что все поля заполнены корректно, можно добавить валидацию:
def validate_product_item(item: ProductItem): required_fields = [ "rrc_price", "title", "art_code", "url_code", "product_type_id", "product_guid", "so_guid_1c", "store_guid", "quantity" ] for field in required_fields: if getattr(item, field) is None: raise ValueError(f"Поле {field} не заполнено для товара {item.title}") for item in items: validate_product_item(item)
5. Альтернатива: Использование
pydanticдля валидацииЕсли проект использует
pydantic, можно определить модель:from pydantic import BaseModel from typing import Optional class ProductItem(BaseModel): rrc_price: float title: str art_code: str url_code: str product_type_id: int product_guid: str so_guid_1c: str store_guid: str quantity: int active: bool = True size: Optional[str] = "0"
6. Пример использования
# Создаем список товаров items = [ ProductItem( rrc_price=1999.99, title="Серебряное кольцо", art_code="ART123", url_code="silver_ring", product_type_id=1, product_guid="GUID123", so_guid_1c="GUID123#18.5", store_guid="STORE456", quantity=10, size="18.5" ) ] # Передаем в метод db_connector.insert_items_in_db(items)
Итог
- Создайте класс
ProductItemс обязательными полями. - Заполните список объектов этого класса.
- Убедитесь, что все поля корректны и соответствуют требованиям метода
insert_items_in_db.
Это позволит методу корректно сформировать SQL-запросы и вставить данные в БД.
- Все поля, указанные в комментарии к методу, должны быть заполнены:
- User
Источником данных может быть таблица b2c.products?
Assistant
Да, таблица
b2c.productsможет быть источником данных, но только частично. Для корректного формирования спискаProductItemтребуется данных из нескольких таблиц, так какProductItemвключает поля, которые хранятся в других таблицах (например,quantityизwtb_stocks,rrc_priceизsale_offer).
Как использовать
b2c.productsкак источник данных?1. Извлечение данных из
b2c.productsЕсли вы хотите обновить/синхронизировать товары из
b2c.products, сначала извлеките данные из неё:SELECT guid_1c AS product_guid, article AS art_code, url_code, name AS title, product_type_id, min_rrc AS rrc_price, active FROM b2c.products;2. Объединение с другими таблицами
Чтобы собрать полный
ProductItem, необходимо присоединить данные изsale_offer,wtb_stocksи других таблиц:SELECT p.guid_1c AS product_guid, p.article AS art_code, p.url_code, p.name AS title, p.product_type_id, p.min_rrc AS rrc_price, p.active, so.guid_1c AS so_guid_1c, so.article AS so_art_code, so.rrc AS so_rrc_price, ws.sale_point_id AS store_guid, ws.quantity, ws.price AS stock_price FROM b2c.products p LEFT JOIN b2c.sale_offer so ON p.id = so.product_id LEFT JOIN b2c.wtb_stocks ws ON so.id = ws.sale_offer_id;3. Преобразование результата в список
ProductItemПосле выполнения запроса преобразуйте данные в список объектов
ProductItem:def fetch_products_from_db(connector) -> List[ProductItem]: query = """ SELECT p.guid_1c, p.article, p.url_code, p.name, p.product_type_id, p.min_rrc, p.active, so.guid_1c AS so_guid_1c, ws.sale_point_id AS store_guid, ws.quantity FROM b2c.products p LEFT JOIN b2c.sale_offer so ON p.id = so.product_id LEFT JOIN b2c.wtb_stocks ws ON so.id = ws.sale_offer_id; """ with cursor_wrapper(connector) as cursor: cursor.execute(query) rows = cursor.fetchall() items = [] for row in rows: items.append(ProductItem( product_guid=row["guid_1c"], art_code=row["article"], url_code=row["url_code"], title=row["name"], product_type_id=row["product_type_id"], rrc_price=row["min_rrc"], active=row["active"], so_guid_1c=row["so_guid_1c"], store_guid=row["store_guid"], quantity=row["quantity"], size="0" # Если размер не указан, по умолчанию "0" )) return items
Когда использовать
b2c.productsкак источник?1. Обновление товаров
Если вы хотите обновить данные товаров (например, изменить
rrc_price,active,title), используйтеb2c.productsкак основной источник, а затем дополните его данными из других таблиц.2. Синхронизация с внешними системами
Если данные о товарах хранятся в
b2c.products, а остатки и предложения — в других таблицах, объединяйте данные через SQL-запросы.3. Резервное копирование или миграция
При миграции данных в другую систему или создании бэкапа используйте
b2c.productsкак часть данных, но не забывайте о связанных таблицах.
Важные ограничения
-
Поле
quantity
Остатки хранятся вwtb_stocks, поэтому без этой таблицыProductItemбудет неполным. -
Поле
so_guid_1c
Этоguid_1cизsale_offer, которое формируется какproduct_guid + "#" + size. Еслиsale_offerотсутствует, это поле будетNone. -
Поле
store_guid
Безwtb_stocksневозможно определить, в каких торговых точках есть товар. -
Размер
size
Еслиsizeне хранится вsale_offer, его придется заполнять вручную или использовать значение по умолчанию ("0").
Пример использования
# Получаем товары из БД items = fetch_products_from_db(connector) # Добавляем/обновляем данные в БД db_connector.insert_items_in_db(items)
Итог
b2c.productsможет быть частью источника данных, но для полногоProductItemнужны данные изsale_offer,wtb_stocksи других таблиц.- Используйте SQL-запросы с
JOIN, чтобы собрать все необходимые поля. - Если данные о размерах или остатках отсутствуют, заполняйте их значениями по умолчанию (
"0").
-