Partilhar via


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

A STRINGTOOBJECT função converte uma expressão de cadeia de caracteres em um objeto.

A STRINGTOOBJECT função converte uma expressão de cadeia de caracteres em um objeto no Azure Cosmos DB para NoSQL.

Sintaxe

STRINGTOOBJECT(<string_expr>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.

Tipos de devolução

Retorna um objeto.

Examples

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

Converter cadeia de caracteres em objeto

Neste exemplo, a STRINGTOOBJECT função é usada para converter várias expressões de cadeia de caracteres em objetos.

SELECT VALUE {
  parseEmptyObject: STRINGTOOBJECT("{}"),
  parseObjectWithProperty: STRINGTOOBJECT('{"isAvailable": true}'),
  parseObjectNested: STRINGTOOBJECT('{"division": {"name": "Sales"}}'),
  parseObjectInvalidJson: STRINGTOOBJECT("{'price': 27.55}"),
  parseUndefined: STRINGTONUMBER(undefined),
  parseNull: STRINGTONUMBER(null)
}
[
  {
    "parseEmptyObject": {},
    "parseObjectWithProperty": {
      "isAvailable": true
    },
    "parseObjectNested": {
      "division": {
        "name": "Sales"
      }
    }
  }
]

Observações

  • Esta função não utiliza o índice.
  • Se a expressão não puder ser convertida, a função retornará undefined.
  • Os valores de cadeia de caracteres aninhados devem ser escritos com aspas duplas para serem válidos.