Compartilhar via


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

A DOCUMENTID função retorna a ID de documento exclusiva 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 retorno

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

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

Recuperar a ID do documento

Neste exemplo, a DOCUMENTID função é usada para obter a 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 IDs de 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

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