SUBSTRING - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Fungsi mengembalikan SUBSTRING bagian dari ekspresi string yang dimulai pada posisi yang ditentukan dan panjang yang ditentukan.

Fungsi sistem Azure Cosmos DB yang mengembalikan sebagian string menggunakan posisi awal dan panjang.

Syntax

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

Arguments

	Description
string_expr	Ekspresi string.
numeric_expr_1	Ekspresi numerik berbasis nol untuk menunjukkan karakter mulai. Nilai 0 mengacu pada karakter pertama.
numeric_expr_2	Ekspresi numerik untuk menunjukkan jumlah maksimum karakter yang string_expr akan dikembalikan.

Tipe pengembalian

Mengembalikan ekspresi string.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Mengekstrak substring dari string

Dalam contoh ini, SUBSTRING fungsi digunakan untuk mengembalikan substring dengan berbagai panjang dan posisi awal.

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

Komentar

• Fungsi ini menggunakan pengindeksan berbasis nol, yang 0 berarti mengacu pada karakter pertama dalam string.
• Jika numeric_expr_2 (panjang) negatif, fungsi mengembalikan string kosong.
• Untuk mengembalikan substring ke akhir string, gunakan LENGTH fungsi untuk menghitung karakter yang tersisa (misalnya, SUBSTRING(str, start, LENGTH(str) - start)).
• Fungsi ini mendapat manfaat dari penggunaan indeks rentang. Untuk informasi selengkapnya, lihat indeks rentang.