SUBSTRING - Cosmos DB'de sorgu dili (Azure ve Doku'da)

İşlev, SUBSTRING belirtilen konumdan ve belirtilen uzunluktan başlayarak dize ifadesinin bir bölümünü döndürür.

Başlangıç konumu ve uzunluğu kullanarak dizenin bir bölümünü döndüren bir Azure Cosmos DB sistem işlevi.

Sözdizimi

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

Arguments

	Description
string_expr	Dize ifadesi.
numeric_expr_1	Başlangıç karakterini belirtmek için sıfır tabanlı sayısal ifade. değeri 0 ilk karaktere başvurur.
numeric_expr_2	Döndürülecek karakter string_expr sayısı üst sınırını belirtmek için sayısal ifade.

Dönüş türleri

Bir dize ifadesi döndürür.

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Dizeden alt dizeleri ayıklama

Bu örnekte işlev, SUBSTRING çeşitli uzunluklara ve başlangıç konumlarına sahip alt dizeleri döndürmek için kullanılır.

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": ""
  }
]

Açıklamalar

• Bu işlev sıfır tabanlı dizinleme kullanır, yani 0 dizedeki ilk karaktere başvurur.
• (uzunluk) negatifse numeric_expr_2 işlev boş bir dize döndürür.
• Dizenin sonuna bir alt dize döndürmek için işlevini kullanarak LENGTH kalan karakterleri (örneğin, SUBSTRING(str, start, LENGTH(str) - start)) hesaplayın.
• Bu işlev, aralık dizini kullanımından yararlanır. Daha fazla bilgi için bkz. aralık dizinleri.