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

A CONCAT função retorna uma cadeia de caracteres que é o resultado da concatenação de vários campos de um documento.

Sintaxe

CONCAT(<string_expr_1>, <string_expr_2> [, <string_expr_N>])

Arguments

	Description
string_expr_1	A primeira expressão de cadeia de caracteres na lista.
string_expr_2	A segunda expressão de cadeia de caracteres na lista.
string_expr_N	Expressões de cadeia de caracteres opcionais, que podem conter um número variável de expressões até o Nth item na lista.

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.

Considere este conjunto de exemplos de documentos na Products coleção para esses exemplos.

[
  {
    "name": "Stilld rope",
    "category": "gear",
    "sku": "66403",
    "detailCategory": "gear-climb-ropes"
  },
  {
    "name": "Orangas rope",
    "category": "gear",
    "sku": "66404",
    "detailCategory": "gear-climb-ropes"
  },
  {
    "name": "Vonel Rope",
    "category": "gear",
    "sku": "66400",
    "detailCategory": "gear-climb-ropes"
  },
  {
    "name": "Ferpal Ropes",
    "category": "gear",
    "sku": "66401",
    "detailCategory": "gear-climb-ropes"
  },
  {
    "name": "Cotings rope",
    "category": "gear",
    "sku": "66402",
    "detailCategory": "gear-climb-ropes"
  }
]

Concatenar cadeias de caracteres

Neste exemplo, a CONCAT função é usada para concatenar duas cadeias de caracteres arbitrárias.

SELECT VALUE
  CONCAT("Ferpal", "Ropes")

[
  "FerpalRopes"
]

Concatenar campos de produto

Neste exemplo, a CONCAT função é usada para concatenar campos de um produto na categoria "heavy-coats".

SELECT VALUE
  CONCAT(p.sku, "-", p.detailCategory)
FROM
  products p
WHERE
  p.detailCategory = "gear-climb-ropes"

[
  "66403-gear-climb-ropes",
  "66404-gear-climb-ropes",
  "66400-gear-climb-ropes",
  "66401-gear-climb-ropes",
  "66402-gear-climb-ropes"
]

Observações

• Essa função não utiliza o índice.