Partilhar via


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

A IS_STRING função retorna um valor booleano indicando se o tipo da expressão especificada é uma cadeia de caracteres.

Uma função de sistema do Azure Cosmos DB para NoSQL que retorna true se o tipo da expressão especificada for uma cadeia de caracteres.

Sintaxe

IS_STRING(<expr>)

Arguments

Description
expr Qualquer expressão.

Tipos de devolução

Retorna uma expressão booleana.

Examples

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

Verifique se o valor é string

Neste exemplo, a IS_STRING função é usada para verificar vários valores para ver se eles são uma cadeia de caracteres.

SELECT VALUE {
  isBooleanAString: IS_STRING(true),
  isNumberAString: IS_STRING(1),
  isStringAString: IS_STRING("value"),
  isArrayAString: IS_STRING([ "green", "red", "yellow" ]),
  isNullAString: IS_STRING(null),
  isObjectAString: IS_STRING({ "name": "Tecozow coat" }),
  isObjectStringPropertyAString: IS_STRING({ "name": "Tecozow coat" }.name),
  isObjectBooleanPropertyAString: IS_STRING({ "onSale": false }.onSale),
  isUndefinedAString: IS_STRING({}.category)
}
[
  {
    "isBooleanAString": false,
    "isNumberAString": false,
    "isStringAString": true,
    "isArrayAString": false,
    "isNullAString": false,
    "isObjectAString": false,
    "isObjectStringPropertyAString": true,
    "isObjectBooleanPropertyAString": false,
    "isUndefinedAString": false
  }
]

Observações

  • Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.