Compartilhar via


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

A SETUNION função retorna um conjunto de expressões que contêm todas as expressões de dois conjuntos coletados sem duplicatas.

Sintaxe

SetUnion(<array_expr_1>, <array_expr_2>)

Arguments

Description
array_expr_1 Uma matriz de expressões.
array_expr_2 Uma matriz de expressões.

Tipos de retorno

Retorna uma matriz de expressões.

Exemplos

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

União de matrizes estáticas

Neste exemplo, a SetUnion função é usada com matrizes estáticas para demonstrar a funcionalidade de união.

SELECT VALUE {
  simpleUnion: SetUnion([1, 2, 3, 4], [3, 4, 5, 6]),
  emptyUnion: SetUnion([1, 2, 3, 4], []),
  duplicatesUnion: SetUnion([1, 2, 3, 4], [1, 1, 1, 1]),
  unorderedUnion: SetUnion([1, 2, "A", "B"], ["A", 1])
}
[
  {
    "simpleUnion": [1, 2, 3, 4, 5, 6],
    "emptyUnion": [1,2,3,4],
    "duplicatesUnion": [1,2,3,4],
    "unorderedUnion": [1,2,"A","B"]
  }
]

União de propriedades de matriz em documentos

Neste exemplo, a função retorna a união de duas propriedades de matriz como uma nova propriedade.

SELECT
  p.name,
  SetUnion(p.colors[0].values, p.colors[1].values) AS allColors
FROM
  products p
WHERE
  p.category = "seasonal-coats"
[
  {
    "name": "Malsca coat",
    "allColors": [
      "Cutty Sark",
      "Horizon",
      "Russet",
      "Fuscous",
      "Tacha"
    ]
  }
]

Observações

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