Condividi tramite


DOCUMENTID - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La DOCUMENTID funzione restituisce l'ID documento univoco per un determinato elemento nel contenitore.

Può essere usato per filtrare o recuperare l'identificatore interno del documento.

Sintassi

DOCUMENTID(<item_expr>)

Arguments

Description
item_expr Elemento o alias che rappresenta il documento.

Tipi restituiti

Restituisce l'ID documento univoco come valore numerico.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Recuperare l'ID documento

In questo esempio, la DOCUMENTID funzione viene usata per ottenere l'ID documento interno per ogni prodotto.

SELECT
  p.id,
  p._rid,
  DOCUMENTID(p) AS documentId
FROM  
  product p
[
  {
    "id": "5741047452",
    "_rid": "36ZyAPW+uN8NAAAAAAAAAA==",
    "documentId": 13
  }
]

Filtrare in base all'intervallo di ID documento

In questo esempio la DOCUMENTID funzione viene usata in una clausola WHERE per filtrare i documenti in base al relativo ID interno.

SELECT
  p.id,
  DOCUMENTID(p) AS documentId
FROM  
  product p
WHERE
  DOCUMENTID(p) >= 5 AND
  DOCUMENTID(p) <= 15
[
  {
    "id": "5720559175",
    "documentId": 13
  }
]

Osservazioni:

  • Questa funzione restituisce un valore intero univoco solo all'interno di una singola partizione fisica.