أمر UPDATE في SQLite: تحديث الصفوف وتعديل الأعمدة

أمر UPDATE لتعديل الصفوف الموجودة

بينما يضيف INSERT صفوفًا جديدة، يأتي دور UPDATE لتحديث بيانات جدول SQLite الموجودة فعلًا. صيغته قصيرة وتستحق الحفظ:

UPDATE table_name
SET column = value
WHERE condition;

مثال عملي مكتمل:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    name TEXT NOT NULL,
    email TEXT,
    status TEXT DEFAULT 'active'
);

INSERT INTO users (name, email) VALUES
    ('Ada', 'ada@old.com'),
    ('Boris', 'boris@old.com'),
    ('Rosa', 'rosa@old.com');

UPDATE users
SET email = 'ada@new.com'
WHERE id = 1;

SELECT * FROM users;

تحدد جملة SET التغييرات المطلوبة، بينما تحدد جملة WHERE الصفوف المستهدفة. أما باقي بيانات الجدول فتبقى كما هي دون أي تعديل.

جملة WHERE ليست اختيارية من الناحية العملية

من الناحية النظرية، تُعتبر جملة WHERE اختيارية. لكن من الناحية العملية، إهمالها هو السبب الأول الذي يجعل المطورين المبتدئين يقضون فترة ما بعد الظهر في إصلاح الكوارث:

UPDATE users SET status = 'inactive';
-- أصبح كل مستخدم الآن غير نشط

غياب الشرط يعني أنّ كل الصفوف ستُطابَق، وSQLite سينفّذ الأمر دون أي اعتراض. اعتد دائمًا على كتابة WHERE أولًا ثم SET بعدها — هذه العادة وحدها كفيلة بتجنّب كثير من الكوارث.

وإذا لم تكن متأكدًا من صحة شرط WHERE، فجرّب الشرط نفسه مع SELECT قبل تنفيذ التحديث:

CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, status TEXT);
INSERT INTO users VALUES (1, 'Ada', 'active'), (2, 'Boris', 'active'), (3, 'Rosa', 'pending');

-- معاينة الصفوف التي سيتم تعديلها.
SELECT id, name, status FROM users WHERE status = 'pending';

-- ثم نفّذ التحديث بنفس شرط WHERE تمامًا.
UPDATE users SET status = 'active' WHERE status = 'pending';

SELECT * FROM users;

نفس الشرط، لكن بأمرين. اعتبر الـ SELECT بمثابة بروفة قبل التنفيذ الفعلي.

تحديث عدة أعمدة في sqlite

تقدر تحدّث أكثر من عمود دفعة واحدة بفصل التعيينات بفواصل داخل SET واحدة. SET واحدة وعدة أعمدة:

CREATE TABLE products (
    id INTEGER PRIMARY KEY,
    name TEXT,
    price REAL,
    stock INTEGER
);

INSERT INTO products VALUES (1, 'أداة', 9.99, 100);

UPDATE products
SET price = 12.99,
    stock = 75,
    name = 'أداة فاخرة'
WHERE id = 1;

SELECT * FROM products;

رحلة واحدة فقط إلى قاعدة البيانات، صف واحد تم تعديله، وثلاثة أعمدة جرى تحديثها. لا داعي لكتابة ثلاث جمل UPDATE منفصلة طالما أن جملة واحدة تكفي.

التعابير بعد علامة =

القيمة التي تأتي بعد = ليست مقتصرة على القيم الحرفية، بل يمكن أن تكون أي تعبير برمجي — بما في ذلك تعبير يعتمد على القيمة الحالية للعمود نفسه:

CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, price REAL, stock INTEGER);
INSERT INTO products VALUES
    (1, 'Widget', 10.00, 50),
    (2, 'Gadget', 20.00, 30),
    (3, 'Gizmo', 15.00, 80);

-- رفع الأسعار بنسبة 10%.
UPDATE products
SET price = price * 1.10;

-- إنقاص المخزون لصف واحد.
UPDATE products
SET stock = stock - 1
WHERE id = 2;

SELECT * FROM products;

