Partilhar via


DOCUMENTID - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A DOCUMENTID função retorna o ID de documento exclusivo para um determinado item no contêiner.

Isso pode ser usado para filtrar ou recuperar o identificador interno do documento.

Sintaxe

DOCUMENTID(<item_expr>)

Arguments

Description
item_expr O item ou alias que representa o documento.

Tipos de devolução

Retorna a ID exclusiva do documento como um valor numérico.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Recuperar ID do documento

Neste exemplo, a DOCUMENTID função é usada para obter o ID do documento interno para cada produto.

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

Filtrar por intervalo de ID do documento

Neste exemplo, a DOCUMENTID função é usada em uma cláusula WHERE para filtrar documentos por sua ID interna.

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

Observações

  • Esta função retorna um valor inteiro que só é exclusivo dentro de uma única partição física.