PostgreSQL: أنواع البيانات في PostgreSQL: الدليل الكامل

-- اختيارات الأنواع الصحيحة لقاعدة بيانات التجارة الإلكترونية
CREATE TABLE smart_products (
    id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,  -- معرف مقاوم للمستقبل
    name VARCHAR(200) NOT NULL,                          -- سلسلة محدودة
    description TEXT,                                    -- نص غير محدود
    price DECIMAL(10, 2) NOT NULL,                       -- مال دقيق
    weight_kg REAL,                                      -- تقريبي مقبول
    is_available BOOLEAN DEFAULT true,                   -- علم نعم/لا
    created_at TIMESTAMPTZ DEFAULT NOW(),                -- واع بالمنطقة الزمنية
    source_ip INET,                                      -- نوع عنوان IP
    attributes JSONB DEFAULT '{}'::jsonb                 -- هيكل مرن
);

-- SMALLINT للقيم ذات النطاق الصغير
CREATE TABLE ratings (
    user_id INTEGER REFERENCES users(id),
    product_id INTEGER REFERENCES products(id),
    score SMALLINT CHECK (score BETWEEN 1 AND 5),  -- 1-5 ضمن نطاق SMALLINT تمامًا
    PRIMARY KEY (user_id, product_id)
);

-- INTEGER لمعظم المع��فات
CREATE TABLE categories (
    id SERIAL PRIMARY KEY,  -- SERIAL = INTEGER + تسلسل تلقائي
    name VARCHAR(100) NOT NULL
);

-- BIGINT للجداول عالية النمو
CREATE TABLE audit_log (
    id BIGSERIAL PRIMARY KEY,  -- BIGSERIAL = BIGINT + تلقائي
    action VARCHAR(50),
    details JSONB,
    created_at TIMESTAMPTZ DEFAULT NOW()
);

CREATE TABLE

-- عمود هوية بمعيار SQL (PostgreSQL 10+)
CREATE TABLE orders_v2 (
    id INTEGER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    user_id INTEGER REFERENCES users(id),
    total DECIMAL(12, 2) DEFAULT 0
);

-- إدراج بدون تحديد id (توليد تلقائي)
INSERT INTO orders_v2 (user_id, total) VALUES (1, 99.99);

-- محاولة إدراج id يدويًا (ستفشل مع GENERATED ALWAYS)
-- INSERT INTO orders_v2 (id, user_id, total) VALUES (100, 1, 50.00);

-- استخدم GENERATED BY DEFAULT إذا كنت بحاجة لتجاوز يدوي أحيانًا
CREATE TABLE logs (
    id INTEGER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    message TEXT
);

INSERT 0 1

-- فخ دقة العائمة: 0.1 + 0.2 != 0.3
SELECT 0.1::REAL + 0.2::REAL = 0.3::REAL AS float_equal;
-- الناتج: f (خطأ!)

-- DECIMAL لا فقدان دقة
SELECT 0.1::DECIMAL + 0.2::DECIMAL = 0.3::DECIMAL AS decimal_equal;
-- الناتج: t (صحيح!)

 id | name     | value 
----+----------+-------
  1 | example  | 42
(1 row)

-- DECIMAL(الدقة, المقياس)
-- الدقة = إجمالي الأرقام، المقياس = الأرقام بعد الفاصلة العشرية
-- DECIMAL(10,2) = حتى 99,999,999.99

CREATE TABLE products_precise (
    id SERIAL PRIMARY KEY,
    name VARCHAR(200),
    price DECIMAL(10, 2) NOT NULL,       -- الحد الأقصى 99,999,999.99
    tax_rate DECIMAL(5, 4) DEFAULT 0.0875, -- 0.0875 = 8.75%
    discount NUMERIC(5, 2) DEFAULT 0.00   -- الحد الأقصى 999.99%
);

-- حسابات المال دقيقة
SELECT name,
       price,
       price * tax_rate AS tax_amount,
       price + (price * tax_rate) AS price_with_tax
FROM products_precise;

 count 
-------
     5
(1 row)

-- CHAR: طول ثابت (مبطن بمسافات)
SELECT LENGTH('abc'::CHAR(5));
-- الناتج: 5 (مبطن إلى 5 أحرف)

-- VARCHAR: طول متغير مع حد
SELECT LENGTH('abc'::VARCHAR(5));
-- الناتج: 3 (مخزن كما هو، الحد الأقصى 5)

-- TEXT: طول متغير، بلا حد
SELECT LENGTH('abc'::TEXT);
-- الناتج: 3 (بلا حد)

-- اختبار الأداء: VARCHAR و TEXT متطابقان في PG
-- (على عكس MySQL حيث VARCHAR أسرع من TEXT)

 id | name     | value 
----+----------+-------
  1 | example  | 42
(1 row)

-- تعيين المنطقة الزمنية إلى UTC
SET timezone = 'UTC';

-- إدراج نفس اللحظة بأنواع مختلفة
INSERT INTO test_times (ts_no_tz, ts_with_tz) VALUES
    ('2026-07-13 10:00:00', '2026-07-13 10:00:00+00');

-- التغيير إلى منطقة طوكيو الزمنية
SET timezone = 'Asia/Tokyo';

-- TIMESTAMP (بدون منطقة زمنية) يظهر نفس القيمة الحرفية
SELECT ts_no_tz FROM test_times;
-- الناتج: 2026-07-13 10:00:00 (بدون تغيير، يمكن أن يكون أي منطقة زمنية!)

