Compartilhar via


REPLICATE – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A REPLICATE função retorna um valor de cadeia de caracteres repetido um número específico de vezes.

Uma função do sistema do Azure Cosmos DB para NoSQL que retorna um valor de cadeia de caracteres repetido um número específico de vezes.

Sintaxe

REPLICATE(<string_expr>, <numeric_expr>)

Arguments

Description
string_expr Uma expressão de cadeia de caracteres.
numeric_expr Uma expressão numérica.

Tipos de retorno

Retorna uma expressão de cadeia de caracteres.

Exemplos

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

Repetir o valor da cadeia de caracteres

Neste exemplo, a função cria uma cadeia de caracteres repetida.

SELECT VALUE {
  catchPhrase: REPLICATE("Cosmic", 3)
}
[
  {
    "catchPhrase": "CosmicCosmicCosmic"
  }
]

Observações

  • Essa função não utiliza o índice.
  • O comprimento máximo do resultado é de 10.000 caracteres . - (length(string_expr) * numeric_expr) <= 10,000
  • Se numeric_expr for negativo ou não definido, o resultado será undefined.