SUBSTRING - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La SUBSTRING funzione restituisce parte di un'espressione stringa a partire dalla posizione specificata e dalla lunghezza specificata.

Funzione di sistema di Azure Cosmos DB che restituisce una parte di una stringa usando una posizione iniziale e una lunghezza.

Sintassi

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

Arguments

	Description
string_expr	Espressione stringa.
numeric_expr_1	Espressione numerica in base zero per indicare il carattere iniziale. Un valore di 0 fa riferimento al primo carattere.
numeric_expr_2	Espressione numerica per indicare il numero massimo di caratteri di string_expr da restituire.

Tipi restituiti

Restituisce un'espressione stringa.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Estrarre sottostringhe da una stringa

In questo esempio, la SUBSTRING funzione viene usata per restituire sottostringhe con diverse lunghezze e posizioni iniziali.

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

Osservazioni:

• Questa funzione usa l'indicizzazione in base zero, ovvero 0 fa riferimento al primo carattere nella stringa.
• Se numeric_expr_2 (lunghezza) è negativo, la funzione restituisce una stringa vuota.
• Per restituire una sottostringa alla fine della stringa, usare la LENGTH funzione per calcolare i caratteri rimanenti, ad esempio SUBSTRING(str, start, LENGTH(str) - start).
• Questa funzione trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.