سلسلة فرعية (استعلام NoSQL)

ينطبق على: NoSQL

إرجاع جزء من تعبير سلسلة بدءا من الموضع المحدد والطول المحدد، أو إلى نهاية السلسلة.

بناء الجملة

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)  

الوسيطات

الوصف
string_expr تعبير سلسلة.
numeric_expr_1 تعبير رقمي للإشارة إلى حرف البدء.
numeric_expr_2 تعبير رقمي للإشارة إلى الحد الأقصى لعدد الأحرف string_expr التي سيتم إرجاعها.

أنواع الإرجاع

يُرجع تعبير سلسلة.

أمثلة

يقوم المثال التالي بإرجاع سلاسل فرعية بأطوال مختلفة ومواضع بدء.

SELECT VALUE {
    substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
    substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
    substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
    substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}
[
  {
    "substringPrefix": "Adventure",
    "substringSuffix": "Works",
    "substringTotalLength": "AdventureWorks",
    "substringEmptyString": ""
  }
]

الملاحظات

  • تستفيد هذه الدالة من فهرس النطاق إذا كان موضع البداية هو 0.
  • numeric_expr_1 المواضع مستندة إلى الصفر، لذلك قيمة تبدأ من 0 الحرف الأول من string_expr.
  • قيمة 0 أو أقل للنتائج numeric_expr_2 في سلسلة فارغة.