SUBSTRING - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La SUBSTRING función devuelve parte de una expresión de cadena a partir de la posición especificada y de la longitud especificada, o al final de la cadena.

Una función del sistema de Azure Cosmos DB para NoSQL que devuelve una parte de una cadena mediante una posición inicial y una longitud.

Syntax

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

Arguments

	Description
string_expr	Expresión de cadena.
numeric_expr_1	Expresión numérica para indicar el carácter inicial.
numeric_expr_2	Expresión numérica para indicar el número máximo de caracteres de string_expr que se va a devolver.

Tipos de retorno

Devuelve una expresión de cadena.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

Extracción de subcadenas de una cadena

En este ejemplo, la SUBSTRING función se usa para devolver subcadenas con varias longitudes e posiciones iniciales.

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

Observaciones

• Esta función se beneficia del uso de un índice de intervalo. Para obtener más información, vea Índices de intervalo.