DOCUMENTID — Język zapytań w usłudze Cosmos DB (na platformie Azure i w sieci szkieletowej)

Funkcja DOCUMENTID zwraca unikatowy identyfikator dokumentu dla danego elementu w kontenerze.

Może to służyć do filtrowania lub pobierania identyfikatora wewnętrznego dokumentu.

Składnia

DOCUMENTID(<item_expr>)

Arguments

	Description
item_expr	Element lub alias reprezentujący dokument.

Typy zwracane

Zwraca unikatowy identyfikator dokumentu jako wartość liczbową.

Przykłady

Ta sekcja zawiera przykłady użycia tej konstrukcji języka zapytań.

Pobieranie identyfikatora dokumentu

W tym przykładzie funkcja służy do pobierania DOCUMENTID wewnętrznego identyfikatora dokumentu dla każdego produktu.

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

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

Filtruj według zakresu identyfikatorów dokumentu

W tym przykładzie DOCUMENTID funkcja jest używana w klauzuli WHERE do filtrowania dokumentów według ich wewnętrznego identyfikatora.

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

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

Uwagi

• Ta funkcja zwraca wartość całkowitą, która jest unikatowa tylko w ramach jednej partycji fizycznej.