SUBSTRING - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La SUBSTRING fonction retourne une partie d’une expression de chaîne commençant à la position spécifiée et de la longueur spécifiée, ou à la fin de la chaîne.

Fonction système Azure Cosmos DB pour NoSQL qui retourne une partie d’une chaîne à l’aide d’une position de départ et d’une longueur.

Syntaxe

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

Arguments

	Descriptif
string_expr	Expression de chaîne.
numeric_expr_1	Expression numérique qui indique le caractère de début.
numeric_expr_2	Expression numérique qui indique le nombre maximal de caractères string_expr à renvoyer.

Types de retour

Retourne une expression de chaîne.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Extraire des sous-chaînes d’une chaîne

Dans cet exemple, la SUBSTRING fonction est utilisée pour retourner des sous-chaînes avec différentes longueurs et positions de départ.

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

Remarques

• Cette fonction tire parti de l’utilisation d’un index de plage. Pour plus d’informations, consultez les index de plage.