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 de sistema do Azure Cosmos DB para NoSQL que retorna uma expressão de cadeia de caracteres convertida em uma matriz.

Sintaxe

STRINGTOARRAY(<string_expr>)

Arguments

Tipos de retorno

Retorna uma matriz.

Exemplos

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

Converter cadeia de caracteres em matriz

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

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