Freigeben über


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

Die GETCURRENTDATETIMESTATIC Funktion gibt denselben UTC-Datums- und Uhrzeitwert für alle Elemente in der Abfrage als ISO 8601-Zeichenfolge zurück. Dies ist nützlich für konsistente Zeitstempel in allen Abfrageergebnissen.

Syntax

GETCURRENTDATETIMESTATIC()

Rückgabetypen

Gibt das aktuelle UTC-Datum und die aktuelle UHRZEIT als Zeichenfolge im ISO 8601-Format zurück, die für alle Elemente in der Abfrage konsistent ist.

Examples

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

Abrufen statischer und nicht statischer aktueller Datums- und Uhrzeitdaten

In diesem Beispiel wird die GETCURRENTDATETIMESTATIC Funktion verwendet, um den gleichen Zeitstempel für alle Elemente zurückzugeben, während GetCurrentDateTime für jedes Element ein anderer Wert zurückgegeben wird.

SELECT
  i.id,
  i.pk AS partitionKey,
  GetCurrentDateTime() AS nonStaticDateTime,
  GETCURRENTDATETIMESTATIC() AS staticDateTime
FROM
    items i
[
  {
    "id": "1",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4500994Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "2",
    "partitionKey": "A",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501101Z",
    "staticDateTime": "2023-06-28T18:32:12.4499507Z"
  },
  {
    "id": "3",
    "partitionKey": "B",
    "nonStaticDateTime": "2023-06-28T18:32:12.4501181Z",
    "staticDateTime": "2023-06-28T18:32:12.4401181Z"
  }
]

Bemerkungen

  • Diese statische Funktion wird einmal pro Partition aufgerufen.
  • Statische Versionen von Systemfunktionen erhalten ihre jeweiligen Werte nur einmal während der Bindung, anstatt wiederholt in der Laufzeit auszuführen, wie bei den nicht statischen Versionen derselben Funktionen.