كيف تعمل معرّفات الزيادة التلقائية (SERIAL و sequences و IDENTITY)؟

Question

Accepted Answer

يولّد PostgreSQL معرّفات الزيادة التلقائية (عادة للمفاتيح الأساسية) باستخدام **sequences** — كائنات خاصة تنتج أرقاماً فريدة متزايدة. **`SERIAL`** هو اختصار ينشئ تسلسلاً تلقائياً، و**`IDENTITY`** هو المعادل الحديث المتوافق مع معيار SQL.

## SERIAL — الاختصار الكلاسيكي

```sql
CREATE TABLE users (
  id SERIAL PRIMARY KEY,      -- auto-incrementing integer (SERIAL = INT + a sequence)
  name TEXT
);
-- BIGSERIAL for larger ranges (BIGINT-backed) — use for tables expecting many rows

INSERT INTO users (name) VALUES ('Ann');   -- id auto-assigned (1, 2, 3, ...)
```

ينشئ `SERIAL` تسلسلاً تلقائياً ويعين القيمة الافتراضية للعمود لسحب القيمة التالية منه. يستخدم `BIGSERIAL` قيمة `BIGINT` لنطاقات أكبر (مهم للجداول التي قد تتجاوز حوالي ملياري صف).

## IDENTITY — الطريقة الحديثة والموصى بها (Postgres 10+)

```sql
CREATE TABLE users (
  id INT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,   -- SQL-standard, recommended
  name TEXT
);
-- GENERATED ALWAYS → you can't manually insert a value (cleaner)
-- GENERATED BY DEFAULT → allows manual override when needed
```

`GENERATED ... AS IDENTITY` هو النهج الحديث المتوافق مع معيار SQL (الفضل على `SERIAL` في الأكواد الجديدة) — إنه أنظف ويتجنب بعض غرائب `SERIAL` (مثل حالات المالكية والأذونات).

## كيفية عمل التسلسلات تحت السطح

```sql
CREATE SEQUENCE my_seq START 1 INCREMENT 1;
SELECT nextval('my_seq');     -- get the next value (advances the sequence)
SELECT currval('my_seq');     -- the last value YOU got
SELECT setval('my_seq', 100); -- set the current value
```

التسلسل هو عداد مستقل. يستخدم `SERIAL`/`IDENTITY` واحداً خلف الكواليس. ملاحظة: التسلسلات **لا** يتم التراجع عنها بواسطة العمليات (لذا قد تحتوي المعرفات على فجوات بعد التراجع — أمر طبيعي ومتوقع).

## الحصول على المعرف الجديد

```sql
-- RETURNING — get the generated id back from an INSERT (very useful)
INSERT INTO users (name) VALUES ('Ann') RETURNING id;
```

## لماذا يهم

معرفات الزيادة التلقائية أساسية — تقريباً كل جدول يحتاج إلى مفتاح أساسي فريد، ومعرفات المتسلسلات ذاتية التوليد هي النهج القياسي، لذا فهم كيفية تعامل PostgreSQL معها معرفة أساسية ضرورية يومية.

معرفة **`SERIAL`** (الاختصار الكلاسيكي الشائع الذي ينشئ تسلسلاً تلقائياً) والأهم **`IDENTITY`** (`GENERATED ... AS IDENTITY` — النهج الحديث المتوافق مع معيار SQL والموصى به للأكواد الجديدة، وهو أنظف ويتجنب غرائب SERIAL) مهمة لتعريف المفاتيح الأساسية بشكل صحيح.

فهم **التسلسلات** الأساسية (العدادات المستقلة التي تنتج قيماً فريدة متزايدة) يوضح كيفية عمل الزيادة التلقائية ومفيد للتحكم المتقدم (`nextval` و `setval`).

هناك نقطتان عمليتان مهمتان: اختيار **`BIGSERIAL`/BIGINT`** للجداول التي قد تنمو كثيراً (تجنب تجاوز الأعداد الصحيحة — مشكلة حقيقية)، والعلم بأن **التسلسلات لا يتم التراجع عنها** بواسطة العمليات (لذا قد تحتوي المعرفات على فجوات بعد التراجع أو المدخلات الفاشلة — سلوك طبيعي ومتوقع قد يفاجئ البعض).

جملة **`RETURNING`** للحصول على المعرف المولد مرة أخرى من INSERT مفيدة أيضاً ومعرفة يومية.

بما أن كل جدول يحتاج إلى مفاتيح أساسية ومعرفات الزيادة التلقائية هي المعيار، وبما أن فهم SERIAL مقابل IDENTITY الموصى به، والتسلسلات الأساسية، وتحديد الحجم (BIGSERIAL)، وسلوك الفجوات، و RETURNING يغطي الاحتياجات العملية، فإن معرفة كيفية توليد PostgreSQL لمعرفات الزيادة التلقائية معرفة أساسية وتطبيقية متكررة للعمل مع جداول Postgres ونقطة مشتركة حيث تعكس معرفة الممارسة الحديثة (IDENTITY) الكفاءة الحالية في Postgres.