price * 1.10 يقرأ السعر الحالي، يضربه، ثم يكتب الناتج مكانه. ينفّذ SQLite الطرف الأيمن اعتماداً على القيم الحالية للصف قبل تطبيق أي إسناد من إسنادات هذه الجملة، فبإمكانك الإشارة إلى أكثر من عمود دون قلق:

UPDATE products SET price = price * 1.10, stock = stock + price;
-- إن قيمة 'price' في الطرف الأيمن هنا هي السعر القديم، وليس السعر الذي تم تحديثه للتو.

UPDATE ... FROM: تحديث الأعمدة بقيم من جدول آخر

ابتداءً من الإصدار 3.33، أصبح UPDATE في SQLite يدعم جملة FROM، وهي أنظف طريقة لتحديث بيانات جدول اعتمادًا على جدول آخر ومزامنة القيم بينهما:

CREATE TABLE customers (id INTEGER PRIMARY KEY, name TEXT, total_spent REAL DEFAULT 0);
CREATE TABLE orders (id INTEGER PRIMARY KEY, customer_id INTEGER, amount REAL);

INSERT INTO customers (name) VALUES ('Ada'), ('Boris'), ('Rosa');
INSERT INTO orders (customer_id, amount) VALUES
    (1, 50.00), (1, 30.00),
    (2, 100.00),
    (3, 25.00), (3, 75.00);

UPDATE customers
SET total_spent = totals.sum_amount
FROM (
    SELECT customer_id, SUM(amount) AS sum_amount
    FROM orders
    GROUP BY customer_id
) AS totals
WHERE customers.id = totals.customer_id;

SELECT * FROM customers;

الاستعلام الفرعي يحسب الإجماليات لكل عميل، ثم تقوم جملة UPDATE الخارجية بربط هذه النتائج مع جدول customers عبر العمود id. لو لم تكن صيغة UPDATE ... FROM متاحة، لاضطررت إلى كتابة استعلام فرعي مرتبط لكل عمود على حدة، وهذا يجعل الكود أكثر فوضى.

إليك بعض القواعد التي يجب الانتباه لها:

• اسم الجدول الهدف يُكتب بعد UPDATE مباشرةً، وليس ضمن قائمة FROM.
• جملة WHERE هي التي تتولى عملية الربط (الـ join)، فلا توجد كلمة ON هنا.
• إذا كان الربط يحتمل مطابقة أكثر من صف في FROM، فالنتيجة غير محددة. تأكد أن مفاتيح الربط تُنتج مطابقة واحدة على الأكثر لكل صف هدف.

استخدام RETURNING لمعرفة الصفوف المعدّلة

ابتداءً من الإصدار 3.35، يسمح لك SQLite بإرجاع الصفوف المُحدَّثة من جملة UPDATE نفسها. هذا مفيد جداً عندما يحتاج تطبيقك إلى القيم بعد التحديث دون الحاجة إلى تنفيذ SELECT إضافي بعدها:

CREATE TABLE products (id INTEGER PRIMARY KEY, name TEXT, price REAL);
INSERT INTO products VALUES (1, 'Widget', 10.00), (2, 'Gadget', 20.00);

UPDATE products
SET price = price * 0.9
WHERE price > 15
RETURNING id, name, price;

ترجع لك الصفوف التي فعلاً تعدّلت بقيمها الجديدة. هذا يوفّر عليك رحلة ثانية للسيرفر، ويقضي على نوع كامل من مشاكل التعارض (race conditions) في الكود المتزامن. في فصل لاحق صفحة كاملة مخصصة لـ RETURNING.

UPDATE OR REPLACE: التعامل مع تعارضات القيود

لو كان التحديث الذي تنفّذه سيخالف قيد UNIQUE، فالسلوك الافتراضي هو إلغاء التنفيذ ورمي خطأ. لكن جملة OR تتيح لك اختيار سياسة مختلفة:

CREATE TABLE users (
    id INTEGER PRIMARY KEY,
    email TEXT UNIQUE,
    name TEXT
);

