Partager via


SETUNION - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La SETUNION fonction retourne un ensemble d’expressions contenant toutes les expressions de deux ensembles collectés sans doublons.

Syntaxe

SetUnion(<array_expr_1>, <array_expr_2>)

Arguments

Descriptif
array_expr_1 Tableau d’expressions.
array_expr_2 Tableau d’expressions.

Types de retour

Retourne un tableau d’expressions.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Union de tableaux statiques

Dans cet exemple, la SetUnion fonction est utilisée avec des tableaux statiques pour illustrer la fonctionnalité union.

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"]
  }
]

Union des propriétés de tableau dans les documents

Dans cet exemple, la fonction retourne l’union de deux propriétés de tableau en tant que nouvelle propriété.

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"
    ]
  }
]

Remarques

  • Cette fonction n’utilise pas l’index.
  • Cette fonction ne retourne pas de doublons.