-- TIMESTAMPTZ يحول إلى المنطقة الزمنية المحلية
SELECT ts_with_tz FROM test_times;
-- الناتج: 2026-07-13 19:00:00+09 (10:00 UTC = 19:00 طوكيو)

INSERT 0 1

-- التاريخ والوقت الحالي
SELECT NOW();                    -- 2026-07-13 10:30:00.123456+00
SELECT CURRENT_DATE;             -- 2026-07-13
SELECT CURRENT_TIMESTAMP;        -- نفس NOW()

-- حساب التاريخ مع INTERVAL
SELECT NOW() + INTERVAL '7 days';     -- بعد أسبوع من الآن
SELECT NOW() - INTERVAL '3 months';   -- قبل 3 أشهر

-- حساب العمر
SELECT AGE(TIMESTAMP '1990-05-15');   -- 36 سنة 1 شهر 28 يوم

-- استخراج الأجزاء
SELECT EXTRACT(YEAR FROM NOW());      -- 2026
SELECT EXTRACT(MONTH FROM NOW());     -- 7
SELECT EXTRACT(DOW FROM NOW());       -- 1 (الاثنين، 0=الأحد)

 id | name     | value 
----+----------+-------
  1 | example  | 42
(1 row)

-- تمكين إضافة uuid-ossp
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

-- توليد إصدارات UUID مختلفة
SELECT uuid_generate_v4();  -- UUID عشوائي (الأكثر شيوعًا)
SELECT uuid_generate_v1();  -- UUID معتمد على الوقت

-- INET: IP مفرد أو نطاق IP
CREATE TABLE access_log (
    id BIGSERIAL PRIMARY KEY,
    source_ip INET NOT NULL,
    access_time TIMESTAMPTZ DEFAULT NOW()
);

INSERT INTO access_log (source_ip) VALUES
    ('192.168.1.100'),
    ('10.0.0.5'),
    ('2001:db8::1');

-- استعلام: العثور على جميع IP في شبكة فرعية (مستحيل مع VARCHAR!)
SELECT source_ip FROM access_log
WHERE source_ip << '192.168.1.0/24'::INET;
-- << تعني "محتوى داخل"

INSERT 0 1

-- Boolean يقبل تمثيلات متعددة
SELECT true, 't', 'true', 'yes', 'on', '1';   -- الكل = TRUE
SELECT false, 'f', 'false', 'no', 'off', '0';  -- الكل = FALSE

-- Boolean في عبارة WHERE
SELECT name FROM products WHERE is_available IS TRUE;
SELECT name FROM products WHERE is_available IS NOT FALSE;

 id | name     | value 
----+----------+-------
  1 | example  | 42
(1 row)

-- إنشاء نوع تعداد (مرة واحدة، قابل لإعادة الاستخدام عبر الجداول)
CREATE TYPE order_status AS ENUM (
    'pending', 'paid', 'shipped', 'delivered', 'cancelled'
);

-- استخدام في تعريف الجدول
CREATE TABLE orders_enum (
    id SERIAL PRIMARY KEY,
    status order_status DEFAULT 'pending'
);

-- قيم التعداد يتم التحقق منها تلقائيًا
INSERT INTO orders_enum (status) VALUES ('pending');   -- موافق
-- INSERT INTO orders_enum (status) VALUES ('unknown');  -- خطأ!

INSERT 0 1

-- ============================================
-- مثال كامل: جدول بجميع الأنواع الرئيسية
-- نظام جمع بيانات المستشعرات
-- ============================================

-- إنشاء نوع تعداد
CREATE TYPE sensor_status AS ENUM ('active', 'inactive', 'maintenance');

-- إنشاء جدول بأنواع بيانات متنوعة
CREATE TABLE sensors (
    -- الهوية
    id BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
    uuid UUID DEFAULT uuid_generate_v4() UNIQUE,

    -- النص
    name VARCHAR(100) NOT NULL,
    description TEXT,
    location_code CHAR(10),

    -- الرقمي
    latitude DECIMAL(9, 6) CHECK (latitude BETWEEN -90 AND 90),
    longitude DECIMAL(9, 6) CHECK (longitude BETWEEN -180 AND 180),
    altitude REAL,

    -- الشبكة
    ip_address INET,
    subnet CIDR,

    -- الحالة
    status sensor_status DEFAULT 'active',
    is_online BOOLEAN DEFAULT false,

    -- الوقت
    installed_at DATE,
    last_reading_at TIMESTAMPTZ,
    reading_interval INTERVAL DEFAULT INTERVAL '5 minutes',

    -- بيانات مرنة
    metadata JSONB DEFAULT '{}'::jsonb,

    -- التدقيق
    created_at TIMESTAMPTZ DEFAULT NOW()
);

-- إدراج بيانات نموذجية
INSERT INTO sensors (name, latitude, longitude, ip_address, status, installed_at, metadata)
VALUES (
    'Temperature Sensor A1',
    35.6762, 139.6503,
    '192.168.1.50',
    'active',
    '2025-01-15',
    '{"model": "TX-200", "unit": "celsius", "range_min": -40, "range_max": 85}'::jsonb
);

-- استعلام بعوامل خاصة بالنوع
SELECT name, ip_address, metadata->>'model' AS model
FROM sensors
WHERE ip_address << '192.168.1.0/24'::INET
  AND status = 'active';