STRINGTOARRAY – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen STRINGTOARRAY konverterar ett stränguttryck till en matris.

En Azure Cosmos DB for NoSQL-systemfunktion som returnerar ett stränguttryck som konverterats till en matris.

Syntax

STRINGTOARRAY(<string_expr>)

Arguments

	Description
string_expr	Ett stränguttryck.

Returtyper

Returnerar en matris.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Konvertera sträng till matris

I det här exemplet STRINGTOARRAY används funktionen för att parsa olika strängvärden i matriser.

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

Anmärkningar

• Den här funktionen använder inte indexet.