يحوّل CAST(value AS type) قيمة إلى نوع آخر، وvalue::type هي الصيغة الأقصر للشيء نفسه في PostgreSQL. يعيد كل من '42'::integer وCAST('42' AS integer) العدد الصحيح 42. وهناك صيغة ثالثة، type 'literal' (كما في date '2026-11-17')، تعمل مع الثوابت فقط.
يصبح النص '2026-11-17' تاريخًا، فإضافة 30 تعطي التاريخ بعد 30 يومًا. و'yes' إحدى الكتابات التي يقبلها boolean، مع true وt وon و1.
تحويل نص إلى رقم أو تاريخ
البيانات المحمّلة من ملفات CSV أو النماذج تصل غالبًا نصًا. حوّلها قبل المقارنة أو الحساب، لأن '10' يأتي قبل '9' عند المقارنة كنص:
عند الترتيب كأعداد صحيحة يأتي 9 قبل 10، ومجموعا السطرين 40.5 و120. المسافات في البداية والنهاية مسموح بها (' 42 '::integer يعمل)، لكن أي حرف زائد آخر يرفع الخطأ "invalid input syntax for type integer". وللنصوص بصيغة أخرى، مثل '17/11/2026' أو '1,234.50'، استخدم to_date وto_number مع نمط تنسيق.
التقريب وقسمة الأعداد الصحيحة
تحويل numeric إلى عدد صحيح يقرّب النصف بعيدًا عن الصفر، وتحويل قيمة double precision يقرّب النصف إلى العدد الزوجي. أما قسمة الأعداد الصحيحة فتحذف الكسر:
النتائج هي 3 و-3 و2 و4 و3 و3.5 و12. استخدم trunc() أو floor() قبل التحويل حين تريد قطع الكسر بدل تقريبه.
التحويل إلى نوع أصغر يتحقق من النطاق: يفشل 70000::smallint بالخطأ "smallint out of range"، ويُقرَّب 12.345::numeric(5, 2) إلى 12.35.
تحقق من المدخل قبل التحويل
التحويل الفاشل يوقف الجملة كلها. منذ PostgreSQL 16 تختبر pg_input_is_valid(text, type) هل سينجح التحويل، وتعيد pg_input_error_info رسالة الخطأ دون رفعه:
وحده '42' عدد صحيح صالح. يبدو '2026-02-30' تاريخًا لكنه ليس كذلك، فتكون valid_date له false أيضًا. وفي صف NULL تكون كل الأعمدة NULL، لأن تحويل NULL يعطي NULL من النوع الجديد.
متى يحوّل PostgreSQL عنك
القيمة الحرفية المقتبسة لا نوع لها حتى يرى PostgreSQL أين تُستخدم. لذا يعمل WHERE id = '5' و'1' + 1، وتُقرأ القيمة الحرفية كعدد صحيح. أما القيمة التي لها نوع أصلًا فلا تُحوَّل عنك: يفشل '1'::text + 1 بالخطأ "operator does not exist: text + integer"، وكذلك مقارنة عمود text بعمود integer. أضف التحويل بنفسك.
الكتابة أكثر تساهلًا. يحوّل INSERT أو UPDATE القيمة إلى نوع العمود حين يوجد تحويل إسناد (assignment cast)، فإدراج القيمة numeric 12.7 في عمود integer يخزّن 13.
لتغيير نوع عمود نهائيًا، حوّل كل صف مرة واحدة بـ ALTER TABLE ... ALTER COLUMN ... TYPE ... USING:
ALTER TABLE imports ALTER COLUMN qty TYPE integer USING qty::integer;
تسرد صفحة أنواع البيانات الأنواع التي يمكنك التحويل إليها.
الأسئلة الشائعة
ماذا تعني :: في PostgreSQL؟
إنها معامل التحويل في PostgreSQL: يحوّل '42'::integer النص '42' إلى عدد صحيح. ويؤدي العمل نفسه الذي يؤديه CAST('42' AS integer) القياسي.
هل أستخدم CAST أم :: في PostgreSQL؟
سلوكهما واحد. :: أقصر وشائع في شيفرة PostgreSQL. أما CAST(... AS ...) فهي SQL قياسية يقبلها MySQL وSQL Server وSQLite أيضًا، فاستخدمها في الاستعلامات التي يجب أن تبقى قابلة للنقل.
كيف أحوّل دون خطأ عندما لا يكون النص رقمًا؟
اختبره أولًا. منذ PostgreSQL 16 تعيد pg_input_is_valid('4x2', 'integer') القيمة false بدل رفع خطأ، فيعطي CASE WHEN pg_input_is_valid(s, 'integer') THEN s::integer END NULL للمدخل غير الصالح. وفي الإصدارات الأقدم تحقق من النص أولًا بتعبير نمطي مثل s ~ '^-?\d+$'.
لماذا يعيد 7 / 2 القيمة 3 في PostgreSQL؟
قسمة عددين صحيحين تعطي عددًا صحيحًا وتحذف الكسر. حوّل أحد الطرفين إلى numeric لتحصل على 3.5: 7::numeric / 2.