Compartilhar 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 retorno

Retorna um objeto.

Exemplos

Esta seção contém exemplos de como usar este constructo 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

  • Essa 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 gravados com aspas duplas para serem válidos.