Menu

دوال النصوص في PostgreSQL: ‏substring وconcat وsplit_part

دوال النصوص في PostgreSQL التي تستخدمها كل يوم: substring وleft وright و|| وconcat وsplit_part وposition وreplace وregexp_replace وtrim وlpad وformat.

تحتوي هذه الصفحة على محررات قابلة للتشغيل. حرّر، شغّل، وشاهد النتيجة فوراً.

دوال النصوص في PostgreSQL التي ستحتاجها أكثر من غيرها:

  • تقتطع substring(text FROM start FOR length) جزءًا من نص. تبدأ المواضع من 1.
  • يدمج || أو concat() النصوص.
  • تأخذ split_part(text, delimiter, n) حقلًا واحدًا من نص مفصول بفاصل.
  • تستبدل replace(text, from, to) كل ظهور لنص فرعي.

تحصل Ada على Ada Lovelace وعلى النطاق example.com. وتتخطى concat_ws اسم عائلة Lin الناقص، فيكون اسمها الكامل Lin دون مسافة في النهاية.

استخراج جزء من نص

يعيد هذا PostgreS وgre وPost وSQL وPostgre و0042.

  • substring(... FROM start FOR length) هي الصيغة القياسية في SQL، وتؤدي substr(text, start, length) العمل نفسه كدالة عادية. احذف الطول لتأخذ بقية النص.
  • العدد السالب في left أو right يعني كل شيء ما عدا آخر (أو أول) n أحرف.
  • مع تعبير نمطي بعد FROM تعيد substring أول مطابقة، أو أول مجموعة بين قوسين إن كان في النمط مجموعة.

دمج النصوص: || وconcat وconcat_ws

يعيد || ‏NULL بمجرد أن يكون أحد الطرفين NULL. وتعامل concat قيمة NULL كنص فارغ وتعيد ab. وتضع concat_ws الفاصل بين القيم التي ليست NULL وتعيد Ada, London. وحين يكون أحد طرفي || نصًا، يُحوَّل الرقم في الطرف الآخر، كما في id-42.

لدمج قيم صفوف كثيرة في نص واحد استخدم string_agg.

التقسيم والبحث والاستبدال

النتائج هي example.com وc و4 و2026/11/17 وa#b#c# و{red,green,blue}.

  • تعيد split_part نصًا فارغًا حين لا يوجد الحقل، ورقم الحقل السالب يُعدّ من النهاية (منذ PostgreSQL 14).
  • تعيد position(sub IN text) وstrpos(text, sub) الموضع بدءًا من 1، أو 0 إن لم يوجد.
  • تستبدل replace كل ظهور وتميّز حالة الأحرف. أما regexp_replace فتستبدل أول مطابقة فقط ما لم تمرر العلَم 'g'، وأضف 'i' لتجاهل حالة الأحرف.
  • تقسم regexp_split_to_table(text, pattern) إلى صفوف بدل مصفوفة.

لاختبارات الأنماط في WHERE (LIKE وILIKE و~) راجع LIKE وILIKE والتعبيرات النمطية.

التنظيف والحشو والتنسيق

يعيد هذا hello وhi و00042 وHello World و5 وAda has 3 items. تقص ltrim وrtrim جانبًا واحدًا فقط، وتقطع lpad وrpad أيضًا النص الأطول من الطول المطلوب.

تعدّ length الأحرف وتعدّ octet_length البايتات، وتختلفان في النصوص غير ASCII مثل é. وتستخدم format ‏%s للقيمة، و%I للمعرّف المقتبس، و%L للقيمة الحرفية المقتبسة، وهذا يجعلها الطريقة الآمنة لبناء SQL ديناميكي داخل الدوال.

مرجع سريع

المهمةالدالةمثال على النتيجة
أحرف كبيرة، أحرف صغيرةupper(s)، lower(s)ADA، ada
يبدأ بـstarts_with(s, 'pre') أو s LIKE 'pre%'true
التكرار، العكسrepeat('ab', 3)، reverse('abc')ababab، cba
أول مطابقة لتعبير نمطيsubstring(s FROM 'pattern')النص المطابق
كل مطابقات التعبير النمطيregexp_matches(s, 'pattern', 'g')صف لكل مطابقة
رقم إلى نص بتنسيقto_char(1234.5, 'FM9,999.00')1,234.50

ويسرد مرجع دوال النصوص الرسمي البقية.

الأسئلة الشائعة

كيف أتحقق من أن نصًا يحتوي على نص فرعي في PostgreSQL؟

position('needle' IN haystack) > 0 أو strpos(haystack, 'needle') > 0، أو داخل WHERE ‏haystack LIKE '%needle%'. استخدم ILIKE لتجاهل حالة الأحرف وstarts_with(haystack, 'prefix') لاختبار البادئة.

لماذا يعيد || القيمة NULL في PostgreSQL؟

إذا كان أي طرف من طرفي || ‏NULL تكون النتيجة NULL. استخدم concat() أو concat_ws() اللتين تتخطيان وسائط NULL، أو غلّف القيمة التي قد تكون NULL بـ COALESCE(value, '').

هل يبدأ ترقيم النصوص في PostgreSQL من 1؟

نعم. تبدأ المواضع من 1، فتكون substring('abc' FROM 1 FOR 1) هي a، وتعيد position القيمة 0 حين لا يوجد النص.

ما الفرق بين text وvarchar في PostgreSQL؟

لا فرق في السرعة ولا في التخزين. يضيف varchar(n) فحصًا للطول، ولا حد لـ text وvarchar دون طول سوى الحد الأقصى للقيمة وهو 1 GB. وكل دوال النصوص تقبل الاثنين.

رسم توضيحي للغات البرمجة في Coddy

تعلّم البرمجة مع Coddy

ابدأ الآن