Compartilhar via


STRINGSPLIT – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A STRINGSPLIT função retorna uma matriz de subcadeias de caracteres obtidas da separação da cadeia de caracteres de origem pelo delimitador especificado.

A STRINGSPLIT função retorna uma matriz de subcadeias de caracteres obtidas da separação da cadeia de caracteres de origem pelo delimitador especificado no Azure Cosmos DB para NoSQL.

Sintaxe

STRINGSPLIT(<string_expr1>, <string_expr2>)

Arguments

Description
string_expr1 A expressão de cadeia de caracteres de origem a ser analisada.
string_expr2 A cadeia de caracteres usada como delimitador.

Tipos de retorno

Retorna uma expressão de matriz.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Dividir cadeia de caracteres em subcadeias de caracteres

Neste exemplo, a STRINGSPLIT função é usada para dividir uma cadeia de caracteres em subcadeias de caracteres usando vários delimitadores.

SELECT VALUE {
  seperateOnLetter: STRINGSPLIT("Handlebar", "e"),
  seperateOnSymbol: STRINGSPLIT("CARBON_STEEL_BIKE_WHEEL", "_"),
  seperateOnWhitespace: STRINGSPLIT("Road Bike", " "),
  seperateOnPhrase: STRINGSPLIT("xenmoun mountain bike", "moun"),
  undefinedSeperator: STRINGSPLIT("AluminumBikeFrame", undefined),
  emptySeparatorString: STRINGSPLIT("Helmet", ""),
  emptySourceString: STRINGSPLIT("", "")
}
[
  {
    "seperateOnLetter": [
      "Handl",
      "bar"
    ],
    "seperateOnSymbol": [
      "CARBON",
      "STEEL",
      "BIKE",
      "WHEEL"
    ],
    "seperateOnWhitespace": [
      "Road",
      "Bike"
    ],
    "seperateOnPhrase": [
      "xen",
      " ",
      "tain bike"
    ],
    "emptySeparatorString": [
      "Helmet"
    ],
    "emptySourceString": [
      ""
    ]
  }
]

Observações

  • Essa função não utiliza o índice.