دوال النصوص في 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. وكل دوال النصوص تقبل الاثنين.