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 oppure alla fine della stringa.

Funzione di sistema Di Azure Cosmos DB per NoSQL 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 per indicare il carattere iniziale.
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 trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.