DOCUMENTID — язык запросов в Cosmos DB (в Azure и Fabric)

Функция DOCUMENTID возвращает уникальный идентификатор документа для заданного элемента в контейнере.

Это можно использовать для фильтрации или получения внутреннего идентификатора документа.

Синтаксис

DOCUMENTID(<item_expr>)

Arguments

	Description
item_expr	Элемент или псевдоним, представляющий документ.

Типы возвращаемых данных

Возвращает уникальный идентификатор документа в виде числового значения.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Получение идентификатора документа

В этом примере DOCUMENTID функция используется для получения внутреннего идентификатора документа для каждого продукта.

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

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

Фильтрация по диапазону идентификаторов документа

В этом примере DOCUMENTID функция используется в предложении WHERE для фильтрации документов по внутреннему идентификатору.

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

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

Замечания

• Эта функция возвращает целочисленное значение, уникальное только в пределах одной физической секции.