INSERT INTO users VALUES
    (1, 'ada@x.com', 'Ada'),
    (2, 'boris@x.com', 'Boris');

-- سيفشل هذا بسبب انتهاك قيد UNIQUE:
-- UPDATE users SET email = 'boris@x.com' WHERE id = 1;

-- تقوم OR REPLACE بحذف الصف المتعارض، ثم تنفّذ التحديث.
UPDATE OR REPLACE users
SET email = 'boris@x.com'
WHERE id = 1;

SELECT * FROM users;

الخيارات المتاحة هي OR ABORT (وهو الافتراضي)، وOR REPLACE، وOR IGNORE، وOR FAIL، وOR ROLLBACK. الخيار الخطير منها هو REPLACE، لأنه يحذف الصف المتعارض، وقد يمتد هذا الحذف عبر المفاتيح الأجنبية ويُسبّب سلسلة من العمليات غير المرغوبة. لا تستخدمه إلا حين تقصد فعلاً: "لو وُجد صف بنفس القيمة الفريدة، تخلّص منه".

أما في معظم سيناريوهات الـ upsert، فإن صيغة INSERT ... ON CONFLICT المخصصة لذلك تكون أوضح بكثير، وهناك صفحة كاملة تشرحها.

تغليف عمليات التحديث الحساسة داخل معاملة (Transaction)

عندما تُعدّل عدداً كبيراً من الصفوف، أو تُنفّذ عدة جمل UPDATE يجب أن تنجح كلها معاً أو لا تنجح أصلاً، ضعها داخل معاملة. وهكذا، إذا حدث أي خطأ، يمكنك التراجع (rollback) والعودة إلى الحالة السابقة:

CREATE TABLE accounts (id INTEGER PRIMARY KEY, name TEXT, balance REAL);
INSERT INTO accounts VALUES (1, 'Ada', 100.00), (2, 'Boris', 50.00);

BEGIN;
    UPDATE accounts SET balance = balance - 25 WHERE id = 1;
    UPDATE accounts SET balance = balance + 25 WHERE id = 2;
COMMIT;

SELECT * FROM accounts;

إذا فشلت الجملة الثانية (لنقل أن قيدًا ما تدخّل)، فإن ROLLBACK يتراجع عن الأولى. بدون استخدام المعاملات، ستجد نفسك أمام تحويل نصف مكتمل — حُسم من Ada مبلغ 25 ولم يتغير رصيد Boris. سنُفرد للمعاملات فصلًا خاصًا لاحقًا، يكفي الآن أن تعرف أنها موجودة، وأن عمليات التحديث المُجمَّعة يجب أن تكون داخلها في الغالب.

الأخطاء الشائعة في أمر update في sqlite

قائمة موجزة بأكثر الأمور التي يقع فيها المطورون:

• نسيان WHERE — سيؤدي ذلك إلى تحديث جميع الصفوف. اقرأ الجملة بصوت مرتفع قبل تنفيذها.
• استخدام معامل خاطئ داخل WHERE — الجملة WHERE status = NULL لن تطابق أي صف. استخدم IS NULL بدلًا منها. سنتناول هذه النقطة بالتفصيل في صفحة المعاملات.
• التحديث باستعلام فرعي يُرجع أكثر من صف بينما كنت تتوقع صفًا واحدًا. أضف LIMIT 1 أو استخدم دالة تجميع داخل الاستعلام الفرعي، وإلا ستحصل على أخطاء أو نتائج غير متوقعة.
• الخلط بين UPDATE OR REPLACE وبين UPSERT. OR REPLACE يحذف الصفوف المتعارضة، أما INSERT ... ON CONFLICT DO UPDATE فيُعدّلها في مكانها. عمليتان مختلفتان تمامًا.

الخطوة التالية: DELETE

UPDATE يُعدّل الصفوف، بينما DELETE يحذفها. ينطبق على الأمرين نفس الانضباط في استخدام WHERE، وكذلك العادة الذهبية بتشغيل SELECT أولًا، فهي ستُجنّبك الكوارث نفسها. هذا ما سنتناوله في الصفحة التالية.