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ão(ões) de cadeia de caracteres opcional, que pode conter um número variável de expressões até o Nono item da lista.

Tipos de devolução

Retorna uma expressão de cadeia de caracteres.

Examples

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

Considere este conjunto de exemplos de documentos dentro da 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

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 "casacos pesados".

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

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