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

La DOCUMENTID fonction retourne l’ID de document unique d’un élément donné dans le conteneur.

Cela peut être utilisé pour filtrer ou récupérer l’identificateur interne du document.

Syntaxe

DOCUMENTID(<item_expr>)

Arguments

	Descriptif
item_expr	Élément ou alias représentant le document.

Types de retour

Retourne l’ID de document unique sous forme de valeur numérique.

Examples

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

Récupérer l’ID de document

Dans cet exemple, la DOCUMENTID fonction est utilisée pour obtenir l’ID de document interne pour chaque produit.

SELECT
  p.id,
  p._rid,
  DOCUMENTID(p) AS documentId
FROM  
  product p

[
  {
    "id": "5741047452",
    "_rid": "36ZyAPW+uN8NAAAAAAAAAA==",
    "documentId": 13
  }
]

Filtrer par plage d’ID de document

Dans cet exemple, la DOCUMENTID fonction est utilisée dans une clause WHERE pour filtrer les documents par leur ID interne.

SELECT
  p.id,
  DOCUMENTID(p) AS documentId
FROM  
  product p
WHERE
  DOCUMENTID(p) >= 5 AND
  DOCUMENTID(p) <= 15

[
  {
    "id": "5720559175",
    "documentId": 13
  }
]

Remarques

• Cette fonction retourne une valeur entière qui n’est unique qu’au sein d’une seule partition physique.