STRINGTOARRAY - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A STRINGTOARRAY função converte uma expressão de cadeia de caracteres em uma matriz.

Uma função do sistema Azure Cosmos DB que devolve uma expressão de string convertida para um array.

Sintaxe

STRINGTOARRAY(<string_expr>)

Arguments

	Description
string_expr	Uma expressão de cadeia de caracteres.

Tipos de devolução

Retorna uma matriz.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Converter string em array

Neste exemplo, a STRINGTOARRAY função é usada para analisar vários valores de cadeia de caracteres em matrizes.

SELECT VALUE {
  parseEmptyArray: STRINGTOARRAY("[]"),
  parseArray: STRINGTOARRAY('[ "coats", "gloves", "hats" ]'),
  complexArray: STRINGTOARRAY('[ { "types": [ "coats", "gloves" ] }, [ "hats" ], 76, false, null ]'),
  nestedArray: STRINGTOARRAY('[ [ "coats", "gloves" ], [ "hats" ] ]'),
  invalidArray: STRINGTOARRAY("[ 'coats', 'gloves', 'hats' ]"),
  parseUndefined: STRINGTOARRAY(undefined),
  parseNull: STRINGTOARRAY(null)
}

[
  {
    "parseEmptyArray": [],
    "parseArray": [ "coats", "gloves", "hats" ],
    "complexArray": [
      {
        "types": [ "coats", "gloves" ]
      },
      [ "hats" ],
      76,
      false,
      null
    ],
    "nestedArray": [
      [ "coats", "gloves" ],
      [ "hats" ]
    ]
  }
]

Observações

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