Freigeben über


DOCUMENTID - Abfragesprache in Cosmos DB (in Azure und Fabric)

Die DOCUMENTID Funktion gibt die eindeutige Dokument-ID für ein bestimmtes Element im Container zurück.

Dies kann zum Filtern oder Abrufen des internen Bezeichners des Dokuments verwendet werden.

Syntax

DOCUMENTID(<item_expr>)

Arguments

Description
item_expr Das Element oder alias, das das Dokument darstellt.

Rückgabetypen

Gibt die eindeutige Dokument-ID als numerischen Wert zurück.

Examples

Dieser Abschnitt enthält Beispiele für die Verwendung dieses Abfragesprachenkonstrukts.

Abrufen der Dokument-ID

In diesem Beispiel wird die DOCUMENTID Funktion verwendet, um die interne Dokument-ID für jedes Produkt abzurufen.

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

Nach Dokument-ID-Bereich filtern

In diesem Beispiel wird die DOCUMENTID Funktion in einer WHERE-Klausel verwendet, um Dokumente anhand ihrer internen ID zu filtern.

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

Bemerkungen

  • Diese Funktion gibt einen ganzzahligen Wert zurück, der nur innerhalb einer einzigen physischen Partition eindeutig ist.